CLI commands
Sistema
openclaw system
Herramientas auxiliares a nivel del 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 de 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 | Esperar la respuesta final (agente). |
--json |
desactivado | Generar 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 simple de ok. |
Comandos comunes
openclaw system event --text "Comprobar si hay seguimientos urgentes" --mode nowopenclaw system event --text "Comprobar si hay seguimientos urgentes" --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 de System: en el prompt. Use --mode now para
activar el heartbeat de inmediato; next-heartbeat (valor predeterminado) espera al
siguiente ciclo programado.
Pase --session-key para dirigirse a una sesión específica, por ejemplo, para retransmitir 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; se dirige a una sesión específica del agente en lugar de a la sesión principal del agente. Las claves que no pertenecen 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 (use esta opción 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 al que se pueda acceder mediante la configuración actual (local o remota).
- Los eventos del sistema son efímeros y no se conservan entre reinicios.
