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 usare una versione specifica:

openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag main
openclaw update --dry-run   # preview without applying

openclaw update non accetta --verbose. Per la diagnostica degli aggiornamenti, usa --dry-run per visualizzare in anteprima le azioni pianificate, --json per risultati strutturati, oppure openclaw update status --json per ispezionare lo stato del canale e della disponibilità. Il programma di installazione ha il proprio flag --verbose, ma quel flag non fa parte di openclaw update.

--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 occasionale del pacchetto.

OpenClaw non espone ancora un canale di aggiornamento LTS o di supporto mensile. Stiamo lavorando verso linee di supporto mensili compatibili con SemVer, ma oggi i canali supportati sono ancora stable, beta e dev.

Consulta Canali di sviluppo per la semantica dei canali.

# Passare tra installazioni npm e git

Usa i canali quando vuoi cambiare il tipo di installazione. Il programma di aggiornamento mantiene stato, configurazione, credenziali e workspace in ~/.openclaw; cambia solo quale installazione del codice OpenClaw usano la CLI e il Gateway.

# npm package install -> editable git checkout
openclaw update --channel dev

# git checkout -> npm package install
openclaw update --channel stable

Esegui prima con --dry-run per visualizzare in anteprima l'esatto cambio di modalità di installazione:

openclaw update --channel dev --dry-run
openclaw update --channel stable --dry-run

Il canale dev assicura un checkout git, lo compila e installa la CLI globale da quel checkout. I canali stable e beta usano installazioni da pacchetto. Se il Gateway è già installato, openclaw update aggiorna i metadati del servizio e lo riavvia, a meno che tu non passi --no-restart.

# Alternativa: rieseguire il programma di installazione

curl -fsSL https://openclaw.ai/install.sh | bash

Aggiungi --no-onboard per saltare l'onboarding. Per forzare un tipo di installazione specifico tramite il programma di installazione, passa --install-method git --no-onboard oppure --install-method npm --no-onboard.

Se openclaw update fallisce dopo la fase di installazione del pacchetto npm, riesegui il programma di installazione. Il programma di installazione non richiama il vecchio aggiornamento; esegue direttamente l'installazione del pacchetto globale e può recuperare un'installazione npm aggiornata parzialmente.

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

Per vincolare il recupero a una versione o a un dist-tag specifico, aggiungi --version:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>

# Alternativa: npm, pnpm o bun manuale

npm i -g openclaw@latest

Preferisci openclaw update per le installazioni supervisionate perché può coordinare la sostituzione del pacchetto con il servizio Gateway in esecuzione. Se aggiorni manualmente mentre un Gateway gestito è in esecuzione, riavvia il Gateway subito dopo che il package manager ha terminato, così il vecchio processo non continua a servire file di pacchetto sostituiti.

Quando openclaw update gestisce un'installazione npm globale, installa prima il target in un prefisso npm temporaneo, verifica l'inventario dist impacchettato, quindi sostituisce l'albero pulito del pacchetto nel prefisso globale reale. Questo evita che npm sovrapponga un nuovo pacchetto a file obsoleti del vecchio pacchetto. Se il comando di installazione fallisce, OpenClaw ritenta una volta con --omit=optional. Quel tentativo aiuta gli host in cui le dipendenze opzionali native non possono essere compilate, mantenendo visibile l'errore originale se anche il fallback fallisce.

pnpm add -g openclaw@latest

bun add -g openclaw@latest

# Argomenti avanzati sull'installazione npm

ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp

# Aggiornamento automatico

L'aggiornamento automatico è disattivato per impostazione predefinita. Abilitalo in ~/.openclaw/openclaw.json:

{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}

Il Gateway registra anche un suggerimento di aggiornamento all'avvio (disabilitalo con update.checkOnStart: false). Per downgrade o recupero da incidente, imposta OPENCLAW_NO_AUTO_UPDATE=1 nell'ambiente del Gateway per bloccare le applicazioni automatiche anche quando update.auto.enabled è configurato. I suggerimenti di aggiornamento all'avvio possono comunque essere eseguiti, a meno che anche update.checkOnStart sia disabilitato.

Gli aggiornamenti del package manager richiesti tramite l'handler live del control plane del Gateway forzano un riavvio di aggiornamento non differito e senza cooldown dopo la sostituzione del pacchetto. Questo evita di lasciare in memoria un vecchio processo abbastanza a lungo da caricare pigramente chunk da un albero del pacchetto che è già stato sostituito. openclaw update da shell rimane il percorso preferito per installazioni supervisionate perché può fermare e riavviare il servizio intorno all'aggiornamento.

# Dopo l'aggiornamento

openclaw doctor

openclaw gateway restart

openclaw health

# Rollback

# Vincolare una versione (npm)

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart

# Vincolare 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

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

# Correlati

• Panoramica dell'installazione: tutti i metodi di installazione.
• Doctor: controlli di integrità dopo gli aggiornamenti.
• Migrazione: guide alla migrazione delle versioni principali.