Skip to main content

​
openclaw system

用于 Gateway 的系统级辅助工具：排队系统事件、控制心跳， 以及查看存在状态。 所有 system 子命令都使用 Gateway RPC，并接受共享的客户端标志：
  • --url <url>
  • --token <token>
  • --timeout <ms>
  • --expect-final

​
常用命令

openclaw system event --text "检查紧急跟进事项" --mode now
openclaw system event --text "检查紧急跟进事项" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"
openclaw system heartbeat enable
openclaw system heartbeat last
openclaw system presence

​
system event

默认情况下，将系统事件排队到 主 会话。下一次心跳 会将其作为 System: 行注入到提示中。使用 --mode now 可立即触发 心跳；next-heartbeat 会等待下一次计划中的 tick。 传入 --session-key 以针对特定会话（例如将一个 异步任务完成结果转发回发起它的频道）。
**--session-key 下的时间行为例外：**当提供 --session-key 时， --mode next-heartbeat 会折叠为立即的定向唤醒，而不是 等待下一次计划中的 tick。定向唤醒使用心跳意图 immediate，因此它们会绕过运行器的未到期门控；否则该门控会延迟（并实际上丢弃） 一个 event 意图的唤醒。如果你想要延迟 传递，请省略 --session-key，这样事件会落到主会话上并 走下一次常规心跳。
标志：
  • --text <text>: required system event text.
  • --mode <mode>: now or next-heartbeat (default).
  • --session-key <sessionKey>: optional; target a specific agent session instead of the agent’s main session. Keys that do not belong to the resolved agent fall back to the agent’s main session.
  • --json: machine-readable output.
  • --url, --token, --timeout, --expect-final: shared Gateway RPC flags.

​
system heartbeat last|enable|disable

心跳控制：
  • last：显示上一次心跳事件。
  • enable：重新开启心跳（如果之前已禁用，请使用此项）。
  • disable：暂停心跳。
标志：
  • --json：机器可读输出。
  • --url、--token、--timeout、--expect-final：共享的 Gateway RPC 标志。

​
system presence

列出 Gateway 当前已知的系统存在状态条目（节点、 实例以及类似的状态行）。 标志：
  • --json：机器可读输出。
  • --url、--token、--timeout、--expect-final：共享的 Gateway RPC 标志。

​
注意

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

​
相关