​

openclaw daemon

​

Uso

openclaw daemon status
openclaw daemon install
openclaw daemon start
openclaw daemon stop
openclaw daemon restart
openclaw daemon uninstall

​

Subcomandos y opciones

• status: muestra el estado de instalación del servicio (launchd/systemd/schtasks) y sondea la salud de Gateway.
• install: instala el servicio; --force reinstala/sobrescribe una instalación existente.
• restart --safe: pide al Gateway en ejecución que haga una comprobación previa del trabajo activo y programe un único reinicio combinado después de que el trabajo se vacíe, limitado por gateway.reload.deferralTimeoutMs (valor predeterminado 300000ms/5 minutos; configúralo en 0 para esperar indefinidamente). Cuando ese presupuesto expira, el reinicio se fuerza de todos modos. restart sin más usa directamente el administrador de servicios; --force es la anulación inmediata.
• restart --safe --skip-deferral: omite la puerta de aplazamiento por trabajo activo, de modo que Gateway se reinicia de inmediato aunque se informen bloqueadores. Requiere --safe.

​

Notas

• status resuelve los SecretRefs de autenticación configurados para la autenticación del sondeo cuando es posible. Si un SecretRef requerido no está resuelto, status --json informa rpc.authWarning; pasa --token/--password explícitamente o resuelve primero el origen del secreto. Las advertencias de autenticación no resuelta se suprimen una vez que el sondeo se realiza correctamente por lo demás.
• status --deep agrega un escaneo de sistema de mejor esfuerzo para otros servicios similares a Gateway (imprime sugerencias de limpieza; se sigue recomendando un Gateway por máquina) y ejecuta la validación de configuración en modo consciente de plugins, mostrando advertencias de manifiestos de plugins que la ruta predeterminada rápida omite.
• En instalaciones systemd de Linux, las comprobaciones de desviación del token inspeccionan tanto las fuentes de unidad Environment= como EnvironmentFile=.
• Las comprobaciones de desviación del token resuelven los SecretRefs de gateway.auth.token usando el entorno de runtime combinado (primero el entorno del comando de servicio y luego el entorno del proceso). Si la autenticación por token no está efectivamente activa (gateway.auth.mode de password/none/trusted-proxy, o sin definir con la contraseña pudiendo prevalecer), se omite la resolución del token de configuración.
• install valida que un gateway.auth.token administrado por SecretRef se pueda resolver, pero nunca persiste el valor resuelto en los metadatos del entorno de servicio; si no puede resolverlo, la instalación falla de forma cerrada.
• Si tanto gateway.auth.token como gateway.auth.password están configurados y gateway.auth.mode no está definido, install bloquea hasta que establezcas el modo explícitamente.
• En macOS, install mantiene los plists de LaunchAgent y el archivo de entorno/wrapper generado solo para el propietario (modo 0600/0700) en lugar de incrustar secretos en EnvironmentVariables.
• Ejecutar varios Gateways en un host: aísla puertos, configuración/estado y espacios de trabajo. Consulta Varios gateways.

​

Relacionado

• Referencia de CLI
• Runbook de Gateway