챗봇이 응답하지 않나요? OpenClaw 오류 5분 만에 해결하기

정상 상태라면 이렇게 표시되어야 합니다

각 명령어 실행 결과가 다음과 같은지 확인하세요. 하나라도 다르다면 거기에 문제의 실마리가 있습니다.

• openclaw gateway status

  → Runtime: running과 Connectivity probe: ok가 반드시 보여야 합니다.

• openclaw channels status --probe

  → 전송 프로토콜이 connected 상태이고, 지원되는 경우 works 또는 audit ok가 표시되어야 합니다.

• openclaw status

  → 명백한 인증 오류나 설정 오류가 없어야 합니다.

업데이트 후 갑자기 멈췄다면?

OpenClaw 업데이트 이후 채널이 사라지거나 챗봇이 응답하지 않는 문제는 의외로 흔합니다. 이때는 아래 순서를 그대로 따라 해 보세요.

1. openclaw status --all

   실행

2. openclaw doctor --fix

   실행

3. openclaw gateway restart

   실행
4. 다시

   openclaw status --all

   로 상태 확인

실행 중

plugin load failed: dependency tree corrupted

openclaw doctor --fix

텔레그램 챗봇만 멈췄을 때 확인할 사항

텔레그램 봇에서 문제가 발생하는 경우는 조금 더 세분화됩니다. 봇은 온라인인데 메시지를 주고받을 수 없거나, 그룹 채팅에서만 조용해지는 등의 증상이 나타날 수 있습니다.

• 봇은 켜져 있는데 대화가 불가능한 경우: 가장 먼저

  openclaw pairing list telegram

  명령어로 페어링 상태를 확인하세요.
• 그룹 채팅에서만 반응이 없는 경우: 텔레그램 봇 설정에서 privacy mode와 멘션 요구 사항을 확인하세요. 봇이 모든 메시지를 읽지 못하게 막혀 있을 수 있습니다.
• 텔레그램 API 네트워크 오류가 로그에 찍히는 경우: DNS, IPv6, 프록시 라우팅 설정을 점검하세요.
• 시작 시 "getMe returned 401" 오류가 발생하는 경우: BotFather에서 발급받은 토큰이 만료되었거나 잘못 입력된 것입니다. botToken, tokenFile, 또는 TELEGRAM_BOT_TOKEN 환경 변수를 새 토큰으로 업데이트하세요.
• 폴링(polling)이 멈추거나 재연결이 느린 경우:

  openclaw logs --follow

  로 로그를 지켜보며, 문제가 지속되면 프록시/DNS/IPv6 설정을 의심해야 합니다.

게이트웨이 자체가 문제인 경우

만약 openclaw 명령어가 예전 버전의 바이너리를 가리키고 있다면, 모든 명령이 엉뚱하게 실행될 수 있습니다. PATH 환경 변수를 최신 설치 경로로 수정한 후 다시 시도하세요.

게이트웨이 서비스가 잘못된 버전으로 설치되었거나 오래된 래퍼(Wrapper)가 남아 있다면, 공식 문서에서는 게이트웨이 서비스를 의도한 버전으로 재설치하고 불필요한 래퍼나 패키지를 제거할 것을 권장합니다.

증상별 빠른 진단 차트

증상만으로도 어느 부분을 먼저 살펴야 할지 예측할 수 있습니다.

• 게이트웨이가 실행되지 않거나 프로브(probe)가 실패하는 경우 → 게이트웨이 서비스, PATH 설정, 바이너리 버전 충돌을 점검하세요.
• 게이트웨이는 실행 중인데 챗봇이 응답하지 않는 경우 → 채널 메시지 흐름, 페어링, 멘션 제한, 프라이버시 모드, 텔레그램 토큰, API 네트워크 연결을 확인하세요.
• 업데이트 직후 발생한 문제 →

  doctor --fix

  실행 후 게이트웨이 재시작을 가장 먼저 시도하세요.
• 로그에 치명적 오류(fatal error)가 반복되는 경우 → 단순한 일시적 지연이 아니라 설정 파일이나 플러그인의 근본적인 손상입니다.

마무리

더 이상 막연히 추측하지 마세요. OpenClaw 문제는 위 5가지 기본 명령어로 시작하여 텔레그램, 게이트웨이 등 해당 분기로 접근하는 것이 정석입니다.

지금 바로

openclaw gateway status

openclaw channels status --probe

openclaw logs --follow