跳到內容

如何檢查 OpenClaw Gateway 的健康狀況

寫程式最煩的就是遇到「沈默的錯誤」。有時候你的 Gateway 看起來在跑,但你並不知道背後的帳號連線是否真的正常,或是回應速度是否變慢。與其在那邊盲目猜測,不如直接看系統給你的健康報告。

這篇文章會教你如何使用 openclaw health 指令,讓你一眼看穿 Gateway 的運行細節。

  • 已安裝 OpenClaw
  • 正在運行的 Gateway

要檢查 Gateway 的狀態,你只需要 5 分鐘(甚至更短)就能上手這幾個指令。

這是最簡單的用法,直接在終端機輸入:

Terminal window
openclaw health

如果你需要把這些數據餵給其他程式或 API 處理,可以加上 --json 旗標來取得結構化的資料:

Terminal window
openclaw health --json

當你配置了多個帳號或 Agent,簡單的檢查可能不夠。這時候請使用 --verbose 模式:

Terminal window
openclaw health --verbose

這個指令會執行以下操作:

  • 即時探測 (Live Probes):實際測試連線狀況。
  • 帳號效能分析:顯示每個帳號的響應時間(Timings)。
  • Session 狀態:列出每個 Agent 的 Session 儲存資訊。

如果你在執行指令時遇到問題,可以參考以下常見狀況:

  • 看不到詳細的帳號數據:請確認你有加上 --verbose 參數,否則系統只會顯示摘要資訊。
  • 無法獲取 Session 資訊:這通常發生在多 Agent 配置下,請確保 Gateway 正在運行且 Agent 已正確加載。

想要更快速的解決方案嗎?試試我們的 AI Setup Assistant。

OpenClaw

OpenClaw Expert

還是卡住了?

如果這篇文件沒有解決你的情境,直接問 OpenClaw Expert,拿到可執行步驟。