Wird aktualisiert

Halten Sie OpenClaw aktuell.

Empfohlen: openclaw update

Der schnellste Weg zum Aktualisieren. Der Befehl erkennt Ihren Installationstyp (npm oder git), ruft die neueste Version ab, führt openclaw doctor aus und startet den Gateway neu.

openclaw update

So wechseln Sie Kanäle oder wählen eine bestimmte Version aus:

openclaw update --channel betaopenclaw update --channel devopenclaw update --tag mainopenclaw update --dry-run   # Vorschau ohne Anwendung

openclaw update akzeptiert kein --verbose. Verwenden Sie für die Update-Diagnose --dry-run, um die geplanten Aktionen vorab anzuzeigen, --json für strukturierte Ergebnisse oder openclaw update status --json, um Kanal- und Verfügbarkeitsstatus zu prüfen. Das Installationsprogramm hat ein eigenes --verbose-Flag, dieses Flag ist jedoch nicht Teil von openclaw update.

--channel beta bevorzugt Beta, aber die Laufzeit fällt auf Stable/Latest zurück, wenn das Beta-Tag fehlt oder älter als die neueste stabile Version ist. Verwenden Sie --tag beta, wenn Sie das rohe npm-Beta-dist-tag für ein einmaliges Paket-Update möchten.

Bei verwalteten Plugins ist der Fallback des Beta-Kanals eine Warnung: Das Core-Update kann weiterhin erfolgreich sein, während ein Plugin seine aufgezeichnete Standard-/Latest-Version verwendet, weil keine Plugin-Beta verfügbar ist.

Siehe Entwicklungskanäle für die Kanal-Semantik.

Zwischen npm- und git-Installationen wechseln

Verwenden Sie Kanäle, wenn Sie den Installationstyp ändern möchten. Der Updater behält Ihren Status, Ihre Konfiguration, Anmeldedaten und den Workspace in ~/.openclaw; er ändert nur, welche OpenClaw-Codeinstallation die CLI und der Gateway verwenden.

# npm-Paketinstallation -> editierbarer git-Checkoutopenclaw update --channel dev # git-Checkout -> npm-Paketinstallationopenclaw update --channel stable

Führen Sie zuerst --dry-run aus, um den exakten Wechsel des Installationsmodus vorab anzuzeigen:

openclaw update --channel dev --dry-runopenclaw update --channel stable --dry-run

Der Kanal dev stellt einen git-Checkout sicher, baut ihn und installiert die globale CLI aus diesem Checkout. Die Kanäle stable und beta verwenden Paketinstallationen. Wenn der Gateway bereits installiert ist, aktualisiert openclaw update die Dienstmetadaten und startet ihn neu, sofern Sie nicht --no-restart übergeben.

Alternative: Installationsprogramm erneut ausführen

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

Fügen Sie --no-onboard hinzu, um das Onboarding zu überspringen. Um einen bestimmten Installationstyp über das Installationsprogramm zu erzwingen, übergeben Sie --install-method git --no-onboard oder --install-method npm --no-onboard.

Wenn openclaw update nach der npm-Paketinstallationsphase fehlschlägt, führen Sie das Installationsprogramm erneut aus. Das Installationsprogramm ruft den alten Updater nicht auf; es führt die globale Paketinstallation direkt aus und kann eine teilweise aktualisierte npm-Installation wiederherstellen.

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

Um die Wiederherstellung auf eine bestimmte Version oder ein dist-tag festzulegen, fügen Sie --version hinzu:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>

Alternative: manuell mit npm, pnpm oder bun

npm i -g openclaw@latest

Bevorzugen Sie openclaw update für überwachte Installationen, da es den Paketaustausch mit dem laufenden Gateway-Dienst koordinieren kann. Wenn Sie manuell aktualisieren, während ein verwalteter Gateway läuft, starten Sie den Gateway unmittelbar nach Abschluss des Paketmanagers neu, damit der alte Prozess nicht weiter aus ersetzten Paketdateien bedient.

Wenn openclaw update eine globale npm-Installation verwaltet, installiert es das Ziel zuerst in ein temporäres npm-Präfix, verifiziert das gepackte dist-Inventar und tauscht dann den sauberen Paketbaum in das echte globale Präfix ein. Dadurch wird vermieden, dass npm ein neues Paket über veraltete Dateien aus dem alten Paket legt. Wenn der Installationsbefehl fehlschlägt, versucht OpenClaw es einmal erneut mit --omit=optional. Dieser erneute Versuch hilft Hosts, auf denen native optionale Abhängigkeiten nicht kompiliert werden können, während der ursprüngliche Fehler sichtbar bleibt, falls auch der Fallback fehlschlägt.

pnpm add -g openclaw@latest

bun add -g openclaw@latest

Fortgeschrittene npm-Installationsthemen

ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp

Auto-Updater

Der Auto-Updater ist standardmäßig deaktiviert. Aktivieren Sie ihn in ~/.openclaw/openclaw.json:

{  update: {    channel: "stable",    auto: {      enabled: true,      stableDelayHours: 6,      stableJitterHours: 12,      betaCheckIntervalHours: 1,    },  },}

Der Gateway protokolliert beim Start außerdem einen Update-Hinweis (deaktivieren mit update.checkOnStart: false). Für Downgrade oder Incident-Wiederherstellung setzen Sie OPENCLAW_NO_AUTO_UPDATE=1 in der Gateway-Umgebung, um automatische Anwendungen auch dann zu blockieren, wenn update.auto.enabled konfiguriert ist. Update-Hinweise beim Start können weiterhin ausgeführt werden, sofern update.checkOnStart nicht ebenfalls deaktiviert ist.

Paketmanager-Updates, die über den Live-Gateway-Control-Plane-Handler angefordert werden, erzwingen nach dem Paketaustausch einen nicht aufgeschobenen Update-Neustart ohne Cooldown. Dadurch wird vermieden, dass ein alter In-Memory-Prozess lange genug bestehen bleibt, um Chunks lazy-loaden zu können aus einem Paketbaum, der bereits ersetzt wurde. Shell-openclaw update bleibt der bevorzugte Pfad für überwachte Installationen, da er den Dienst rund um das Update stoppen und neu starten kann.

Nach dem Update

openclaw doctor

openclaw gateway restart

openclaw health

Rollback

Version festlegen (npm)

npm i -g openclaw@<version>openclaw doctoropenclaw gateway restart

Commit festlegen (Quelle)

git fetch origingit checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"pnpm install && pnpm buildopenclaw gateway restart

Zurück zur neuesten Version: git checkout main && git pull.

Wenn Sie feststecken

• Führen Sie openclaw doctor erneut aus und lesen Sie die Ausgabe sorgfältig.
• Bei openclaw update --channel dev auf Quellcode-Checkouts bootstrapt der Updater pnpm bei Bedarf automatisch. Wenn Sie einen pnpm-/corepack-Bootstrap-Fehler sehen, installieren Sie pnpm manuell (oder aktivieren Sie corepack erneut) und führen Sie das Update erneut aus.
• Prüfen Sie: Fehlerbehebung
• Fragen Sie in Discord: https://discord.gg/clawd

Verwandt

• Installationsübersicht: alle Installationsmethoden.
• Doctor: Gesundheitsprüfungen nach Updates.
• Migration: Migrationsleitfäden für Hauptversionen.