openclaw system

Gateway 的系统级辅助工具：添加系统事件、控制 Heartbeat、查看在线状态。

常用命令

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 上添加一个系统事件。下次 Heartbeat 触发时，会把它作为 System: 行注入到 Prompt 中。用 --mode now 可以立即触发 Heartbeat；next-heartbeat 则等待下次定时触发。

参数：

  • --text <text>：必填，系统事件的文本内容。
  • --mode <mode>：now 或 next-heartbeat（默认）。
  • --json：输出机器可读的 JSON 格式。

system heartbeat last|enable|disable

Heartbeat 控制命令：

  • last：显示最后一次 Heartbeat 事件。
  • enable：重新启用 Heartbeat（如果之前被禁用了）。
  • disable：暂停 Heartbeat。

参数：

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

system presence

列出 Gateway 当前知道的系统在线状态信息（节点、实例等状态行）。

参数：

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

注意事项

  • 需要有一个正在运行的 Gateway（本地或远程），并且当前配置能连接到它。
  • 系统事件是临时的，重启后不会保留。