System
CLI reference for openclaw system (system events, heartbeat, presence).
Gateway's system-level helper: queue system events, control heartbeat,
and view status.
Common Commands
openclaw system event --text "Check for urgent follow-ups" --mode now openclaw system heartbeat enable openclaw system heartbeat last openclaw system presence
`system event`
Queue system events on the main session. The next heartbeat will inject
it as a ''System:'' line in the prompt. Use ''--mode now'' to trigger heartbeat
immediately; ''next-heartbeat'' waits for the next scheduled tick.
Flags:
- ''--text <text>'': Required system event text.'
'- ''--mode <mode>'': ''now'' or ''next-heartbeat'' (default).'
'- ''--json'': Machine-readable output.
`system heartbeat last|enable|disable`
Heartbeat control:
- ''last'': Show last heartbeat event.'
'- ''enable'': Re-enable heartbeat (use this if heartbeat was disabled).'
'- ''disable'': Pause heartbeat.
Flags:
- ''--json'': Machine-readable output.
ReferenceCliSystemPage step 03: P5
ReferenceCliSystemPage step 03: P6
`system presence`
List current system presence entries known to the gateway (nodes,
instances, and similar status lines).
Flags:'
'- ''--json'': Machine-readable output.
Notes
- Requires current configuration (local or remote) to be accessible to the running gateway.'
'- System events are transient and do not persist across restarts.
ReferenceCliSystemPage step 05: P2