OpenClaw 채널 문제 해결: 5분 만에 오류 진단 및 복구

채널 연결은 정상인데 메시지가 오지 않거나 봇이 반응하지 않아 당황스러웠던 적 있으신가요? 개발자라면 누구나 한 번쯤 겪는 흔한 문제지만, 어디서부터 손을 대야 할지 막막할 때가 많습니다.

OpenClaw 채널 문제 해결 가이드를 통해 연결 상태를 진단하고 일반적인 오류를 빠르게 수정해 보세요. 이 가이드는 OpenClaw의 다양한 채널 연결 문제를 해결하는 데 필요한 핵심 진단 절차를 담고 있습니다.

명령 단계별 확인 (Command ladder)

가장 먼저 시스템의 전반적인 상태를 확인하기 위해 아래 명령어를 순서대로 실행해 보세요.

1. openclaw status
2. openclaw gateway status
3. openclaw logs —follow
4. openclaw doctor
5. openclaw channels status —probe

정상적인 상태라면 다음 항목들이 확인되어야 합니다:

• Runtime: running
• Connectivity probe: ok
• Capability: read-only, write-capable, 또는 admin-capable
• 채널 프로브 결과 전송 연결이 확인되며, 지원되는 경우 works 또는 audit ok가 표시됩니다.

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

WhatsApp 문제 해결

WhatsApp 채널에서 발생하는 일반적인 오류와 해결 방법입니다.

1. DM 응답이 없는 경우 openclaw pairing list whatsapp 명령어로 페어링 상태를 확인하고 발신자를 승인하거나 DM 정책을 변경하세요.
2. 그룹 메시지가 무시된다면 설정의 requireMention 및 멘션 패턴을 확인하고 봇을 멘션하거나 정책을 완화하세요.
3. 연결이 끊기거나 재로그인이 반복되면 openclaw channels status —probe와 로그를 확인한 뒤, 재로그인 후 자격 증명 디렉토리가 정상인지 확인하세요.

자세한 내용은 /channels/whatsapp#troubleshooting에서 확인 가능합니다.

Telegram 문제 해결

Telegram 채널에서 발생하는 일반적인 오류와 해결 방법입니다.

1. /start 후 응답 흐름이 없다면 openclaw pairing list telegram으로 페어링을 승인하거나 DM 정책을 변경하세요.
2. 봇은 온라인인데 그룹이 조용하다면 봇 개인정보 보호 모드를 비활성화하거나 봇을 멘션하세요.
3. 네트워크 오류로 전송 실패 시 로그에서 API 호출 실패 여부를 확인하고 api.telegram.org로의 DNS/IPv6/프록시 경로를 수정하세요.
4. 폴링이 멈추거나 느리게 재연결되면 openclaw logs —follow로 진단하고, 프록시/DNS/IPv6 설정을 점검하세요.
5. 시작 시 setMyCommands가 거부되면 로그에서 BOT_COMMANDS_TOO_MUCH를 확인하고 플러그인/스킬 명령어를 줄이세요.
6. 업그레이드 후 허용 목록이 차단한다면 openclaw security audit을 실행하거나 @username을 숫자 ID로 교체하세요.

자세한 내용은 /channels/telegram#troubleshooting에서 확인 가능합니다.

Discord 문제 해결

Discord 채널에서 발생하는 일반적인 오류와 해결 방법입니다.

1. 봇은 온라인인데 길드 응답이 없다면 openclaw channels status —probe를 실행하고 길드/채널 허용 여부와 메시지 콘텐츠 의도를 확인하세요.
2. 그룹 메시지가 무시된다면 로그에서 멘션 차단 여부를 확인하고 봇을 멘션하거나 requireMention: false로 설정하세요.
3. DM 응답이 누락되면 openclaw pairing list discord로 페어링을 승인하거나 DM 정책을 조정하세요.

자세한 내용은 /channels/discord#troubleshooting에서 확인 가능합니다.

Slack 문제 해결

Slack 채널에서 발생하는 일반적인 오류와 해결 방법입니다.

1. Socket 모드는 연결되었으나 응답이 없다면 openclaw channels status —probe를 실행하고, 앱 토큰과 봇 토큰 및 필수 스코프를 확인하세요.
2. DM이 차단되었다면 openclaw pairing list slack으로 페어링을 승인하거나 DM 정책을 완화하세요.
3. 채널 메시지가 무시된다면 groupPolicy와 채널 허용 목록을 확인하고 정책을 open으로 변경하세요.

자세한 내용은 /channels/slack#troubleshooting에서 확인 가능합니다.

iMessage 및 BlueBubbles 문제 해결

iMessage와 BlueBubbles 채널에서 발생하는 일반적인 오류와 해결 방법입니다.

1. 인바운드 이벤트가 없다면 webhook 또는 서버 연결 가능 여부와 앱 권한을 확인하고 webhook URL을 수정하세요.
2. macOS에서 전송은 되지만 수신이 안 된다면 메시지 자동화에 대한 macOS 개인정보 보호 권한을 확인하고 권한을 재부여하세요.
3. DM 발신자가 차단되었다면 openclaw pairing list imessage 또는 openclaw pairing list bluebubbles를 통해 승인하세요.

자세한 내용은 /channels/imessage#troubleshooting 및 /channels/bluebubbles#troubleshooting에서 확인 가능합니다.

Signal 문제 해결

Signal 채널에서 발생하는 일반적인 오류와 해결 방법입니다.

1. 데몬은 연결되었으나 봇이 조용하다면 openclaw channels status —probe를 실행하고 signal-cli 데몬 URL 및 수신 모드를 확인하세요.
2. DM이 차단되었다면 openclaw pairing list signal을 통해 발신자를 승인하세요.
3. 그룹 응답이 트리거되지 않는다면 그룹 허용 목록과 멘션 패턴을 확인하고 설정을 조정하세요.

자세한 내용은 /channels/signal#troubleshooting에서 확인 가능합니다.

QQ Bot 문제 해결

QQ Bot 채널에서 발생하는 일반적인 오류와 해결 방법입니다.

1. 봇이 “gone to Mars”라고 응답하면 설정의 appId와 clientSecret을 확인하고 Gateway를 재시작하세요.
2. 인바운드 메시지가 없다면 openclaw channels status —probe를 실행하고 QQ 오픈 플랫폼의 자격 증명을 확인하세요.
3. 음성 변환이 안 된다면 STT 제공자 설정을 확인하세요.
4. 능동적인 메시지가 도착하지 않는다면 QQ 플랫폼의 상호작용 요구 사항을 확인하세요.

자세한 내용은 /channels/qqbot#troubleshooting에서 확인 가능합니다.

Matrix 문제 해결

Matrix 채널에서 발생하는 일반적인 오류와 해결 방법입니다.

1. 로그인은 되었으나 방 메시지를 무시한다면 openclaw channels status —probe를 실행하고 groupPolicy와 허용 목록을 확인하세요.
2. DM이 처리되지 않는다면 openclaw pairing list matrix로 승인하세요.
3. 암호화된 방에서 오류가 발생하면 openclaw matrix verify status를 실행하고 장치를 재인증하세요.
4. 백업 복원이 안 된다면 openclaw matrix verify backup status를 확인하고 복구 키를 사용하세요.
5. 교차 서명/부트스트랩 문제가 있다면 openclaw matrix verify bootstrap을 실행하세요.

전체 설정 및 구성은 Matrix를 참조하세요.

---

다음 단계

• 채널 설정 가이드
• OpenClaw CLI 명령어 참조

문제가 해결되지 않나요? AI Setup Assistant를 통해 도움을 받아보세요.