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 上把探测基数翻一倍。
