4.23 system命令

openclaw system 命令提供网关级别的实用工具，用于管理事件、心跳和系统状态。

概述

该命令提供了一组用于管理 OpenClaw 网关系统级功能的工具，包括事件注入、心跳控制和在线状态监控。

核心命令

事件管理

在主会话上排队一个系统事件。下一次心跳时，该事件将作为系统行注入到提示中。

# 发送系统事件
openclaw system event "系统维护通知"

# 立即触发事件
openclaw system event "紧急通知" --mode now

# JSON 格式输出
openclaw system event "通知内容" --json

心跳控制

查看最后一次心跳事件，启用或禁用心跳机制。

# 查看最后一次心跳
openclaw system heartbeat status

# 启用心跳
openclaw system heartbeat enable

# 禁用心跳
openclaw system heartbeat disable

# JSON 格式输出
openclaw system heartbeat status --json

在线状态监控

查看当前系统在线状态条目，包括节点和实例状态。

# 查看系统在线状态
openclaw system presence

重要参数

参数	说明
--mode now	立即触发心跳
--mode next-heartbeat	等待下一次计划的心跳（默认）
--json	以机器可读的 JSON 格式输出

系统要求