Skip to main content

​
頻道疑難排解

當頻道已連線但行為異常時，使用此頁面。

​
指令梯次

依序執行以下指令： 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
健康基準：
  • Runtime: running
  • RPC probe: ok
  • 頻道探測顯示已連線/就緒

​
WhatsApp

​
WhatsApp 故障特徵

症狀最快檢查方式修復方式
已連線但無 DM 回覆openclaw pairing list whatsapp核准發送者或切換 DM 策略/allowlist。
群組訊息被忽略檢查設定中的 requireMention 和提及模式提及 bot 或放寬該群組的提及策略。
隨機斷線/重新登入迴圈openclaw channels status --probe + 日誌重新登入並確認憑證目錄狀態正常。
完整疑難排解：/channels/whatsapp#troubleshooting-quick

​
Telegram

​
Telegram 故障特徵

症狀最快檢查方式修復方式
/start 後無可用的回覆流程openclaw pairing list telegram核准配對或變更 DM 策略。
Bot 在線但群組保持靜默確認提及需求和 bot 隱私模式停用群組可見性的隱私模式或提及 bot。
傳送失敗並出現網路錯誤檢查日誌中的 Telegram API 呼叫失敗修復連往 api.telegram.org 的 DNS/IPv6/代理路由。
啟動時 setMyCommands 被拒絕檢查日誌中的 BOT_COMMANDS_TOO_MUCH減少外掛/技能/自訂 Telegram 指令，或停用原生選單。
升級後 allowlist 阻擋自己openclaw security audit 和設定 allowlist執行 openclaw doctor --fix 或將 @username 替換為數字發送者 ID。
完整疑難排解：/channels/telegram#troubleshooting

​
Discord

​
Discord 故障特徵

症狀最快檢查方式修復方式
Bot 在線但無 guild 回覆openclaw channels status --probe允許 guild/頻道並確認訊息內容 intent。
群組訊息被忽略檢查日誌中的提及閘控丟棄記錄提及 bot 或設定 guild/頻道 requireMention: false。
DM 回覆遺失openclaw pairing list discord核准 DM 配對或調整 DM 策略。
完整疑難排解：/channels/discord#troubleshooting

​
Slack

​
Slack 故障特徵

症狀最快檢查方式修復方式
Socket mode 已連線但無回應openclaw channels status --probe確認 app token + bot token 和所需的 scopes。
DM 被封鎖openclaw pairing list slack核准配對或放寬 DM 策略。
頻道訊息被忽略檢查 groupPolicy 和頻道 allowlist允許該頻道或將策略切換為 open。
完整疑難排解：/channels/slack#troubleshooting

​
iMessage 和 BlueBubbles

​
iMessage 和 BlueBubbles 故障特徵

症狀最快檢查方式修復方式
無入站事件確認 webhook/伺服器可達性和應用程式權限修復 webhook URL 或 BlueBubbles 伺服器狀態。
macOS 上可傳送但無法接收檢查 macOS Messages 自動化的隱私權限重新授予 TCC 權限並重啟頻道程序。
DM 發送者被封鎖openclaw pairing list imessage 或 openclaw pairing list bluebubbles核准配對或更新 allowlist。
完整疑難排解：

​
Signal

​
Signal 故障特徵

症狀最快檢查方式修復方式
Daemon 可達但 bot 保持靜默openclaw channels status --probe確認 signal-cli daemon URL/帳號和接收模式。
DM 被封鎖openclaw pairing list signal核准發送者或調整 DM 策略。
群組回覆無法觸發檢查群組 allowlist 和提及模式新增發送者/群組或放寬閘控。
完整疑難排解：/channels/signal#troubleshooting

​
Matrix

​
Matrix 故障特徵

症狀最快檢查方式修復方式
已登入但忽略房間訊息openclaw channels status --probe檢查 groupPolicy 和房間 allowlist。
DM 未被處理openclaw pairing list matrix核准發送者或調整 DM 策略。
加密房間失敗確認加密模組和加密設定啟用加密支援並重新加入/同步房間。
完整疑難排解：/channels/matrix#troubleshooting