Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 beta
openclaw update --channel dev
openclaw update --tag main
openclaw 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-Checkout
openclaw update --channel dev

# git-Checkout -> npm-Paketinstallation
openclaw update --channel stable
Führen Sie zuerst --dry-run aus, um den exakten Wechsel des Installationsmodus vorab anzuzeigen: 
openclaw update --channel dev --dry-run
openclaw 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

OpenClaw behandelt gepackte globale Installationen zur Laufzeit als schreibgeschützt, selbst wenn das globale Paketverzeichnis für den aktuellen Benutzer beschreibbar ist. Plugin-Paketinstallationen liegen in OpenClaw-eigenen npm-/git-Wurzeln unter dem Benutzerkonfigurationsverzeichnis, und der Gateway-Start verändert den OpenClaw-Paketbaum nicht.Einige Linux-npm-Setups installieren globale Pakete unter root-eigenen Verzeichnissen wie /usr/lib/node_modules/openclaw. OpenClaw unterstützt dieses Layout, da Plugin-Installations-/Update-Befehle außerhalb dieses globalen Paketverzeichnisses schreiben.
Geben Sie OpenClaw Schreibzugriff auf seine Konfigurations-/Status-Wurzeln, damit explizite Plugin-Installationen, Plugin-Updates und Doctor-Bereinigungen ihre Änderungen dauerhaft speichern können:
ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp
Vor Paket-Updates und expliziten Plugin-Installationen versucht OpenClaw nach bestem Bemühen eine Speicherplatzprüfung für das Zielvolume. Wenig Speicherplatz erzeugt eine Warnung mit dem geprüften Pfad, blockiert das Update jedoch nicht, da Dateisystem-Quotas, Snapshots und Netzwerkvolumes sich nach der Prüfung ändern können. Die tatsächliche Paketmanager-Installation und die Post-Install-Verifizierung bleiben maßgeblich.

​
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,
    },
  },
}
KanalVerhalten
stableWartet stableDelayHours und wendet dann mit deterministischem Jitter über stableJitterHours hinweg an (verteilter Rollout).
betaPrüft alle betaCheckIntervalHours (Standard: stündlich) und wendet sofort an.
devKeine automatische Anwendung. Verwenden Sie openclaw update manuell.
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

1
Doctor ausführen
2
openclaw doctor
3
Migriert Konfiguration, prüft DM-Richtlinien und überprüft die Gateway-Gesundheit. Details: Doctor
4
Gateway neu starten
5
openclaw gateway restart
6
Verifizieren
7
openclaw health

​
Rollback

​
Version festlegen (npm)

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart
npm view openclaw version zeigt die aktuell veröffentlichte Version.

​
Commit festlegen (Quelle)

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
openclaw 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