Development Channels

Zuletzt aktualisiert: 21.01.2026

OpenClaw bietet drei Update-Channels:

  • stable: npm dist-tag latest.
  • beta: npm dist-tag beta (Builds im Test).
  • dev: aktueller Stand von main (git). npm dist-tag: dev (wenn veröffentlicht).

Wir veröffentlichen Builds zuerst auf beta, testen sie, und promoten dann einen geprüften Build auf latest — ohne die Versionsnummer zu ändern. Die dist-tags sind die Quelle der Wahrheit für npm-Installationen.

Channels wechseln

Git checkout:

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
  • stable/beta checken den neuesten passenden Tag aus (oft derselbe Tag).
  • dev wechselt zu main und rebased auf den Upstream.

npm/pnpm globale Installation:

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

Das aktualisiert über den entsprechenden npm dist-tag (latest, beta, dev).

Wenn du explizit mit --channel den Channel wechselst, passt OpenClaw auch die Installationsmethode an:

  • dev stellt sicher, dass ein git checkout existiert (Standard: ~/openclaw, überschreibbar mit OPENCLAW_GIT_DIR), aktualisiert ihn und installiert die globale CLI aus diesem Checkout.
  • stable/beta installiert von npm mit dem passenden dist-tag.

Tipp: Wenn du stable + dev parallel nutzen willst, behalte zwei Clones und richte dein Gateway auf den stable Clone.

Plugins und Channels

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

  • dev bevorzugt gebündelte Plugins aus dem git checkout.
  • stable und beta stellen npm-installierte Plugin-Pakete wieder her.

Best Practices für Tagging

  • Tagge Releases, auf denen git checkouts landen sollen (vYYYY.M.D oder vYYYY.M.D-<patch>).
  • Tags sind unveränderlich: Verschiebe oder verwende einen Tag nie erneut.
  • npm dist-tags bleiben die Quelle der Wahrheit für npm-Installationen:
    • latest → stable
    • beta → Kandidaten-Build
    • dev → main Snapshot (optional)

macOS App Verfügbarkeit

Beta- und dev-Builds enthalten möglicherweise keine macOS App. Das ist OK:

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