OpenClaw ゲートウェイのブルー／グリーンロールアウト—第2ポート、ヘルスゲート・カットオーバー、レンタルクラウド Mac 上の launchd（2026-05-08）
2026年の OpenClaw macOS ゲートウェイは二正面です。デスクトップアプリがライフサイクルを司り、常駐デーモンは外部 CLI インストールとともに launchd の下にあります。 この分離はブルー／グリーンに好都合です。本番を 127.0.0.1:18764 に置いたまま、候補を 127.0.0.1:18765 で起動し、合成プローブで準備を証明してからループバック利用者や上流プロキシだけを付け替えればよく、第二の物理 MacLogin mini を増やす必要はありません。 本稿は 2026年5月時点で香港・日本・韓国・シンガポール・米国のテナントが採用するマトリクスをまとめ、Webhook ワーカー・Canvas フック・CLI 自動化をアップグレード中も安定させます。
関連読み：アプリと CLI の引き継ぎ、ヘルス curl 監視、グレースフルシャットダウンとドレイン、ハブ OpenClaw トピック索引。サイト：ヘルプ、料金、VNC。
混雑したゲートウェイではブルー／グリーンがインプレース再起動に勝つ理由
小さなパッチならインプレースの launchctl kickstart -k で足りますが、Node メジャー昇級・モデル許可リスト変更・Webhook URL 移行などリスクの高い更新は並行プロセスが有利です。ブルー／グリーンは TLS コンテキストのコンパイル済み状態、モデルキャッシュのウォームアップ、ワーカーキューの検証まで含む「暖かい」一式を、顧客トラフィックが触れる前に用意できます。
ポート計画と launchd ラベル・マトリクス
| 色 | 待受アドレス | launchd ラベル（例） | 用途 |
|---|---|---|---|
| ブルー（安定） | 127.0.0.1:18764 | ai.openclaw.gateway.blue | 本番トラフィック |
| グリーン（候補） | 127.0.0.1:18765 | ai.openclaw.gateway.green | ステージング検証 |
| 可観測性 | どちらでも | N/A | ヘルスはループバックに拘束し、公開は localhost 硬化 に沿ってプロキシのみ経由 |
トラフィックを切り替える前のヘルスプローブ契約
譲れない信号を定義してください：/healthz（またはプロジェクト固有）での HTTP 200、CLI と一致する JSON のバージョン欄、予算内レイテンシでのモデル ping、該当時は Webhook セルフテストのエコー。スクラップ間隔を二度以上踏んで遅いリークを捉えます。
セカンダリ LaunchAgent plist（ユーザー単位）
動いている plist を複製し、Label、StandardOutPath、StandardErrorPath、ポートと設定ルートを固定する環境変数を変更します。ThrottleInterval はクラッシュループが syslog を叩き潰さない程度に。環境変数ガイド に揃えれば両色とも正しいシークレット金庫を継承します。
9 ステップ・カットオーバー・ランブック
- スナップショット： 現行 plist、バイナリハッシュ、Node 版。
- デプロイ： 候補ビットを版付きディレクトリへ。安定パスは上書きしない。
- インストール： グリーン用 plist をテナントユーザーで
launchctl bootstrap。 - 検証： ローカルで curl、mTLS 有効ならそれも。
- リプレイ： 合成 Webhook をグリーンだけへ。
- ドレイン： 2026年4月のドレイン記事の順でブルーを空ける。
- 昇格： localhost フォワーダまたは上流プロキシの upstream を付け替える。
- 観察： 勝利宣言の前に 30〜60 分エラーバジェットを見る。
- 降格： ブルーのバイナリを下げるか、即時ロールバック用に暖機維持。
5 分以内に終えるロールバック演練
昇格の逆を練習してください：上流ポインタをブルーへ戻し、キューをドレインした後にだけ launchctl bootout でグリーンを止め、Webhook プロバイダが 5xx 再試行をやめるまでログを追尾します。DNS・ループバック・リバースプロキシの責務境界を文書化しないとインシデントが SLA を超えます。
可観測性：色ごとの JSONL ストリーム差分
両デーモンが JSON Lines を出すなら、ロガー設定で color=blue|green を付与します。香港・日本・韓国・シンガポール・米国のタイムゾーンをまたぐ SIEM でも、どのプロセスのノイズか推測せずエラー率を重ねられます。
FAQ
これで Kubernetes は不要ですか？ 単一ホストのリースには単純なパターンで足ります。K8s テナントは Pod のブルー／グリーンを使ってください。
公開 TLS Webhook は？ 本パターンと TLS リバースプロキシの指針 を組み合わせ、エッジが健全なループバックポートへ上流を向けるようにします。
ゲートウェイをもっと隔離したい？ 騒がしいワークロード向けに JP や US のキャパを足すなら 料金 から。
OpenClaw ハブ、ヘルプ、リージョンが効く理由
OpenClaw ハブ に社内ランブックとポート表を載せ続ければ、新しいエンジニアも同じ行列を継承します。東京のブローカーに近い低遅延自動化ならリースをリージョンで固定し、Webhook RTT を読みやすくするとカットオーバーリスクも下がります。
