OpenClaw 봇이 응답하지 않을 때: 단계별 문제 해결 가이드

아직 봇챗의 OpenClaw 오작동에 대한 구체적인 원인을 단정할 수 있는 충분한 증거는 없습니다. 하지만 문제 해결을 위한 올바른 진단 경로는 명확합니다. 다음의 5단계 명령어를 순서대로 실행하여 상태를 확인해야 합니다.

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

이 명령어들은 "연결은 되어 있지만 동작이 올바르지 않은" 채널 문제를 해결할 때 가장 먼저 사용해야 하는 표준 진단 도구입니다.

지금 바로 확인해야 할 사항

• 기본 상태 확인: 정상적인 기준선은

  Runtime: running

  ,

  Connectivity probe: ok

  , 유효한 Capability(읽기 전용, 쓰기 가능 등)가 표시되어야 합니다. 또한 채널 프로브에서 전송 계층(transport)이 연결되었음을 알리고, 지원되는 경우 works 또는

  audit ok

  상태를 보여야 합니다.
• 텔레그램 그룹 침묵 문제: 텔레그램 봇이 온라인 상태인데도 그룹 채팅에서 반응이 없다면, requireMention(멘션 필수) 설정과 봇의 프라이버시 모드를 확인하십시오. 봇이 그룹의 모든 메시지를 읽게 하려면, 봇파더(BotFather)를 통해 /setprivacy 명령어로 프라이버시 모드를 비활성화하거나 봇을 그룹 관리자로 지정해야 합니다. 이후 변경 사항을 적용하려면 그룹에서 봇을 내보낸 후 다시 초대해야 합니다.
• 네트워크 오류: 메시지 전송 시 네트워크 오류가 발생한다면, 텔레그램 API 로그를 확인하고 api.telegram.org로 향하는 DNS, IPv6, 프록시 라우팅 설정을 점검해야 합니다.
• 401 인증 오류: 봇 시작 시

  getMe returned 401

  오류가 표시된다면, 봇파더에서 발급받은 토큰이 잘못되었거나 만료된 것입니다. botToken, tokenFile, 또는 기본 계정의 TELEGRAM_BOT_TOKEN 환경 변수를 업데이트해야 합니다.
• Polling 지연 또는 불안정: long polling이 멈추거나 재연결 속도가 느리다면

  openclaw logs --follow

  명령어로 로그를 면밀히 추적하십시오. 문제가 지속될 경우, 공식 문서는 그 원인이 대부분 프록시, DNS, IPv6 설정과 관련되어 있다고 설명합니다.
• Polling 충돌 (409 Conflict): 로그에서 getUpdates 409 충돌이 발견된다면, 동일한 봇 토큰을 사용하는 또 다른 OpenClaw 게이트웨이나 외부 스크립트가 존재한다는 의미입니다. OpenClaw의 텔레그램 문서는 하나의 봇 토큰에 대해 오직 하나의 long polling 주체만 활성화되어야 한다고 명시합니다.

업데이트 이후 봇이 고장 났다면?

업데이트 후 봇 기능에 문제가 생겼다면, 공식 문서는 다음 순서를 권장합니다.

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의 텔레그램 채널은

  openclaw channels login telegram

  명령어를 사용하지 않습니다. 설정 파일이나 환경 변수에서 토큰을 가져와

  channels.telegram.enabled: true

  로 활성화한 후 게이트웨이를 시작하는 방식입니다.
• DM(ダイレクトメッセージ)은 기본적으로 페어링(pairing) 방식을 사용합니다. 게이트웨이 시작 후

  openclaw pairing list telegram

  명령어로 페어링 목록을 확인하고, 필요한 경우 이를 승인해야 합니다.

핵심 요약

현재로서는 "이것 때문에 고장 났다"라고 특정할 수 없습니다. 증거가 불충분합니다.

하지만 정확한 해결을 원한다면, 위에서 제시한 5가지 진단 명령어의 출력 결과를 확보하는 것이 선행되어야 합니다. 특히 텔레그램이라면, 가장 의심해봐야 할 네 가지 핵심 영역은 프라이버시/멘션 설정, 토큰 401 오류, DNS/IPv6/프록시 문제, 그리고 polling 충돌 (409) 입니다.