2026年 OpenClaw Gateway 内蔵ヘルス探針（/health、/ready）と負荷分散：リモート物理 Mac 裸機、Docker Compose と Kubernetes の検収揃え——パスシャドウイングと誤検知の NotReady 再現 Runbook（設定断片＋FAQ）

1. 痛みの分解：シャドウイング、意味のズレ、監査コスト

1. パスシャドウイング。 静的 location / や SPA の try_files が /ready に先に 200 を返し、OpenClaw には届きません。LB はプール健全と判断しますがゲートウェイは未検査です。
2. プラットフォーム間の意味ドリフト。 Compose の healthy はエンジン視点です。Kubernetes の Service セレクタが重なる、Ingress が意図しないカナリアへ流すと、観測は「緑」でも実トラフィックは別リビジョンです。
3. 監査と安定性の隠れコスト。 liveness に /ready を流用すると依存の瞬断が Pod 再起動に直結します。リモート Mac 群では Screen Sharing やエージェント状態のフラップ、オンノイズに化けます。

2. 意思決定表：各シグナルをどこで見るか

設計レビューで「誰が何を観測するか」を先に固定します。YAML を貼る前の一枚です。

3. 七ステップ揃え込み Runbook

1. 呼び出し元の列挙。 クラウド LB、nginx の server_name、Compose、Helm、監視の ad-hoc curl を表にし、空欄を潰します。
2. シャドウイングの実証。 プロキシホストから curl -svH 'Host: your.api' https://127.0.0.1/ready と、ゲートウェイのループバック直叩きを diff します。
3. catch-all より前に固定。 location = /health と location = /ready を上流へ proxy_pass。proxy_buffering off と Cache-Control: no-store を付与します。
4. Compose：LB タイムアウトに寄せる。 interval／timeout／retries を外部 LB の約 80% 以内に揃え、先に optimistic に緑にしないようにします。
5. Kubernetes：Probe の分離。 liveness→/health、readiness→/ready。モデルルータのウォームアップには startupProbe の failureThreshold を伸ばします。
6. ロールアウト稽古。 Blue/Green または Rolling で kubectl get endpoints とゲートウェイログを並走し、/ready が新リビジョンで立ってからトラフィックが移ることを確認します。
7. 証跡のアーカイブ。 マスクした nginx -T、Compose、kubectl describe pod をタイムスタンプ付きで保存し、次の偽 NotReady に備えます。

4. 設定断片

4.1 nginx：プローブ専用 location（シャドウ回避）

location = /health { proxy_pass http://openclaw_gateway; proxy_http_version 1.1;
  proxy_set_header Host $host; proxy_buffering off; add_header Cache-Control "no-store"; }
location = /ready  { proxy_pass http://openclaw_gateway; proxy_http_version 1.1;
  proxy_set_header Host $host; proxy_buffering off; add_header Cache-Control "no-store"; }

4.2 Docker Compose：healthcheck と依存ゲート

services:
  openclaw-gateway:
    image: your.registry/openclaw-gateway@sha256:…
    healthcheck:
      test: ["CMD", "curl", "-fsS", "http://127.0.0.1:18789/health"]
      interval: 15s
      timeout: 3s
      retries: 5
      start_period: 120s
  edge-proxy:
    depends_on:
      openclaw-gateway:
        condition: service_healthy

4.3 Kubernetes：startup＋readiness＋liveness

startupProbe:
  httpGet: { path: /ready, port: http }
  periodSeconds: 5
  failureThreshold: 30
readinessProbe:
  httpGet: { path: /ready, port: http }
  periodSeconds: 10
  timeoutSeconds: 3
livenessProbe:
  httpGet: { path: /health, port: http }
  periodSeconds: 20
  timeoutSeconds: 2

port: http は containerPort 名に合わせてください。TLS を Ingress で終端する場合は、メッシュの sidecar 有無に合わせてコンテナ素のポートへ向けるかを揃えます。

5. 引用用パラメータ（3 点）

• 18789 — Mac ノードでよく使われる OpenClaw gateway の HTTP 面。必ず openclaw.json またはリリースノートで実ポートを確定してから LB テンプレに焼き込みます。
• 120 秒の start_period — コールドモデルキャッシュや Secret マウント遅延を吸う初手。2 週間の P95 で削ります。
• readiness 3 秒タイムアウト — 遅い上流と kubelet の攻撃性の折り合い。failureThreshold で粘らせ、無限タイムアウトで本物の停滞を隠さないようにします。

6. FAQ：再現可能な偽陽性

7. このゲートウェイ層に Mac mini が向く理由

プローブの意味は「ホストが落ちず、経路がブレない」ことから成り立ちます。Apple Silicon の Mac mini は待機電力が小さく、ラックやデスクでも静音で長時間稼働向きです。curl、launchctl、Docker Desktop／Colima、SSH が素直に揃う Unix 系スタックで、Windows 端末群のようなドライバ摩擦が少ないのも運用の楽さに直結します。

macOS の Gatekeeper、SIP、FileVault は、長寿命のエージェントトークンをゲートウェイ横に置くときの改ざんリスクを下げます。/ready が外向き自動化の合図になるほど、その静かな境界が効いてきます。

本文の検収 curl をそのまま回せるノードを手早く確保したいなら、Mac mini M4 は 2026 年時点でも現実的な基準線です。下の CTA から ZoneMac のゲートウェイ向け構成を比較し、ここで書いた三地点検証をそのまま本番前チェックに転用してください。