OpenClaw aktualisieren: So hältst du dein System stabil

Updates können nerven, wenn sie mitten im Workflow die Infrastruktur zerschießen. Da sich OpenClaw aktuell schnell entwickelt (Pre-1.0), ist ein strukturierter Update-Prozess wichtig. Du willst nicht, dass dein Gateway nach einem Git-Pull plötzlich schweigt.

Behandle Updates wie das Deployment von kritischer Infrastruktur: Erst aktualisieren, dann Checks ausführen, neu starten und das Ergebnis verifizieren.

Voraussetzungen

Bevor du den Update-Befehl abschickst, solltest du diese Punkte klären und vorbereiten:

• Kenne deine Installationsmethode: global (via npm/pnpm) oder from source (via git clone).
• Kenne den Status deines Gateways: Läuft es im Vordergrund im Terminal oder als supervised service (systemd/launchd)?
• Erstelle einen Snapshot deiner Konfiguration unter ~/.openclaw/openclaw.json und deiner Credentials in ~/.openclaw/credentials/.
• Sichere deinen Workspace unter ~/.openclaw/workspace.

Schnellstart

Der empfohlene Weg ist die erneute Ausführung des Website-Installers. Er erkennt bestehende Installationen, führt das Upgrade direkt durch und startet bei Bedarf openclaw doctor.

1. Installer ausführen:

   curl -fsSL https://openclaw.ai/install.sh | bash

2. Checks verifizieren: Der Installer kümmert sich um die Migrationen. Wenn du den Onboarding-Wizard überspringen willst, hänge --no-onboard an den Befehl an.

Update-Pfade

Je nachdem, wie du OpenClaw installiert hast, gibt es verschiedene Wege.

Global Install (npm/pnpm)

Wenn du OpenClaw über einen Package Manager installiert hast, nutzt du diesen auch für das Update. Wir empfehlen nicht, Bun für die Gateway-Laufzeit zu nutzen, da dies zu Fehlern bei WhatsApp und Telegram führt.

Wähle einen Befehl für dein System:

npm i -g openclaw@latest
# ODER
pnpm add -g openclaw@latest

Nach dem Update solltest du diese Befehlsfolge ausführen, um alles zu prüfen:

openclaw doctor
openclaw gateway restart
openclaw health

Du kannst auch zwischen verschiedenen Channels wechseln oder bestimmte Versionen pinnen:

• openclaw update --channel beta
• openclaw update --channel stable
• openclaw update --tag <version>

Source Install (Git)

Für Installationen direkt aus dem Repository nutzt du am besten den integrierten Update-Befehl. Er stellt sicher, dass dein Worktree sauber ist, führt einen Rebase durch und baut das UI neu.

openclaw update

Dieser Befehl führt folgende Schritte aus:

• Wechselt zum gewählten Channel (Tag oder Branch).
• Installiert Abhängigkeiten und baut die Control UI.
• Führt openclaw doctor aus.
• Startet das Gateway standardmäßig neu (nutze --no-restart, um das zu verhindern).

Falls du manuell updaten willst, sieht die Kette so aus:

git pull
pnpm install
pnpm build
pnpm ui:build
openclaw doctor
openclaw health

Das wichtigste Tool: openclaw doctor

Egal wie du updatest, openclaw doctor ist dein Sicherheitsnetz. Der Befehl ist absichtlich simpel gehalten: Reparieren, migrieren und warnen.

Das erledigt der Doctor für dich:

• Er migriert veraltete Config-Keys oder Dateipfade.
• Er prüft DM-Policies und warnt bei riskanten Einstellungen.
• Er migriert ältere Gateway-Services (z. B. von Legacy-schtasks zu modernen OpenClaw-Services).
• Er stellt unter Linux sicher, dass User Lingering für systemd aktiv ist.

Fehlerbehebung

Falls nach dem Update Probleme auftreten, helfen diese Schritte:

• Rebase-Fehler: Wenn der automatische Rebase fehlschlägt, bricht das Gateway das Update ab und startet mit der alten Version neu. Bereinige in diesem Fall deinen Git-Status manuell.
• Gateway startet nicht: Führe openclaw doctor erneut aus. Oft erkennt das Tool das Problem und schlägt direkt die passende Lösung vor.
• Fehlende Berechtigungen: Unter Linux/WSL2 kann ein Neustart des User-Services helfen: systemctl --user restart openclaw-gateway.service.
• Rollback nötig: Falls eine Version fehlerhaft ist, installiere eine spezifische ältere Version mit npm i -g openclaw@<version> oder nutze Git, um zu einem bestimmten Datum zurückzukehren: git checkout "$(git rev-list -n 1 --before="2026-01-01" origin/main)".

Hast du spezifische Fragen zu deinem Setup? Nutze den AI Setup Assistant für direkte Hilfe.

Nächste Schritte

• Development channels – Details zu den Release-Zyklen.
• Doctor – Alle Funktionen des Diagnose-Tools.
• Gateway runbook – Gateway-Management im Detail.
• Troubleshooting – Hilfe bei komplexeren Fehlern.