채널 문제 해결

채널이 연결되었지만 동작이 올바르지 않을 때 이 페이지를 사용하세요.

명령 순서

먼저 다음을 순서대로 실행하세요:

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

정상 기준:

  • Runtime: running
  • RPC probe: ok
  • 채널 프로브에 connected/ready 표시

WhatsApp

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 discordDM 페어링을 승인하거나 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페어링을 승인하거나 허용 목록을 업데이트하세요.

전체 문제 해결:

Signal

Signal 장애 징후

증상가장 빠른 확인 방법수정
데몬 접근 가능하지만 봇 침묵openclaw channels status --probesignal-cli 데몬 URL/계정과 수신 모드를 확인하세요.
DM 차단됨openclaw pairing list signal발신자를 승인하거나 DM 정책을 조정하세요.
그룹 응답이 트리거되지 않음그룹 허용 목록과 멘션 패턴 확인발신자/그룹을 추가하거나 게이팅을 완화하세요.

전체 문제 해결: /channels/signal#troubleshooting

Matrix

Matrix 장애 징후

증상가장 빠른 확인 방법수정
로그인했지만 룸 메시지 무시openclaw channels status --probegroupPolicy와 룸 허용 목록을 확인하세요.
DM이 처리되지 않음openclaw pairing list matrix발신자를 승인하거나 DM 정책을 조정하세요.
암호화된 룸 실패암호화 모듈과 암호화 설정 확인암호화 지원을 활성화하고 룸에 다시 참여/동기화.

전체 문제 해결: /channels/matrix#troubleshooting