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
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.
Exceção de temporização com
--session-key: quando --session-key é fornecido,
--mode next-heartbeat passa a realizar uma ativação direcionada imediata em vez de
aguardar o próximo ciclo agendado. Ativações direcionadas usam a intenção de heartbeat
immediate, portanto ignoram o bloqueio de execução antes do prazo, que, de outra forma,
adiaria (e efetivamente descartaria) uma ativação com intenção event. Se quiser uma
entrega posterior, omita --session-key para que o evento seja destinado à sessão principal e
seja transportado pelo próximo heartbeat regular.--text <text>: texto obrigatório do evento do sistema.--mode <mode>:nowounext-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.