CLI commands

Demonio

`openclaw daemon`

Alias heredado para los comandos de administración del servicio Gateway.

openclaw daemon ... se asigna a la misma superficie de control de servicio que los comandos de servicio openclaw gateway ....

Uso

bash

openclaw daemon statusopenclaw daemon installopenclaw daemon startopenclaw daemon stopopenclaw daemon restartopenclaw daemon uninstall

Subcomandos

status: mostrar el estado de instalación del servicio y comprobar la salud del Gateway
install: instalar el servicio (launchd/systemd/schtasks)
uninstall: eliminar el servicio
start: iniciar el servicio
stop: detener el servicio
restart: reiniciar el servicio

Opciones comunes

status: --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
install: --port, --runtime <node|bun>, --token, --force, --json
restart: --safe, --skip-deferral, --force, --wait <duration>, --json
ciclo de vida (uninstall|start|stop): --json

Notas:

status resuelve las SecretRefs de autenticación configuradas para la autenticación de la comprobación cuando es posible.
Si una SecretRef de autenticación requerida no se puede resolver en esta ruta de comando, daemon status --json informa rpc.authWarning cuando falla la conectividad/autenticación de la comprobación; pasa --token/--password explícitamente o resuelve primero el origen del secreto.
Si la comprobación se realiza correctamente, las advertencias de referencias de autenticación no resueltas se suprimen para evitar falsos positivos.
status --deep añade un escaneo de servicio a nivel de sistema de mejor esfuerzo. Cuando encuentra otros servicios similares a gateway, la salida para humanos imprime sugerencias de limpieza y advierte que un gateway por máquina sigue siendo la recomendación normal.
status --deep también ejecuta la validación de configuración en modo compatible con plugins y muestra advertencias configuradas del manifiesto de plugins (por ejemplo, metadatos de configuración de canal ausentes) para que las comprobaciones rápidas de instalación y actualización las detecten. El status predeterminado mantiene la ruta rápida de solo lectura que omite la validación de plugins.
En instalaciones systemd de Linux, las comprobaciones de desviación de token de status incluyen fuentes de unidad tanto Environment= como EnvironmentFile=.
Las comprobaciones de desviación resuelven SecretRefs de gateway.auth.token usando el entorno de runtime fusionado (primero el entorno del comando de servicio y luego el entorno del proceso como respaldo).
Si la autenticación por token no está efectivamente activa (gateway.auth.mode explícito de password/none/trusted-proxy, o modo sin definir cuando la contraseña puede prevalecer y ningún candidato de token puede prevalecer), las comprobaciones de desviación de token omiten la resolución del token de configuración.
Cuando la autenticación por token requiere un token y gateway.auth.token está administrado por SecretRef, install valida que la SecretRef se pueda resolver, pero no persiste el token resuelto en los metadatos del entorno del servicio.
Si la autenticación por token requiere un token y la SecretRef del token configurada no se puede resolver, la instalación falla en modo cerrado.
Si tanto gateway.auth.token como gateway.auth.password están configurados y gateway.auth.mode no está definido, la instalación se bloquea hasta que el modo se defina explícitamente.
En macOS, install mantiene los plists de LaunchAgent solo para el propietario y carga los valores administrados del entorno del servicio mediante un archivo y un wrapper solo para el propietario, en lugar de serializar claves de API o referencias env de perfil de autenticación en EnvironmentVariables.
Si ejecutas intencionalmente varios gateways en un mismo host, aísla puertos, configuración/estado y espacios de trabajo; consulta /gateway#multiple-gateways-same-host.
restart --safe pide al Gateway en ejecución que haga una comprobación previa del trabajo activo y programe un reinicio fusionado después de que el trabajo activo se drene. El reinicio seguro predeterminado espera el trabajo activo hasta el gateway.reload.deferralTimeoutMs configurado (valor predeterminado: 5 minutos); cuando ese presupuesto expira, el reinicio se fuerza. Define gateway.reload.deferralTimeoutMs en 0 para una espera segura indefinida que nunca fuerza. restart simple conserva el comportamiento existente del administrador de servicios; --force sigue siendo la ruta de anulación inmediata.
restart --safe --skip-deferral ejecuta el reinicio seguro compatible con OpenClaw, pero omite la puerta de aplazamiento de trabajo activo para que el Gateway emita el reinicio inmediatamente incluso cuando se informen bloqueadores. Vía de escape del operador cuando una ejecución de tarea atascada bloquea el reinicio seguro; requiere --safe.

Preferir

Usa openclaw gateway para la documentación y los ejemplos actuales.

Relacionado

Was this useful?