Zum Hauptinhalt springen
OpenClaw liefert drei Update-Kanäle aus:
  • stable: npm-dist-tag latest. Für die meisten Benutzer empfohlen.
  • beta: npm-dist-tag beta, wenn er aktuell ist; wenn beta fehlt oder älter ist als die neueste stabile Version, fällt der Update-Ablauf auf latest zurück.
  • dev: beweglicher Stand von main (git). npm-dist-tag: dev (wenn veröffentlicht). Der Branch main ist für Experimente und aktive Entwicklung gedacht. Er kann unvollständige Features oder Breaking Changes enthalten. Verwenden Sie ihn nicht für Produktions-Gateways.
Wir liefern stabile Builds normalerweise zuerst nach beta aus, testen sie dort und führen dann einen expliziten Promotion-Schritt aus, der den geprüften Build nach latest verschiebt, ohne die Versionsnummer zu ändern. Maintainer können bei Bedarf auch eine stabile Version direkt nach latest veröffentlichen. Dist-tags sind die Quelle der Wahrheit für npm-Installationen.

​
Kanäle wechseln

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
--channel speichert Ihre Auswahl dauerhaft in der Konfiguration (update.channel) und richtet die Installationsmethode aus:
  • stable (Paketinstallationen): aktualisiert über den npm-dist-tag latest.
  • beta (Paketinstallationen): bevorzugt den npm-dist-tag beta, fällt aber auf latest zurück, wenn beta fehlt oder älter ist als der aktuelle stabile Tag.
  • stable (git-Installationen): checkt den neuesten stabilen git-Tag aus, ausgenommen semver-Prerelease-Tags wie -alpha.N, -beta.N, -rc.N, -dev.N, -next.N, -preview.N, -canary.N, -nightly.N und andere Prerelease- Suffixe.
  • beta (git-Installationen): bevorzugt den neuesten beta-git-Tag, fällt aber auf den neuesten stabilen git-Tag zurück, wenn beta fehlt oder älter ist.
  • dev: stellt einen git-Checkout sicher (standardmäßig ~/openclaw oder $OPENCLAW_HOME/openclaw, wenn OPENCLAW_HOME gesetzt ist; mit OPENCLAW_GIT_DIR überschreiben), wechselt zu main, rebast auf upstream, baut und installiert die globale CLI aus diesem Checkout.
Wenn Sie stable und dev parallel verwenden möchten, behalten Sie zwei Klone und richten Sie Ihr Gateway auf den stabilen aus.

​
Einmalige Version oder Tag ansteuern

Verwenden Sie --tag, um einen bestimmten dist-tag, eine Version oder eine Paketspezifikation für ein einzelnes Update anzusteuern, ohne Ihren gespeicherten Kanal zu ändern: 
# Install a specific version
openclaw update --tag 2026.4.1-beta.1

# Install from the beta dist-tag (one-off, does not persist)
openclaw update --tag beta

# Switch to the moving GitHub main checkout
openclaw update --channel dev

# Install a specific npm package spec
openclaw update --tag openclaw@2026.4.1-beta.1

# Install from GitHub main once without persisting the channel
openclaw update --tag main
Hinweise:
  • --tag gilt nur für Paketinstallationen (npm). Git-Installationen ignorieren es.
  • Der Tag wird nicht dauerhaft gespeichert. Ihr nächstes openclaw update verwendet wie gewohnt Ihren konfigurierten Kanal.
  • Bei Paketinstallationen packt OpenClaw GitHub-/git-Quellspezifikationen vor der gestuften npm-Installation in einen temporären Tarball vor. Verwenden Sie --channel dev oder --install-method git --version main, wenn Sie den beweglichen main- Checkout als dauerhafte Installation möchten.
  • Downgrade-Schutz: Wenn die Zielversion älter als Ihre aktuelle Version ist, fragt OpenClaw nach einer Bestätigung (mit --yes überspringen).
  • --channel beta unterscheidet sich von --tag beta: Der Kanalablauf kann auf stable/latest zurückfallen, wenn beta fehlt oder älter ist, während --tag beta für diesen einen Lauf den rohen dist-tag beta ansteuert.

​
Probelauf

Zeigen Sie in der Vorschau an, was openclaw update tun würde, ohne Änderungen vorzunehmen: 
openclaw update --dry-run
openclaw update --channel beta --dry-run
openclaw update --tag 2026.4.1-beta.1 --dry-run
openclaw update --dry-run --json
Der Probelauf zeigt den effektiven Kanal, die Zielversion, die geplanten Aktionen und ob eine Downgrade-Bestätigung erforderlich wäre.

​
Plugins und Kanäle

Wenn Sie mit openclaw update den Kanal wechseln, synchronisiert OpenClaw auch Plugin- Quellen:
  • dev bevorzugt gebündelte Plugins aus dem git-Checkout.
  • stable und beta stellen per npm installierte Plugin-Pakete wieder her.
  • Per npm installierte Plugins werden aktualisiert, nachdem das Core-Update abgeschlossen ist.

​
Aktuellen Status prüfen

openclaw update status
Zeigt den aktiven Kanal, die Installationsart (git oder Paket), die aktuelle Version und die Quelle (Konfiguration, git-Tag, git-Branch oder Standard).

​
Best Practices für Tagging

  • Taggen Sie Releases, auf denen git-Checkouts landen sollen (vYYYY.M.PATCH für stable, vYYYY.M.PATCH-beta.N für beta; benannte semver-Prerelease-Suffixe wie -alpha.N, -rc.N und -next.N sind keine stabilen Ziele).
  • Ältere numerische stabile Tags wie vYYYY.M.PATCH-1 und v1.0.1-1 werden aus Kompatibilitätsgründen weiterhin als stabile git-Tags erkannt.
  • vYYYY.M.PATCH.beta.N wird aus Kompatibilitätsgründen ebenfalls erkannt, bevorzugen Sie aber -beta.N.
  • Halten Sie Tags unveränderlich: Verschieben oder wiederverwenden Sie niemals einen Tag.
  • npm-dist-tags bleiben die Quelle der Wahrheit für npm-Installationen:
    • latest -> stable
    • beta -> Kandidaten-Build oder beta-first-stabiler Build
    • dev -> main-Snapshot (optional)

​
Verfügbarkeit der macOS-App

Beta- und dev-Builds enthalten möglicherweise keine macOS-App-Version. Das ist in Ordnung:
  • Der git-Tag und der npm-dist-tag können trotzdem veröffentlicht werden.
  • Weisen Sie in den Release Notes oder im Changelog auf „kein macOS-Build für diese Beta“ hin.

​
Verwandt