System

text

Copy

openclaw system

System-level helpers for the Gateway: enqueue system events, control heartbeats, and view presence.

All

subcommands use Gateway RPC and accept the shared client flags:

• text

  Copy

  --url <url>
• text

  Copy

  --token <token>
• text

  Copy

  --timeout <ms>
• text

  Copy

  --expect-final

Common commands

bash
Copy
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

text

Copy

system event

Enqueue a system event on the main session. The next heartbeat will inject it as a

line in the prompt. Use to trigger the heartbeat immediately; waits for the next scheduled tick.

Flags:

• text

  Copy

  --text <text>
  : required system event text.
• text

  Copy

  --mode <mode>
  :
  text

  Copy

  now
  or
  text

  Copy

  next-heartbeat
  (default).
• text

  Copy

  --json
  : machine-readable output.
• text

  Copy

  --url
  ,
  text

  Copy

  --token
  ,
  text

  Copy

  --timeout
  ,
  text

  Copy

  --expect-final
  : shared Gateway RPC flags.

text

Copy

system heartbeat last|enable|disable

Heartbeat controls:

• text

  Copy

  last
  : show the last heartbeat event.
• text

  Copy

  enable
  : turn heartbeats back on (use this if they were disabled).
• text

  Copy

  disable
  : pause heartbeats.

Flags:

• text

  Copy

  --json
  : machine-readable output.
• text

  Copy

  --url
  ,
  text

  Copy

  --token
  ,
  text

  Copy

  --timeout
  ,
  text

  Copy

  --expect-final
  : shared Gateway RPC flags.

text

Copy

system presence

List the current system presence entries the Gateway knows about (nodes, instances, and similar status lines).

Flags:

• text

  Copy

  --json
  : machine-readable output.
• text

  Copy

  --url
  ,
  text

  Copy

  --token
  ,
  text

  Copy

  --timeout
  ,
  text

  Copy

  --expect-final
  : shared Gateway RPC flags.

Notes

• Requires a running Gateway reachable by your current config (local or remote).
• System events are ephemeral and not persisted across restarts.

Related

• CLI reference