openclaw update

OpenClaw sicher aktualisieren und zwischen stable/beta/dev Channels wechseln.

Falls du über npm/pnpm installiert hast (globale Installation, ohne Git-Metadaten), läuft das Update über den Paketmanager — siehe Aktualisieren.

Verwendung

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

Optionen

  • --no-restart: Gateway nach erfolgreichem Update nicht neu starten.
  • --channel <stable|beta|dev>: Update-Channel festlegen (für Git + npm; wird in der Config gespeichert).
  • --tag <dist-tag|version>: npm dist-tag oder Version nur für dieses Update überschreiben.
  • --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

Zeigt den aktiven Update-Channel + Git-Tag/Branch/SHA (bei Source-Checkouts) sowie verfügbare Updates an.

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 Ablauf zur Auswahl eines Update-Channels. Du kannst auch festlegen, ob das Gateway nach dem Update neu gestartet werden soll (Standard: ja). Wenn du dev wählst, aber kein Git-Checkout hast, bietet der Wizard an, eines zu erstellen.

Was passiert dabei?

Wenn du explizit den Channel wechselst (--channel ...), passt OpenClaw auch die Installationsmethode an:

  • dev → stellt sicher, dass ein Git-Checkout existiert (Standard: ~/openclaw, überschreibbar mit OPENCLAW_GIT_DIR), aktualisiert es und installiert die globale CLI aus diesem Checkout.
  • stable/beta → installiert von npm mit dem passenden dist-tag.

Git-Checkout-Ablauf

Channels:

  • stable: Checkt den neuesten Nicht-Beta-Tag aus, dann Build + Doctor.
  • beta: Checkt den neuesten -beta-Tag aus, dann Build + Doctor.
  • dev: Checkt main aus, dann Fetch + Rebase.

Ablauf im Detail:

  1. Erfordert einen sauberen Worktree (keine uncommitteten Änderungen).
  2. Wechselt zum gewählten Channel (Tag oder Branch).
  3. Holt Upstream-Änderungen (nur bei dev).
  4. Nur dev: Preflight-Lint + TypeScript-Build in einem temporären Worktree; falls der aktuelle Stand fehlschlägt, werden bis zu 10 Commits zurückgegangen, um den neuesten sauberen Build zu finden.
  5. Rebase auf den gewählten Commit (nur bei dev).
  6. Installiert Dependencies (pnpm bevorzugt; npm als Fallback).
  7. Baut das Projekt + die Control UI.
  8. Führt openclaw doctor als finalen Check aus.
  9. Synchronisiert Plugins mit dem aktiven Channel (dev nutzt gebündelte Extensions; stable/beta nutzt npm) und aktualisiert npm-installierte Plugins.

--update Kurzformat

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

Siehe auch