Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw system

Auxiliares em nível de sistema para o Gateway: enfileire eventos do sistema, controle Heartbeats e veja a presença. Todos os subcomandos system usam RPC do Gateway e aceitam as flags compartilhadas do cliente:
  • --url <url>
  • --token <token>
  • --timeout <ms>
  • --expect-final

​
Comandos comuns

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

Enfileira um evento do sistema na sessão principal por padrão. O próximo Heartbeat o injetará como uma linha System: no prompt. Use --mode now para acionar o Heartbeat imediatamente; next-heartbeat aguarda o próximo tick agendado. Passe --session-key para direcionar uma sessão específica (por exemplo, para retransmitir a conclusão de uma tarefa assíncrona de volta ao canal que a iniciou).
Exceção de temporização com --session-key: quando --session-key é fornecido, --mode next-heartbeat se reduz a um despertar direcionado imediato em vez de aguardar o próximo tick agendado. Despertares direcionados usam a intenção de Heartbeat immediate, portanto ignoram a barreira de não vencido do executor que, de outra forma, adiaria (e efetivamente descartaria) um despertar com intenção event. Se você quiser entrega atrasada, omita --session-key para que o evento caia na sessão principal e acompanhe o próximo Heartbeat regular.
Flags:
  • --text <text>: texto obrigatório do evento do sistema.
  • --mode <mode>: now ou next-heartbeat (padrão).
  • --session-key <sessionKey>: opcional; direciona uma sessão específica do agente em vez da sessão principal do agente. Chaves que não pertencem ao agente resolvido fazem fallback para a sessão principal do agente.
  • --json: saída legível por máquina.
  • --url, --token, --timeout, --expect-final: flags compartilhadas de RPC do Gateway.

​
system heartbeat last|enable|disable

Controles de Heartbeat:
  • last: mostra o último evento de Heartbeat.
  • enable: reativa os Heartbeats (use isto se eles tiverem sido desativados).
  • disable: pausa os Heartbeats.
Flags:
  • --json: saída legível por máquina.
  • --url, --token, --timeout, --expect-final: flags compartilhadas de RPC do Gateway.

​
system presence

Lista as entradas atuais de presença do sistema que o Gateway conhece (nós, instâncias e linhas de status semelhantes). Flags:
  • --json: saída legível por máquina.
  • --url, --token, --timeout, --expect-final: flags compartilhadas de RPC do Gateway.

​
Observações

  • Requer um Gateway em execução acessível pela sua configuração atual (local ou remota).
  • Eventos do sistema são efêmeros e não são persistidos entre reinicializações.

​
Relacionado