Entwicklungskanäle

Zuletzt aktualisiert: 2026-01-21

OpenClaw bietet drei Update-Kanäle:

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

Wir veröffentlichen Builds auf beta, testen sie und befördern dann einen geprüften Build zu latest — ohne die Versionsnummer zu ändern. Dist-Tags sind die Referenzquelle für npm-Installationen.

Kanal 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 rebaset gegen Upstream.

npm/pnpm globale Installation:

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

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

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

  • dev stellt einen Git-Checkout sicher (Standard ~/openclaw, änderbar mit OPENCLAW_GIT_DIR), aktualisiert ihn und installiert das globale CLI aus diesem Checkout.
  • stable/beta installiert von npm mit dem passenden dist-tag.

Tipp: Wenn du stable + dev parallel nutzen willst, halte zwei Klone vor und richte dein Gateway auf den Stable-Klon.

Plugins und Kanäle

Beim Kanalwechsel mit openclaw update 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.

Tagging Best Practices

  • 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 ebenfalls für Kompatibilität erkannt, aber -beta.N ist bevorzugt.
  • Legacy-Tags vYYYY.M.D-<patch> werden weiterhin als stable (nicht-beta) erkannt.
  • Halte Tags unveränderlich: Verschiebe oder verwende einen Tag niemals erneut.
  • npm dist-tags bleiben die Referenzquelle für npm-Installationen:
    • latest → stable
    • beta → Kandidat-Build
    • dev → Main-Snapshot (optional)

Verfügbarkeit der macOS-App

Beta- und Dev-Builds enthalten möglicherweise keinen macOS-App-Release. Das ist in Ordnung:

  • Der Git-Tag und npm dist-tag können trotzdem veröffentlicht werden.
  • Weise in den Release Notes oder dem Changelog auf “kein macOS-Build für diese Beta” hin.
arrow_back
Zurück
Northflank
Weiter
Channels
arrow_forward