메인 콘텐츠로 건너뛰기

​
채널 문제 해결

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

​
명령어 순서

다음을 순서대로 실행하세요: 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
건강한 기준선:
  • Runtime: running
  • RPC probe: ok
  • 채널 프로브가 연결/준비 상태 표시

​
WhatsApp

​
WhatsApp 오류 서명

증상가장 빠른 확인 방법수정 방법
연결되었으나 다이렉트 메시지 응답 없음openclaw pairing list whatsapp보낸 사람 승인 또는 다이렉트 메시지 정책/허용 목록 전환.
그룹 메시지 무시됨스킬 설정에서 requireMention + 멘션 패턴 확인봇을 멘션하거나 해당 그룹의 멘션 정책 완화.
무작위 연결 해제/재로그인 루프openclaw channels status --probe + 로그다시 로그인하고 자격 증명 디렉터리가 건강한지 확인.
전체 문제 해결: /channels/whatsapp#troubleshooting-quick

​
Telegram

​
Telegram 오류 서명

증상가장 빠른 확인 방법수정 방법
/start하지만 유용한 응답 흐름 없음openclaw pairing list telegram페어링 승인 또는 다이렉트 메시지 정책 변경.
봇 온라인이지만 그룹이 조용함멘션 요구 사항 및 봇 프라이버시 모드 확인그룹 가시성을 위해 프라이버시 모드 비활성화 또는 봇 멘션.
네트워크 오류로 전송 실패Telegram API 호출 실패 로그 검토api.telegram.org에 대한 DNS/IPv6/프록시 라우팅 수정.
업그레이드 후 허용 목록이 차단됨openclaw security audit 및 구성 허용 목록openclaw doctor --fix 실행 또는 @username을 숫자 발신자 ID로 교체.
전체 문제 해결: /channels/telegram#troubleshooting

​
Discord

​
Discord 오류 서명

증상가장 빠른 확인 방법수정 방법
봇 온라인이지만 길드 응답 없음openclaw channels status --probe길드/채널 허용 및 메시지 콘텐츠 의도 확인.
그룹 메시지 무시됨로그에서 멘션 게이팅 드롭 확인봇 멘션 또는 길드/채널 requireMention: false 설정.
다이렉트 메시지 응답 없음openclaw pairing list discord다이렉트 메시지 페어링 승인 또는 다이렉트 메시지 정책 조정.
전체 문제 해결: /channels/discord#troubleshooting

​
Slack

​
Slack 오류 서명

증상가장 빠른 확인 방법수정 방법
소켓 모드가 연결되었지만 응답 없음openclaw channels status --probe앱 토큰 + 봇 토큰 및 필수 범위 확인.
다이렉트 메시지 차단됨openclaw pairing list slack페어링 승인 또는 다이렉트 메시지 정책 완화.
채널 메시지 무시됨groupPolicy 및 채널 허용 목록 확인채널 허용 또는 정책을 open으로 전환.
전체 문제 해결: /channels/slack#troubleshooting

​
iMessage 및 BlueBubbles

​
iMessage 및 BlueBubbles 오류 서명

증상가장 빠른 확인 방법수정 방법
인바운드 이벤트 없음웹훅/서버 도달 가능성 및 앱 권한 확인웹훅 URL 또는 BlueBubbles 서버 상태 수정.
macOS에서 보낼 수 있지만 수신 없음Messages 자동화를 위한 macOS 프라이버시 권한 확인TCC 권한을 다시 부여하고 채널 프로세스 재시작.
다이렉트 메시지 발신자 차단됨openclaw pairing list imessage 또는 openclaw pairing list bluebubbles페어링 승인 또는 허용 목록 업데이트.
전체 문제 해결:

​
Signal

​
Signal 오류 서명

증상가장 빠른 확인 방법수정 방법
데몬 접근 가능하지만 봇이 조용한 경우openclaw channels status --probesignal-cli 데몬 URL/계정 및 수신 모드 확인.
다이렉트 메시지 차단됨openclaw pairing list signal발신자 승인 또는 다이렉트 메시지 정책 조정.
그룹 응답이 트리거되지 않음그룹 허용 목록 및 멘션 패턴 확인발신자/그룹 추가 또는 게이팅 완화.
전체 문제 해결: /channels/signal#troubleshooting

​
Matrix

​
Matrix 오류 서명

증상가장 빠른 확인 방법수정 방법
로그인 되었으나 룸 메시지 무시됨openclaw channels status --probegroupPolicy 및 룸 허용 목록 확인.
다이렉트 메시지 처리되지 않음openclaw pairing list matrix발신자 승인 또는 다이렉트 메시지 정책 조정.
암호화된 룸 실패암호화 모듈 및 설정 확인암호화 지원 활성화 및 재가입/동기화 룸.
전체 문제 해결: /channels/matrix#troubleshooting