¿El servicio en segundo plano de OpenClaw no se detiene? Aquí está la solución real

Cuando la puerta de enlace de OpenClaw se niega a apagarse, lo sientes de inmediato: los ventiladores siguen girando, los puertos permanecen ocupados y el agente continúa ejecutando automatizaciones incluso después de que "cierras" la aplicación. Debido a que la puerta de enlace se ejecuta como un servicio en segundo plano, cerrar la interfaz de usuario o cerrar la sesión de tu escritorio rara vez termina el proceso. Si no lo detienes correctamente, terminas con instancias duplicadas, unidades que no se pueden montar o webhooks persistentes. Esta guía explica lo que realmente está sucediendo y cómo detener el servicio de forma segura en cada sistema operativo.

En resumen

1. OpenClaw se instala como un servicio persistente (systemd --user, launchctl, o OpenClawGateway en Windows), por lo que cerrar la interfaz de usuario no hace nada.
2. Deténgalo primero de la manera oficial (openclaw gateway stop, openclaw gateway autostart disable). Si sigue reapareciendo, elimine el agente de inicio o la definición del servicio.
3. Valide con systemctl --user status openclaw-gateway, launchctl list ai.openclaw.gateway, o Get-Service OpenClawGateway antes y después.
4. Una vez que esté detenido, limpie los sockets/registros persistentes y reconstruya el inicio automático solo si realmente lo necesita.

Comprenda cómo se instala el servicio

OpenClaw despliega una puerta de enlace en segundo plano la primera vez que ejecuta openclaw gateway start. El instalador coloca:

1. Linux: una unidad de systemd a nivel de usuario ~/.config/systemd/user/openclaw-gateway.service además de la habilitación persistente para que se ejecute incluso cuando cierra la sesión.
2. macOS: un plist de LaunchAgent ~/Library/LaunchAgents/ai.openclaw.gateway.plist que reinicia la puerta de enlace.
3. Windows: una entrada del Administrador de control de servicios llamada OpenClawGateway, además de una tarea programada que lo vuelve a habilitar si deshabilita el inicio automático solo en la interfaz de usuario.
4. Saber qué supervisor es el propietario del proceso le indica qué comando lo detiene realmente.

Evaluación rápida antes de forzar la detención

Verifique las sesiones activas: ejecute openclaw status para ver si hay trabajos en ejecución; cancelarlos puede dejar flujos de trabajo huérfanos.

Intente una detención controlada: openclaw gateway stop --timeout 30. Si devuelve éxito, ha terminado.

Confirme la lógica de reinicio: openclaw gateway autostart status muestra si un vigilante lo volverá a lanzar.

Capture los registros: siga ~/.openclaw/logs/gateway.log (Linux/macOS) o el Visor de eventos de Windows para que pueda confirmar la causa raíz después de la solución.

Linux: detenga el servicio de usuario de systemd

systemctl --user stop openclaw-gateway.service

systemctl --user disable openclaw-gateway.service

systemctl --user daemon-reload

loginctl disable-linger $USER (opcional) para evitar el inicio automático después de cerrar la sesión.

Verifique con systemctl --user status openclaw-gateway — debería mostrar inactive (dead).

Si queda un proceso rebelde, ejecute pkill -f openclaw-gateway y elimine el archivo de la unidad antes de volver a habilitarlo.

macOS: descargue el LaunchAgent

launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist

launchctl remove ai.openclaw.gateway 2>/dev/null

Elimine el plist si no desea el inicio automático: rm ~/Library/LaunchAgents/ai.openclaw.gateway.plist

Termine cualquier proceso restante: pkill -f openclaw-gateway

Reinicie o ejecute openclaw gateway start solo después de confirmar que el PID antiguo ha desaparecido con ps aux | grep openclaw.

Windows: detenga la entrada SCM y la tarea programada

Abra PowerShell como administrador y ejecute Stop-Service -Name OpenClawGateway -Force

Set-Service -Name OpenClawGateway -StartupType Disabled

Elimine la tarea programada que lo reinicia: Unregister-ScheduledTask -TaskName "OpenClaw Autostart" -Confirm:$false

Si el PID persiste, ejecute Stop-Process -Name openclaw -Force

Confirme con Get-Service OpenClawGateway — el estado debería ser Stopped.

También puede leer la documentación de Microsoft.

Cuando el servicio sigue reiniciándose solo

La CLI de OpenClaw puede reconstruir los ayudantes de inicio automático cada vez que actualiza o se autentica. Ejecute estos comandos para restablecer las expectativas:

1. openclaw gateway autostart disable (desactiva los relanzadores gestionados por la CLI)
2. openclaw gateway doctor (informa sobre unidades huérfanas)
3. Elimine sockets obsoletos (Linux/macOS): rm -f ~/.openclaw/run/gateway.sock
4. Si el servicio se reinicia inmediatamente, algo más (p. ej., un script de monitoreo o un perfil MDM) está llamando a openclaw gateway start. Busque en su crontab, ~/.config/openclaw/autostart.sh, y en las herramientas de gestión empresarial.

Valide la detención

Después de ejecutar los pasos anteriores:

1. Procesos: ps, el Administrador de tareas o el Monitor de actividad deberían mostrar cero entradas de openclaw.
2. Puertos: lsof -i :11434 (reemplace con su puerto de OpenClaw) no debería devolver nada.
3. Registros: las últimas líneas del registro de la puerta de enlace deberían incluir Stopping gateway... y ninguna entrada nueva después.
4. Monitores de recursos: el uso de CPU y RAM debería volver a la línea de base.

Evitar la recurrencia

1. Habilite el inicio automático solo en máquinas que realmente necesiten cobertura 24/7.
2. Documente qué usuarios y hosts están ejecutando OpenClaw; las instalaciones duplicadas a menudo ocurren cuando los equipos comparten credenciales.
3. Programe auditorías trimestrales: liste todas las unidades de usuario de systemd, LaunchAgents y servicios de Windows llamados *openclaw* para detectar desviaciones.
4. Mantenga la CLI actualizada. Las compilaciones más antiguas a veces ignoran las solicitudes de stop porque el binario del supervisor no coincide con la versión de la puerta de enlace.

Conclusión

Un servicio en segundo plano de OpenClaw descontrolado es casi siempre un problema del supervisor: el sistema operativo está haciendo exactamente lo que le pidió que hiciera: mantener viva la puerta de enlace. Una vez que elimina la unidad, el plist o el servicio de Windows y verifica dos veces las banderas de inicio automático, el proceso permanece inactivo. Trate la puerta de enlace como cualquier otro demonio: deténgalo limpiamente, deshabilite el vigilante, confirme que está inactivo y luego vuelva a habilitarlo solo cuando esté listo. También puede desinstalar OpenClaw siguiendo nuestra guía.

Preguntas frecuentes

¿Por qué OpenClaw vuelve a iniciarse inmediatamente después de que lo detengo?

Porque el vigilante de inicio automático (persistencia de systemd, LaunchAgents o una tarea programada) todavía está habilitado. Deshabilite el vigilante antes de detener el servicio.

¿Puedo simplemente terminar el proceso desde el Monitor de actividad o el Administrador de tareas?

Puede hacerlo, pero es probable que se reinicie a menos que deshabilite la definición del servicio. Siga los pasos específicos del sistema operativo anteriores para eliminar primero la entrada del supervisor.

¿Es seguro eliminar el LaunchAgent o la unidad de systemd?

Sí, siempre y cuando planee reinstalarlo o volver a habilitarlo más tarde. La CLI puede regenerar unidades nuevas con openclaw gateway autostart enable una vez que necesite el modo de segundo plano nuevamente.