메인 콘텐츠로 건너뛰기

채널 문제 해결

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

명령 순서

먼저 이 순서대로 실행하세요.
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
정상 기준:
  • Runtime: running
  • RPC probe: ok
  • Channel probe에 connected/ready 표시

WhatsApp

WhatsApp failure signatures

SymptomFastest checkFix
Connected but no DM repliesopenclaw pairing list whatsapp발신자를 승인하거나 DM policy/allowlist를 바꿉니다.
Group messages ignoredconfig의 requireMention + mention pattern 확인bot을 mention하거나 해당 그룹의 mention policy를 완화합니다.
Random disconnect/relogin loopsopenclaw channels status --probe + logs다시 로그인하고 credentials directory 상태를 확인합니다.
Full troubleshooting: /channels/whatsapp#troubleshooting-quick

Telegram

Telegram failure signatures

SymptomFastest checkFix
/start but no usable reply flowopenclaw pairing list telegrampairing을 승인하거나 DM policy를 변경합니다.
Bot online but group stays silentmention requirement와 bot privacy mode 확인group visibility를 위해 privacy mode를 끄거나 bot을 mention합니다.
Send failures with network errorsTelegram API call failure logs 확인api.telegram.org로의 DNS/IPv6/proxy routing을 수정합니다.
Upgraded and allowlist blocks youopenclaw security audit와 config allowlist 확인openclaw doctor --fix를 실행하거나 @username을 numeric sender ID로 교체합니다.
Full troubleshooting: /channels/telegram#troubleshooting

Discord

Discord failure signatures

SymptomFastest checkFix
Bot online but no guild repliesopenclaw channels status --probeguild/channel을 허용하고 message content intent를 확인합니다.
Group messages ignoredlogs에서 mention gating drop 확인bot을 mention하거나 guild/channel에 requireMention: false를 설정합니다.
DM replies missingopenclaw pairing list discordDM pairing을 승인하거나 DM policy를 조정합니다.
Full troubleshooting: /channels/discord#troubleshooting

Slack

Slack failure signatures

SymptomFastest checkFix
Socket mode connected but no responsesopenclaw channels status --probeapp token + bot token과 필요한 scope를 확인합니다.
DMs blockedopenclaw pairing list slackpairing을 승인하거나 DM policy를 완화합니다.
Channel message ignoredgroupPolicy와 channel allowlist 확인channel을 허용하거나 policy를 open으로 바꿉니다.
Full troubleshooting: /channels/slack#troubleshooting

iMessage and BlueBubbles

iMessage and BlueBubbles failure signatures

SymptomFastest checkFix
No inbound eventswebhook/server reachability와 app permission 확인webhook URL 또는 BlueBubbles server 상태를 수정합니다.
Can send but no receive on macOSMessages automation용 macOS privacy permission 확인TCC 권한을 다시 부여하고 channel process를 재시작합니다.
DM sender blockedopenclaw pairing list imessage 또는 openclaw pairing list bluebubblespairing을 승인하거나 allowlist를 갱신합니다.
Full troubleshooting:

Signal

Signal failure signatures

SymptomFastest checkFix
Daemon reachable but bot silentopenclaw channels status --probesignal-cli daemon URL/account와 receive mode를 확인합니다.
DM blockedopenclaw pairing list signal발신자를 승인하거나 DM policy를 조정합니다.
Group replies do not triggergroup allowlist와 mention pattern 확인sender/group을 추가하거나 gating을 완화합니다.
Full troubleshooting: /channels/signal#troubleshooting

Matrix

Matrix failure signatures

SymptomFastest checkFix
Logged in but ignores room messagesopenclaw channels status --probegroupPolicy와 room allowlist를 확인합니다.
DMs do not processopenclaw pairing list matrix발신자를 승인하거나 DM policy를 조정합니다.
Encrypted rooms failcrypto module과 encryption setting 확인encryption 지원을 활성화하고 room을 다시 join/sync합니다.
Full troubleshooting: /channels/matrix#troubleshooting