openclaw system

Gateway 系统级工具：入队系统事件、控制心跳、查看在线状态。

常用命令

openclaw system event --text "Check for urgent follow-ups" --mode now
openclaw system heartbeat enable
openclaw system heartbeat last
openclaw system presence

system event

向主会话（main session）入队一个系统事件。下次心跳触发时，该事件会以 System: 行的形式注入到 prompt 中。使用 --mode now 可立即触发心跳，而不用等待下次定时触发；next-heartbeat 则等待下次计划心跳。

参数：

• --text <text>：必填，系统事件文本内容。
• --mode <mode>：now（立即触发）或 next-heartbeat（默认，等待下次心跳）。
• --json：输出机器可读的 JSON 格式。

system heartbeat last|enable|disable

心跳控制：

• last：查看最后一次心跳事件。
• enable：重新开启心跳（如果之前被禁用，可用此命令恢复）。
• disable：暂停心跳。

参数：

• --json：输出机器可读的 JSON 格式。

system presence

列出 Gateway 当前已知的在线状态条目（节点、实例及类似状态行）。

参数：

• --json：输出机器可读的 JSON 格式。

注意事项

• 需要当前配置可访问到正在运行的 Gateway（本地或远程均可）。
• 系统事件是临时性的，重启后不会保留。

想让你的龙虾在下次心跳时处理特定任务？用 system event --mode now 立即触发，无需等待。