本页内容
本页内容
CLI 命令
系统
openclaw system
适用于 Gateway 的系统级辅助工具:排队系统事件、控制心跳,并查看存在状态。
所有 system 子命令都使用 Gateway RPC,并接受共享的客户端标志:
| 标志 | 默认值 | 描述 |
|---|---|---|
--url <url> |
配置时为 gateway.remote.url |
网关 WebSocket URL。 |
--port <port> |
无 | 本地网关端口。 |
--token <token> |
无 | 网关令牌(如果需要)。 |
--password <password> |
无 | 网关密码(如果需要)。 |
--timeout <ms> |
30000 |
RPC 超时(以毫秒为单位)。 |
--expect-final |
关闭 | 等待最终响应(agent)。 |
--json |
关闭 | 输出 JSON。heartbeat last/enable/disable 和 system presence 无论此标志如何都会始终打印原始 RPC JSON 载荷;system event 会使用它在 JSON 和纯 ok 行之间切换。 |
常用命令
system event
默认情况下,将系统事件入队到 main 会话。下一个心跳会将其作为 System: 行注入到提示中。使用 --mode now 可立即触发心跳;next-heartbeat(默认)则等待下一次计划中的节拍。
传入 --session-key 可针对特定会话,例如将异步任务完成结果回传给发起它的频道。
标志:
--text <text>:必填的系统事件文本。--mode <mode>:now或next-heartbeat(默认)。--session-key <sessionKey>:可选;针对特定代理会话,而不是该代理的 main 会话。属于已解析代理之外的键会回退到该代理的 main 会话。
system heartbeat last|enable|disable
last: 显示最后一次心跳事件。enable: 重新开启心跳(如果之前已被禁用,请使用此项)。disable: 暂停心跳。
system presence
列出网关知道的当前系统存在条目(节点、实例和类似的状态行)。
说明
- 需要一个正在运行且可通过当前配置访问的 Gateway(本地或远程)。
- 系统事件是临时的,不会在重启后持久保存。
相关内容
本页有帮助吗?