Come disinstallare completamente OpenClaw

Disinstallare OpenClaw significa quattro ambiti, non un solo comando: il servizio Gateway, la directory di stato, lo spazio di lavoro e la CLI stessa, più l’app desktop se l’hai installata. La documentazione indica un percorso facile finché la CLI è ancora installata e un percorso manuale per quando non c’è più ma il servizio continua a girare, che è il caso da cui nascono le discussioni nei forum. Ecco entrambi, e l’unica cosa da spostare prima di eliminare qualsiasi cosa.

Il percorso facile

• Un solo comando di disinstallazione, interattivo per impostazione predefinita, preseleziona solo il servizio Gateway; seleziona anche stato, spazio di lavoro e app, oppure passa il flag all, per una rimozione completa.
• Un dry run con il flag all mostra in anteprima cosa verrebbe rimosso, in tutta sicurezza.
• La rimozione dello stato conserva le directory degli spazi di lavoro configurati, a meno che tu non selezioni anche l’ambito dello spazio di lavoro.
• Lo smontaggio del servizio è la barriera di sicurezza: se fallisce, l’eliminazione di stato e spazio di lavoro non procede, e il comando restituisce uno stato diverso da zero quando un qualsiasi ambito fallisce.

A differenza di openclaw uninstall --state, l’eliminazione manuale dello stato non conserva gli spazi di lavoro.

Il percorso manuale

• Ferma il servizio Gateway, poi disinstallalo: launchd su macOS, systemd su Linux, Scheduled Tasks su Windows.
• Sposta prima fuori dalla directory di stato ogni spazio di lavoro che vuoi conservare, compreso quello predefinito, perché eliminare la directory di stato elimina gli spazi di lavoro al suo interno.
• Elimina la directory di stato e di configurazione, e un percorso di configurazione personalizzato se ne hai impostato uno; elimina uno spazio di lavoro esterno solo se vuoi che spariscano anche i suoi file dell’agente.
• Rimuovi la CLI con lo strumento che l’ha installata, e l’app macOS da Applicazioni.

Due residui citati dalla documentazione

Un’unità di servizio precedente al cambio di nome, dell’era Clawdbot, può ancora esistere sulle macchine aggiornate da installazioni molto vecchie; i comandi di disinstallazione la rilevano. E le variabili d’ambiente con i vecchi prefissi non fanno altro che generare un avviso, quindi conviene rimuoverle dai profili della shell già che ci sei. Clawdbot, Moltbot, OpenClaw racconta il resto della storia.

Prima di disinstallare: fai un backup

Lo spazio di lavoro contiene i file di memoria, le skill che hai scritto e le istruzioni dell’agente; la directory di stato contiene la configurazione, le credenziali e le sessioni. Se c’è anche solo una possibilità che tu torni, esiste il comando di backup, e l’articolo su come funziona la memoria di OpenClaw spiega cosa sono i file di memoria e perché sono la parte che vale la pena conservare.

L’altro modo per smettere di pensarci

Le persone disinstallano per due motivi: hanno finito, oppure hanno finito di gestirlo da sole. Per il secondo caso, OpenClaw ospitato su Diali è lo stesso runtime mantenuto in vita su un’istanza isolata, con lo spazio di lavoro sottoposto a backup e gli aggiornamenti testati prima, e niente da rimuovere in futuro dalla tua macchina.

• Servizio, stato, spazio di lavoro, CLI, app: cinque cose, un solo comando con il flag all.
• Sposta fuori lo spazio di lavoro prima di un’eliminazione manuale.
• Il servizio deve fermarsi prima che si rimuova qualsiasi altra cosa.