Mantieni OpenClaw aggiornato.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
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 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 ripiega su stable/latest quando
il tag beta manca o è più vecchio dell’ultima release stabile. Usa --tag beta
se vuoi il dist-tag beta npm grezzo per un aggiornamento pacchetto una tantum.
Per i plugin gestiti, il fallback del canale beta è un avviso: l’aggiornamento del core può
comunque riuscire mentre un plugin usa la propria release predefinita/latest registrata perché non
è disponibile alcuna beta del plugin.
Vedi Canali di sviluppo per la semantica dei canali.
Passare tra installazioni npm e git
Usa i canali quando vuoi cambiare il tipo di installazione. L’aggiornatore mantiene stato, configurazione, credenziali e workspace in~/.openclaw; cambia solo
quale installazione del codice OpenClaw viene usata da CLI e Gateway.
--dry-run per visualizzare in anteprima l’esatto cambio di modalità di installazione:
dev garantisce 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
--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 chiama il vecchio aggiornatore; esegue direttamente
l’installazione del pacchetto globale e può recuperare un’installazione npm parzialmente aggiornata.
--version:
Alternativa: npm, pnpm o bun manuale
openclaw update per installazioni supervisionate, perché può coordinare lo
scambio 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 da un pacchetto
sostituito.
Quando openclaw update gestisce un’installazione npm globale, installa prima la destinazione in
un prefisso npm temporaneo, verifica l’inventario dist impacchettato, quindi scambia
l’albero del pacchetto pulito nel vero prefisso globale. Questo evita che npm sovrapponga un
nuovo pacchetto a file obsoleti del vecchio pacchetto. Se il comando di installazione fallisce,
OpenClaw riprova una volta con --omit=optional. Quel nuovo tentativo aiuta gli host in cui le
dipendenze native opzionali non possono essere compilate, mantenendo visibile l’errore originale
se anche il fallback fallisce.
Argomenti avanzati sull’installazione npm
Albero dei pacchetti in sola lettura
Albero dei pacchetti in sola lettura
OpenClaw tratta le installazioni globali impacchettate come in sola lettura in runtime, anche quando la directory del pacchetto globale è scrivibile dall’utente corrente. Le installazioni dei pacchetti plugin risiedono in radici npm/git di proprietà di OpenClaw sotto la directory di configurazione utente, e l’avvio del Gateway non modifica l’albero dei pacchetti OpenClaw.Alcune configurazioni npm Linux installano i pacchetti globali in directory di proprietà di root, come
/usr/lib/node_modules/openclaw. OpenClaw supporta quel layout perché i comandi di installazione/aggiornamento dei plugin scrivono fuori da quella directory del pacchetto globale.Unità systemd rafforzate
Unità systemd rafforzate
Concedi a OpenClaw l’accesso in scrittura alle sue radici di configurazione/stato, così installazioni esplicite di plugin, aggiornamenti di plugin e pulizia di doctor possono persistere le modifiche:
Controllo preliminare dello spazio su disco
Controllo preliminare dello spazio su disco
Prima degli aggiornamenti dei pacchetti e delle installazioni esplicite di plugin, OpenClaw prova a eseguire un controllo best-effort dello spazio su disco per il volume di destinazione. Lo spazio insufficiente produce un avviso con il percorso controllato, ma non blocca l’aggiornamento perché quote del filesystem, snapshot e volumi di rete possono cambiare dopo il controllo. L’installazione effettiva del package manager e la verifica post-installazione restano autorevoli.
Auto-updater
L’auto-updater è disattivato per impostazione predefinita. Abilitalo in~/.openclaw/openclaw.json:
| Canale | Comportamento |
|---|---|
stable | Attende stableDelayHours, poi applica con jitter deterministico su stableJitterHours (rilascio distribuito). |
beta | Controlla ogni betaCheckIntervalHours (predefinito: ogni ora) e applica immediatamente. |
dev | Nessuna applicazione automatica. Usa openclaw update manualmente. |
update.checkOnStart: false).
Per downgrade o recupero da incidenti, 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 piano di controllo del Gateway
forzano un riavvio di aggiornamento non differito e senza cooldown dopo lo scambio del pacchetto. Questo
evita di lasciare in giro un vecchio processo in memoria abbastanza a lungo da caricare lazy chunk
da un albero di pacchetti che è già stato sostituito. openclaw update da shell
rimane il percorso preferito per installazioni supervisionate perché può arrestare e
riavviare il servizio durante l’aggiornamento.
Dopo l’aggiornamento
Migra la configurazione, controlla le policy DM e verifica lo stato del Gateway. Dettagli: Doctor
Rollback
Vincolare una versione (npm)
Vincolare un commit (sorgente)
git checkout main && git pull.
Se sei bloccato
- Esegui di nuovo
openclaw doctore leggi attentamente l’output. - Per
openclaw update --channel devsui checkout sorgente, l’aggiornatore esegue automaticamente il bootstrap dipnpmquando necessario. Se vedi un errore di bootstrap pnpm/corepack, installapnpmmanualmente (o riabilitacorepack) e riesegui 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 di versioni principali.