Canali di rilascio

OpenClaw distribuisce tre canali di aggiornamento:

• stable: dist-tag npm latest. Consigliato per la maggior parte degli utenti.
• beta: dist-tag npm beta quando è corrente; se beta manca o è più vecchio della release stable più recente, il flusso di aggiornamento ripiega su latest.
• dev: head mobile di main (git). dist-tag npm: dev (quando pubblicato). Il branch main è destinato alla sperimentazione e allo sviluppo attivo. Può contenere funzionalità incomplete o modifiche incompatibili. Non usarlo per Gateway di produzione.

Di solito pubblichiamo prima le build stable su beta, le testiamo lì, poi eseguiamo un passaggio esplicito di promozione che sposta la build verificata su latest senza modificare il numero di versione. I manutentori possono anche pubblicare una release stable direttamente su latest quando necessario. I dist-tag sono la fonte di verità per le installazioni npm.

Cambio di canale

openclaw update --channel stableopenclaw update --channel betaopenclaw update --channel dev

--channel salva la tua scelta nella configurazione (update.channel) e allinea il metodo di installazione:

• stable (installazioni da pacchetto): aggiorna tramite il dist-tag npm latest.
• beta (installazioni da pacchetto): preferisce il dist-tag npm beta, ma ripiega su latest quando beta manca o è più vecchio del tag stable corrente.
• stable (installazioni git): esegue il checkout del tag git stable più recente, escludendo i tag semver di prerelease come -alpha.N, -beta.N, -rc.N, -dev.N, -next.N, -preview.N, -canary.N, -nightly.N e altri suffissi di prerelease.
• beta (installazioni git): preferisce il tag git beta più recente, ma ripiega sul tag git stable più recente quando beta manca o è più vecchio.
• dev: garantisce un checkout git (predefinito ~/openclaw, oppure $OPENCLAW_HOME/openclaw quando OPENCLAW_HOME è impostato; sovrascrivilo con OPENCLAW_GIT_DIR), passa a main, esegue il rebase sull'upstream, compila e installa la CLI globale da quel checkout.

Puntamento occasionale a versione o tag

Usa --tag per puntare a uno specifico dist-tag, versione o specifica di pacchetto per un singolo aggiornamento senza modificare il canale salvato:

# Install a specific versionopenclaw update --tag 2026.4.1-beta.1 # Install from the beta dist-tag (one-off, does not persist)openclaw update --tag beta # Switch to the moving GitHub main checkoutopenclaw update --channel dev # Install a specific npm package specopenclaw update --tag openclaw@2026.4.1-beta.1 # Install from GitHub main once without persisting the channelopenclaw update --tag main

Note:

• --tag si applica solo alle installazioni da pacchetto (npm). Le installazioni git lo ignorano.
• Il tag non viene salvato. Il prossimo openclaw update userà come al solito il canale configurato.
• Per le installazioni da pacchetto, OpenClaw preconfeziona le specifiche sorgente GitHub/git in un tarball temporaneo prima dell'installazione npm staged. Usa --channel dev o --install-method git --version main quando vuoi il checkout mobile di main come installazione persistente.
• Protezione dal downgrade: se la versione di destinazione è più vecchia della versione corrente, OpenClaw chiede conferma (salta con --yes).
• --channel beta è diverso da --tag beta: il flusso del canale può ripiegare su stable/latest quando beta manca o è più vecchio, mentre --tag beta punta al dist-tag beta grezzo per quella singola esecuzione.

Dry run

Visualizza in anteprima cosa farebbe openclaw update senza apportare modifiche:

openclaw update --dry-runopenclaw update --channel beta --dry-runopenclaw update --tag 2026.4.1-beta.1 --dry-runopenclaw update --dry-run --json

Il dry run mostra il canale effettivo, la versione di destinazione, le azioni pianificate e se sarebbe richiesta una conferma di downgrade.

Plugin e canali

Quando cambi canale con openclaw update, OpenClaw sincronizza anche le sorgenti dei Plugin:

• dev preferisce i Plugin inclusi dal checkout git.
• stable e beta ripristinano i pacchetti Plugin installati tramite npm.
• I Plugin installati tramite npm vengono aggiornati dopo il completamento dell'aggiornamento del core.

Controllo dello stato corrente

openclaw update status

Mostra il canale attivo, il tipo di installazione (git o pacchetto), la versione corrente e la sorgente (configurazione, tag git, branch git o predefinita).

Best practice per i tag

• Tagga le release su cui vuoi che approdino i checkout git (vYYYY.M.PATCH per stable, vYYYY.M.PATCH-beta.N per beta; i suffissi semver di prerelease denominati come -alpha.N, -rc.N e -next.N non sono destinazioni stable).
• I tag stable numerici legacy come vYYYY.M.PATCH-1 e v1.0.1-1 sono ancora riconosciuti come tag git stable per compatibilità.
• Anche vYYYY.M.PATCH.beta.N è riconosciuto per compatibilità, ma preferisci -beta.N.
• Mantieni i tag immutabili: non spostare né riutilizzare mai un tag.
• I dist-tag npm restano la fonte di verità per le installazioni npm:
  • latest -> stable
  • beta -> build candidata o build stable pubblicata prima su beta
  • dev -> snapshot di main (facoltativo)

Disponibilità dell'app macOS

Le build beta e dev potrebbero non includere una release dell'app macOS. Va bene:

• Il tag git e il dist-tag npm possono comunque essere pubblicati.
• Indica "nessuna build macOS per questa beta" nelle note di release o nel changelog.

Correlati

• Aggiornamento
• Dettagli interni dell'installer