OpenClaw 閘道合成健康檢查：curl 迴圈、JSONL 日誌與相容 launchd 的租用雲端 Mac 監控
生產事故很少以壯觀的堆疊追蹤開場——往往始於閘道早已停止回應，卻沒人察覺，直到 webhook 佇列淹沒 Slack。 合成探測——針對回環的緊湊 curl、只追加的結構化日誌，以及尊重 ThrottleInterval 的 LaunchAgent——讓香港、東京、首爾、新加坡與美國的維運獲得誠實的心跳，又不必把憑證交給外部 SaaS。 這篇 2026 年 5 月的文章把探測節拍與本機綁定上游指引對齊，解釋失敗預算，列出九步上線路徑，並對應連續探測失敗時的升級鏈路。
請先讀：localhost 綁定強化、閘道守護程序排錯、切換與健康檢查回滾，以及專題 OpenClaw 合集。站內入口：說明中心、定價、遠端桌面（VNC）。
合成探測為何勝過「總會有人發現」
openclaw doctor 能擷取設定漂移，但要消耗數秒 CPU；輕量 curl 則以低成本證明 HTTP 監聽器仍能接受連線——在 TLS 終止於經 SSH 隧道的 localhost 時尤為關鍵。
健康端點契約矩陣
| 端點風格 | 期望訊號 | 誤報來源 | 緩解 |
|---|---|---|---|
| HTTP 200 空本文 | 監聽器存活 | 程序在 accept() 後僵死 | 輔以程序 RSS 檢查 |
| JSON 狀態載荷 | 版本與建置戳記 | 額外剖析失敗 | 使用 jq 離開碼 |
| WebSocket 升級探測 | 全堆疊健康 | 實作嘈雜 | 僅保留給一級閘道 |
每個探測指令稿都必須具備的 curl 護欄
--fail --silent --show-error，並明確設定連線 + 最大耗時預算。- 僅限回環（
127.0.0.1），除非已書面紀錄 TLS 網格。 - 結構化 stderr：行首帶 ISO 時間戳與租約 ID。
探測輔助工具的 LaunchAgent 節流模式
Apple 的 launchd 會在探測崩潰時樂於反覆拉起——除非存在合理的 ThrottleInterval 與明確的離開碼——請鏡像早前閘道復原文章中的崩潰迴圈治理思路。
探測落地的九步上線
- 基線：改動前先擷取 doctor JSON。
- 釘死：監聽器連接埠（常為 18789）寫入防火牆文件，與 SSH 並列。
- 撰寫：curl 包裝指令稿與基礎設施即程式碼同倉提交。
- 演練：先在有活動的 SSH 工作階段中手動執行。
- 安裝：LaunchAgent 掛在正確的 macOS 使用者下。
- 驗證：JSONL 成長與輪替策略。
- 接線：演練成功後再把告警路由到 PagerDuty/webhook。
- 演習日：有意弄垮閘道——確認告警真的會響。
- 複盤：每季回顧閾值。
JSONL 追加日誌與 SIEM 體量估算
每分鐘一次探測約產生每年 ~52.5 萬行——相對 webhook 軌跡微不足道，但仍需 gzip 輪替策略，並與 JSONL 輪替指引 對齊。
監控與可靠性文章的交叉引用
把探測與 優雅關停演練 綁定，避免維護視窗雙重告警；上游 LLM API 抖動時，再用 提供商退避指引 對應重試策略。
常見問題
探測能否做認證？ 優先在回環側免認證；若必須認證，把 bearer token 放進 launchd 環境變數——絕不要內嵌寫進程式碼庫。
東京觀察者擷取美國日誌應使用怎樣的 RTT 預算？ 以實測為準——跨太平洋示意 RTT 往往超過 120 ms；告警管道必須容忍抖動。
何處擴展機隊容量？ 在榨乾監控主機之前，先從 定價 頁評估。
為何租用的 Mac mini 仍是實用的探測錨點
Apple Silicon 的閒置能效讓背景 curl 成本極低；把閘道分布到香港、日本、韓國、新加坡與美國多地，可在隔離區域故障的同時，避免在單台過載 mini 上把探測基數翻一倍。
