Configuration

채널 문제 해결

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

명령 실행 순서

먼저 다음 명령을 순서대로 실행하세요.

bash

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

정상 기준:

Runtime: running
Connectivity probe: ok
Capability: read-only, write-capable 또는 admin-capable
채널 프로브에 전송 계층이 연결된 것으로 표시되며, 지원되는 경우 works 또는 audit ok가 표시됨

업데이트 후

업데이트 후 Telegram, iMessage, BlueBubbles 시절의 구성 또는 다른 Plugin 채널이 사라지는 경우 다음 명령을 사용하세요.

bash

openclaw status --allopenclaw doctor --fixopenclaw gateway restartopenclaw status --all

openclaw status --all에서 plugin load failed: dependency tree corrupted; run openclaw doctor --fix를 찾으세요. 이는 채널이 구성되어 있지만 Plugin 설정 또는 로드 과정에서 채널을 등록하는 대신 손상된 종속성 트리가 감지되었다는 의미입니다. openclaw doctor --fix는 오래된 Plugin 런타임 종속성 심볼릭 링크와 오래된 인증 섀도를 제거하고, 이후 openclaw gateway restart가 깨끗한 상태를 다시 로드합니다.

WhatsApp 장애 징후

증상	가장 빠른 확인 방법	해결 방법
연결되었지만 DM 답장이 없음	`openclaw pairing list whatsapp`	발신자를 승인하거나 DM 정책/허용 목록을 변경하세요.
그룹 메시지가 무시됨	구성에서 `requireMention`과 멘션 패턴 확인	봇을 멘션하거나 해당 그룹의 멘션 정책을 완화하세요.
QR 로그인 시간이 초과되며 408 발생	Gateway의 `HTTPS_PROXY` / `HTTP_PROXY` 환경 변수 확인	연결 가능한 프록시를 설정하세요. 우회할 때만 `NO_PROXY`를 사용하세요.
무작위 연결 끊김/재로그인 반복	`openclaw channels status --probe`와 로그	현재 연결된 상태여도 최근 재연결은 표시됩니다. 로그를 확인하고 Gateway를 재시작한 후, 불안정한 상태가 계속되면 다시 연결하세요.
`status=408 Request Time-out` 반복	프로브, 로그, doctor, Gateway 상태 순으로 확인	먼저 호스트 연결과 타이밍 문제를 해결하세요. 반복이 지속되면 인증을 백업하고 계정을 다시 연결하세요.
답장이 수초/수분 늦게 도착	`openclaw doctor --fix`	doctor는 Gateway 이벤트 루프의 성능을 저하시키는 것으로 확인된 오래된 로컬 TUI 클라이언트를 중지합니다.

전체 문제 해결: WhatsApp 문제 해결

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/Skills/사용자 지정 Telegram 명령 수를 줄이거나 네이티브 메뉴를 비활성화하세요.
업그레이드 후 허용 목록에 의해 차단됨	`openclaw security audit`와 구성 허용 목록 확인	`openclaw doctor --fix`를 실행하거나 `@username`을 숫자형 발신자 ID로 바꾸세요.

전체 문제 해결: Telegram 문제 해결

Discord

Discord 장애 징후

증상	가장 빠른 확인 방법	해결 방법
봇이 온라인이지만 길드에서 답장이 없음	`openclaw channels status --probe`	길드/채널을 허용하고 메시지 콘텐츠 인텐트를 확인하세요.
그룹 메시지가 무시됨	로그에서 멘션 게이팅으로 인한 삭제 확인	봇을 멘션하거나 길드/채널의 `requireMention: false`를 설정하세요.
입력/토큰 사용량은 있지만 Discord 메시지가 없음	주변 룸 이벤트인지, 아니면 모델이 `message(action=send)`를 누락한 옵트인 `message_tool` 룸인지 확인	Gateway 상세 로그에서 억제된 최종 페이로드 메타데이터를 검사하고 `messages.groupChat.unmentionedInbound`를 확인하며 주변 룸 이벤트를 읽거나, 일반 그룹 요청에서는 `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

iMessage 장애 징후

증상	가장 빠른 확인 방법	해결 방법
macOS가 아닌 환경에서 `imsg`가 없거나 실패함	`openclaw channels status --probe --channel imessage`	메시지용 Mac에서 OpenClaw를 실행하거나 `cliPath`에 SSH 래퍼를 사용하세요.
macOS에서 전송은 가능하지만 수신은 불가능함	메시지 자동화를 위한 macOS 개인정보 보호 권한 확인	TCC 권한을 다시 부여하고 채널 프로세스를 재시작하세요.
DM 발신자가 차단됨	`openclaw pairing list imessage`	페어링을 승인하거나 허용 목록을 업데이트하세요.

전체 문제 해결: iMessage 문제 해결

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