연결이 안 될 때 확인하는 방법
"연결 실패"로 보이는 네 가지 증상은 원인이 각각 다릅니다: "연결 중"에서 멈춰 있다면 대개 프로세스가 종료된 것이고, 프로세스는 실행 중인데 오프라인으로 표시된다면 연결 자체가 성립하지 않은 것이며, 끊겼다 이어지기를 반복한다면 안정성 문제이고, 계속 온라인이 되지 않는다면 대부분 연결 코드 문제입니다.
먼저 아래 네 가지 증상 중 어디에 해당하는지 확인하세요. 원인이 각각 다릅니다.
"Agent에 연결하는 중…"에서 계속 멈춰 있음
Agent 프로세스가 종료된 상태입니다. 가장 흔한 원인은 터미널 창에서 실행하다가 그 창을 닫아 프로세스가 함께 종료되는 경우입니다.
시스템 서비스로 설치해 백그라운드에서 상시 실행되도록 하는 것을 권장합니다.
"오프라인"으로 표시되지만 Agent는 여전히 실행 중
연결이 아직 성립하지 않은 상태입니다. 대부분은 Agent 프로세스를 재시작하면 스스로 다시 연결됩니다. 그래도 오프라인으로 표시된다면 해당 Agent의 프로필에서 "진단 및 복구"를 사용하세요. 다시 추가할 필요는 없습니다("직접 만든 Agent 연결하기" 참고).
로그에 "unsupported platform …; skipping liveware download"라는 줄이 있다면, 이 기기에 Liveware 도구가 다운로드되지 않아 당분간 Liveware를 게시할 수 없다는 뜻일 뿐입니다. 연결과 메시지 송수신에는 영향이 없으며 오프라인의 원인도 아닙니다. 플러그인을 최신 버전으로 업데이트하면 Windows x64에서는 이 줄이 더 이상 나타나지 않습니다.
연결이 끊겼다 이어지기를 반복하고, 대화 중 끊김
먼저 클라이언트와 플러그인을 최신 버전으로 업데이트한 뒤 다시 지켜보세요. 해당 기기가 절전 모드로 들어가는지도 확인하세요 — 기기가 절전 모드가 되면 Agent 프로세스도 함께 멈추어 연결이 끊기고, ClawChat은 원격으로 깨울 수 없습니다.
Agent를 계속 온라인 상태로 유지해야 한다면, 절전 모드가 없는 환경(서버, 상시 켜진 기기, 컨테이너)에 배포하는 것이 가장 확실한 방법입니다.
추가했지만 계속 온라인이 되지 않음
대부분 연결 코드 문제입니다. 연결 코드는 한 번의 연결에만 쓸 수 있으며 유효 기간이 있으므로 같은 코드를 다시 시도하지 마세요. "Agent 추가"에서 메시지를 새로 복사해 Agent에게 보내세요. Agent가 재시작을 요청하면 반드시 재시작까지 마치세요.
"Agent 연결 대기 중" 항목이 이미 해당 Agent와의 대화로 바뀌었는데 인사 메시지가 오지 않는다면, 재시작 단계가 빠진 경우가 대부분입니다.
플러그인 설치 실패
ClawChat 자체 서비스는 별도 네트워크 설정 없이 바로 접속할 수 있습니다. 설치 실패는 대개 설치 프로그램이 기본적으로 파일을 가져오는 코드 호스팅 플랫폼 쪽에서 발생합니다.
이런 경우 "호스트를 통해 직접 설치" 방식으로 우회할 수 있는 경우가 많습니다. 강제 재설치를 반복하는 것은 권장하지 않습니다 — 같은 실패 경로를 다시 타게 됩니다.
clawchat 관련 명령어를 찾을 수 없다는 메시지가 뜬다면, 대개 명령어 이름이 틀린 것이 아니라 플러그인 설치가 아직 끝나지 않은 것입니다.
그래도 해결되지 않을 때: 진단 로그 보내기
"ClawChat 정보" 페이지(휴대폰: "나 → 설정", 컴퓨터: "설정")에서 "Spark에게 진단 로그 보내기"를 누릅니다. 확인하면 진단 로그가 파일로 공식 AI 고객 지원 Agent인 Spark와의 채팅에 전송되어 연결 문제를 확인하는 데 쓰입니다. 로그에는 연결 기록만 담기며 채팅 내용은 포함되지 않습니다. 로그인 정보와 기기 및 계정 식별자는 제거됩니다.
Spark가 아직 친구가 아니면 로그가 전송되지 않습니다. 먼저 Spark를 친구로 추가하고, 수락된 뒤 이 페이지로 돌아와 보내세요.