Configuration
채널 문제 해결
채널은 연결되지만 동작이 잘못된 경우 이 페이지를 사용하세요.
명령 실행 순서
먼저 다음을 순서대로 실행하세요.
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
정상 기준선:
Runtime: runningConnectivity probe: okCapability: read-only,write-capable, 또는admin-capable- 채널 프로브가 전송 계층이 연결되었음을 표시하고, 지원되는 경우
works또는audit ok를 표시합니다.
WhatsApp 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 방법 |
|---|---|---|
| 연결되었지만 DM 답장이 없음 | openclaw pairing list whatsapp |
발신자를 승인하거나 DM 정책/허용 목록을 전환하세요. |
| 그룹 메시지가 무시됨 | 구성에서 requireMention + 멘션 패턴 확인 |
봇을 멘션하거나 해당 그룹의 멘션 정책을 완화하세요. |
| QR 로그인 시간이 408로 초과됨 | Gateway HTTPS_PROXY / HTTP_PROXY env 확인 |
도달 가능한 프록시를 설정하세요. NO_PROXY는 우회에만 사용하세요. |
| 무작위 연결 끊김/재로그인 루프 | openclaw channels status --probe + 로그 |
현재 연결되어 있어도 최근 재연결은 플래그로 표시됩니다. 로그를 확인하고 Gateway를 재시작한 다음, 흔들림이 계속되면 다시 연결하세요. |
| 답장이 몇 초/몇 분 늦게 도착함 | openclaw doctor --fix |
검증된 오래된 로컬 TUI 클라이언트가 Gateway 이벤트 루프를 저하시킬 때 Doctor가 이를 중지합니다. |
전체 문제 해결: WhatsApp 문제 해결
Telegram
Telegram 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 방법 |
|---|---|---|
/start 후 사용 가능한 답장 흐름이 없음 |
openclaw pairing list telegram |
페어링을 승인하거나 DM 정책을 변경하세요. |
| 봇이 온라인이지만 그룹이 계속 조용함 | 멘션 요구 사항과 봇 개인정보 보호 모드 확인 | 그룹 가시성을 위해 개인정보 보호 모드를 비활성화하거나 봇을 멘션하세요. |
| 네트워크 오류로 전송 실패 | Telegram API 호출 실패가 있는지 로그 검사 | api.telegram.org로 향하는 DNS/IPv6/프록시 라우팅을 수정하세요. |
시작 시 getMe returned 401 보고 |
구성된 토큰 소스 확인 | BotFather 토큰을 다시 복사하거나 재생성하고 botToken, tokenFile 또는 기본 계정 TELEGRAM_BOT_TOKEN을 업데이트하세요. |
| 폴링이 멈추거나 느리게 재연결됨 | 폴링 진단용 openclaw logs --follow |
업그레이드하세요. 재시작이 오탐이면 pollingStallThresholdMs를 조정하세요. 지속적인 멈춤은 여전히 프록시/DNS/IPv6 문제를 가리킵니다. |
시작 시 setMyCommands가 거부됨 |
로그에서 BOT_COMMANDS_TOO_MUCH 검사 |
Plugin/skill/사용자 지정 Telegram 명령을 줄이거나 네이티브 메뉴를 비활성화하세요. |
| 업그레이드 후 허용 목록이 사용자를 차단함 | openclaw security audit 및 구성 허용 목록 |
openclaw doctor --fix를 실행하거나 @username을 숫자 발신자 ID로 바꾸세요. |
전체 문제 해결: Telegram 문제 해결
Discord
Discord 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 방법 |
|---|---|---|
| 봇이 온라인이지만 길드 답장이 없음 | openclaw channels status --probe |
길드/채널을 허용하고 메시지 콘텐츠 intent를 확인하세요. |
| 그룹 메시지가 무시됨 | 멘션 게이팅 드롭이 있는지 로그 확인 | 봇을 멘션하거나 길드/채널 requireMention: false를 설정하세요. |
| 입력 중/토큰 사용량은 있지만 Discord 메시지가 없음 | 세션 로그에 didSendViaMessagingTool: false가 포함된 어시스턴트 텍스트 표시 |
모델이 메시지 도구를 호출하는 대신 비공개로 답했습니다. 도구 호출이 안정적인 모델을 사용하거나 messages.groupChat.visibleReplies: "automatic"을 설정해 자동 게시하세요. |
| DM 답장이 누락됨 | openclaw pairing list discord |
DM 페어링을 승인하거나 DM 정책을 조정하세요. |
전체 문제 해결: Discord 문제 해결
Slack
Slack 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 방법 |
|---|---|---|
| 소켓 모드는 연결되었지만 응답이 없음 | openclaw channels status --probe |
앱 토큰 + 봇 토큰 및 필요한 범위를 확인하세요. SecretRef 기반 설정에서는 botTokenStatus / appTokenStatus = configured_unavailable를 주시하세요. |
| DM이 차단됨 | openclaw pairing list slack |
페어링을 승인하거나 DM 정책을 완화하세요. |
| 채널 메시지가 무시됨 | groupPolicy 및 채널 허용 목록 확인 |
채널을 허용하거나 정책을 open으로 전환하세요. |
전체 문제 해결: Slack 문제 해결
iMessage 및 BlueBubbles
iMessage 및 BlueBubbles 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 방법 |
|---|---|---|
| 인바운드 이벤트가 없음 | Webhook/서버 도달 가능성과 앱 권한 확인 | Webhook URL 또는 BlueBubbles 서버 상태를 수정하세요. |
| macOS에서 보낼 수 있지만 받을 수 없음 | Messages 자동화를 위한 macOS 개인정보 보호 권한 확인 | TCC 권한을 다시 부여하고 채널 프로세스를 재시작하세요. |
| DM 발신자가 차단됨 | openclaw pairing list imessage 또는 openclaw pairing list bluebubbles |
페어링을 승인하거나 허용 목록을 업데이트하세요. |
전체 문제 해결:
Signal
Signal 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 방법 |
|---|---|---|
| 데몬에 도달할 수 있지만 봇이 조용함 | openclaw channels status --probe |
signal-cli 데몬 URL/계정 및 수신 모드를 확인하세요. |
| DM이 차단됨 | openclaw pairing list signal |
발신자를 승인하거나 DM 정책을 조정하세요. |
| 그룹 답장이 트리거되지 않음 | 그룹 허용 목록 및 멘션 패턴 확인 | 발신자/그룹을 추가하거나 게이팅을 완화하세요. |
전체 문제 해결: Signal 문제 해결
QQ Bot
QQ Bot 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 방법 |
|---|---|---|
| 봇이 "gone to Mars"라고 답함 | 구성에서 appId 및 clientSecret 확인 |
자격 증명을 설정하거나 Gateway를 재시작하세요. |
| 인바운드 메시지가 없음 | openclaw channels status --probe |
QQ Open Platform에서 자격 증명을 확인하세요. |
| 음성이 전사되지 않음 | STT 제공자 구성 확인 | channels.qqbot.stt 또는 tools.media.audio를 구성하세요. |
| 사전 메시지가 도착하지 않음 | QQ 플랫폼 상호작용 요구 사항 확인 | 최근 상호작용이 없으면 QQ가 봇이 시작한 메시지를 차단할 수 있습니다. |
전체 문제 해결: QQ Bot 문제 해결
Matrix
Matrix 장애 징후
| 증상 | 가장 빠른 확인 방법 | 수정 방법 |
|---|---|---|
| 로그인되었지만 방 메시지를 무시함 | openclaw channels status --probe |
groupPolicy, 방 허용 목록, 멘션 게이팅을 확인하세요. |
| DM이 처리되지 않음 | openclaw pairing list matrix |
발신자를 승인하거나 DM 정책을 조정하세요. |
| 암호화된 방이 실패함 | openclaw matrix verify status |
장치를 다시 검증한 다음 openclaw matrix verify backup status를 확인하세요. |
| 백업 복원이 대기 중이거나 손상됨 | openclaw matrix verify backup status |
openclaw matrix verify backup restore를 실행하거나 복구 키로 다시 실행하세요. |
| 교차 서명/부트스트랩이 잘못된 것처럼 보임 | openclaw matrix verify bootstrap |
비밀 저장소, 교차 서명, 백업 상태를 한 번에 복구하세요. |
전체 설정 및 구성: Matrix