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

Maintenance

Desinstalar

Dois caminhos:

  • Caminho fácil se o openclaw ainda estiver instalado.
  • Remoção manual do serviço se a CLI não estiver mais disponível, mas o serviço ainda estiver em execução.

Caminho fácil (CLI ainda instalada)

Recomendado: use o desinstalador integrado:

bash
openclaw uninstall

A remoção do estado preserva os diretórios de espaço de trabalho configurados, a menos que você também selecione --workspace.

Visualize o que será removido (seguro):

bash
openclaw uninstall --dry-run --all

Não interativo (automação / npx). Use com cuidado e somente após confirmar os escopos:

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

Opções: --service, --state, --workspace e --app selecionam escopos individuais; --all seleciona os quatro.

Etapas manuais (mesmo resultado):

  1. Pare o serviço do Gateway:
bash
openclaw gateway stop
  1. Desinstale o serviço do Gateway (launchd/systemd/schtasks):
bash
openclaw gateway uninstall
  1. Exclua o estado e a configuração:
bash
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

Se você definiu OPENCLAW_CONFIG_PATH como um local personalizado fora do diretório de estado, exclua também esse arquivo. Se quiser manter um espaço de trabalho dentro do diretório de estado, como ~/.openclaw/workspace, mova-o para outro local antes de executar rm -rf ou exclua seletivamente o conteúdo do estado.

  1. Exclua seu espaço de trabalho (opcional, remove os arquivos do agente):
bash
rm -rf ~/.openclaw/workspace
  1. Remova a instalação da CLI (escolha o método que você usou):
bash
npm rm -g openclawpnpm remove -g openclawbun remove -g openclaw
  1. Se você instalou o aplicativo para macOS:
bash
rm -rf /Applications/OpenClaw.app

Observações:

  • Se você usou perfis (--profile / OPENCLAW_PROFILE), repita a etapa 3 para cada diretório de estado (os padrões são ~/.openclaw-<profile>).
  • No modo remoto, o diretório de estado fica no host do Gateway, portanto execute as etapas 1 a 4 nele também.

Remoção manual do serviço (CLI não instalada)

Use este procedimento se o serviço do Gateway continuar em execução, mas o openclaw não estiver disponível.

macOS (launchd)

O rótulo padrão é ai.openclaw.gateway (ou ai.openclaw.<profile> com um perfil):

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

Se você usou um perfil, substitua o rótulo e o nome do plist por ai.openclaw.<profile>.

Linux (unidade de usuário do systemd)

O nome padrão da unidade é openclaw-gateway.service (ou openclaw-gateway-<profile>.service). Uma unidade clawdbot-gateway.service anterior à renomeação ainda pode existir em máquinas atualizadas a partir de instalações muito antigas; openclaw uninstall / openclaw gateway uninstall a detecta e remove automaticamente.

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

Windows (Tarefa Agendada)

O nome padrão da tarefa é OpenClaw Gateway (ou OpenClaw Gateway (<profile>)). A tarefa inicia um script gateway.vbs sem janela no diretório de estado, que, por sua vez, executa gateway.cmd; remova ambos.

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 você usou um perfil, exclua a tarefa com o nome correspondente e os arquivos gateway.cmd / gateway.vbs em ~\.openclaw-<profile>.

Instalação normal versus checkout do código-fonte

Instalação normal (install.sh / npm / pnpm / bun)

Se você usou https://openclaw.ai/install.sh ou install.ps1, a CLI foi instalada com npm install -g openclaw@latest. Remova-a com npm rm -g openclaw (ou pnpm remove -g / bun remove -g se você usou um desses métodos).

Checkout do código-fonte (git clone)

Se você executa a partir de um checkout do repositório (git clone + openclaw ... / bun run openclaw ...):

  1. Desinstale o serviço do Gateway antes de excluir o repositório (use o caminho fácil acima ou a remoção manual do serviço).
  2. Exclua o diretório do repositório.
  3. Remova o estado e o espaço de trabalho conforme mostrado acima.

Relacionado

Was this useful?
On this page

On this page