OpenClaw Update-Channels: Richtig wechseln und nutzen

Kennst du das? Du willst ein neues Feature unbedingt ausprobieren, hast aber keine Lust, dir dein produktives System zu zerschießen. Oder du hängst auf einer alten Version fest und weißt nicht genau, wie du sicher auf den neuesten Stand kommst, ohne die Kontrolle zu verlieren.

Das Management von Updates und verschiedenen Entwicklungsständen kann nervig sein. Deshalb nutzt OpenClaw ein klares System aus Channels, damit du immer genau die Stabilität bekommst, die du gerade brauchst.

Entwicklungs-Channels

OpenClaw bietet drei Update-Channels:

• stable: npm dist-tag latest. Empfohlen für die meisten User.
• beta: npm dist-tag beta (Builds im Test).
• dev: Der aktuelle Stand von main (git). npm dist-tag: dev (falls veröffentlicht). Der main Branch ist für Experimente und die aktive Entwicklung gedacht. Er kann unvollständige Features oder Breaking Changes enthalten. Nutze ihn nicht für produktive Gateways.

Wir veröffentlichen Builds in beta, testen sie und befördern einen geprüften Build zu latest, ohne die Versionsnummer zu ändern. Die dist-tags sind bei npm-Installationen die “Source of Truth”.

Channels wechseln

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev

Das Flag --channel speichert deine Wahl dauerhaft in der Config (update.channel) und passt die Installationsmethode an:

• stable/beta (Package-Installationen): Updates erfolgen über den passenden npm dist-tag.
• stable/beta (Git-Installationen): Checkt den neuesten passenden Git-Tag aus.
• dev: Erzwingt einen Git-Checkout (Standard ist ~/openclaw, überschreibbar mit OPENCLAW_GIT_DIR), wechselt auf main, führt einen Rebase auf Upstream aus, baut das Projekt und installiert die globale CLI aus diesem Checkout.

Tipp: Wenn du stable und dev parallel nutzen willst, behalte zwei Clones und richte dein Gateway auf die stabile Version aus.

Einmalige Versionen oder Tags anvisieren

Nutze --tag, um einen spezifischen dist-tag, eine Version oder eine Package-Spec für ein einzelnes Update anzusteuern, ohne deinen gespeicherten Channel 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 openclaw@2026.4.1-beta.1

Hinweise:

• --tag gilt nur für Package-Installationen (npm). Git-Installationen ignorieren dieses Flag.
• Der Tag wird nicht gespeichert. Dein nächstes openclaw update nutzt wieder deinen konfigurierten Channel.
• Downgrade-Schutz: Wenn die Zielversion älter als deine aktuelle Version ist, fragt OpenClaw nach einer Bestätigung (überspringe dies mit --yes).

Dry Run

Schau dir an, was openclaw update tun würde, ohne tatsächliche Ä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 Dry Run zeigt dir den effektiven Channel, die Zielversion, geplante Aktionen und ob eine Bestätigung für ein Downgrade nötig wäre.

Plugins und Channels

Wenn du mit openclaw update den Channel wechselst, synchronisiert OpenClaw auch die Plugin-Quellen:

• dev bevorzugt Bundled Plugins aus dem Git-Checkout.
• stable und beta stellen über npm installierte Plugin-Packages wieder her.
• Über npm installierte Plugins werden aktualisiert, sobald das Core-Update abgeschlossen ist.

Aktuellen Status prüfen

openclaw update status

Dieser Befehl zeigt den aktiven Channel, die Installationsart (Git oder Package), die aktuelle Version und die Quelle (Config, Git-Tag, Git-Branch oder Default) an.

Best Practices für Tagging

• Tagge Releases, 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, aber bevorzuge -beta.N.
• Alte vYYYY.M.D-<patch> Tags werden weiterhin als stable (non-beta) erkannt.
• Halte Tags unveränderlich: Verschiebe oder verwende einen Tag niemals erneut.
• npm dist-tags bleiben die Source of Truth für npm-Installationen:
  • latest -> stable
  • beta -> Candidate Build
  • dev -> Snapshot von main (optional)

Verfügbarkeit der macOS App

Beta- und dev-Builds enthalten unter Umständen kein Release der macOS App. Das ist völlig okay:

• Der Git-Tag und der npm dist-tag können trotzdem veröffentlicht werden.
• Erwähne “kein macOS Build für diese Beta” einfach in den Release Notes oder im Changelog.

---

Du hast Fragen zu den Channels oder brauchst Hilfe beim Setup? Frag unseren AI Setup Assistant.

Nächste Schritte

• CLI Referenz ansehen
• Plugins konfigurieren