🔧 Desinstalación manual paso a paso

Cuando la desinstalación de un clic no está disponible (por ejemplo, si la CLI se dañó), sigue estos pasos manualmente. El orden es importante — primero detén los servicios, luego elimina archivos, y finalmente remueve la herramienta.

Paso 1: Detener el servicio Gateway

Primero, asegúrate de que el servicio gateway que corre en segundo plano esté detenido:

openclaw gateway stop

Si el comando openclaw ya no funciona, salta este paso y usa comandos del sistema para forzar la detención (ver la página de limpieza especial de tu sistema operativo).

Paso 2: Desinstalar servicios de demonio

Remueve la configuración de inicio automático para que el servicio no regrese después de reiniciar:

openclaw gateway uninstall

Igualmente, si la CLI no funciona, necesitarás hacerlo manualmente — macOS: limpiar launchd, Linux: limpiar systemd, Windows: limpiar tareas programadas. Ver los detalles en las páginas especiales de cada sistema.

Paso 3: Eliminar configuración y datos de estado

Todos los archivos de configuración, conversaciones y estados de OpenClaw están almacenados en el directorio de estado:

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

Si personalizaste la variable de entorno OPENCLAW_STATE_DIR, necesitas verificar la ruta actual. Por defecto es ~/.openclaw.

⚠️ ¡Este paso es irreversible! Se perderán todas tus conversaciones y configuraciones personalizadas. Si podrías necesitarlas más adelante, haz una copia de seguridad del directorio ~/.openclaw primero. Para recomendaciones de copia de seguridad, consulta Cosas importantes que debes saber.

Paso 4: Eliminar archivos de espacios de trabajo (opcional)

Si ya eliminaste el directorio .openclaw en el paso 3, puedes saltarte esto. Si no, elimina los espacios de trabajo por separado:

rm -rf ~/.openclaw/workspace

Paso 5: Remover la herramienta CLI

Dependiendo de cómo instalaste OpenClaw originalmente, elige el comando correspondiente:

Instalación con npm

npm rm -g openclaw

Instalación con pnpm

pnpm remove -g openclaw

Instalación con Bun

bun remove -g openclaw

Instalación con Homebrew (macOS)

# Versión CLI
brew uninstall openclaw-cli

# Versión de aplicación de escritorio
brew uninstall --cask openclaw

Instalación desde código fuente (git clone)

Si lo instalaste desde código fuente, asegúrate de completar primero los pasos anteriores de detención de servicios, luego simplemente elimina el directorio del código fuente. Siempre detén el servicio primero antes de eliminar el directorio, de lo contrario el servicio podría referenciar rutas eliminadas causando errores.

Instalación con múltiples Profiles

Si usaste Profiles personalizados (por ejemplo, uno para trabajo y otro personal), cada uno tiene su propio directorio de estado que necesita ser eliminado:

# Elimina todos los directorios de profile relacionados con openclaw
rm -rf ~/.openclaw
rm -rf ~/.openclaw-*

💡 ¿No sabes cuántos Profiles tienes? Ejecuta ls -la ~ | grep openclaw para verlo.