OpenClaw 2026 Cloud-Mac Versions-Upgrade: Speicher-Vorprüfung, launchd-Restjobs und update restart health Checkliste

Anders als bei Erstinstallation onboard oder launchd-Token-Fehlersuche fokussiert dieser Text den Pfad „Gateway läuft, Rolling Upgrade nötig“: Sie melden sich per SSH auf dem gemieteten Mac an, führen openclaw update aus und erwarten Rückkehr in Produktion – stattdessen eine launchd-Neustart-Schleife.

In Postmortems werden diese fünf Schmerzpunkte oft unterschätzt:

• plugin-runtime-deps ENOSPC: Versionen ab 2026.4.24 entpacken bundled Abhängigkeiten nach ~/.openclaw/plugin-runtime-deps. Bei zu wenig Speicher bricht der Vorgang mittendrin ab; Gateway wirkt ready, ist aber unhealthy (openclaw#71835).
• stale ai.openclaw.update.* Jobs: Nach Beta-Upgrades bleiben updater jobs in launchd, triggern Gateway-Neustarts mit exit 127, gateway status --deep schlägt fehl (openclaw#81859).
• Mixed-Version false-ready: CLI ist neu, Gateway-Prozess alt – oder Plugin-Laden scheitert, ohne „Erfolg“ zu blockieren; Remote-Clients hängen bei Health Check pending.
• Mehrere Node-Installationspfade: Seit 2026.5.20 nutzt openclaw update bevorzugt den Node des Gateway-Dienstes; koexistieren Homebrew- und fnm-Node, kann restart auf falsche Binaries wechseln.
• Mietdauer und Zeitfenster: Bei Tages-/Wochenmiete und ENOSPC mid-upgrade ist das Fenster für Erweiterung oder zweiten Knoten minimal – Puffer vorab in der Mietmatrix einplanen.

Merksatz für On-Call: „Erst df, dann update, deep status, doctor räumt jobs, health 200 – fertig.“ Wer Vorprüfung oder Restjob-Bereinigung überspringt, verwandelt zehn Minuten Upgrade in stundenlange Nacharbeit.

Bevor Sie openclaw update drücken, gleichen Sie Speicher, Rechenleistung und Zeitfenster in der Tabelle ab – statt mitten im Upgrade in der Konsole zu erweitern.

Bei parallel laufendem WeChat-ClawBot-Kanal neue QR-Bindings während des Upgrade-Fensters pausieren; nach bestandener Gateway restart health openclaw gateway restart und Kanal-Reconnect.

Vor dem Upgrade per nicht-interaktivem Skript Speicher und staging-Verzeichnis prüfen – kein Mitternachts-Pager.

df -h / | awk 'NR==2{print "avail="$4,"use="$5}'
du -sh ~/.openclaw/plugin-runtime-deps 2>/dev/null || echo "no staging yet"
launchctl list | grep -E 'openclaw\.(gateway|update)'
openclaw --version
openclaw gateway status --json | head -c 400

• Referenz: plugin-runtime-deps-Pfad — Standard ~/.openclaw/plugin-runtime-deps, alternativ OPENCLAW_PLUGIN_STAGE_DIR auf separates Volume; pro großem Upgrade ≥ 8–15 GB freier Speicher (abhängig von Plugin-Anzahl).
• Referenz: typisches ENOSPC-Log — failed to install bundled runtime deps: Error: ENOSPC: no space left on device; dann nicht wiederholt update, sondern erweitern oder unvollständiges staging per rm -rf entfernen und erneut versuchen.
• Referenz: Root-Warnschwelle — Produktion langfristig < 80 % Belegung; ab 85 % steigen Fehlerraten bei OpenClaw-Upgrade und Xcode-Cache deutlich.

1. Config- und Token-Snapshot: cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak.$(date +%Y%m%d); aktuelles openclaw --version und gateway status --deep JSON notieren.
2. Preflight ausführen: Root frei ≥ 15 GB; kein abnormal großes staging; launchd openclaw-Jobs auflisten.
3. Update in Nebenzeit: openclaw update (oder npm update -g openclaw / brew upgrade openclaw, konsistent mit Installationspfad); restart-health-Abschnitt in CLI-Ausgabe beobachten.
4. deep status Probe: openclaw gateway status --deep; Connectivity probe ok; bei stale updater job nächstes Kapitel bereinigen, dann kickstart.
5. doctor und health HTTP: openclaw doctor; curl -sf -H "Authorization: Bearer token $(openclaw config get gateway.auth.token)" http://127.0.0.1:18789/health liefert 200.
6. Versions-Baseline: CLI- und Gateway-hello-Version im Change-Log; auf Preisseite prüfen, ob dauerhaft 1 TB nötig; Remote-Client-Pairing-Test wieder aufnehmen.

openclaw update
openclaw gateway status --deep
openclaw doctor
curl -sf http://127.0.0.1:18789/health
launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

Seit 2026.5.20 versucht openclaw update restart health auch bei ein Version Protokoll-Skew zwischen CLI und Gateway und bevorzugt den Node des Gateway-Dienstes – weniger „update ok, Gateway auf falschem Node“.

Zeigt gateway status --deep connectivity failed und launchctl list hohe RunCount bei ai.openclaw.update.*, zuerst stale updater job laut Diagnose entfernen, dann LaunchAgent reparieren.

Bei Mixed Version nicht nur CLI-„ready“ vertrauen: restart health und Plugin-Ladeergebnis sind maßgeblich. Wenn mehrfaches gateway restart nicht hilft, im Wartungsfenster openclaw gateway install --force und erneut openclaw doctor.

OpenClaw-Upgrades an Heim-Macs oder schlafende Laptops binden OS-Updates und Fragmentierung ins Upgrade-Fenster. Auf oversellte VPS oder Nicht-macOS fehlen Apple-Kanäle und native launchd-Pfade. Teams, die wiederholbare updates, sofortige Speichererweiterung und Bare-Metal-Rechenleistung brauchen, fahren auf JEXCLOUD Multi-Region Cloud-Macs mit den sechs Schritten dieses Artikels oft ruhiger: vor ENOSPC 1 TB/2 TB oder M4 Pro parallel, ca. 120 Sekunden Bereitstellung, projektweise flexible Miete. Pakete auf der JEXCLOUD-Preisseite.