Skip to main content
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

--channel speichert die Auswahl als update.channel in der Konfiguration und steuert beide Installationspfade: 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.
Um Stable und Dev parallel zu verwenden, nutzen Sie zwei separate Checkouts und verweisen Sie jedes Gateway auf seinen eigenen Checkout.

​
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:
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:
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

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