跳轉到主要內容

​
頻道疑難排解

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

​
命令階梯

請先依序執行以下項目： 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
健康的基準狀態：
  • Runtime: running
  • RPC probe: ok
  • 頻道探測顯示已連線／就緒

​
WhatsApp

​
WhatsApp 失敗特徵

症狀最快檢查修復
已連線但沒有私訊回覆openclaw pairing list whatsapp18. 核准傳送者，或切換私訊政策／允許清單。
群組訊息被忽略檢查 requireMention + 設定中的提及模式19. 提及機器人，或放寬該群組的提及政策。
隨機斷線／重新登入循環openclaw channels status --probe + 記錄20. 重新登入並驗證憑證目錄是否正常。
完整疑難排解：/channels/whatsapp#troubleshooting-quick

​
Telegram

​
Telegram 失敗特徵

症狀最快檢查修復
/start 但沒有可用的回覆流程openclaw pairing list telegram21. 核准配對或變更私訊政策。
機器人在線但群組保持沉默驗證提及需求與機器人隱私模式停用隱私模式以取得群組可見性，或提及機器人。
傳送失敗並伴隨網路錯誤檢查記錄中的 Telegram API 呼叫失敗修復 DNS／IPv6／代理路由至 api.telegram.org。
已升級且 allowlist 封鎖你openclaw security audit 與設定允許清單執行 openclaw doctor --fix 或將 @username 替換為數字型發送者 ID。
完整疑難排解：/channels/telegram#troubleshooting

​
Discord

​
Discord 失敗特徵

症狀最快檢查修復
22. 機器人在線但沒有伺服器回覆openclaw channels status --probe23. 允許伺服器／頻道並驗證訊息內容意圖。
群組訊息被忽略24. 檢查日誌以確認提及門檻被丟棄的情況提及機器人或設定伺服器／頻道 requireMention: false。
25. 私訊回覆遺失openclaw pairing list discord26. 核准私訊配對或調整私訊政策。
完整疑難排解：/channels/discord#troubleshooting

​
Slack

​
Slack 失敗特徵

症狀最快檢查修復
Socket 模式已連線但沒有回應openclaw channels status --probe27. 驗證應用程式權杖與機器人權杖，以及所需的範圍。
私訊被封鎖openclaw pairing list slack28. 核准配對或放寬私訊政策。
頻道訊息被忽略檢查 groupPolicy 與頻道允許清單允許該頻道或將政策切換為 open。
完整疑難排解：/channels/slack#troubleshooting

​
iMessage 與 BlueBubbles

​
iMessage 與 BlueBubbles 失敗特徵

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

​
Signal

​
Signal 失敗特徵

症狀最快檢查修復
29. 常駐程式可連線但機器人無回應openclaw channels status --probe驗證 signal-cli 常駐程式的 URL／帳號與接收模式。
31. 私訊被封鎖openclaw pairing list signal核准寄件者或調整私訊政策。
群組回覆未觸發檢查群組允許清單與提及模式新增寄件者／群組或放寬閘控。
完整疑難排解：/channels/signal#troubleshooting

​
Matrix

​
Matrix 失敗特徵

症狀最快檢查修復
已登入但忽略房間訊息openclaw channels status --probe檢查 groupPolicy 與房間允許清單。
32. 私訊未處理openclaw pairing list matrix核准寄件者或調整私訊政策。
加密房間失敗驗證加密模組與加密設定啟用加密支援並重新加入／同步房間。
完整疑難排解：/channels/matrix#troubleshooting