OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Release-Kanäle

OpenClaw wird über vier Update-Kanäle ausgeliefert:

  • stable: npm-Dist-Tag latest. Für die meisten Benutzer empfohlen.
  • extended-stable: npm-Dist-Tag extended-stable. Ein vollständig neuer, nachlaufender Paketkanal für unterstützte Monate. Er ist ausschließlich für Pakete vorgesehen und die Installation erfolgt nur im Vordergrund. Eine gespeicherte Auswahl erhält schreibgeschützte Update-Hinweise, wenn update.checkOnStart aktiviert ist, wendet Updates jedoch nie automatisch an.
  • beta: npm-Dist-Tag beta. Fällt auf latest zurück, wenn beta fehlt oder älter als die aktuelle stabile Version ist.
  • dev: fortlaufend aktualisierter Stand von main (Git). npm-Dist-Tag dev, sofern veröffentlicht. main ist für Experimente und die aktive Entwicklung vorgesehen; der Kanal kann unvollständige Funktionen oder inkompatible Änderungen enthalten. Verwenden Sie ihn nicht für produktive Gateways.

Stabile Builds werden normalerweise zuerst über beta ausgeliefert, dort geprüft und anschließend ohne Erhöhung der Versionsnummer zu latest hochgestuft. Maintainer können auch direkt unter latest veröffentlichen. Dist-Tags sind die maßgebliche Quelle für npm-Installationen.

Kanäle wechseln

bash
openclaw update --channel stableopenclaw update --channel extended-stableopenclaw update --channel betaopenclaw update --channel dev

--channel speichert die Auswahl als update.channel in der Konfiguration und steuert beide Installationspfade:

Kanal npm-/Paketinstallationen Git-Installationen
stable Dist-Tag latest neuestes stabiles Git-Tag (ausgenommen -alpha.N, -beta.N, -rc.N, -dev.N, -next.N, -preview.N, -canary.N, -nightly.N und andere benannte Vorabversionssuffixe)
extended-stable löst den öffentlichen npm-Selektor extended-stable auf, verifiziert das exakt ausgewählte Paket und installiert genau diese Version. Schlägt ohne Rückgriff auf latest, beta oder dev sicher fehl. nicht unterstützt: OpenClaw lässt den Checkout unverändert und fordert Sie auf, eine Paketinstallation zu verwenden
beta Dist-Tag beta, mit Rückgriff auf latest, wenn beta fehlt oder älter ist neuestes Beta-Git-Tag, mit Rückgriff auf das neueste stabile Git-Tag, wenn Beta fehlt oder älter ist
dev Dist-Tag dev (selten; die meisten Dev-Benutzer verwenden Git-Installationen) ruft Änderungen ab, führt einen Rebase des Checkouts auf den vorgelagerten Branch main durch, erstellt den Build und installiert die globale CLI neu

Bei Git-Installationen über dev ist der standardmäßige Checkout ~/openclaw (oder $OPENCLAW_HOME/openclaw, wenn OPENCLAW_HOME gesetzt ist); überschreiben Sie ihn mit OPENCLAW_GIT_DIR.

Einmalig eine Version oder ein Tag auswählen

Verwenden Sie --tag, um für ein einzelnes Update ein bestimmtes Dist-Tag, eine Version oder eine Paketspezifikation auszuwählen, ohne den gespeicherten Kanal zu ändern:

bash
# Eine bestimmte Version installierenopenclaw update --tag 2026.4.1-beta.1 # Vom Beta-Dist-Tag installieren (einmalig, wird nicht gespeichert)openclaw update --tag beta # Zum fortlaufend aktualisierten GitHub-Main-Checkout wechseln (dauerhaft)openclaw update --channel dev # Eine bestimmte npm-Paketspezifikation installierenopenclaw update --tag openclaw@2026.4.1-beta.1 # Einmalig von GitHub Main installieren, ohne den Kanal zu speichernopenclaw update --tag main

Hinweise:

  • --tag gilt nur für Paketinstallationen (npm); Git-Installationen ignorieren die Option.
  • Das Tag wird nicht gespeichert; das nächste openclaw update verwendet den konfigurierten Kanal.
  • --tag main wird für diesen einen Durchlauf der npm-kompatiblen Spezifikation github:openclaw/openclaw#main zugeordnet. Verwenden Sie für eine dauerhaft fortlaufend aktualisierte main-Installation openclaw update --channel dev (Paketinstallationen wechseln zu einem Git-Checkout) oder installieren Sie mit der Git-Methode des Installationsprogramms neu: curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --version main. Der npm-Installationspfad lehnt GitHub-/Git-Quellziele vollständig ab und verweist Sie stattdessen auf die Git-Methode.
  • Downgrade-Schutz: Wenn die Zielversion älter als die aktuelle Version ist, fordert OpenClaw eine Bestätigung an (mit --yes überspringen).
  • Extended-Stable verwendet stets sein verifiziertes, exaktes Paketziel. Es ist kein einmaliger Alias für --tag extended-stable, und --tag kann nicht mit einem wirksamen Extended-Stable-Kanal kombiniert werden.
  • --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 Durchlauf stets direkt das Dist-Tag beta auswählt.

Probelauf

Zeigen Sie eine Vorschau der Aktionen von openclaw update an, ohne Änderungen vorzunehmen:

bash
openclaw update --dry-runopenclaw update --channel beta --dry-runopenclaw update --tag 2026.4.1-beta.1 --dry-runopenclaw update --dry-run --json

Der Probelauf meldet den wirksamen Kanal, die Zielversion, die geplanten Aktionen und ob eine Downgrade-Bestätigung erforderlich wäre.

Plugins und Kanäle

Das Wechseln von Kanälen mit openclaw update synchronisiert auch die Plugin-Quellen:

  • dev stellt installierte Plugins mit einem gebündelten Gegenstück wieder auf ihre gebündelte Quelle (Git-Checkout) um.
  • stable und beta stellen über npm oder ClawHub installierte Plugin- Pakete wieder her.
  • extended-stable löst infrage kommende offizielle npm-Plugins mit bloßer/standardmäßiger oder latest-Vorgabe auf die exakt installierte Kernversion auf. Zur Laufzeit werden keine Plugin-Tags vom Typ @extended-stable abgefragt.
  • Über npm installierte Plugins werden aktualisiert, nachdem das Kern-Update abgeschlossen ist.

Aktuellen Status prüfen

bash
openclaw update status

Zeigt den aktiven Kanal (einschließlich der Quelle, die ihn bestimmt hat: Konfiguration, Git-Tag, Git-Branch, installierte Version oder Standardwert), die Installationsart (Git oder Paket), die aktuelle Version und die Verfügbarkeit von Updates an.

Bewährte Verfahren für Tags

  • Versehen Sie Releases, auf denen Git-Checkouts landen sollen, mit Tags: vYYYY.M.PATCH für Stable, vYYYY.M.PATCH-beta.N für Beta. Benannte Vorabversionssuffixe wie -alpha.N, -rc.N und -next.N sind keine Stable- oder Beta-Ziele.
  • Veraltete numerische Stable-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 (durch Punkte getrennt) wird aus Kompatibilitätsgründen ebenfalls erkannt; bevorzugen Sie -beta.N.
  • Halten Sie Tags unveränderlich: Verschieben oder verwenden Sie ein Tag niemals erneut.
  • npm-Dist-Tags bleiben die maßgebliche Quelle für npm-Installationen:
    • latest -> Stable
    • extended-stable -> nachlaufendes Paket-Release für unterstützte Monate
    • beta -> Kandidaten-Build oder zuerst als Beta veröffentlichter stabiler Build
    • dev -> Main-Snapshot (optional)

Verfügbarkeit der macOS-App

Beta- und Dev-Builds enthalten möglicherweise keine Veröffentlichung der macOS-App. Das ist unproblematisch:

  • Das Git-Tag und das npm-Dist-Tag können dennoch unabhängig veröffentlicht werden.
  • Weisen Sie in den Versionshinweisen oder im Changelog auf „kein macOS-Build für diese Beta-Version“ hin.

Verwandte Themen

Was this useful?
On this page

On this page