2026 年 OpenClaw Gateway 内置健康探针（/health、/ready）与负载均衡：远程物理 Mac 裸机、Docker Compose 与 Kubernetes 的对齐验收、路径 shadowing 与误报未就绪的可复现 Runbook（配置片段 + FAQ）

2. 三类痛点：语义混用、路径 shadowing、探针源与 bind 不一致

1. 语义混用与隐性成本：把重查询或依赖外部网络的检查塞进 /health，会导致 liveness 误杀；反过来把 /ready 实现得过轻，又会在滚动发布时把未warm副本接进 LB，放大 5xx 与队列堆积。
2. 路径 shadowing 与审计风险：更泛化的 location / 或 Ingress 默认后端抢在网关规则之前命中，监控看到 200，但业务路径仍指向旧静态资源；审计上难以解释「为何健康与告警打架」。测试机型与系统版本不一致也会污染基线，关于 Sequoia 测试机租赁的决策 可作为对照阅读。
3. 稳定性与权限边界：裸机上 launchd 的环境变量与交互式 SSH 会话不一致，探针脚本引用到错误 HOME；K8s 上 kubelet 探针与 VPC LB 健康检查源网段不同，NetworkPolicy 放行其一却拦截其二，表现为「调度已就绪但外部 LB 仍摘流」。

3. 决策矩阵：裸机、Compose、Kubernetes 如何对齐验收

用一张表统一「谁在什么约束下负责哪类健康信号」，避免三套脚本各写各的。

4. 七步落地 Runbook（含配置片段）

1. 冻结契约：在变更单写明 /health 与 /ready 的状态码、JSON 字段（例如 ok、deps）、最大响应时间与允许的短暂 503 窗口。
2. 消除路径 shadowing（nginx 片段示意）：将精确路径放在泛化规则之前。

   # 精确路径优先，再落到 /
   location = /health { proxy_pass http://openclaw_gateway; }
   location = /ready  { proxy_pass http://openclaw_gateway; }
   location / {
     # 其他站点或静态资源
   }

3. Kubernetes 探针片段（请按端口与路径替换）：

   startupProbe:
     httpGet:
       path: /ready
       port: 18789
     failureThreshold: 30
     periodSeconds: 2
   readinessProbe:
     httpGet:
       path: /ready
       port: 18789
     periodSeconds: 5
     timeoutSeconds: 2
   livenessProbe:
     httpGet:
       path: /health
       port: 18789
     periodSeconds: 10
     timeoutSeconds: 2

4. Docker Compose 健康检查与依赖：

   services:
     openclaw-gateway:
       image: your.repo/openclaw-gateway@sha256:...
       healthcheck:
         test: ["CMD", "curl", "-fsS", "http://127.0.0.1:18789/ready"]
         interval: 10s
         timeout: 3s
         retries: 5
         start_period: 60s
     edge:
       depends_on:
         openclaw-gateway:
           condition: service_healthy

5. 对齐 bind 与探针源：若网关配置为 bind=lan，避免 kubelet 只验证「进程存在」而 LB 仍指向旧成员；把云厂商健康检查源网段加入 NetworkPolicy／安全组白名单，并在变更单附「LB→节点→Pod」与「Pod 内自测」两组结果。
6. 双路径对照与摘流演练：滚动发布前后各执行一次：直连 Pod IP、经 ClusterIP、经 Ingress 域名；记录 /ready 返回体差异。若与你团队在 Kubernetes 上归档的 bind=lan、Service 与 NetworkPolicy 对照清单一并执行，可快速判断是否为网络层而非应用层回归。
7. 误报未就绪复现包：在实验环境故意把反代 location /ready 指到静态 200 页，再观察 Prometheus／云监控「全绿」与业务 5xx 分叉；把修复 diff（调整 location 顺序或改为 location = /ready）附在 RCA 模板中，避免同类事故二次发生。

5. 可引用阈值与参数清单

6. FAQ：误报未就绪与负载均衡