OpenClawDocs
En esta página

En esta página

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

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

bash
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 presence

system 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>: now o next-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.

Relacionado

Was this useful?