English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Maintenance

Release-Kanäle

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 als die neueste stabile Version ist, 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 dient Experimenten und aktiver Entwicklung. Er kann unvollständige Funktionen oder Breaking Changes enthalten. Verwenden Sie ihn nicht für Produktions-Gateways.

Wir liefern stabile Builds in der Regel 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 verbindliche Quelle 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 daran 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 als der aktuelle stabile Tag ist.
  • stable (git-Installationen): checkt den neuesten stabilen git-Tag aus.
  • 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 (Standard ~/openclaw, überschreibbar mit OPENCLAW_GIT_DIR), wechselt zu main, rebaset auf upstream, baut und installiert die globale CLI aus diesem Checkout.

Einmaliges Ansteuern einer Version oder eines Tags

Verwenden Sie --tag, um einen bestimmten dist-tag, eine Version oder eine Paketspezifikation für ein einzelnes Update anzusteuern, ohne Ihren dauerhaft 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

# Install from GitHub main branch (npm tarball)
openclaw update --tag main

# Install a specific npm package spec
openclaw update --tag [email protected]

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.
  • Downgrade-Schutz: Wenn die Zielversion älter als Ihre aktuelle Version ist, fragt OpenClaw nach einer Bestätigung (überspringen mit --yes).
  • --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 den rohen beta-dist-tag für diesen einen Lauf 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 Kern-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) an.

Best Practices für Tags

  • Taggen Sie Versionen, auf denen git-Checkouts landen sollen (vYYYY.M.D für stable, vYYYY.M.D-beta.N für beta).
  • vYYYY.M.D.beta.N wird aus Kompatibilitätsgründen ebenfalls erkannt, bevorzugen Sie jedoch -beta.N.
  • Veraltete vYYYY.M.D-<patch>-Tags werden weiterhin als stable (nicht beta) erkannt.
  • Halten Sie Tags unveränderlich: Verschieben oder verwenden Sie einen Tag niemals erneut.
  • npm-dist-tags bleiben die verbindliche Quelle für npm-Installationen:
    • latest -> stable
    • beta -> Kandidaten-Build oder beta-first-stable-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.
  • Erwähnen Sie „kein macOS-Build für diese beta“ in den Versionshinweisen oder im Changelog.

Verwandt