system event
像往主会话托盘里塞一张系统提醒纸条。
Cli 导读
用 CLI 控制 Gateway 心跳、事件与节点状态
所有子命令都走 Gateway RPC，必须先配好 `--url` 和 `--token`。最常用的 `system event` 能把自定义文本注入下一次心跳的 System 行，`--mode now` 可立即触发。`system presence` 列出当前所有在线节点，排查连接问题时优先看它。
先讲这一页到底在解决什么
用 CLI 控制 Gateway 心跳、事件与节点状态
所有子命令都走 Gateway RPC，必须先配好 `--url` 和 `--token`。最常用的 `system event` 能把自定义文本注入下一次心跳的 System 行，`--mode now` 可立即触发。`system presence` 列出当前所有在线节点，排查连接问题时优先看它。
第一站
🎛️ 先记 4 个动作：塞系统纸条、开心跳、看上次心跳、看现场在场牌
官方示例已经把主线讲完了，你只要把每个动作想成总控台上的一个按钮就够了。
heartbeat enable / disable
像把总控台的心跳节拍器打开或暂停。
heartbeat last
像翻看“上一次心跳是什么时候、带了什么动静”。
presence
像看一块在场白板，写着现在有哪些节点、实例和状态线还亮着。
第二站
📮 system event --text ... 最像“往总控室里递一张只给系统看的便条”
这条命令不是直接发给用户，而是塞进 main session，等下一次心跳把它作为 System: 纸条塞进提示里。
--text "Check for urgent follow-ups"像在便条上写：“别忘了看看有没有紧急跟进。”
进 main session
像这张便条是塞到总值班本里，不是塞给某个普通聊天窗口。
会变成
System: 行等心跳来时，这张便条会被正式念出来，像总控台广播一句系统提示。
--json像把“这张便条已经塞进去”的回执做成标准小票。
第三站
⏱️ --mode now 和 next-heartbeat，像“马上敲铃”还是“等下一轮自然报时”
这组模式很好懂，只要把心跳想成一个定时敲响的节拍器。
--mode now
像你不等下一轮了，立刻敲铃，把便条现在就插进系统提示里。
next-heartbeat
像把纸条放在托盘里，等下一次自然报时再一起念。
默认就是等下一拍
官方说默认值是 next-heartbeat，也就是不急着马上打断节奏。
一句话
一个是立即敲铃，一个是等下一拍再播。
第四站
💓 heartbeat 的 3 个按钮，就像“看上次跳动、恢复跳动、暂停跳动”
这一组很像节拍器开关，没有太多花活，但很重要。
heartbeat last像翻值班日志，看看上一次心跳到底什么时候发生过。
heartbeat enable像把停掉的节拍器重新拨到转动状态。
heartbeat disable像先把节拍器按停，暂时别再规律地往系统里打点。
--json像每个按钮按完都能打印一张标准回执，方便自动化脚本接住。
第五站
👀 presence 像“看白板上现在谁在场、哪盏灯亮着”
官方说它会列出 nodes、instances 和类似的状态线。你可以把它当成总控室的在场板。
nodes
像远端小工位们有没有在线、有没有在岗。
instances
像当前跑着的那些实例是谁，在哪个角落亮着灯。
status lines
像白板上那些短短的值班说明行，告诉你现场大致是什么样。
一句话
presence 就是看看现在屋里谁在、哪盏灯还亮着。
最后总结
🎈 把 openclaw system 压成一句话
openclaw system 就像总控室的小按钮组：往系统里塞一张便条、控制心跳节拍器，再看看现场有哪些节点和实例还在值班。