# openclaw system

Helpers de nível de sistema para o Gateway: enfileirar eventos do sistema, controlar Heartbeats e visualizar presença.

Todos os subcomandos de system usam RPC do Gateway e aceitam as flags compartilhadas de cliente:

• --url <url>
• --token <token>
• --timeout <ms>
• --expect-final

# Comandos comuns

openclaw system event --text "Verifique acompanhamentos urgentes" --mode now
openclaw system event --text "Verifique acompanhamentos urgentes" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"
openclaw system heartbeat enable
openclaw system heartbeat last
openclaw system presence

# system event

Enfileire um evento do sistema na sessão main. O próximo Heartbeat o injetará como uma linha System: no prompt. Use --mode now para acionar o Heartbeat imediatamente; next-heartbeat espera pelo próximo tick agendado.

Flags:

• --text <text>: texto obrigatório do evento do sistema.
• --mode <mode>: now ou next-heartbeat (padrão).
• --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: mostrar o último evento de Heartbeat.
• enable: reativar Heartbeats (use isso se eles tiverem sido desabilitados).
• disable: pausar Heartbeats.

Flags:

• --json: saída legível por máquina.
• --url, --token, --timeout, --expect-final: flags compartilhadas de RPC do Gateway.

# system presence

Liste as entradas atuais de presença do sistema que o Gateway conhece (nodes, 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 persistem entre reinicializações.

# Relacionados

• Referência da CLI