頻道疑難排解

當頻道已連接但行為不正確時,請參考本頁。

指令流程

依序執行以下指令:

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

正常基準:

  • Runtime: running
  • RPC probe: ok
  • 頻道探測顯示已連接/就緒

WhatsApp

WhatsApp 故障特徵

症狀最快檢查方式修復方式
已連接但私訊沒有回覆openclaw pairing list whatsapp核准發送者或調整私訊政策/許可清單。
群組訊息被忽略檢查設定中的 requireMention + mention patterns提及機器人或放寬該群組的提及政策。
隨機斷線/重新登入迴圈openclaw channels status --probe + 日誌重新登入並確認憑證目錄狀態正常。

完整疑難排解:/channels/whatsapp#troubleshooting-quick

Telegram

Telegram 故障特徵

症狀最快檢查方式修復方式
/start 後沒有可用的回覆流程openclaw pairing list telegram核准配對或變更私訊政策。
機器人上線但群組保持沉默確認提及需求和機器人隱私模式關閉隱私模式以獲得群組可見性,或提及機器人。
網路錯誤導致傳送失敗檢查日誌中的 Telegram API 呼叫失敗修復 DNS/IPv6/代理到 api.telegram.org 的路由。
啟動時 setMyCommands 被拒絕檢查日誌中的 BOT_COMMANDS_TOO_MUCH減少外掛/技能/自訂 Telegram 指令或停用原生選單。
升級後許可清單封鎖了你openclaw security audit 和設定許可清單執行 openclaw doctor --fix 或將 @username 替換為數字發送者 ID。

完整疑難排解:/channels/telegram#troubleshooting

Discord

Discord 故障特徵

症狀最快檢查方式修復方式
機器人上線但伺服器無回覆openclaw channels status --probe允許伺服器/頻道並確認訊息內容意圖。
群組訊息被忽略檢查日誌中的提及過濾丟棄提及機器人或設定伺服器/頻道 requireMention: false
私訊回覆遺失openclaw pairing list discord核准私訊配對或調整私訊政策。

完整疑難排解:/channels/discord#troubleshooting

Slack

Slack 故障特徵

症狀最快檢查方式修復方式
Socket mode 已連接但沒有回應openclaw channels status --probe確認 app token + bot token 和必要的權限範圍。
私訊被封鎖openclaw pairing list slack核准配對或放寬私訊政策。
頻道訊息被忽略檢查 groupPolicy 和頻道許可清單允許該頻道或將政策切換為 open

完整疑難排解:/channels/slack#troubleshooting

iMessage 與 BlueBubbles

iMessage 與 BlueBubbles 故障特徵

症狀最快檢查方式修復方式
沒有接收事件確認 webhook/伺服器可達性和應用程式權限修復 webhook URL 或 BlueBubbles 伺服器狀態。
macOS 上可傳送但無法接收檢查 macOS 隱私權限(訊息自動化)重新授予 TCC 權限並重啟頻道程序。
私訊發送者被封鎖openclaw pairing list imessageopenclaw pairing list bluebubbles核准配對或更新許可清單。

完整疑難排解:

Signal

Signal 故障特徵

症狀最快檢查方式修復方式
背景程式可達但機器人沉默openclaw channels status --probe確認 signal-cli 背景程式 URL/帳號和接收模式。
私訊被封鎖openclaw pairing list signal核准發送者或調整私訊政策。
群組回覆未觸發檢查群組許可清單和 mention patterns新增發送者/群組或放寬過濾。

完整疑難排解:/channels/signal#troubleshooting

Matrix

Matrix 故障特徵

症狀最快檢查方式修復方式
已登入但忽略聊天室訊息openclaw channels status --probe檢查 groupPolicy 和聊天室許可清單。
私訊未處理openclaw pairing list matrix核准發送者或調整私訊政策。
加密聊天室失敗確認加密模組和加密設定啟用加密支援並重新加入/同步聊天室。

完整疑難排解:/channels/matrix#troubleshooting