OpenClaw Gateway Blue-Green-Rollout mit zweitem Port, health-gesteuerter Umschaltung und launchd auf gemietetem Cloud Mac (2026-05-08)

Die OpenClaw-Gateway-Geschichte unter macOS 2026 ist zweigeteilt: Die Desktop-App steuert den Lebenszyklus, der Langläufer-Daemon bleibt unter launchd mit externen CLI-Installationen. Das ist gut für Blue-Green: Sie starten einen Kandidaten-Gateway auf 127.0.0.1:18765, während Produktion auf 127.0.0.1:18764 bleibt, beweisen Bereitschaft mit synthetischen Probes und hängen Loopback-Verbraucher oder Upstream-Proxys um — ohne zweiten physischen MacLogin-Mini. Dieses Mai-2026-Runbook codiert die Matrix, die MacLogin-Mieter in Hongkong, Japan, Korea, Singapur und den USA nutzen, um Webhook-Worker, Canvas-Hooks und CLI-Automatisierungen während Upgrades stabil zu halten.

Querverweise: App + CLI-Übergabe, Health-Curl-Monitoring, Graceful Shutdown & Drain, und der Hub OpenClaw-Themenindex. Außerdem Hilfe und Preise.

Warum Blue-Green In-Place-Neustarts auf stark frequentierten Gateways schlägt

In-Place-launchctl kickstart -k gewinnt bei kleinen Patches, aber riskante Upgrades (Node-Major, Model-Allowlist-Änderungen, Webhook-URL-Migrationen) profitieren von Side-by-Side-Prozessen. Blue-Green liefert einen voll warmen Container: TLS-Kontexte kompiliert, Model-Caches vorgewärmt und Worker-Warteschlangen validiert, bevor Kundenverkehr die Build berührt.

Portplan und launchd-Label-Matrix

Farbe	Listenadresse	launchd-Label (Beispiel)	Zweck
Blau (stabil)	127.0.0.1:18764	ai.openclaw.gateway.blue	Produktionstraffic
Grün (Kandidat)	127.0.0.1:18765	ai.openclaw.gateway.green	Staging-Validierung
Observability	Entweder	N/A	Health an Loopback binden; öffentlich nur über kontrollierte Proxys gemäß Localhost-Härtung

Health-Probe-Vertrag vor Traffic-Umschaltung

Definieren Sie nicht verhandelbare Signale: HTTP 200 auf /healthz (oder projektspezifisch), JSON-Versionsfeld passend zur CLI, erfolgreicher Model-Ping unter Latenzbudget und Webhook-Selbsttest-Echo falls zutreffend. Probes mindestens zwei Scrape-Intervalle lang laufen lassen, um langsame Lecks zu erwischen.

Sekundäres LaunchAgent-Plist-Muster (pro Nutzer)

Duplizieren Sie das funktionierende Plist, ändern Sie Label, StandardOutPath, StandardErrorPath und Umgebungs-Exports für Port + Config-Root. Halten Sie ThrottleInterval vernünftig, damit Crash-Loops syslog nicht fluten. Passen Sie zu Umgebungsvariablen unter launchd, damit beide Farben das richtige Secrets-Vault erben.

Neun-Schritte-Cutover-Runbook

1. Snapshot aktuelles Plist, Binary-Hash und Node-Version.
2. Deploy Kandidaten-Bits in ein versioniertes Verzeichnis; stabile Pfade nicht überschreiben.
3. Installieren grünes Plist; launchctl bootstrap als Mieterbenutzer.
4. Verifizieren Health-Endpunkte lokal mit curl + mTLS falls aktiv.
5. Replay synthetischer Webhook-Payloads nur gegen Grün.
6. Drain Blau nach April-2026-Drain-Artikelsequenz.
7. Promoten durch Umhängen von Localhost-Forwardern oder Upstream-Proxy-Blöcken.
8. Beobachten Fehlerbudget 30–60 Minuten vor Siegeserklärung.
9. Demoten blaue Binaries oder warm halten für sofortiges Rollback.

Rollback-Übungen unter fünf Minuten

Üben Sie die Umkehr der Promotion: Upstream-Zeiger auf Blau zurück, launchctl bootout Grün erst nach Queue-Drain, Logs weiter tailen bis Webhook-Anbieter keine 5xx-Bursts mehr wiederholen. Dokumentieren Sie DNS vs. Loopback vs. Reverse-Proxy-Schichten — Verwirrung dort streckt Vorfälle über SLAs.

Observability: JSONL-Streams zwischen Farben diffen

Wenn beide Daemons JSON-Zeilen ausgeben, taggen Sie jeden Datensatz mit color=blue|green auf Logger-Ebene. SIEM-Teams über HK, JP, KR, SG und US-Zeitzonen können Fehlerraten überlagern ohne zu raten, welcher Prozess rauschte.

FAQ

Ersetzt das Kubernetes? Nein — Single-Host-Leases nutzen einfachere Muster; K8s-Mieter sollten Pod-Blue-Green einsetzen.

Öffentliche TLS-Webhooks? Kombinieren Sie mit TLS-Reverse-Proxy-Leitfaden, damit die Edge den gesunden Loopback-Port upstream schaltet.

Wo mehr isolierte Gateways mieten? Start bei Preisen, um JP- oder US-Kapazität für laute Workloads hinzuzufügen.

OpenClaw-Hub, Hilfe und warum Regionen zählen

Aktualisieren Sie den OpenClaw-Hub mit internen Run-Labels, damit neue Engineers dieselbe Port-Matrix erben. Wenn latenzkritische Automationen näher an Tokyo-Brokern als US-West-Küste laufen, feste Leases pro Region senken Cutover-Risiko, weil Webhook-RTTs planbar bleiben.