openclaw system

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

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

常用命令

openclaw system event --text "Check for urgent follow-ups" --mode nowopenclaw system event --text "Check for urgent follow-ups" --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 参考