64 lines
1.7 KiB
Markdown
64 lines
1.7 KiB
Markdown
---
|
||
read_when:
|
||
- 您想在不创建 cron 任务的情况下将系统事件加入队列
|
||
- 您需要启用或禁用心跳
|
||
- 您想检查系统存在状态条目
|
||
summary: "`openclaw system` 的 CLI 参考（系统事件、心跳、存在状态）"
|
||
title: system
|
||
x-i18n:
|
||
generated_at: "2026-02-01T20:21:34Z"
|
||
model: claude-opus-4-5
|
||
provider: pi
|
||
source_hash: 36ae5dbdec327f5a32f7ef44bdc1f161bad69868de62f5071bb4d25a71bfdfe9
|
||
source_path: cli/system.md
|
||
workflow: 14
|
||
---
|
||
|
||
# `openclaw system`
|
||
|
||
Gateway 的系统级辅助工具：将系统事件加入队列、控制心跳以及查看存在状态。
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
openclaw system event --text "Check for urgent follow-ups" --mode now
|
||
openclaw system heartbeat enable
|
||
openclaw system heartbeat last
|
||
openclaw system presence
|
||
```
|
||
|
||
## `system event`
|
||
|
||
在**主**会话上将系统事件加入队列。下一次心跳会将其作为 `System:` 行注入到提示中。使用 `--mode now` 可立即触发心跳；`next-heartbeat` 则等待下一次计划的心跳周期。
|
||
|
||
标志：
|
||
|
||
- `--text <text>`：必需的系统事件文本。
|
||
- `--mode <mode>`：`now` 或 `next-heartbeat`（默认）。
|
||
- `--json`：机器可读输出。
|
||
|
||
## `system heartbeat last|enable|disable`
|
||
|
||
心跳控制：
|
||
|
||
- `last`：显示上一次心跳事件。
|
||
- `enable`：重新开启心跳（如果之前被禁用，请使用此命令）。
|
||
- `disable`：暂停心跳。
|
||
|
||
标志：
|
||
|
||
- `--json`：机器可读输出。
|
||
|
||
## `system presence`
|
||
|
||
列出 Gateway 已知的当前系统存在状态条目（节点、实例及类似状态行）。
|
||
|
||
标志：
|
||
|
||
- `--json`：机器可读输出。
|
||
|
||
## 注意事项
|
||
|
||
- 需要当前配置（本地或远程）可访问的运行中 Gateway。
|
||
- 系统事件是临时的，不会在重启后持久化。
|