Desinstalar

Dois caminhos:

• Caminho fácil se openclaw ainda estiver instalado.
• Remoção manual do serviço se a CLI tiver sido removida, mas o serviço ainda estiver em execução.

Caminho fácil (CLI ainda instalada)

Recomendado: use o desinstalador integrado:

openclaw uninstall

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

Pré-visualize o que será removido (seguro):

openclaw uninstall --dry-run --all

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

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

Etapas manuais (mesmo resultado):

1. Pare o serviço Gateway:

openclaw gateway stop

2. Desinstale o serviço Gateway (launchd/systemd/schtasks):

openclaw gateway uninstall

3. Exclua estado + configuração:

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

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

4. Exclua seu workspace (opcional, remove arquivos de agentes):

rm -rf ~/.openclaw/workspace

5. Remova a instalação da CLI (escolha a que você usou):

npm rm -g openclawpnpm remove -g openclawbun remove -g openclaw

6. Se você instalou o app para macOS:

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 Gateway, então execute as etapas 1 a 4 lá também.

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

Use isto se o serviço Gateway continuar em execução, mas openclaw estiver ausente.

macOS (launchd)

O rótulo padrão é ai.openclaw.gateway (ou ai.openclaw.<profile>; o legado com.openclaw.* ainda pode existir):

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>. Remova quaisquer plists legados com.openclaw.* se estiverem presentes.

Linux (unidade de usuário systemd)

O nome padrão da unidade é openclaw-gateway.service (ou openclaw-gateway-<profile>.service):

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>)). O script da tarefa fica no seu diretório de estado como gateway.cmd; instalações atuais também podem criar um inicializador sem janela gateway.vbs que o Agendador de Tarefas executa em vez de abrir gateway.cmd diretamente.

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 o nome da tarefa correspondente e os arquivos gateway.cmd / gateway.vbs em ~\.openclaw-<profile>.

Instalação normal vs checkout de 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ê instalou dessa forma).

Checkout de 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 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 estado + workspace conforme mostrado acima.

Relacionado

• Visão geral da instalação
• Guia de migração