Controla el Gateway con openclaw system

Mantener el control sobre lo que ocurre en segundo plano en tu Gateway puede ser frustrante. A veces necesitas que el sistema reaccione de inmediato a un cambio de contexto o simplemente verificar si todo sigue funcionando sin tener que reiniciar procesos.

Gestionar estos estados de forma manual suele ser un problema cuando no tienes las herramientas adecuadas para intervenir en la sesión. La mejor opción es utilizar los comandos de sistema para inyectar información o pausar procesos de mantenimiento según lo necesites.

Requisitos previos

• Un Gateway en ejecución que sea accesible por tu configuración actual.
• Configuración de acceso válida (local o remota).

Inicio rápido

Sigue estos pasos para interactuar con el sistema en menos de 5 minutos:

1. Inyecta un evento urgente: Usa este comando para que el Gateway reciba una instrucción inmediata en la sesión main.

   openclaw system event --text "Check for urgent follow-ups" --mode now

2. Activa los heartbeats: Si los latidos del sistema estaban pausados, vuelve a activarlos con este comando.

   openclaw system heartbeat enable

3. Verifica el último heartbeat: Comprueba cuándo ocurrió el último evento de mantenimiento.

   openclaw system heartbeat last

4. Consulta la presencia: Obtén la lista de nodos e instancias que el Gateway reconoce actualmente.

   openclaw system presence

Detalles de los comandos

system event

Este comando encola un evento en la sesión principal. El siguiente heartbeat lo incluirá como una línea System: en el prompt. Te recomiendo usar --mode now si quieres que el heartbeat se dispare al instante; de lo contrario, next-heartbeat esperará al siguiente ciclo programado.

Flags disponibles:

• --text <text>: El texto del evento (obligatorio).
• --mode <mode>: Puedes elegir entre now o next-heartbeat.
• --json: Para obtener una salida procesable por máquinas.

system heartbeat

Controla el flujo de mantenimiento del sistema. Puedes usar enable para reanudarlo o disable para pausarlo si necesitas detener las actualizaciones temporales. El subcomando last es útil para auditoría rápida.

system presence

Muestra las entradas de presencia actuales, como nodos y estados de instancias. Si necesitas integrar esto con otros scripts, usa el flag --json.

Solución de problemas

• Los eventos no aparecen en el prompt: Verifica si el heartbeat está desactivado. Ejecuta openclaw system heartbeat enable para asegurar que el ciclo continúe.
• El evento tarda demasiado en procesarse: Por defecto, el sistema usa next-heartbeat. Cambia el flag a --mode now para forzar la inyección inmediata.

Ten en cuenta que los eventos de sistema son efímeros. Si reinicias el Gateway, estos datos no se conservarán.

¿Necesitas ayuda con una configuración específica? Prueba el AI Setup Assistant.

Próximos pasos

• Configuración del Gateway
• Gestión de nodos y presencia
• Guía de flags globales del CLI
• Formatos de salida JSON para automatización