Canali di sviluppo

Ultimo aggiornamento: 2026-01-21

OpenClaw offre tre canali di aggiornamento:

  • stable: dist-tag npm latest.
  • beta: dist-tag npm beta (build in fase di test).
  • dev: head mobile di main (git). Dist-tag npm: dev (quando pubblicato).

Pubblichiamo i build su beta, li testiamo, poi promuoviamo un build verificato a latest senza cambiare il numero di versione — i dist-tag sono il riferimento per le installazioni npm.

Cambiare canale

Checkout git:

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
  • stable/beta fanno checkout del tag corrispondente piu recente (spesso lo stesso tag).
  • dev passa a main e fa rebase sull’upstream.

Installazione globale npm/pnpm:

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

Questo aggiorna tramite il dist-tag npm corrispondente (latest, beta, dev).

Quando cambi esplicitamente canale con --channel, OpenClaw allinea anche il metodo di installazione:

  • dev garantisce un checkout git (default ~/openclaw, personalizzabile via OPENCLAW_GIT_DIR), lo aggiorna e installa il CLI globale da quel checkout.
  • stable/beta installa da npm usando il dist-tag corrispondente.

Suggerimento: se vuoi stable + dev in parallelo, mantieni due cloni e punta il gateway verso lo stable.

Plugin e canali

Quando cambi canale con openclaw update, OpenClaw sincronizza anche le fonti dei plugin:

  • dev preferisce i plugin incorporati dal checkout git.
  • stable e beta ripristinano i pacchetti plugin installati via npm.

Best practice per il tagging

  • Crea tag per le release su cui vuoi che i checkout git atterrino (vYYYY.M.D per stable, vYYYY.M.D-beta.N per beta).
  • vYYYY.M.D.beta.N e anche riconosciuto per compatibilita, ma preferisci -beta.N.
  • I tag legacy vYYYY.M.D-<patch> sono ancora riconosciuti come stable (non-beta).
  • Mantieni i tag immutabili: non spostare o riutilizzare mai un tag.
  • I dist-tag npm rimangono il riferimento per le installazioni npm:
    • latest → stable
    • beta → build candidato
    • dev → snapshot di main (opzionale)

Disponibilita dell’app macOS

I build beta e dev potrebbero non includere un release dell’app macOS. Va bene:

  • Il tag git e il dist-tag npm possono comunque essere pubblicati.
  • Segnala “nessun build macOS per questa beta” nelle note di release o nel changelog.
arrow_back
Precedente
Northflank
Successivo
Channels
arrow_forward