채널 문제 해결

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

명령 순서

먼저 이 순서대로 실행하세요.

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

정상 기준:

Runtime: running
RPC probe: ok
Channel probe에 connected/ready 표시

WhatsApp failure signatures

Symptom	Fastest check	Fix
Connected but no DM replies	`openclaw pairing list whatsapp`	발신자를 승인하거나 DM policy/allowlist를 바꿉니다.
Group messages ignored	config의 `requireMention` + mention pattern 확인	bot을 mention하거나 해당 그룹의 mention policy를 완화합니다.
Random disconnect/relogin loops	`openclaw channels status --probe` + logs	다시 로그인하고 credentials directory 상태를 확인합니다.

Full troubleshooting: /channels/whatsapp#troubleshooting-quick

Telegram failure signatures

Symptom	Fastest check	Fix
`/start` but no usable reply flow	`openclaw pairing list telegram`	pairing을 승인하거나 DM policy를 변경합니다.
Bot online but group stays silent	mention requirement와 bot privacy mode 확인	group visibility를 위해 privacy mode를 끄거나 bot을 mention합니다.
Send failures with network errors	Telegram API call failure logs 확인	`api.telegram.org`로의 DNS/IPv6/proxy routing을 수정합니다.
Upgraded and allowlist blocks you	`openclaw security audit`와 config allowlist 확인	`openclaw doctor --fix`를 실행하거나 `@username`을 numeric sender ID로 교체합니다.

Full troubleshooting: /channels/telegram#troubleshooting

Discord

Discord failure signatures

Symptom	Fastest check	Fix
Bot online but no guild replies	`openclaw channels status --probe`	guild/channel을 허용하고 message content intent를 확인합니다.
Group messages ignored	logs에서 mention gating drop 확인	bot을 mention하거나 guild/channel에 `requireMention: false`를 설정합니다.
DM replies missing	`openclaw pairing list discord`	DM pairing을 승인하거나 DM policy를 조정합니다.

Full troubleshooting: /channels/discord#troubleshooting

Slack

Slack failure signatures

Symptom	Fastest check	Fix
Socket mode connected but no responses	`openclaw channels status --probe`	app token + bot token과 필요한 scope를 확인합니다.
DMs blocked	`openclaw pairing list slack`	pairing을 승인하거나 DM policy를 완화합니다.
Channel message ignored	`groupPolicy`와 channel allowlist 확인	channel을 허용하거나 policy를 `open`으로 바꿉니다.

Full troubleshooting: /channels/slack#troubleshooting

iMessage and BlueBubbles

iMessage and BlueBubbles failure signatures

Symptom	Fastest check	Fix
No inbound events	webhook/server reachability와 app permission 확인	webhook URL 또는 BlueBubbles server 상태를 수정합니다.
Can send but no receive on macOS	Messages automation용 macOS privacy permission 확인	TCC 권한을 다시 부여하고 channel process를 재시작합니다.
DM sender blocked	`openclaw pairing list imessage` 또는 `openclaw pairing list bluebubbles`	pairing을 승인하거나 allowlist를 갱신합니다.

Full troubleshooting:

Signal

Signal failure signatures

Symptom	Fastest check	Fix
Daemon reachable but bot silent	`openclaw channels status --probe`	`signal-cli` daemon URL/account와 receive mode를 확인합니다.
DM blocked	`openclaw pairing list signal`	발신자를 승인하거나 DM policy를 조정합니다.
Group replies do not trigger	group allowlist와 mention pattern 확인	sender/group을 추가하거나 gating을 완화합니다.

Full troubleshooting: /channels/signal#troubleshooting

Matrix

Matrix failure signatures

Symptom	Fastest check	Fix
Logged in but ignores room messages	`openclaw channels status --probe`	`groupPolicy`와 room allowlist를 확인합니다.
DMs do not process	`openclaw pairing list matrix`	발신자를 승인하거나 DM policy를 조정합니다.
Encrypted rooms fail	crypto module과 encryption setting 확인	encryption 지원을 활성화하고 room을 다시 join/sync합니다.

Full troubleshooting: /channels/matrix#troubleshooting

개요

메시징 플랫폼

설정

Channel Troubleshooting

채널 문제 해결

명령 순서

WhatsApp

WhatsApp failure signatures

Telegram

Telegram failure signatures

Discord

Discord failure signatures

Slack

Slack failure signatures

iMessage and BlueBubbles

iMessage and BlueBubbles failure signatures

Signal

Signal failure signatures

Matrix

Matrix failure signatures

​채널 문제 해결

​명령 순서

​WhatsApp

​WhatsApp failure signatures

​Telegram

​Telegram failure signatures

​Discord

​Discord failure signatures

​Slack

​Slack failure signatures

​iMessage and BlueBubbles

​iMessage and BlueBubbles failure signatures

​Signal

​Signal failure signatures

​Matrix

​Matrix failure signatures

채널 문제 해결

명령 순서

WhatsApp

WhatsApp failure signatures

Telegram

Telegram failure signatures

Discord

Discord failure signatures

Slack

Slack failure signatures

iMessage and BlueBubbles

iMessage and BlueBubbles failure signatures

Signal

Signal failure signatures

Matrix

Matrix failure signatures