openclaw system
Gateway 系统级辅助命令：投递系统事件、控制心跳、查看 presence。
所有子命令通过 Gateway RPC，共享选项：--url、--token、--timeout、--expect-final
常用命令
openclaw system event --text "Check for urgent follow-ups" --mode now
openclaw system heartbeat enable
openclaw system heartbeat last
openclaw system presencesystem event
向主会话投递系统事件，下次心跳时以 System: 行注入 prompt。
openclaw system event --text "Check for urgent follow-ups" --mode now
openclaw system event --text "..." --session-key <key> # 指定目标会话| 参数 | 说明 |
|---|---|
--text <text> | 必填，事件文本 |
--mode <mode> | now（立即触发心跳）或 next-heartbeat（默认，等待下次调度） |
--session-key <key> | 指定目标 agent 会话（不属于该 agent 的 key 回退到主会话） |
注意：传入 --session-key 时，--mode next-heartbeat 会折叠为立即定向唤醒（使用 immediate 心跳意图），绕过 not-due 门控。若需延迟投递，省略 --session-key 让事件走主会话的常规心跳。
system heartbeat
openclaw system heartbeat last # 查看最近一次心跳事件
openclaw system heartbeat enable # 开启心跳
openclaw system heartbeat disable # 暂停心跳system presence
列出 Gateway 当前已知的 presence 条目（node、实例等状态行）：
openclaw system presence
openclaw system presence --json注意事项
- 需要运行中的 Gateway（本地或远程）
- 系统事件是临时的，Gateway 重启后不保留