Cómo desinstalar openclaw de tu sistema

¿Alguna vez has borrado una herramienta y has descubierto que todavía hay procesos en segundo plano consumiendo recursos? Es frustrante lidiar con servicios que se quedan activos o archivos de configuración ocultos que ocupan espacio después de haber eliminado el binario principal.

Si necesitas limpiar tu entorno de desarrollo o simplemente quieres empezar de cero, aquí tienes los pasos para eliminar openclaw por completo.

Requisitos previos

• Acceso a la terminal de tu sistema operativo.
• Permisos para gestionar servicios (launchd, systemd o Scheduled Tasks).

Inicio rápido

Si todavía tienes la CLI instalada, el camino más rápido es usar el desinstalador integrado. Solo toma un minuto:

openclaw uninstall

Si estás trabajando en un entorno de automatización o usas npx, puedes ejecutarlo sin intervención:

openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive

Desinstalación manual (CLI instalada)

Si prefieres controlar cada paso o el comando automático no encaja con tu configuración, sigue este orden para limpiar el sistema:

1. Detén el servicio Gateway:

   openclaw gateway stop

2. Desinstala el servicio del sistema (launchd/systemd/schtasks):

   openclaw gateway uninstall

3. Elimina el estado y la configuración:

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

   Si definiste un OPENCLAW_CONFIG_PATH personalizado fuera del directorio de estado, borra también ese archivo.

4. Borra tu workspace (opcional, elimina archivos de agentes):

   rm -rf ~/.openclaw/workspace

5. Elimina la CLI (según el gestor que usaste):

   npm rm -g openclaw
   pnpm remove -g openclaw
   bun remove -g openclaw

6. Si instalaste la app de macOS:

   rm -rf /Applications/OpenClaw.app

Ten en cuenta que si usaste perfiles (--profile o OPENCLAW_PROFILE), debes repetir el paso 3 para cada directorio de estado (por defecto es ~/.openclaw-<profile>). En modo remoto, el directorio de estado vive en el host del Gateway, así que ejecuta los pasos del 1 al 4 allí también.

Eliminación manual del servicio (CLI no instalada)

Usa estos comandos si el servicio Gateway sigue ejecutándose pero ya has borrado la CLI de openclaw.

macOS (launchd)

La etiqueta por defecto es bot.molt.gateway. Si usaste un perfil, usa bot.molt.<profile>.

launchctl bootout gui/$UID/bot.molt.gateway
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist

Linux (systemd user unit)

El nombre por defecto de la unidad es openclaw-gateway.service.

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

Windows (Scheduled Task)

La tarea se llama OpenClaw Gateway. El script de la tarea está en tu directorio de estado.

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

Instalación normal vs código fuente

Si instalaste mediante el script install.sh o gestores de paquetes como npm, la CLI se elimina con npm rm -g openclaw.

Si estás ejecutando openclaw desde un clon del repositorio de git:

1. Desinstala el servicio Gateway antes de borrar el repositorio.
2. Borra la carpeta del repositorio.
3. Elimina el estado y el workspace como se explicó arriba.

Solución de problemas

• El Gateway sigue apareciendo en los procesos: Verifica si tienes procesos huérfanos de Node.js ejecutando el script del Gateway y sigue los pasos de “Eliminación manual del servicio” según tu sistema operativo.
• Quedan archivos de perfiles antiguos: Si usaste múltiples perfiles, busca carpetas con el patrón ~/.openclaw-<nombre> y elimínalas manualmente para liberar espacio.

Si tienes dudas sobre algún paso específico de tu configuración, consulta al AI Setup Assistant.

Próximos pasos

• Instalación de openclaw
• Configuración de perfiles