Manual de desinstalaciónmacOS / Linux / WindowsDocker / Podman / Nix / Ansible

Guía completa de desinstalación de OpenClaw

No es solo “borrar una app”: debes gestionar servicios de gateway en segundo plano, directorios de estado/configuración, residuos de despliegues en contenedores y (muy recomendado) revocar permisos y claves concedidas.

Orden recomendado

Primero openclaw uninstall o detener el servicio → luego desinstalar la CLI.

Copiar con un clic

Botón de copia en la esquina superior derecha de cada bloque.

Cierre de seguridad

Tras desinstalar, revoca OAuth / rota las claves API.

Step 0

Primero ubica: ¿cómo lo instalaste?

Cada método de instalación tiene su ruta de desinstalación. Encuentra la tuya en 10 segundos.

A. Instalación local

El comando openclaw funciona y UI/servicio puede estar en segundo plano.

Ir a la sección

B. CLI no está

El comando openclaw desapareció, pero servicio/proceso sigue activo.

Ir a la sección

C/D. Contenedores

Usaste docker-setup.sh o setup-podman.sh.

Ir a la sección

E/F. Nix / Ansible

Desplegado vía nix-openclaw o openclaw-ansible.

Ir a la sección

Step 1

Desinstalación oficial (CLI disponible)

Si el comando openclaw aún funciona, usa primero el desinstalador integrado.

1.1 Un comando (recomendado)

Para la mayoría: desinstalación interactiva, sigue las indicaciones.

bash

openclaw uninstall

1.2 Automatización / Sin intervención

Para entornos automatizados, omite los prompts.

bash

openclaw uninstall --all --yes --non-interactive

# 或者 npx 直接跑
npx -y openclaw uninstall --all --yes --non-interactive

Step 2

CLI no está pero el servicio sigue activo

Cuando el comando openclaw no existe pero los servicios aún se ejecutan.

macOS (launchd)

Label por defecto: ai.openclaw.gateway (pueden existir nombres antiguos). Detén el servicio y elimina el plist.

bash

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

Revisar nombres antiguos:

bash

ls -1 ~/Library/LaunchAgents | grep -Ei 'openclaw|clawd|clawdbot|molt'
launchctl list | grep -Ei 'openclaw|clawd|clawdbot|molt'

Linux (systemd user)

Unit por defecto: openclaw-gateway.service (el profile puede añadir sufijo).

bash

systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

Comprobar:

bash

systemctl --user list-unit-files | grep -i openclaw
systemctl --user status openclaw-gateway.service

Windows (Scheduled Task)

Nombre de tarea por defecto: OpenClaw Gateway (el profile puede añadir sufijo).

powershell

schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

Step 3

Eliminar archivos residuales

Limpia estado/config/workspace y directorios antiguos.

Rutas predeterminadas

Estado/config y workspace suelen estar en ~/.openclaw

bash

rm -rf ~/.openclaw

Directorios heredados (opcional)

Si usaste versiones antiguas, revisa estos directorios.

bash

rm -rf ~/.clawdbot
rm -rf ~/clawdbot

Step 4

Docker / Podman

Eliminar gateway en contenedores y limpiar datos del host.

Docker Compose

Ejecuta en el directorio del repositorio para detener y eliminar contenedores.

bash

docker compose down

docker compose down -v

Eliminar directorio persistente del host:

bash

rm -rf ~/.openclaw

Podman (rootless)

Detén el servicio Quadlet si se usa, luego elimina contenedor y datos.

bash

sudo systemctl --machine openclaw@ --user stop openclaw.service
sudo -u openclaw podman rm -f openclaw

Eliminar datos del host en modo Podman:

bash

sudo rm -rf /home/openclaw/.openclaw
sudo rm -f /home/openclaw/.config/containers/systemd/openclaw.container
sudo systemctl --machine openclaw@ --user daemon-reload

Step 5

Nix / Ansible

Para despliegues con Nix / Ansible.

Nix / Home Manager

Elimina o desactiva el módulo nix-openclaw y vuelve a aplicar.

bash

home-manager switch

home-manager switch --rollback

Si hace falta, elimina tu directorio de estado (puede ser personalizado).

Ansible (openclaw-ansible)

Detén y deshabilita el servicio, luego elimina rutas de instalación y datos.

bash

sudo systemctl stop openclaw
sudo systemctl disable openclaw

sudo rm -rf /opt/openclaw
sudo rm -rf /home/openclaw/openclaw
sudo rm -rf /home/openclaw/.openclaw

Elimina el usuario openclaw solo si estás seguro.

bash

sudo userdel -r openclaw

Step 6

Autocomprobación post‑desinstalación

Confirma que servicios, puertos y directorios locales estén limpios.

Step 7

Revocar acceso y rotar claves

Desinstalar no es revocar acceso. Completa acciones mínimas de seguridad.

Como mínimo, haz estas tres acciones:

Rota todas las claves API dadas a OpenClaw (invalida las antiguas).
Cierra sesión/elimina sesiones sospechosas (chat, correo, consola cloud, etc.).
Revoca permisos OAuth/App (Google/Microsoft/GitHub, etc.).

Cada plataforma es distinta; sigue el centro de seguridad correspondiente.