openclaw system

Auxiliares no nível do sistema para o Gateway: enfileirar eventos do sistema, controlar heartbeats e visualizar a presença.

Todos os subcomandos de system usam RPC do Gateway e aceitam as opções compartilhadas do cliente:

Comandos comuns

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 presence

system event

Por padrão, enfileira um evento do sistema na sessão principal. O próximo heartbeat o injeta como uma linha System: no prompt. Use --mode now para acionar o heartbeat imediatamente; next-heartbeat (padrão) aguarda o próximo ciclo agendado.

Passe --session-key para direcionar a uma sessão específica, por exemplo, para retransmitir a conclusão de uma tarefa assíncrona ao canal que a iniciou.

Opções:

• --text <text>: texto obrigatório do evento do sistema.
• --mode <mode>: now ou next-heartbeat (padrão).
• --session-key <sessionKey>: opcional; direciona a uma sessão específica do agente em vez da sessão principal do agente. Chaves que não pertencem ao agente resolvido usam como alternativa a sessão principal do agente.

system heartbeat last|enable|disable

• last: mostra o último evento de heartbeat.
• enable: reativa os heartbeats (use se eles tiverem sido desativados).
• disable: pausa os heartbeats.

system presence

Lista as entradas atuais de presença do sistema conhecidas pelo Gateway (nodes, instâncias e linhas de status semelhantes).

Observações

• Requer um Gateway em execução que possa ser acessado pela configuração atual (local ou remota).
• Os eventos do sistema são efêmeros e não persistem entre reinicializações.

Relacionado

• Referência da CLI