OpenClaw 頻道故障排除：快速修復連線與訊息問題

搞定了連線，結果機器人卻像木頭人一樣沒反應？這種「看得到卻吃不到」的情況最讓人抓狂。明明顯示已連線，但訊息就是傳不出去或收不到，通常問題都藏在權限設定、訊息原則或特定的 API 限制裡。

當你的 Channel 顯示已連線但行為異常時，請參考這份指南進行排查。

指令階梯

請依序執行以下指令：

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

健康的基準狀態：

症狀	最快檢查方式	修復方法
已連線但私訊（DM）無回覆	`openclaw pairing list whatsapp`	核准傳送者，或切換私訊原則/白名單。
群組訊息被忽略	檢查設定中的 `requireMention` 與提及模式	在群組中標記（mention）機器人，或放寬該群組的標記原則。
隨機斷線或陷入重新登入迴圈	`openclaw channels status --probe` + 日誌	重新登入並確認憑證目錄（credentials directory）狀態正常。

症狀	最快檢查方式	修復方法
執行 `/start` 但沒有可用的回覆流程	`openclaw pairing list telegram`	核准配對或更改私訊原則。
機器人在線但群組保持沉默	確認標記需求與機器人隱私模式（privacy mode）	停用隱私模式以獲得群組可見性，或直接標記機器人。
傳送失敗並出現網路錯誤	檢查日誌中是否有 Telegram API 呼叫失敗	修復連向 `api.telegram.org` 的 DNS、IPv6 或 Proxy 路由。
啟動時 `setMyCommands` 被拒絕	檢查日誌中是否出現 `BOT_COMMANDS_TOO_MUCH`	減少 Plugin、Skill 或自定義指令，或停用原生選單。
升級後被白名單阻擋	`openclaw security audit` 與設定白名單	執行 `openclaw doctor --fix` 或將 `@username` 替換為數字 ID。

症狀	最快檢查方式	修復方法
機器人在線但伺服器（guild）無回覆	`openclaw channels status --probe`	允許該伺服器/頻道，並確認訊息內容意圖（message content intent）。
群組訊息被忽略	檢查日誌中是否有標記門檻（mention gating）攔截	標記機器人，或將該伺服器/頻道的 `requireMention` 設為 `false`。
遺失私訊回覆	`openclaw pairing list discord`	核准私訊配對或調整私訊原則。

症狀	最快檢查方式	修復方法
Socket 模式已連線但無回應	`openclaw channels status --probe`	確認 App token、Bot token 以及必要的 Scopes 權限。
私訊被阻擋	`openclaw pairing list slack`	核准配對或放寬私訊原則。
頻道訊息被忽略	檢查 `groupPolicy` 與頻道白名單	允許該頻道，或將原則切換為 `open`。

症狀	最快檢查方式	修復方法
沒有傳入事件	確認 Webhook/伺服器連通性與 App 權限	修復 Webhook URL 或檢查 BlueBubbles 伺服器狀態。
在 macOS 上可以傳送但無法接收	檢查 macOS 訊息自動化的隱私權限	重新授予 TCC 權限並重啟 Channel 程序。
私訊傳送者被阻擋	`openclaw pairing list imessage` 或 `openclaw pairing list bluebubbles`	核准配對或更新白名單。

完整故障排除指南：

症狀	最快檢查方式	修復方法
Daemon 可連線但機器人無反應	`openclaw channels status --probe`	確認 `signal-cli` daemon URL、帳號及接收模式（receive mode）。
私訊被阻擋	`openclaw pairing list signal`	核准傳送者或調整私訊原則。
群組回覆未觸發	檢查群組白名單與標記模式	新增傳送者/群組，或放寬門檻限制。

症狀	最快檢查方式	修復方法
機器人回覆「已前往火星」	確認設定中的 `appId` 與 `clientSecret`	設定憑證或重啟 Gateway。
沒有傳入訊息	`openclaw channels status --probe`	在 QQ 開放平台驗證憑證有效性。
語音未轉換文字	檢查 STT 服務商設定	設定 `channels.qqbot.stt` 或 `tools.media.audio`。
主動訊息（Proactive messages）未送達	檢查 QQ 平台互動要求	若近期無互動，QQ 可能會阻擋機器人發起的訊息。

症狀	最快檢查方式	修復方法
已登入但忽略房間訊息	`openclaw channels status --probe`	檢查 `groupPolicy` 與房間白名單。
私訊未處理	`openclaw pairing list matrix`	核准傳送者或調整私訊原則。
加密房間失效	確認加密模組與加密設定	啟用加密支援並重新加入/同步房間。

完整安裝與設定：Matrix

如果你嘗試了上述方法仍無法解決問題，可以詢問我們的 AI Setup Assistant。

OpenClaw Expert

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。