Vai al contenuto principale

​
Aggiornamento

Mantieni OpenClaw aggiornato.

​
Consigliato: openclaw update

Il modo più rapido per aggiornare. Rileva il tipo di installazione (npm o git), recupera la versione più recente, esegue openclaw doctor e riavvia il gateway. 
openclaw update
Per cambiare canale o scegliere una versione specifica: 
openclaw update --channel beta
openclaw update --tag main
openclaw update --dry-run   # anteprima senza applicare
--channel beta preferisce beta, ma il runtime torna a stable/latest quando il tag beta manca o è più vecchio dell’ultima release stable. Usa --tag beta se vuoi il dist-tag npm beta grezzo per un aggiornamento una tantum del pacchetto. Vedi Development channels per la semantica dei canali.

​
Alternativa: esegui di nuovo l’installer

curl -fsSL https://openclaw.ai/install.sh | bash
Aggiungi --no-onboard per saltare l’onboarding. Per le installazioni da sorgente, passa --install-method git --no-onboard.

​
Alternativa: npm, pnpm o bun manuale

npm i -g openclaw@latest

pnpm add -g openclaw@latest

bun add -g openclaw@latest

​
Aggiornatore automatico

L’aggiornatore automatico è disattivato per impostazione predefinita. Abilitalo in ~/.openclaw/openclaw.json: 
{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}
CanaleComportamento
stableAttende stableDelayHours, poi applica con jitter deterministico su stableJitterHours (rollout distribuito).
betaControlla ogni betaCheckIntervalHours (predefinito: ogni ora) e applica immediatamente.
devNessuna applicazione automatica. Usa openclaw update manualmente.
Il gateway registra anche un suggerimento di aggiornamento all’avvio (disabilita con update.checkOnStart: false).

​
Dopo l’aggiornamento

1
Esegui doctor
2
openclaw doctor
3
Migra la config, controlla le policy DM ed esamina lo stato del gateway. Dettagli: Doctor
4
Riavvia il gateway
5
openclaw gateway restart
6
Verifica
7
openclaw health

​
Rollback

​
Fissa una versione (npm)

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart
Suggerimento: npm view openclaw version mostra la versione attualmente pubblicata.

​
Fissa un commit (sorgente)

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
openclaw gateway restart
Per tornare alla versione più recente: git checkout main && git pull.

​
Se sei bloccato

  • Esegui di nuovo openclaw doctor e leggi attentamente l’output.
  • Per openclaw update --channel dev su checkout da sorgente, l’updater esegue automaticamente il bootstrap di pnpm quando necessario. Se vedi un errore di bootstrap di pnpm/corepack, installa pnpm manualmente (o riabilita corepack) ed esegui di nuovo l’aggiornamento.
  • Controlla: Troubleshooting
  • Chiedi su Discord: https://discord.gg/clawd

​
Correlati

  • Install Overview — tutti i metodi di installazione
  • Doctor — controlli di stato dopo gli aggiornamenti
  • Migrating — guide di migrazione delle versioni principali