疑難排解

以症狀為導向的診斷，包含精確的指令順序與日誌特徵

前 60 秒

依序執行以下診斷指令：

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

健康系統應顯示 Runtime: running 和 RPC probe: ok。

決策樹

根據症狀選擇對應的故障類別：

無回覆
儀表板或 Control UI 連線問題
Gateway 啟動失敗
頻道已連線但訊息未流通
Cron 或 heartbeat 失敗
Node 已配對但工具執行失敗
瀏覽器工具故障

無回覆

檢查路由策略、頻道允許清單和配對狀態。在日誌中尋找如「drop guild message (mention required)」或「pairing request」等特徵。

相關指令：

openclaw channels status --probe
openclaw logs --follow

儀表板/Control UI 連線問題

驗證 probe URL、驗證模式和安全上下文。常見錯誤包括「device identity required」和「device nonce mismatch」，表示驗證流程問題。

openclaw gateway status
openclaw gateway probe

Gateway 服務無法持續執行

檢查連接埠衝突、設定不匹配，並確保設定了 gateway.mode=local。

常見日誌特徵：

特徵	意義
`refusing to bind gateway without auth`	非 loopback 繫結需要設定驗證
`another gateway instance is already listening` / `EADDRINUSE`	連接埠衝突
`Gateway start blocked: set gateway.mode=local`	設定為 remote 模式

頻道已連線但訊息未流通

當頻道顯示已連線但訊息未流通時，檢查 DM 策略、群組允許清單設定和頻道權限。

常見問題：

群組中需要 mention
配對待核准
API 權限/scope 缺失導致 401/403 錯誤

Cron/Heartbeat 問題

openclaw cron status

Heartbeat 在安靜時段或有進行中的請求時會跳過。

常見問題：

排程器已停用
安靜時段跳過
不存在的帳號目標

Node 工具執行失敗

openclaw node status

常見特徵包含背景可用性問題、OS 權限、需要核准和允許清單限制。

瀏覽器工具故障

驗證瀏覽器狀態和 profile 設定。常見問題包括 Chrome 啟動失敗、二進位路徑錯誤、擴充功能連線問題和 attach-only profile 無法連線。