🔧 Desinstalação manual passo a passo

Quando a desinstalação em um clique não tá disponível (por exemplo, se a CLI quebrou), segue esses passos manualmente. A ordem importa — primeiro para os serviços, depois deleta arquivos, e por último remove a ferramenta.

Passo 1: Parar o serviço Gateway

Primeiro, garante que o serviço gateway rodando em segundo plano tá parado:

openclaw gateway stop

Se o comando openclaw já não funciona, pula esse passo e usa comandos do sistema pra forçar a parada (vê a página de limpeza especial do seu sistema operacional).

Passo 2: Desinstalar serviços daemon

Remove a configuração de inicialização automática pra que o serviço não volte depois de reiniciar:

openclaw gateway uninstall

Igualmente, se a CLI não funciona, vai precisar fazer manualmente — macOS: limpa launchd, Linux: limpa systemd, Windows: limpa tarefas agendadas. Vê os detalhes nas páginas especiais de cada sistema.

Passo 3: Deletar configuração e dados de estado

Todos os arquivos de configuração, conversas e estados de OpenClaw são armazenados no diretório de estado:

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

Se você customizou a variável de ambiente OPENCLAW_STATE_DIR, precisa verificar o caminho real. Por padrão é ~/.openclaw.

⚠️ Esse passo é irreversível! Todas as suas conversas e configurações personalizadas vão ser deletadas. Se você pode vir a precisar delas depois, faz um backup do diretório ~/.openclaw primeiro. Pra recomendações de backup, dá uma olhada em Coisas importantes que você precisa saber.

Passo 4: Deletar arquivos de workspace (opcional)

Se você já deletou o diretório .openclaw no passo 3, dá pra pular isso. Se não, deleta os workspaces separadamente:

rm -rf ~/.openclaw/workspace

Passo 5: Remover a ferramenta CLI

Dependendo de como você instalou OpenClaw originalmente, escolhe o comando correspondente:

Instalação com npm

npm rm -g openclaw

Instalação com pnpm

pnpm remove -g openclaw

Instalação com Bun

bun remove -g openclaw

Instalação com Homebrew (macOS)

# Versão CLI
brew uninstall openclaw-cli

# Versão de aplicação desktop
brew uninstall --cask openclaw

Instalação a partir do código-fonte (git clone)

Se você instalou a partir do código-fonte, garante que completou primeiro os passos anteriores de parada de serviços, aí é só deletar o diretório do código-fonte. Sempre para o serviço antes de deletar o diretório, senão o serviço pode referenciar caminhos deletados causando erros.

Instalação com múltiplos Profiles

Se você usou Profiles customizados (por exemplo, um pro trabalho e um pessoal), cada um tem seu próprio diretório de estado que precisa ser deletado:

# Deleta todos os diretórios de profile relacionados com openclaw
rm -rf ~/.openclaw
rm -rf ~/.openclaw-*

💡 Não sabe quantos Profiles tem? Roda ls -la ~ | grep openclaw pra ver.