跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

當通道已連線但行為不正確時，請使用此頁面。

​
命令階梯

先依序執行這些命令： 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
健康基準：
  • Runtime: running
  • Connectivity probe: ok
  • Capability: read-only、write-capable 或 admin-capable
  • 通道探測顯示傳輸已連線，且在支援的情況下顯示 works 或 audit ok

​
WhatsApp

​
WhatsApp 失敗特徵

症狀最快檢查修正
已連線但沒有私人訊息回覆openclaw pairing list whatsapp核准寄件者，或切換私人訊息政策/允許清單。
群組訊息被忽略檢查設定中的 requireMention + 提及模式提及機器人，或放寬該群組的提及政策。
QR 登入因 408 而逾時檢查 Gateway 的 HTTPS_PROXY / HTTP_PROXY 環境變數設定可連線的 Proxy；僅將 NO_PROXY 用於略過連線。
隨機斷線/重新登入迴圈openclaw channels status --probe + 日誌即使目前已連線，最近重新連線也會被標記；監看日誌、重新啟動 Gateway，若持續不穩再重新連結。
完整疑難排解：WhatsApp 疑難排解

​
Telegram

​
Telegram 失敗特徵

症狀最快檢查修正
/start 但沒有可用的回覆流程openclaw pairing list telegram核准配對或變更私人訊息政策。
機器人在線上但群組保持沉默驗證提及要求與機器人隱私模式停用隱私模式以允許群組可見，或提及機器人。
傳送因網路錯誤而失敗檢查日誌中的 Telegram API 呼叫失敗修正到 api.telegram.org 的 DNS/IPv6/Proxy 路由。
啟動回報 getMe returned 401檢查設定的 Token 來源重新複製或重新產生 BotFather Token，並更新 botToken、tokenFile 或預設帳號的 TELEGRAM_BOT_TOKEN。
輪詢停滯或重新連線緩慢使用 openclaw logs --follow 檢查輪詢診斷升級；若重新啟動是誤判，請調整 pollingStallThresholdMs。持續停滯仍表示 Proxy/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。
私人訊息回覆遺失openclaw pairing list discord核准私人訊息配對或調整私人訊息政策。
完整疑難排解：Discord 疑難排解

​
Slack

​
Slack 失敗特徵

症狀最快檢查修正
Socket mode 已連線但沒有回應openclaw channels status --probe驗證 App Token + Bot Token 和必要 Scope；在 SecretRef 支援的設定中留意 botTokenStatus / appTokenStatus = configured_unavailable。
私人訊息被封鎖openclaw pairing list slack核准配對或放寬私人訊息政策。
頻道訊息被忽略檢查 groupPolicy 和頻道允許清單允許該頻道，或將政策切換為 open。
完整疑難排解：Slack 疑難排解

​
iMessage 和 BlueBubbles

​
iMessage 和 BlueBubbles 失敗特徵

症狀最快檢查修正
沒有傳入事件驗證 Webhook/伺服器可達性與 App 權限修正 Webhook URL 或 BlueBubbles 伺服器狀態。
在 macOS 上可傳送但無法接收檢查 macOS 對 Messages 自動化的隱私權限重新授予 TCC 權限並重新啟動通道程序。
私人訊息寄件者被封鎖openclaw pairing list imessage 或 openclaw pairing list bluebubbles核准配對或更新允許清單。
完整疑難排解：

​
Signal

​
Signal 失敗特徵

症狀最快檢查修正
Daemon 可達但機器人沉默openclaw channels status --probe驗證 signal-cli Daemon URL/帳號和接收模式。
私人訊息被封鎖openclaw pairing list signal核准寄件者或調整私人訊息政策。
群組回覆未觸發檢查群組允許清單和提及模式新增寄件者/群組或放寬閘控。
完整疑難排解：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、房間允許清單與提及閘控。
私人訊息未處理openclaw pairing list matrix核准寄件者或調整私人訊息政策。
加密房間失敗openclaw matrix verify status重新驗證裝置，然後檢查 openclaw matrix verify backup status。
備份還原擱置/損壞openclaw matrix verify backup status執行 openclaw matrix verify backup restore，或使用復原金鑰重新執行。
交叉簽署/啟動流程看起來不正確openclaw matrix verify bootstrap一次修復祕密儲存、交叉簽署與備份狀態。
完整設定與配置：Matrix

​
相關