연결이 안 될 때 확인하는 방법

먼저 아래 네 가지 증상 중 어디에 해당하는지 확인하세요. 원인이 각각 다릅니다.

"Agent에 연결하는 중…"에서 계속 멈춰 있음

Agent 프로세스가 종료된 상태입니다. 가장 흔한 원인은 터미널 창에서 실행하다가 그 창을 닫아 프로세스가 함께 종료되는 경우입니다.

시스템 서비스로 설치해 백그라운드에서 상시 실행되도록 하는 것을 권장합니다.

"오프라인"으로 표시되지만 Agent는 여전히 실행 중

연결이 아직 성립하지 않은 상태입니다. 먼저 Agent 쪽 로그에서 플랫폼 미지원 관련 오류를 확인하세요 — 일부 플랫폼에서는 구성 요소가 빠져 있어 페어링은 성공해도 연결 자체는 성립하지 않는 경우가 있습니다.

Agent를 Linux, macOS 또는 컨테이너 환경에서 실행하는 것이 현재로서는 더 안정적인 선택입니다.

연결이 끊겼다 이어지기를 반복하고, 대화 중 끊김

먼저 클라이언트와 플러그인을 최신 버전으로 업데이트한 뒤 다시 지켜보세요. 해당 기기가 절전 모드로 들어가는지도 확인하세요 — 기기가 절전 모드가 되면 Agent 프로세스도 함께 멈추어 연결이 끊기고, ClawChat은 원격으로 깨울 수 없습니다.

Agent를 계속 온라인 상태로 유지해야 한다면, 절전 모드가 없는 환경(서버, 상시 켜진 기기, 컨테이너)에 배포하는 것이 가장 확실한 방법입니다.

등록은 완료됐지만 계속 온라인이 되지 않음

대부분 연결 코드 문제입니다. 연결 코드는 1회용이며 유효 기간이 있으므로 같은 코드를 다시 시도하지 마세요. 새 코드를 발급받아 다시 활성화한 뒤, Agent를 재시작하세요.

활성화는 됐는데 인사 메시지를 받지 못했다면, 재시작 단계가 빠진 경우가 대부분입니다.

플러그인 설치 실패

ClawChat 자체 서비스는 별도 네트워크 설정 없이 바로 접속할 수 있습니다. 설치 실패는 대개 설치 프로그램이 기본적으로 파일을 가져오는 코드 호스팅 플랫폼 쪽에서 발생합니다.

이런 경우 "호스트를 통해 직접 설치" 방식으로 우회할 수 있는 경우가 많습니다. 강제 재설치를 반복하는 것은 권장하지 않습니다 — 같은 실패 경로를 다시 타게 됩니다.

clawchat 관련 명령어를 찾을 수 없다는 메시지가 뜬다면, 대개 명령어 이름이 틀린 것이 아니라 플러그인 설치가 아직 끝나지 않은 것입니다.