openclaw daemon

Alias heredado para la gestión del servicio Gateway. openclaw daemon ... se asigna a los mismos comandos de control del servicio que openclaw gateway .... Para consultar la documentación y los ejemplos actuales, se recomienda openclaw gateway.

Uso

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

Subcomandos y opciones

• status: muestra el estado de instalación del servicio (launchd/systemd/schtasks) y sondea el estado del Gateway.
• install: instala el servicio; --force reinstala o sobrescribe una instalación existente.
• restart --safe: solicita al Gateway en ejecución que compruebe previamente el trabajo activo y programe un único reinicio combinado una vez que finalice el trabajo, limitado por gateway.reload.deferralTimeoutMs (valor predeterminado: 300000ms/5 minutos; se establece en 0 para esperar indefinidamente). Cuando se agota ese plazo, el reinicio se fuerza de todos modos. restart sin modificadores usa directamente el gestor de servicios; --force es la anulación inmediata.
• restart --safe --skip-deferral: omite la condición de aplazamiento por trabajo activo para que el Gateway se reinicie inmediatamente, incluso cuando se notifican bloqueos. Requiere --safe.

Notas

• status resuelve las SecretRefs de autenticación configuradas para la autenticación del sondeo cuando es posible. Si una SecretRef requerida no está resuelta, status --json informa de rpc.authWarning; se deben proporcionar explícitamente --token/--password o resolver primero el origen del secreto. Las advertencias de autenticación sin resolver se suprimen una vez que el sondeo tiene éxito por lo demás.
• status --deep añade un análisis a nivel del sistema, en la medida de lo posible, para detectar otros servicios similares a Gateway (muestra sugerencias de limpieza; se sigue recomendando un Gateway por máquina) y ejecuta la validación de la configuración en un modo que tiene en cuenta los plugins, mostrando advertencias de los manifiestos de los plugins que omite la ruta rápida predeterminada.
• En instalaciones de systemd en Linux, las comprobaciones de divergencia del token inspeccionan las fuentes de unidad Environment= y EnvironmentFile=.
• Las comprobaciones de divergencia del token resuelven las SecretRefs de gateway.auth.token mediante el entorno de ejecución combinado (primero el entorno del comando del servicio y después el entorno del proceso). Si la autenticación mediante token no está activa de forma efectiva (gateway.auth.mode de password/none/trusted-proxy, o sin establecer cuando puede prevalecer la contraseña), se omite la resolución del token de configuración.
• install valida que un gateway.auth.token gestionado mediante SecretRef se pueda resolver, pero nunca conserva el valor resuelto en los metadatos del entorno del servicio; si no puede resolverlo, la instalación falla de forma segura.
• Si están configurados tanto gateway.auth.token como gateway.auth.password y gateway.auth.mode no está establecido, install se bloquea hasta que se establezca explícitamente el modo.
• En macOS, install mantiene los archivos plist de LaunchAgent y el archivo de entorno o contenedor generado accesibles únicamente para el propietario (modo 0600/0700), en lugar de incrustar secretos en EnvironmentVariables.
• Para ejecutar varios Gateways en un mismo host: se deben aislar los puertos, la configuración y el estado, y los espacios de trabajo. Consulte Varios gateways.

Contenido relacionado

• Referencia de la CLI
• Guía operativa del Gateway