채널 문제 해결
채널이 연결되었지만 동작이 올바르지 않을 때 이 페이지를 사용하세요.
명령 순서
먼저 다음을 순서대로 실행하세요:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
정상 기준:
Runtime: runningRPC probe: ok- 채널 프로브에 connected/ready 표시
WhatsApp 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 |
|---|---|---|
| 연결되었지만 DM 응답 없음 | openclaw pairing list whatsapp | 발신자를 승인하거나 DM 정책/허용 목록을 변경하세요. |
| 그룹 메시지 무시됨 | 설정에서 requireMention + 멘션 패턴 확인 | 봇을 멘션하거나 해당 그룹의 멘션 정책을 완화하세요. |
| 무작위 연결 끊김/재로그인 반복 | openclaw channels status --probe + 로그 | 재로그인하고 자격 증명 디렉토리 상태를 확인하세요. |
전체 문제 해결: /channels/whatsapp#troubleshooting-quick
Telegram
Telegram 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 |
|---|---|---|
/start했지만 응답 흐름 없음 | openclaw pairing list telegram | 페어링을 승인하거나 DM 정책을 변경하세요. |
| 봇이 온라인이지만 그룹 침묵 | 멘션 요구 사항과 봇 프라이버시 모드 확인 | 그룹 가시성을 위해 프라이버시 모드 비활성화 또는 봇 멘션. |
| 네트워크 오류로 전송 실패 | 로그에서 Telegram API 호출 실패 확인 | api.telegram.org로의 DNS/IPv6/프록시 라우팅 수정. |
시작 시 setMyCommands 거부됨 | 로그에서 BOT_COMMANDS_TOO_MUCH 확인 | 플러그인/스킬/커스텀 Telegram 명령을 줄이거나 네이티브 메뉴 비활성화. |
| 업그레이드 후 허용 목록이 차단 | openclaw security audit와 설정 허용 목록 | openclaw doctor --fix 실행 또는 @username을 숫자 발신자 ID로 교체. |
전체 문제 해결: /channels/telegram#troubleshooting
Discord
Discord 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 |
|---|---|---|
| 봇이 온라인이지만 길드 응답 없음 | openclaw channels status --probe | 길드/채널을 허용하고 메시지 컨텐츠 인텐트를 확인하세요. |
| 그룹 메시지 무시됨 | 로그에서 멘션 게이팅 차단 확인 | 봇을 멘션하거나 길드/채널에 requireMention: false 설정. |
| DM 응답 누락 | openclaw pairing list discord | DM 페어링을 승인하거나 DM 정책을 조정하세요. |
전체 문제 해결: /channels/discord#troubleshooting
Slack
Slack 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 |
|---|---|---|
| 소켓 모드 연결되었지만 응답 없음 | openclaw channels status --probe | 앱 토큰 + 봇 토큰과 필요한 스코프를 확인하세요. |
| DM 차단됨 | openclaw pairing list slack | 페어링을 승인하거나 DM 정책을 완화하세요. |
| 채널 메시지 무시됨 | groupPolicy와 채널 허용 목록 확인 | 채널을 허용하거나 정책을 open으로 변경하세요. |
전체 문제 해결: /channels/slack#troubleshooting
iMessage와 BlueBubbles
iMessage와 BlueBubbles 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 |
|---|---|---|
| 인바운드 이벤트 없음 | 웹훅/서버 접근성과 앱 권한 확인 | 웹훅 URL 또는 BlueBubbles 서버 상태를 수정하세요. |
| 보내기는 가능하지만 macOS에서 수신 불가 | Messages 자동화를 위한 macOS 개인정보 권한 확인 | TCC 권한을 다시 부여하고 채널 프로세스를 재시작하세요. |
| DM 발신자 차단됨 | openclaw pairing list imessage 또는 openclaw pairing list bluebubbles | 페어링을 승인하거나 허용 목록을 업데이트하세요. |
전체 문제 해결:
- /channels/imessage#troubleshooting-macos-privacy-and-security-tcc
- /channels/bluebubbles#troubleshooting
Signal
Signal 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 |
|---|---|---|
| 데몬 접근 가능하지만 봇 침묵 | openclaw channels status --probe | signal-cli 데몬 URL/계정과 수신 모드를 확인하세요. |
| DM 차단됨 | openclaw pairing list signal | 발신자를 승인하거나 DM 정책을 조정하세요. |
| 그룹 응답이 트리거되지 않음 | 그룹 허용 목록과 멘션 패턴 확인 | 발신자/그룹을 추가하거나 게이팅을 완화하세요. |
전체 문제 해결: /channels/signal#troubleshooting
Matrix
Matrix 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 |
|---|---|---|
| 로그인했지만 룸 메시지 무시 | openclaw channels status --probe | groupPolicy와 룸 허용 목록을 확인하세요. |
| DM이 처리되지 않음 | openclaw pairing list matrix | 발신자를 승인하거나 DM 정책을 조정하세요. |
| 암호화된 룸 실패 | 암호화 모듈과 암호화 설정 확인 | 암호화 지원을 활성화하고 룸에 다시 참여/동기화. |
전체 문제 해결: /channels/matrix#troubleshooting