openclaw system 命令¶
面向 Gateway 的系统级辅助工具：将系统事件入队、控制心跳，以及查看存在性（presence）信息。
所有 system 子命令都使用 Gateway RPC，并接受以下共享客户端标志：
| Flag | Default | Description |
|---|---|---|
--url <url> |
gateway.remote.url when configured |
Gateway WebSocket URL。 |
--port <port> |
none | 本地 Gateway 端口。 |
--token <token> |
none | Gateway 令牌（如果需要）。 |
--password <password> |
none | Gateway 密码（如果需要）。 |
--timeout <ms> |
30000 |
RPC 超时时间（毫秒）。 |
--expect-final |
off | 等待最终响应（智能体）。 |
--json |
off | 输出 JSON。无论此标志如何设置，heartbeat last/enable/disable 和 system presence 始终输出原始 RPC JSON 负载；system event 使用它在 JSON 和普通的 ok 行之间切换。 |
常用命令¶
openclaw system event --text "Check for urgent follow-ups" --mode now
openclaw system event --text "Check for urgent follow-ups" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"
openclaw system heartbeat enable
openclaw system heartbeat last
openclaw system presence
system event 命令¶
默认情况下，将系统事件排入 主（main）会话的队列。下一次心跳会将它作为 System: 行注入提示中。使用 --mode now 可立即触发心跳；next-heartbeat（默认）会等待下一个计划的心跳周期。
传递 --session-key 可指定某个会话，例如将异步任务完成结果回传给发起该任务的频道。
Note
使用 --session-key 时的时序例外： 当提供 --session-key 时，--mode next-heartbeat 会收缩为立即定向唤醒，而不是等待下一个计划的心跳周期。定向唤醒使用心跳意图 immediate，因此它们会绕过运行器的“未到期”门（not-due gate），否则该门会延迟（并实际上丢弃）event 意图的唤醒。如果您希望延迟传递，请省略 --session-key，使事件落入主会话，并搭上下一次常规心跳。
Flags:
--text <text>: 必需的系统事件文本。--mode <mode>:now或next-heartbeat（默认）。--session-key <sessionKey>: 可选；指定要触达的智能体会话，而不是该智能体的主会话。不属于已解析智能体的键会回退到该智能体的主会话。
system heartbeat last|enable|disable 命令¶
last: 显示最近一次心跳事件。enable: 重新启用心跳（如果之前被禁用的话）。disable: 暂停心跳。
system presence 命令¶
列出 Gateway 当前已知的系统 presence 条目（节点、实例及类似的状态行）。
备注¶
- 需要一个正在运行的 Gateway，且当前配置（本地或远程）能够访问到它。
- 系统事件是临时的，重启后不会持久化。
相关文档¶
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw