如何檢查 OpenClaw Gateway 的健康狀況
寫程式最煩的就是遇到「沈默的錯誤」。有時候你的 Gateway 看起來在跑,但你並不知道背後的帳號連線是否真的正常,或是回應速度是否變慢。與其在那邊盲目猜測,不如直接看系統給你的健康報告。
這篇文章會教你如何使用 openclaw health 指令,讓你一眼看穿 Gateway 的運行細節。
需要準備的東西
Section titled “需要準備的東西”- 已安裝 OpenClaw
- 正在運行的 Gateway
要檢查 Gateway 的狀態,你只需要 5 分鐘(甚至更短)就能上手這幾個指令。
1. 基本健康檢查
Section titled “1. 基本健康檢查”這是最簡單的用法,直接在終端機輸入:
openclaw health如果你需要把這些數據餵給其他程式或 API 處理,可以加上 --json 旗標來取得結構化的資料:
openclaw health --json2. 進階效能診斷
Section titled “2. 進階效能診斷”當你配置了多個帳號或 Agent,簡單的檢查可能不夠。這時候請使用 --verbose 模式:
openclaw health --verbose這個指令會執行以下操作:
- 即時探測 (Live Probes):實際測試連線狀況。
- 帳號效能分析:顯示每個帳號的響應時間(Timings)。
- Session 狀態:列出每個 Agent 的 Session 儲存資訊。
如果你在執行指令時遇到問題,可以參考以下常見狀況:
- 看不到詳細的帳號數據:請確認你有加上
--verbose參數,否則系統只會顯示摘要資訊。 - 無法獲取 Session 資訊:這通常發生在多 Agent 配置下,請確保 Gateway 正在運行且 Agent 已正確加載。
想要更快速的解決方案嗎?試試我們的 AI Setup Assistant。
OpenClaw Expert
還是卡住了?
如果這篇文件沒有解決你的情境,直接問 OpenClaw Expert,拿到可執行步驟。