# system

# `openclaw system`

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

## Key Capabilities

**System Events**: Enqueue messages that inject into prompts as system lines, with options to trigger immediately or await the next scheduled heartbeat.

**Heartbeat Management**: Enable, disable, or check the status of periodic heartbeat events.

**Presence Monitoring**: Display current system presence entries including nodes and instance statuses.

## Commands

```bash
openclaw system event --text "message" --mode now
openclaw system event --text "message" --mode next-heartbeat
openclaw system heartbeat status
openclaw system heartbeat enable
openclaw system heartbeat disable
openclaw system presence
```

## Notable Parameters

The system event command accepts text content, execution mode selection (`now` or `next-heartbeat`), and optional JSON output formatting. Similarly, heartbeat and presence commands support JSON output for programmatic use.

## Requirements

A running Gateway reachable by your current config (local or remote) is necessary. Note that system events are temporary rather than persisting across restarts.
