openclaw system

Gateway 网关的系统级辅助工具：将系统事件加入队列、控制 Heartbeat，以及查看在线状态。

所有 system 子命令都使用 Gateway RPC，并接受共享客户端标志：

常用命令

openclaw system event --text "检查是否有紧急的后续事项" --mode nowopenclaw system event --text "检查是否有紧急的后续事项" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"openclaw system heartbeat enableopenclaw system heartbeat lastopenclaw system presence

system event

默认将系统事件加入主会话的队列。下一次 Heartbeat 会将其作为 System: 行注入提示词。使用 --mode now 可立即触发 Heartbeat；next-heartbeat（默认）会等待下一次计划触发。

传入 --session-key 可指定特定会话，例如，将异步任务完成事件转发回启动该任务的渠道。

标志：

• --text <text>：必需的系统事件文本。
• --mode <mode>：now 或 next-heartbeat（默认）。
• --session-key <sessionKey>：可选；指定特定的智能体会话，而不是该智能体的主会话。不属于已解析智能体的键将回退到该智能体的主会话。

system heartbeat last|enable|disable

• last：显示上一次 Heartbeat 事件。
• enable：重新开启 Heartbeat（如果已禁用，请使用此项）。
• disable：暂停 Heartbeat。

system presence

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

备注

• 需要有一个正在运行且可通过当前配置访问的 Gateway 网关（本地或远程）。
• 系统事件是临时的，不会跨重启持久保留。

相关内容

• CLI 参考