# openclaw system

Ayudantes a nivel de sistema para el Gateway: poner en cola eventos del sistema, controlar Heartbeats y ver la presencia.

Todos los subcomandos de system usan RPC del Gateway y aceptan las flags compartidas del cliente:

• --url <url>
• --token <token>
• --timeout <ms>
• --expect-final

# Comandos comunes

openclaw system event --text "Check for urgent follow-ups" --mode now
openclaw system event --text "Check for urgent follow-ups" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"
openclaw system heartbeat enable
openclaw system heartbeat last
openclaw system presence

# system event

Pone en cola un evento del sistema en la sesión principal. El siguiente Heartbeat lo inyectará como una línea System: en el prompt. Usa --mode now para activar el Heartbeat inmediatamente; next-heartbeat espera al siguiente tick programado.

Flags:

• --text <text>: texto obligatorio del evento del sistema.
• --mode <mode>: now o next-heartbeat (predeterminado).
• --json: salida legible por máquinas.
• --url, --token, --timeout, --expect-final: flags compartidas de RPC del Gateway.

# system heartbeat last|enable|disable

Controles de Heartbeat:

• last: muestra el último evento de Heartbeat.
• enable: vuelve a activar Heartbeats (úsalo si estaban deshabilitados).
• disable: pausa Heartbeats.

Flags:

• --json: salida legible por máquinas.
• --url, --token, --timeout, --expect-final: flags compartidas de RPC del Gateway.

# system presence

Lista las entradas actuales de presencia del sistema que conoce el Gateway (Node, instancias y líneas de estado similares).

Flags:

• --json: salida legible por máquinas.
• --url, --token, --timeout, --expect-final: flags compartidas de RPC del Gateway.

# Notas

• Requiere un Gateway en ejecución accesible mediante tu configuración actual (local o remota).
• Los eventos del sistema son efímeros y no persisten entre reinicios.

# Relacionado

• Referencia de CLI