頻道疑難排解
當頻道已連接但行為不正確時,請參考本頁。
指令流程
依序執行以下指令:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
正常基準:
Runtime: runningRPC probe: ok- 頻道探測顯示已連接/就緒
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 imessage 或 openclaw pairing list bluebubbles | 核准配對或更新許可清單。 |
完整疑難排解:
- /channels/imessage#troubleshooting-macos-privacy-and-security-tcc
- /channels/bluebubbles#troubleshooting
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 | 核准發送者或調整私訊政策。 |
| 加密聊天室失敗 | 確認加密模組和加密設定 | 啟用加密支援並重新加入/同步聊天室。 |