Files
openclaw-skill/openclaw-knowhow-skill/docs/reference/cli/system.md
Selig 4c966a3ad2 Initial commit: OpenClaw Skill Collection
6 custom skills (assign-task, dispatch-webhook, daily-briefing,
task-capture, qmd-brain, tts-voice) with technical documentation.
Compatible with Claude Code, OpenClaw, Codex CLI, and OpenCode.
2026-03-13 10:58:30 +08:00

1.2 KiB

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

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.