OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Disinstallazione

Due percorsi:

  • Percorso semplice se openclaw è ancora installato.
  • Rimozione manuale del servizio se la CLI non è più presente ma il servizio è ancora in esecuzione.

Percorso semplice (CLI ancora installata)

Consigliato: usa il programma di disinstallazione integrato:

bash
openclaw uninstall

La rimozione dello stato mantiene le directory dell'area di lavoro configurate, a meno che non selezioni anche --workspace.

Visualizza in anteprima ciò che verrà rimosso (operazione sicura):

bash
openclaw uninstall --dry-run --all

Modalità non interattiva (automazione / npx). Usala con cautela e solo dopo aver verificato gli ambiti:

bash
openclaw uninstall --all --yes --non-interactivenpx -y openclaw uninstall --all --yes --non-interactive

Flag: --service, --state, --workspace, --app selezionano i singoli ambiti; --all li seleziona tutti e quattro.

Passaggi manuali (stesso risultato):

  1. Arresta il servizio Gateway:
bash
openclaw gateway stop
  1. Disinstalla il servizio Gateway (launchd/systemd/schtasks):
bash
openclaw gateway uninstall
  1. Elimina stato e configurazione:
bash
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

Se hai impostato OPENCLAW_CONFIG_PATH su un percorso personalizzato esterno alla directory dello stato, elimina anche quel file. Se vuoi conservare un'area di lavoro all'interno della directory dello stato, ad esempio ~/.openclaw/workspace, spostala altrove prima di eseguire rm -rf oppure elimina selettivamente il contenuto dello stato.

  1. Elimina la tua area di lavoro (facoltativo, rimuove i file dell'agente):
bash
rm -rf ~/.openclaw/workspace
  1. Rimuovi l'installazione della CLI (scegli il comando corrispondente al metodo usato):
bash
npm rm -g openclawpnpm remove -g openclawbun remove -g openclaw
  1. Se hai installato l'app per macOS:
bash
rm -rf /Applications/OpenClaw.app

Note:

  • Se hai usato profili (--profile / OPENCLAW_PROFILE), ripeti il passaggio 3 per ogni directory dello stato (i valori predefiniti sono ~/.openclaw-<profile>).
  • In modalità remota, la directory dello stato si trova sull'host del Gateway, quindi esegui anche lì i passaggi 1-4.

Rimozione manuale del servizio (CLI non installata)

Usa questa procedura se il servizio Gateway continua a essere eseguito ma openclaw non è presente.

macOS (launchd)

L'etichetta predefinita è ai.openclaw.gateway (oppure ai.openclaw.<profile> con un profilo):

bash
launchctl bootout gui/$UID/ai.openclaw.gatewayrm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

Se hai usato un profilo, sostituisci l'etichetta e il nome del file plist con ai.openclaw.<profile>.

Linux (unità utente systemd)

Il nome predefinito dell'unità è openclaw-gateway.service (oppure openclaw-gateway-<profile>.service). Un'unità precedente alla ridenominazione, clawdbot-gateway.service, potrebbe essere ancora presente nei computer aggiornati da installazioni molto vecchie; openclaw uninstall / openclaw gateway uninstall la rileva e la rimuove automaticamente.

bash
systemctl --user disable --now openclaw-gateway.servicerm -f ~/.config/systemd/user/openclaw-gateway.servicesystemctl --user daemon-reload

Windows (attività pianificata)

Il nome predefinito dell'attività è OpenClaw Gateway (oppure OpenClaw Gateway (<profile>)). L'attività avvia senza finestra uno script gateway.vbs nella directory dello stato, che a sua volta esegue gateway.cmd; rimuovili entrambi.

powershell
schtasks /Delete /F /TN "OpenClaw Gateway"Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" -ErrorAction SilentlyContinueRemove-Item -Force "$env:USERPROFILE\.openclaw\gateway.vbs" -ErrorAction SilentlyContinue

Se hai usato un profilo, elimina l'attività con il nome corrispondente e i file gateway.cmd / gateway.vbs in ~\.openclaw-<profile>.

Installazione normale e checkout del codice sorgente

Installazione normale (install.sh / npm / pnpm / bun)

Se hai usato https://openclaw.ai/install.sh o install.ps1, la CLI è stata installata con npm install -g openclaw@latest. Rimuovila con npm rm -g openclaw (oppure pnpm remove -g / bun remove -g se hai utilizzato uno di questi metodi).

Checkout del codice sorgente (git clone)

Se esegui il programma da un checkout del repository (git clone + openclaw ... / bun run openclaw ...):

  1. Disinstalla il servizio Gateway prima di eliminare il repository (usa il percorso semplice descritto sopra o la rimozione manuale del servizio).
  2. Elimina la directory del repository.
  3. Rimuovi lo stato e l'area di lavoro come illustrato sopra.

Argomenti correlati

Was this useful?
On this page

On this page