Desinstala OpenClaw en Linux sin unidades systemd residuales

Linux ejecuta la puerta de enlace de OpenClaw como un servicio systemd de nivel de usuario, lo que significa que desinstalarlo requiere algo más que eliminar el binario. Las unidades, sockets y directorios de perfiles pueden persistir y seguir afectando a tu sistema.

Esta guía te guía por un proceso de eliminación limpio para garantizar que no queden servicios, archivos ni configuraciones residuales.

Resumen

Preparar Linux para la desinstalación

1. Guarda espacios de trabajo, registros de cron y secretos para restauraciones futuras.
2. Listar perfiles: ejecuta ls -d ~/.openclaw* para ver todos los directorios de estado predeterminados y con perfil.
3. Encontrar puertas de enlace remotas: anota cualquier host remoto donde también se ejecute la puerta de enlace; repetirás la limpieza allí más adelante.

Detener y desinstalar la unidad de la puerta de enlace

1. gateway uninstall elimina la unidad systemd y el socket mediante la CLI.
2. El comando unificado openclaw uninstall realiza estos pasos automáticamente.

Eliminar unidades de usuario y sockets de systemd

Comprueba nuevamente que no quede ninguna unidad:

Si usaste perfiles, repite con openclaw-gateway-<profile>.service. Usa systemctl --user list-units | grep openclaw para confirmar que no haya nada activo. (Referencia: página man de systemctl de systemd)

Limpieza de archivos residuales de OpenClaw en Linux

1. Espacio de trabajo + registros: elimina ~/.openclaw/workspace, ~/.openclaw/logs y cualquier ruta personalizada de espacio de trabajo (/srv/agents/...).
2. Directorios de caché: si almacenaste archivos de caché en /var/tmp/openclaw o una ruta similar, elimínalos también.
3. Editores/terminales: borra las entradas del historial de shell que incluyan secretos (history -d o sed -i en .bash_history) si es necesario.

Eliminar la CLI y los artefactos de shell

Si clonaste el repositorio en lugar de instalarlo globalmente, elimina el clon después de apagar la puerta de enlace. Elimina cualquier autocompletado de shell o alias personalizado que haga referencia a OpenClaw de ~/.bashrc, ~/.zshrc o ~/.config/fish/config.fish.

Revocar claves de API y hosts remotos

1. Revoca los tokens OAuth (Slack, Google, Notion, GitHub, Discord, etc.) que estuvieran vinculados a este equipo Linux.
2. Elimina claves SSH o tokens de despliegue si concediste a OpenClaw acceso a repositorios Git privados.
3. Si ejecutaste puertas de enlace remotas, repite los pasos de desinstalación de la puerta de enlace en cada host para que no quede ningún servicio en segundo plano.

Verificar la desinstalación y próximos pasos

1. debería responder “No se pudo encontrar la unidad openclaw-gateway.service.”
2. Comprobación del binario: which openclaw no debería devolver nada.
3. Comprobación del sistema de archivos: ls ~/.openclaw ~/.openclaw-* debería mostrar “No existe el archivo o el directorio.”
4. Revisión del journal: journalctl --user -u openclaw-gateway.service debería mostrar solo entradas antiguas, ninguna nueva.

Cuando todo esté despejado, reinstala en la misma máquina o migra a un nuevo host.

Preguntas frecuentes

¿Necesito sudo para algún comando?

No. OpenClaw usa unidades systemd de nivel de usuario. Ejecuta los comandos como el mismo usuario que instaló la puerta de enlace.

¿Cómo limpio sandboxes de Docker o Podman?

Detén y elimina cualquier contenedor/imagen que haga referencia a OpenClaw: docker rm <container> → docker rmi <image> (o los equivalentes de Podman) para mantener limpios los registros.

¿Puedo omitir la eliminación del espacio de trabajo?

Solo si quieres conservar las transcripciones locales. De lo contrario, mueve los archivos a otro lugar y elimina los originales para garantizar una desinstalación limpia.

¿Qué pasa si systemctl --user dice que el servicio está enmascarado?

Ejecuta primero systemctl --user unmask openclaw-gateway.service y luego vuelve a ejecutar los comandos para deshabilitar/eliminar.