健康檢查（CLI）

快速驗證頻道連線狀態的簡短指南，不用再猜測。

快速檢查

• openclaw status — 本地摘要：gateway 可達性/模式、更新提示、已連結頻道的驗證時間、sessions 數量與近期活動。
• openclaw status --all — 完整本地診斷（唯讀、彩色輸出，可安全貼出來做除錯用）。
• openclaw status --deep — 額外探測運行中的 Gateway（支援各頻道探測）。
• openclaw health --json — 向運行中的 Gateway 請求完整健康快照（僅限 WS；不直接存取 Baileys socket）。
• 在 WhatsApp/WebChat 中發送 /status 作為獨立訊息，可取得狀態回覆而不觸發 agent。
• 日誌：tail /tmp/openclaw/openclaw-*.log 並搜尋 web-heartbeat、web-reconnect、web-auto-reply、web-inbound。

深度診斷

• 磁碟上的憑證：ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json（修改時間應該是近期的）。
• Session 儲存：ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json（路徑可在設定中覆寫）。計數和近期接收者可透過 status 查看。
• 重新連結流程：當日誌中出現狀態碼 409–515 或 loggedOut 時，執行 openclaw channels logout && openclaw channels login --verbose。（注意：QR 登入流程在配對後的 515 狀態會自動重試一次。）

出問題時

• logged out 或狀態碼 409–515 → 用 openclaw channels logout 然後 openclaw channels login 重新連結。
• Gateway 無法連線 → 啟動它：openclaw gateway --port 18789（埠被佔用時加 --force）。
• 收不到訊息 → 確認已連結的手機在線上且發送者在允許清單中（channels.whatsapp.allowFrom）；群組聊天要確認白名單和 mention 規則都正確（channels.whatsapp.groups、agents.list[].groupChat.mentionPatterns）。

專用「health」指令

openclaw health --json 向運行中的 Gateway 請求健康快照（CLI 不直接存取頻道 socket）。它會回報已連結的憑證/驗證時間（如果有的話）、各頻道探測摘要、session 儲存摘要，以及探測耗時。如果 Gateway 無法連線或探測失敗/逾時，會以非零狀態碼退出。用 --timeout <ms> 覆寫預設的 10 秒逾時。