CLI commands
Sistema
openclaw system
Utilidades de nivel de sistema para el Gateway: poner en cola eventos del sistema, controlar los Heartbeats y consultar la presencia.
Todos los subcomandos de system usan RPC del Gateway y aceptan las opciones compartidas del cliente:
| Opción | Valor predeterminado | Descripción |
|---|---|---|
--url <url> |
gateway.remote.url cuando está configurado |
URL WebSocket del Gateway. |
--token <token> |
ninguno | Token del Gateway (si es necesario). |
--timeout <ms> |
30000 |
Tiempo de espera de RPC en milisegundos. |
--expect-final |
desactivado | Espera la respuesta final (agente). |
--json |
desactivado | Genera JSON. heartbeat last/enable/disable y system presence siempre imprimen la carga útil JSON sin procesar de RPC independientemente de esta opción; system event la usa para alternar entre JSON y una línea ok sin formato. |
Comandos comunes
openclaw system event --text "Check for urgent follow-ups" --mode nowopenclaw system event --text "Check for urgent follow-ups" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"openclaw system heartbeat enableopenclaw system heartbeat lastopenclaw system presencesystem event
De forma predeterminada, pone en cola un evento del sistema en la sesión principal. El siguiente
Heartbeat lo inserta como una línea System: en el prompt. Use --mode now para
activar el Heartbeat inmediatamente; next-heartbeat (valor predeterminado) espera al
siguiente ciclo programado.
Pase --session-key para dirigirlo a una sesión específica, por ejemplo, para reenviar la
finalización de una tarea asíncrona al canal que la inició.
Opciones:
--text <text>: texto obligatorio del evento del sistema.--mode <mode>:nowonext-heartbeat(valor predeterminado).--session-key <sessionKey>: opcional; dirige el evento a una sesión específica del agente en lugar de a la sesión principal del agente. Las claves que no pertenezcan al agente resuelto recurren a la sesión principal del agente.
system heartbeat last|enable|disable
last: muestra el último evento de Heartbeat.enable: vuelve a activar los Heartbeats (úselo si estaban desactivados).disable: pausa los Heartbeats.
system presence
Enumera las entradas actuales de presencia del sistema que conoce el Gateway (nodos, instancias y líneas de estado similares).
Notas
- Requiere un Gateway en ejecución accesible mediante la configuración actual (local o remota).
- Los eventos del sistema son efímeros y no persisten entre reinicios.
