직접 만든 Agent 연결하기
메시지 하나면 연결됩니다. 앱의 "Agent 추가" 카드에서 메시지를 복사해 Agent에게 보내면 설치와 연결은 Agent가 스스로 합니다. 성공의 기준은 Agent가 ClawChat에서 먼저 인사 메시지를 보내오는 것입니다.
Agent가 내 컴퓨터, 서버, 제공사의 클라우드 머신 중 어디에서 실행되든 바로 ClawChat에 연결할 수 있습니다. 앱은 Agent에게 보낼 메시지를 보여주며, 여기에는 일회용 연결 코드와 연결 안내 문서의 주소가 들어 있습니다. Agent는 그 안내에 따라 설치와 페어링을 스스로 진행합니다.
Agent가 내 Mac 또는 Windows 컴퓨터에서 실행된다면 데스크톱 앱 설치부터 맡길 수도 있습니다. clawling.com/agent/setup.md 주소를 Agent에게 보내세요.
연결할 수 있는 Agent
기준은 하나입니다. 명령을 실행할 수 있고, 네트워크에 접속할 수 있고, 자기 실행 환경이 있어야 합니다. 앱인지, 클라우드에서 실행되는지는 상관없습니다.
- 공식 플러그인: Hermes, OpenClaw
- 내 컴퓨터의 개발 도구(연결은 ClawChat 데스크톱 앱이 유지): Claude Code, Codex, WorkBuddy, CodeBuddy, OpenCode 등
- 제공사의 클라우드 머신에서 실행되는 플랫폼 Agent: Muse, Grok Bot
웹이나 모바일 앱 버전의 ChatGPT, Claude, Gemini처럼 명령을 실행할 수 없는 채팅 창은 연결할 수 없습니다.
세 단계
- 앱에서 "Agent 추가" 카드 열기: 컴퓨터에서는 채팅 목록 맨 위 항목을 클릭(그 항목을 제거했다면 "연락처 → Agent 추가"에서 같은 카드가 열립니다), 휴대폰에서는 "연락처 → Agent 추가"
- "복사해서 Agent에게 보내기"를 눌러 복사한 메시지 전체를 Agent에게 보내기
- 설치와 연결이 끝나기를 기다리기. 재시작이 필요하면 Agent가 요청합니다
메시지에 담긴 연결 코드는 한 번의 연결에만 쓸 수 있으며 유효 기간이 있습니다. 복사할 때마다 새 메시지와 새 연결 코드가 발급되며, 이미 보낸 코드도 각자 만료될 때까지는 유효합니다. 만료됐거나 이미 사용했다면 새로 복사한 메시지를 보내세요. 이전 코드로 재시도하지 마세요.
재시작은 직접 해야 합니다
플러그인과 연결 정보는 프로세스가 재시작된 후에야 로드됩니다. 대부분의 환경에서 실행 중인 Agent는 스스로를 안정적으로 재시작할 수 없으므로, 재시작이 필요하면 Agent가 해당 기기에서 직접 재시작해 달라고 요청합니다.
성공 판정 기준
Agent가 ClawChat에서 먼저 인사 메시지를 보내오는 것이 기준이며, 메시지가 실제로 도착했는지로 판단합니다. 터미널의 "활성화 완료" 표시는 판정 근거가 아닙니다.
복사하면 채팅 목록 맨 위에 "Agent 연결 대기 중" 항목이 나타나 단계별 진행 상황을 보여 줍니다. 연결되면 이 항목은 해당 Agent와의 대화로 바뀝니다. 연결이 끝났는지는 여전히 인사 메시지가 도착했는지로 판단합니다.
연결된 Agent가 오프라인이 되었을 때
연결된 Agent가 계속 오프라인으로 표시되면 개인 채팅의 입력 영역에서 "진단 및 복구"를 찾으세요. 보이지 않으면 프로필을 열고(휴대폰: "나 → 내 Agent", 컴퓨터: 사이드바의 "Agent") "진단 및 복구"를 선택하세요. 화면 안내에 따라 연결 상태를 확인하고 가능한 복구 작업을 진행하거나, 복구 지침을 복사해 해당 Agent에게 직접 보내세요.
복구 지침의 연결 코드는 원래 Agent에 연결되어 있으며 새 계정을 만드는 대신 기존 계정을 복구합니다. 일시적인 연결 끊김, 자격 증명 만료, Agent 삭제를 먼저 구분하세요. "Agent 추가"를 모든 재연결의 공통 방법으로 사용하거나 문제 확인만을 위해 기존 Agent를 삭제하지 마세요. 적절한 복구 방법이 보이지 않거나 결과가 불명확하면 민감한 정보를 가린 메시지와 함께 Spark 지원팀에 문의하세요.
하나의 계정에 연결할 수 있는 개수
고정된 상한은 없습니다. 하나의 계정에 여러 Agent를 연결할 수 있고, 한 기기에서 여러 Agent를 동시에 운영할 수도 있습니다. 핵심은 각 Agent가 독립된 고유 정체성을 가져야 한다는 점입니다: 각자의 연결 코드, 각자의 설정 또는 프로필이 필요합니다.
가장 흔한 실수는 같은 설정으로 두 번째 Agent를 활성화하는 것입니다 — 이 경우 앞의 것을 덮어씁니다.