如何在 macOS 上監控你的 Gateway 健康狀態
寫程式最怕的就是「以為服務還在跑,結果早就斷線了」。每次都要開 Terminal 下指令檢查狀態真的很煩,如果能直接在選單列看到目前的連線狀況,就能省下不少心力。
這篇文章會告訴你如何利用 macOS 的介面快速檢查通道健康狀態,確保你的連線始終保持正常。
需要準備的東西
Section titled “需要準備的東西”在開始之前,請確保你已經準備好以下項目:
- 已安裝並執行中的 macOS 選單列應用程式
- 已連結的通道(WhatsApp 或 Telegram)
只要 5 分鐘,你就能掌握目前的連線健康度。
1. 查看 Menu Bar 狀態
Section titled “1. 查看 Menu Bar 狀態”你可以直接觀察選單列上的狀態點顏色:
- 綠色:已連結且最近剛開啟 socket。
- 橘色:正在連線或嘗試重連中。
- 紅色:已登出或健康檢查(Probe)失敗。
第二行會顯示詳細資訊,例如 linked · auth 12m 或具體的失敗原因。
2. 執行手動檢查
Section titled “2. 執行手動檢查”如果你覺得狀態更新不夠即時,點擊選單中的 “Run Health Check”,這會立刻觸發一次偵測。
3. 使用 Settings 面板
Section titled “3. 使用 Settings 面板”打開設定頁面,你可以看到更完整的資訊:
- General 標籤:顯示連線認證時間、session-store 路徑與數量、最後檢查時間與錯誤碼。這裡還有 Reveal Logs 按鈕讓你快速開啟記錄檔。
- Channels 標籤:這裡有 WhatsApp 與 Telegram 的專屬控制項,包含登入 QR Code、登出按鈕以及最後一次斷線的錯誤紀錄。
應用程式會透過 ShellExecutor 每 60 秒自動執行一次 openclaw health --json。這個偵測程序會載入你的憑證並回傳狀態,但不會發送任何訊息。
為了避免介面閃爍,系統會分別快取最後一次成功的快照與最後一次錯誤紀錄,並顯示各自的時間戳記。
如果你發現介面顯示異常,可以嘗試以下 CLI 指令來進行深度排查:
# 查看基本狀態openclaw status
# 進行深度狀態檢查openclaw status --deep
# 取得 JSON 格式的健康報告openclaw health --json如果需要查看底層的連線紀錄,可以追蹤 /tmp/openclaw/openclaw-*.log 檔案,搜尋 web-heartbeat 或 web-reconnect 相關字眼。
如果你在設定過程中遇到任何問題,可以直接詢問 AI Setup Assistant。
OpenClaw Expert
還是卡住了?
如果這篇文件沒有解決你的情境,直接問 OpenClaw Expert,拿到可執行步驟。