🦞 18. 텔레그램 안될 때 5분 복구

텔레그램이 갑자기 조용해졌을 때, 초보자가 바로 할 수 있는 것만 남긴 5분 복구 체크리스트입니다. 이 문서는 설명보다 실행을 우선합니다.

안내: 본문은 생성형 AI를 활용해 정리했으며, 토큰·IP·개인식별자는 공개하지 않습니다.

flowchart TD
A[메시지 안 옴] --> B[1. 상태 확인]
B --> C[2. 채널 프로브]
C --> D{로그 에러 유형}
D -->|fetch/sendMessage failed| E[네트워크 경로 점검]
D -->|409 Conflict| F[중복 실행 정리]
D -->|setMyCommands failed| G[API 접근 재시도]
E --> H[복구 테스트 1회]
F --> H
G --> H

0) 증상 확인 (10초)

• 텔레그램에서 봇에게 테스트 보냈는데 답이 없음

1) 바로 실행 (1분)

openclaw status
openclaw gateway status
openclaw channels status --probe

정상 기준:

• Runtime: running
• RPC probe: ok
• Telegram: OK

2) 안 되면 로그 확인 (1분)

openclaw logs --follow

로그에서 아래 문구를 찾으세요.

• sendMessage failed / fetch failed

  • 의미: Telegram API 통신 경로 문제
  • 조치: 게이트웨이 재시작 후 재확인

• getUpdates ... 409 Conflict

  • 의미: 같은 토큰을 다른 프로세스가 동시에 사용
  • 조치: 중복 실행 프로세스 정리

• setMyCommands failed

  • 의미: API 접근 초기 동기화 실패
  • 조치: 네트워크 상태 점검 후 다시 시도

3) 복구 액션 (2분)

# 1) 게이트웨이 재시작
openclaw gateway restart
 
# 2) 재진단
openclaw status --deep
openclaw channels status --probe

필요 시(중복 실행 의심):

• OpenClaw를 한 경로(서비스/로컬)로만 운영
• 동시에 두 인스턴스를 띄우지 않기

4) 복구 확인 (1분)

• 텔레그램에서 테스트123 전송
• 봇 즉시 응답 확인
• 1~2회 추가 송수신으로 안정성 확인

재발 방지 3원칙

• 점검 순서 고정: status → channels --probe → logs
• 게이트웨이 단일 실행 유지
• 장애 로그 공유 시 민감정보 마스킹

관련 문서

• OpenClaw 공식 Troubleshooting
• OpenClaw 16: Gmail 트러블슈팅 7가지
• OpenClaw 17: Subagents 실패패턴 5가지