Canaux de developpement

Derniere mise a jour : 2026-01-21

OpenClaw propose trois canaux de mise a jour :

  • stable : dist-tag npm latest.
  • beta : dist-tag npm beta (builds en cours de test).
  • dev : tete mouvante de main (git). Dist-tag npm : dev (quand publie).

Nous poussons les builds vers beta, les testons, puis promouvons un build valide vers latest sans changer le numero de version — les dist-tags sont la reference pour les installations npm.

Changer de canal

Checkout git :

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
  • stable/beta recuperent le dernier tag correspondant (souvent le meme tag).
  • dev bascule vers main et rebase sur l’upstream.

Installation globale npm/pnpm :

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

Cela met a jour via le dist-tag npm correspondant (latest, beta, dev).

Lorsque vous changez explicitement de canal avec --channel, OpenClaw aligne egalement la methode d’installation :

  • dev garantit un checkout git (par defaut ~/openclaw, modifiable via OPENCLAW_GIT_DIR), le met a jour et installe le CLI global depuis ce checkout.
  • stable/beta installe depuis npm avec le dist-tag correspondant.

Astuce : si vous voulez stable + dev en parallele, gardez deux clones et pointez votre passerelle vers le stable.

Plugins et canaux

Lorsque vous changez de canal avec openclaw update, OpenClaw synchronise aussi les sources des plugins :

  • dev prefere les plugins embarques depuis le checkout git.
  • stable et beta restaurent les packages de plugins installes via npm.

Bonnes pratiques de tagging

  • Taguez les releases sur lesquelles vous voulez que les checkouts git atterrissent (vYYYY.M.D pour stable, vYYYY.M.D-beta.N pour beta).
  • vYYYY.M.D.beta.N est aussi reconnu pour la compatibilite, mais preferez -beta.N.
  • Les tags legacy vYYYY.M.D-<patch> sont toujours reconnus comme stables (non-beta).
  • Gardez les tags immuables : ne deplacez et ne reutilisez jamais un tag.
  • Les dist-tags npm restent la reference pour les installations npm :
    • latest → stable
    • beta → build candidat
    • dev → snapshot de main (optionnel)

Disponibilite de l’app macOS

Les builds beta et dev peuvent ne pas inclure de release de l’app macOS. Ce n’est pas un probleme :

  • Le tag git et le dist-tag npm peuvent quand meme etre publies.
  • Mentionnez “pas de build macOS pour cette beta” dans les notes de release ou le changelog.