Maintenance
Desinstalar
Dois caminhos:
- Caminho fácil se
openclawainda estiver instalado. - Remoção manual do serviço se a CLI já tiver sido removida, mas o serviço ainda estiver em execução.
Caminho fácil (CLI ainda instalada)
Recomendado: use o desinstalador interno:
openclaw uninstall
Não interativo (automação / npx):
openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive
Etapas manuais (mesmo resultado):
- Pare o serviço gateway:
openclaw gateway stop
- Desinstale o serviço gateway (launchd/systemd/schtasks):
openclaw gateway uninstall
- 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.
- Exclua seu workspace (opcional, remove arquivos do agente):
rm -rf ~/.openclaw/workspace
- Remova a instalação da CLI (escolha a que você usou):
npm rm -g openclaw
pnpm remove -g openclaw
bun remove -g openclaw
- Se você instalou o app do 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 do gateway, então execute as etapas 1-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.gateway
rm -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 existirem.
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.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --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.
schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"
Se você usou um perfil, exclua o nome de tarefa correspondente e ~\.openclaw-<profile>\gateway.cmd.
Instalação normal vs 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 com npm rm -g openclaw (ou pnpm remove -g / bun remove -g se você instalou dessa forma).
Checkout do código-fonte (git clone)
Se você executa a partir de um checkout do repositório (git clone + openclaw ... / bun run openclaw ...):
- 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).
- Exclua o diretório do repositório.
- Remova estado + workspace como mostrado acima.