Immutable Tags · Compose-Disziplin · Smoke vor Traffic · Gateway-taugliches Rollback
Solo-Betreiber und kleine Teams auf einem VPS erleben oft Überraschungs-Upgrades, weil :latest nachts ein neues Gateway zieht. Der Artikel erklärt warum schwebende Tags Reproduzierbarkeit zerstören, wie Sie semver oder Digest in Compose und Kubernetes pinnen, was vor einem Image-Wechsel zu sichern ist, wie Dual-Instance-Smoke in einem ruhigen Fenster läuft und eine Rollback-Shell, die den vorherigen Tag zurückbringt und Health sowie Kanäle erneut prüft. Cross-Lesen mit nachhaltigen Upgrades, VPS-Docker-Installation, Exit 137 und WASM-Fenster, Gateway-Doctor-Triage.
:latest Production-OpenClaw untergräbtSchwebende Tags verbergen drei Drift-Arten: die Gateway-Binäroberfläche Ihrer Skills, Plugin- oder Kanalschemas Ihrer Callbacks und Container-Basislibs um Node. „Immer neuestes“ zu ziehen verwandelt Vorfälle in Rätsel: Layer stimmen zwischen Hosts selten überein; Postmortems leiden und das Vertrauen von Kollegen mit IM/Webhooks bricht.
| Schicht | Bewegt sich unter :latest | Erstes Symptom |
|---|---|---|
| Gateway-API | CLI-Flags, Config-Schema, Control-UI-Routen | Skills scheitern nach ungeplantem Neustart |
| Kanäle | Webhook-Handshake-Timing, Discord-Intent-Defaults | Stille Nachrichtenverluste bis jemand die Queue sieht |
| Runtime | Node-Patch-Level, libc-Kompatibilität | Erst-WASM oder native Deps spizen CPU oder OOM |
Production-OpenClaw gehört zu Images, die Sie zweimal gleich benennen können: einmal in Git und einmal auf dem Host—Digest optional, aber bewusst gewählt.
Hinweis: Zero-Downtime-Cluster verschieben Sie mit DR und Zero-Downtime-Upgrades; diese Seite zielt auf einzelne oder doppelte Compose-Stacks auf einem VPS.
Pro Umgebung nur eine unveränderliche Referenz wählen: entweder ein Release-Tag, das Sie getestet haben (v2026.4.2), oder einen Digest, wenn Byte-Identität über Regionen nötig ist. Speichern Sie diese Zeichenkette neben der Compose-Datei und spiegeln Sie sie in Ihren Incident-Tickets.
services:
openclaw:
image: ghcr.io/openclaw/openclaw:v2026.4.2
pull_policy: missing
pull_policy: missing setzen oder Digest pinnen, wenn Automation laufende Container nicht ändern darf.Achtung: nur openclaw.json zu bearbeiten, während das Image still voranschreitet, zählt weiterhin als unkontrolliertes Upgrade—Konfig-Revision und Image-Referenz im selben Change-Ticket pinnen.
Vor jedem docker compose pull den Umfang einfrieren, damit Rollback weiß, was „gut“ bedeutete.
Konfig-Volumen: Snapshot von ~/.openclaw oder dem Mount-Pfad; Dateilisten-Prüfsumme erfassen, falls Ihr Backup-Tool das unterstützt.
Workspace: Skill-Verzeichnisse notieren sowie Secrets außerhalb des Volumens, die Compose über env_file einbindet.
Kanäle: Webhook-URLs exportieren und prüfen, dass Erreichbarkeit im Wartungsfenster zur Kommunikation passt.
Smoke-Liste: zwei Skills und ein Kanal-Sende-Empfang-Paar wählen, die vor Produktions-Traffic bestehen müssen.
Ressourcen: Speicher-Puffer für Erstlauf-Kompilations-Spitzen bestätigen, siehe Exit-137-Artikel.
Das Kandidaten-Image als zweiten Projektnamen oder alternative Compose-Datei auf Nicht-Produktions-Ports laufen lassen. Traffic erst nach bestandenem Smoke umlegen.
| Signal | Wo nachsehen | Bestehens-Kriterium |
|---|---|---|
| Gateway-Health | curl Loopback-Health-Endpunkt | HTTP 200 über mehrere Proben stabil |
| Kanalstatus | Gateway-Logs oder CLI-Status | Kein Reconnect-Sturm; Callbacks bestätigt |
| Skill-Audit | Skill-Runner-Ausgabe | Keine neuen Deny-Regeln gegenüber Staging-Erwartung |
| Control-UI | Browser gegen feste Origin | Nach Proxy-Regeln kein Nicht-Loopback-Mismatch |
Das Promotion-Fenster kurz halten; lange Überlappungen verstärken Drift zwischen Datenbanken oder Queues, die Ihr Gateway berührt.
Rollback wie ein geübtes Skript behandeln, nicht improvisieren. Image-Referenz auf den letzten bekannt guten Tag setzen, explizit pullen, Container neu erstellen, dann Health nachweisen, bevor Sie die Wiederherstellung kommunizieren.
export OPENCLAW_IMAGE_TAG="v2026.4.1" docker compose pull openclaw docker compose up -d --force-recreate openclaw curl -sf http://127.0.0.1:18789/health
Wenn neben Ihrem VPS-Stack von macOS abhängige Lasten laufen, Gateway-Verfügbarkeit von Compile-Pools trennen, damit Rollback-Diskussionen fokussiert bleiben. Für dedicated Remote-Mac-Kapazität mit klareren Grenzen als Heimhardware Mac-Mini-Mietpreise und Bestellung neben dieser Gateway-Disziplin prüfen.
Der nachhaltige Upgrade-Guide behandelt Kanäle, Update-Rhythmus und Backups über Umgebungen hinweg. Dieser Text fokussiert Docker-Image-Pinning, Staging-Smoke und Rollback-Befehle für VPS-Betrieb.
Für die meisten Teams getestete semver-Tags; zu Digests wechseln, wenn Regulierung oder Multi-Region-Parität identische Bytes verlangen. Die Referenz in jedem Fall neben Compose in Git dokumentieren.
Erststart und Dimensionierung stehen in OpenClaw v2026.4 VPS Docker Installation; Speicher-Spitzen beim Upgrade überschneiden sich mit Exit 137 und WASM-Fenster.