Ontwikkelkanalen

Laatst bijgewerkt: 2026-01-21

OpenClaw biedt drie updatekanalen:

  • stable: npm dist-tag latest.
  • beta: npm dist-tag beta (builds die getest worden).
  • dev: lopende head van main (git). npm dist-tag: dev (wanneer gepubliceerd).

We publiceren builds naar beta, testen ze, en promoveren een gevalideerde build naar latest zonder het versienummer te wijzigen — dist-tags zijn de bron van waarheid voor npm-installaties.

Wisselen van kanaal

Git checkout:

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
  • stable/beta checken de laatste bijbehorende tag uit (vaak dezelfde tag).
  • dev schakelt over naar main en rebaset op de upstream.

npm/pnpm globale installatie:

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

Dit werkt bij via de corresponderende npm dist-tag (latest, beta, dev).

Wanneer je expliciet van kanaal wisselt met --channel, stemt OpenClaw ook de installatiemethode af:

  • dev zorgt voor een git checkout (standaard ~/openclaw, overschrijf met OPENCLAW_GIT_DIR), werkt deze bij en installeert de globale CLI vanuit die checkout.
  • stable/beta installeert van npm met de bijbehorende dist-tag.

Tip: als je stable + dev parallel wilt draaien, houd dan twee klonen aan en verwijs je gateway naar de stable-versie.

Plugins en kanalen

Wanneer je van kanaal wisselt met openclaw update, synchroniseert OpenClaw ook de plugin-bronnen:

  • dev geeft voorkeur aan gebundelde plugins uit de git checkout.
  • stable en beta herstellen npm-geïnstalleerde plugin-pakketten.

Best practices voor tagging

  • Tag releases waar je wilt dat git checkouts op landen (vJJJJ.M.D voor stable, vJJJJ.M.D-beta.N voor beta).
  • vJJJJ.M.D.beta.N wordt ook herkend voor compatibiliteit, maar geef de voorkeur aan -beta.N.
  • Verouderde vJJJJ.M.D-<patch>-tags worden nog steeds herkend als stable (niet-beta).
  • Houd tags onveranderlijk: verplaats of hergebruik nooit een tag.
  • npm dist-tags blijven de bron van waarheid voor npm-installaties:
    • latest → stable
    • beta → kandidaat-build
    • dev → main-snapshot (optioneel)

macOS-app-beschikbaarheid

Beta- en dev-builds bevatten mogelijk geen macOS-app-release. Dat is prima:

  • De git tag en npm dist-tag kunnen alsnog gepubliceerd worden.
  • Vermeld “geen macOS-build voor deze beta” in release notes of changelog.