Como desinstalar o OpenClaw por completo

Desinstalar o OpenClaw envolve quatro escopos, não um comando: o serviço do Gateway, o diretório de estado, o espaço de trabalho e a própria CLI, além do app de desktop, se você o instalou. A documentação oferece um caminho fácil enquanto a CLI ainda está instalada e um caminho manual para quando ela já não existe, mas o serviço continua rodando, que é o caso que gera os tópicos nos fóruns. Veja os dois, e a única coisa a mover antes de apagar qualquer coisa.

O caminho fácil

• Um único comando de desinstalação, interativo por padrão, pré-seleciona apenas o serviço do Gateway; selecione também estado, espaço de trabalho e app, ou passe a flag all, para uma remoção completa.
• Uma simulação com a flag all mostra antes o que seria removido, sem riscos.
• A remoção do estado preserva os diretórios de espaço de trabalho configurados, a menos que você selecione também o escopo do espaço de trabalho.
• A remoção do serviço é a trava de segurança: se ela falhar, a exclusão do estado e do espaço de trabalho não prossegue, e o comando retorna um status diferente de zero quando qualquer escopo falha.

Ao contrário de openclaw uninstall --state, a exclusão manual do estado não preserva os espaços de trabalho.

O caminho manual

• Pare o serviço do Gateway e depois desinstale-o: launchd no macOS, systemd no Linux, o Agendador de Tarefas (Scheduled Tasks) no Windows.
• Primeiro, mova para fora do diretório de estado todos os espaços de trabalho que você quer manter, inclusive o padrão, porque excluir o diretório de estado exclui os espaços de trabalho que estão dentro dele.
• Exclua o diretório de estado e de configuração, e um caminho de configuração personalizado, se você tiver definido um; exclua um espaço de trabalho externo apenas se quiser que os arquivos do agente também sumam.
• Remova a CLI com a ferramenta que a instalou, qualquer que seja, e o app do macOS da pasta Aplicativos.

Dois resquícios que a documentação cita

Uma unidade de serviço anterior à mudança de nome, da época do Clawdbot, ainda pode existir em máquinas atualizadas a partir de instalações muito antigas; os comandos de desinstalação a detectam. E variáveis de ambiente com os prefixos antigos não fazem nada além de gerar um aviso, então vale a pena removê-las dos perfis de shell enquanto você está nisso. Clawdbot, Moltbot, OpenClaw traz o resto dessa história.

Antes de desinstalar: faça backup

O espaço de trabalho guarda os arquivos de memória, as skills que você escreveu e as instruções do agente; o diretório de estado guarda a configuração, as credenciais e as sessões. Se houver qualquer chance de você voltar, o comando de backup existe, e o artigo sobre como funciona a memória do OpenClaw explica o que são os arquivos de memória e por que eles são a parte que vale a pena guardar.

O outro jeito de parar de se preocupar

As pessoas desinstalam por dois motivos: não precisam mais dele, ou não querem mais rodá-lo por conta própria. Para o segundo caso, o OpenClaw hospedado na Diali é o mesmo motor mantido vivo em uma instância isolada, com o espaço de trabalho em backup e as atualizações testadas antes, e nada na sua máquina para remover depois.

• Serviço, estado, espaço de trabalho, CLI, app: cinco coisas, um comando com a flag all.
• Mova o espaço de trabalho para fora antes de uma exclusão manual.
• O serviço precisa parar antes que qualquer outra coisa seja removida.