메인 콘텐츠로 건너뛰기

​
채널 문제 해결

채널은 연결되지만 동작이 잘못될 때 이 페이지를 사용하세요.

​
명령 단계

먼저 다음 명령을 순서대로 실행하세요. 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
정상 기준선:
  • Runtime: running
  • RPC probe: ok
  • 채널 프로브에 전송 연결 상태가 표시되고, 지원되는 경우 works 또는 audit ok가 표시됨

​
WhatsApp

​
WhatsApp 실패 시그니처

증상가장 빠른 확인 방법해결 방법
연결되었지만 DM 응답이 없음openclaw pairing list whatsapp발신자를 승인하거나 DM 정책/allowlist를 변경하세요.
그룹 메시지가 무시됨config에서 requireMention + mention 패턴 확인봇을 mention하거나 해당 그룹의 mention 정책을 완화하세요.
무작위 연결 해제/재로그인 루프openclaw channels status --probe + 로그다시 로그인하고 자격 증명 디렉터리가 정상인지 확인하세요.
전체 문제 해결: /channels/whatsapp#troubleshooting

​
Telegram

​
Telegram 실패 시그니처

증상가장 빠른 확인 방법해결 방법
/start는 되지만 정상적인 응답 흐름이 없음openclaw pairing list telegram페어링을 승인하거나 DM 정책을 변경하세요.
봇은 온라인인데 그룹이 조용함mention 요구 사항과 봇 privacy mode 확인그룹 가시성을 위해 privacy mode를 비활성화하거나 봇을 mention하세요.
네트워크 오류와 함께 전송 실패Telegram API 호출 실패 로그 확인api.telegram.org로의 DNS/IPv6/프록시 라우팅을 수정하세요.
시작 시 setMyCommands가 거부됨BOT_COMMANDS_TOO_MUCH 로그 확인plugin/skill/custom Telegram 명령을 줄이거나 네이티브 메뉴를 비활성화하세요.
업그레이드 후 allowlist가 나를 차단함openclaw security audit 및 config allowlistopenclaw doctor --fix를 실행하거나 @username을 숫자 발신자 ID로 바꾸세요.
전체 문제 해결: /channels/telegram#troubleshooting

​
Discord

​
Discord 실패 시그니처

증상가장 빠른 확인 방법해결 방법
봇은 온라인인데 길드 응답이 없음openclaw channels status --probe길드/채널을 허용하고 message content intent를 확인하세요.
그룹 메시지가 무시됨로그에서 mention 게이팅 드롭 확인봇을 mention하거나 길드/채널 requireMention: false를 설정하세요.
DM 응답이 누락됨openclaw pairing list discordDM 페어링을 승인하거나 DM 정책을 조정하세요.
전체 문제 해결: /channels/discord#troubleshooting

​
Slack

​
Slack 실패 시그니처

증상가장 빠른 확인 방법해결 방법
Socket mode는 연결되었지만 응답이 없음openclaw channels status --probe앱 토큰 + 봇 토큰과 필요한 scope를 확인하세요. SecretRef 기반 설정에서는 botTokenStatus / appTokenStatus = configured_unavailable를 주의 깊게 보세요.
DM이 차단됨openclaw pairing list slack페어링을 승인하거나 DM 정책을 완화하세요.
채널 메시지가 무시됨groupPolicy 및 채널 allowlist 확인채널을 허용하거나 정책을 open으로 변경하세요.
전체 문제 해결: /channels/slack#troubleshooting

​
iMessage 및 BlueBubbles

​
iMessage 및 BlueBubbles 실패 시그니처

증상가장 빠른 확인 방법해결 방법
수신 이벤트가 없음webhook/server 도달 가능성 및 앱 권한 확인webhook URL 또는 BlueBubbles 서버 상태를 수정하세요.
보낼 수는 있지만 macOS에서 수신이 안 됨Messages 자동화에 대한 macOS 개인정보 보호 권한 확인TCC 권한을 다시 부여하고 채널 프로세스를 재시작하세요.
DM 발신자가 차단됨openclaw pairing list imessage 또는 openclaw pairing list bluebubbles페어링을 승인하거나 allowlist를 업데이트하세요.
전체 문제 해결:

​
Signal

​
Signal 실패 시그니처

증상가장 빠른 확인 방법해결 방법
데몬에 도달 가능하지만 봇이 조용함openclaw channels status --probesignal-cli 데몬 URL/계정 및 수신 모드를 확인하세요.
DM이 차단됨openclaw pairing list signal발신자를 승인하거나 DM 정책을 조정하세요.
그룹 응답이 트리거되지 않음그룹 allowlist 및 mention 패턴 확인발신자/그룹을 추가하거나 게이팅을 완화하세요.
전체 문제 해결: /channels/signal#troubleshooting

​
QQ Bot

​
QQ Bot 실패 시그니처

증상가장 빠른 확인 방법해결 방법
봇이 “gone to Mars”라고 응답함config에서 appId 및 clientSecret 확인자격 증명을 설정하거나 gateway를 재시작하세요.
수신 메시지가 없음openclaw channels status --probeQQ Open Platform에서 자격 증명을 확인하세요.
음성이 전사되지 않음STT provider config 확인channels.qqbot.stt 또는 tools.media.audio를 구성하세요.
능동적 메시지가 도착하지 않음QQ 플랫폼 상호작용 요구 사항 확인QQ는 최근 상호작용이 없으면 봇이 시작한 메시지를 차단할 수 있습니다.
전체 문제 해결: /channels/qqbot#troubleshooting

​
Matrix

​
Matrix 실패 시그니처

증상가장 빠른 확인 방법해결 방법
로그인했지만 룸 메시지를 무시함openclaw channels status --probegroupPolicy, 룸 allowlist, mention 게이팅을 확인하세요.
DM이 처리되지 않음openclaw pairing list matrix발신자를 승인하거나 DM 정책을 조정하세요.
암호화된 룸에서 실패함openclaw matrix verify status기기를 다시 확인한 뒤 openclaw matrix verify backup status를 확인하세요.
백업 복원이 대기 중이거나 손상됨openclaw matrix verify backup statusopenclaw matrix verify backup restore를 실행하거나 복구 키로 다시 실행하세요.
교차 서명/bootstrap 상태가 잘못됨openclaw matrix verify bootstrap비밀 저장소, 교차 서명, 백업 상태를 한 번에 복구하세요.
전체 설정 및 구성: Matrix