openclaw update

OpenClaw sicher aktualisieren und zwischen stable/beta/dev-Kanälen wechseln.

Wenn du über npm/pnpm installiert hast (globale Installation, keine Git-Metadaten), erfolgen Updates über den Paketmanager-Flow in Updating.

Verwendung

openclaw update
openclaw update status
openclaw update wizard
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag beta
openclaw update --dry-run
openclaw update --no-restart
openclaw update --json
openclaw --update

Optionen

  • --no-restart: Gateway-Dienst-Neustart nach erfolgreichem Update überspringen.
  • --channel <stable|beta|dev>: Update-Kanal festlegen (Git + npm; wird in der Konfiguration gespeichert).
  • --tag <dist-tag|version>: npm-Dist-Tag oder Version nur für dieses Update überschreiben.
  • --dry-run: Geplante Update-Aktionen (Kanal/Tag/Ziel/Neustart-Flow) vorschauen, ohne Konfiguration zu schreiben, zu installieren, Plugins zu synchronisieren oder neu zu starten.
  • --json: Maschinenlesbares UpdateRunResult-JSON ausgeben.
  • --timeout <seconds>: Timeout pro Schritt (Standard 1200s).

Hinweis: Downgrades erfordern eine Bestätigung, da ältere Versionen die Konfiguration beschädigen können.

update status

Den aktiven Update-Kanal + Git-Tag/Branch/SHA (für Source-Checkouts) anzeigen, sowie Update-Verfügbarkeit.

openclaw update status
openclaw update status --json
openclaw update status --timeout 10

Optionen:

  • --json: Maschinenlesbares Status-JSON ausgeben.
  • --timeout <seconds>: Timeout für Prüfungen (Standard 3s).

update wizard

Interaktiver Flow zur Auswahl eines Update-Kanals mit Bestätigung, ob das Gateway nach dem Update neu gestartet werden soll (Standard ist Neustart). Wenn du dev ohne Git-Checkout auswählst, bietet es an, einen zu erstellen.

Was passiert

Wenn du den Kanal explizit wechselst (--channel ...), hält OpenClaw auch die Installationsmethode synchron:

  • dev → stellt einen Git-Checkout sicher (Standard: ~/openclaw, überschreibbar mit OPENCLAW_GIT_DIR), aktualisiert ihn und installiert die globale CLI aus diesem Checkout.
  • stable/beta → installiert von npm mit dem passenden Dist-Tag.

Der Gateway-Core-Auto-Updater (wenn über Konfiguration aktiviert) verwendet denselben Update-Pfad.

Git-Checkout-Flow

Kanäle:

  • stable: Den neuesten Non-Beta-Tag auschecken, dann Build + Doctor.
  • beta: Den neuesten -beta-Tag auschecken, dann Build + Doctor.
  • dev: main auschecken, dann fetch + rebase.

Auf hoher Ebene:

  1. Erfordert einen sauberen Worktree (keine uncommitteten Änderungen).
  2. Wechselt zum ausgewählten Kanal (Tag oder Branch).
  3. Holt Upstream (nur dev).
  4. Nur dev: Preflight Lint + TypeScript-Build in einem temporären Worktree; wenn der Tip fehlschlägt, geht er bis zu 10 Commits zurück, um den neuesten sauberen Build zu finden.
  5. Rebase auf den ausgewählten Commit (nur dev).
  6. Installiert Abhängigkeiten (pnpm bevorzugt; npm als Fallback).
  7. Baut + baut die Control-UI.
  8. Führt openclaw doctor als abschließende “sicheres Update”-Prüfung aus.
  9. Synchronisiert Plugins mit dem aktiven Kanal (dev verwendet gebündelte Erweiterungen; stable/beta verwendet npm) und aktualisiert npm-installierte Plugins.

--update-Kurzform

openclaw --update wird zu openclaw update umgeschrieben (nützlich für Shells und Launcher-Skripte).

Siehe auch

arrow_back
Zurück
Uninstall
Weiter
Voicecall
arrow_forward