Cómo desinstalar OpenClaw sin dejar rastro

OpenClaw instala mucho más que un único ejecutable. El servicio de gateway, los agentes de inicio, los directorios de estado, las credenciales en caché y las aplicaciones de escritorio opcionales permanecen hasta que los eliminas explícitamente. Por eso, una desinstalación limpia requiere más que borrar el binario de la CLI.

Este desmontaje práctico explica cómo hacer una copia de seguridad, ejecutar el flujo compatible de openclaw uninstall, eliminar servicios específicos de cada plataforma y realizar la “limpieza de archivos sobrantes” que garantiza que no queden carpetas de perfil ni secretos de API.

TL;DR

Crea una copia de seguridad y mapea cada perfil

1. Esto crea un archivo restaurable de espacios de trabajo de agentes, registros de cron y archivos de memoria. (Fuente: documentación de desinstalación de la CLI de OpenClaw)
2. Enumera los directorios de estado: comprueba si existen ~/.openclaw, ~/.openclaw-<profile> y ubicaciones personalizadas de OPENCLAW_STATE_DIR. Anótalos: eliminarás cada uno más adelante.
3. Cataloga los conectores: anota qué espacios de trabajo de Slack, cuentas de Google, webhooks personalizados o claves de API personales se emparejaron para poder revocarlos después de la eliminación.

Ejecuta el flujo oficial de desinstalación

Con la CLI aún presente, deja que OpenClaw elimine sus propios servicios:

1. Este comando detiene el gateway, anula el registro de entradas de launchd/systemd/schtasks, elimina el directorio de estado predeterminado y borra las credenciales en caché.
2. Usa openclaw uninstall --dry-run primero si necesitas una vista previa de lo que se eliminará.

Si la CLI ya no está, pasa directamente a la sección de eliminación manual del servicio.

Detén y anula el registro de los servicios del sistema operativo

macOS (launchd)

Sustituye ai.openclaw.gateway por ai.openclaw.<profile> para cada perfil que hayas creado.

Linux (unidad de usuario systemd)

Las unidades heredadas usan openclaw-gateway-<profile>.service; elimina cada una antes de continuar.

Windows (tarea programada)

Abre PowerShell como el mismo usuario que instaló OpenClaw:

Luego elimina %USERPROFILE%\.openclaw\gateway.cmd (o la variante con perfil) para que Windows no pueda volver a iniciarlo.

Elimina archivos sobrantes y perfiles

Aquí es donde entra en juego la palabra clave secundaria: openclaw leftover files cleanup.

1. Directorios específicos de perfil: para cada perfil que anotaste antes:

1. Ruta de configuración personalizada: si configuraste OPENCLAW_CONFIG_PATH, elimina también ese archivo.
2. Sandboxes de Docker o VM: ejecuta docker rm / docker rmi (o podman rm / podman rmi) para cualquier imagen etiquetada con OpenClaw y así mantener limpios los registros.

Elimina la CLI y las aplicaciones de escritorio

Según el instalador que hayas usado:

Si usaste install.sh / install.ps1, la CLI se añadió mediante npm install -g openclaw@latest, por lo que npm rm -g openclaw es suficiente.

Revoca claves de API y webhooks

La desinstalación local no invalida tokens externos. Visita cada servicio conectado (Google Cloud Console, panel de Slack App, Discord Developer Portal, integraciones de Notion, tokens de GitHub) y revoca las credenciales generadas para OpenClaw. Rota los secretos compartidos en cualquier lugar donde se hayan reutilizado.

Verifica la limpieza y planifica tu próxima instalación

1. Procesos y servicios:macOS: launchctl list | grep openclaw
2. Linux: systemctl --user status openclaw-gateway.service
3. Windows: Get-Process OpenClaw* y schtasks /Query /TN "OpenClaw Gateway"
4. Comprobación del binario: which openclaw (macOS/Linux) o Get-Command openclaw (PowerShell) debería devolver “not found.”
5. Comprobación del sistema de archivos: ls ~/.openclaw y ls ~/.openclaw-* deberían devolver “No such file or directory.”
6. Ruta futura: si estás desinstalando para pasar a un host administrado o a una máquina nueva, documenta si reinstalarás localmente, levantarás un gateway remoto o migrarás a un plano de control alojado antes de borrar las copias de seguridad.

Preguntas frecuentes

¿Puedo reinstalar inmediatamente después de ejecutar openclaw uninstall?

Sí. El comando elimina el estado y los servicios, pero deja intactos los gestores de paquetes globales. Una vez que pasen las comprobaciones de limpieza, vuelve a ejecutar npm install -g openclaw (o el script de instalación) e inicia la incorporación como si fuera una máquina nueva.

¿Qué pasa si el servicio sigue reiniciándose después de que elimino archivos?

Probablemente omitiste la entrada de launchd/systemd/schtasks. Vuelve a ejecutar los comandos específicos de la plataforma anteriores y luego elimina cualquier archivo gateway.cmd o .service persistente al que haga referencia el programador de tu sistema operativo.

¿Tengo que eliminar el espacio de trabajo?

No, pero dejar ~/.openclaw/workspace atrás frustra el propósito de una desinstalación limpia. Archívalo en otro lugar si quieres conservar transcripciones históricas y luego elimínalo de la máquina que estás borrando.

¿Cómo gestiono gateways remotos?

Repite los pasos de desinstalación en el host remoto que ejecuta el servicio de gateway. El comando openclaw uninstall solo elimina el estado de la máquina local, así que los hosts remotos deben limpiarse por separado.