Vai al contenuto principale

Aggiornamento

Mantieni OpenClaw aggiornato.

Consigliato: openclaw update

Il modo più rapido per aggiornare. Rileva il tuo tipo di installazione (npm o git), recupera l’ultima versione, esegue openclaw doctor e riavvia il gateway.
openclaw update
Per cambiare canale o puntare a 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 ripiega su stable/latest quando il tag beta è assente 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 Canali di sviluppo per la semantica dei canali.

Alternativa: rieseguire l’installer

curl -fsSL https://openclaw.ai/install.sh | bash
Aggiungi --no-onboard per saltare l’onboarding. Per le installazioni dal 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

Auto-updater

L’auto-updater è 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 distribuito su stableJitterHours (rilascio 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 (disabilitalo con update.checkOnStart: false).

Dopo l’aggiornamento

1
Esegui doctor
2
openclaw doctor
3
Migra la configurazione, verifica le policy DM e controlla 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 all’ultima versione: git checkout main && git pull.

Se sei bloccato

Correlati