> ## Documentation Index
> Fetch the complete documentation index at: https://claw-tw.jackle.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# system（系統操作）

# `openclaw system`

針對 Gateway 的系統級協助工具：發送系統事件、控制心跳機制並檢視在線狀態。

## 常見指令

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# 立即觸發一個系統事件
openclaw system event --text "檢查緊急追蹤事項" --mode now

# 啟用心跳機制
openclaw system heartbeat enable

# 顯示最後一次心跳事件
openclaw system heartbeat last

# 顯示系統在線狀態
openclaw system presence
```

## `system event` (系統事件)

將系統事件排入**主要 (main)** 會話的隊列中。下一次心跳觸發時，系統會將其作為 `System:` 行注入提示詞 (Prompt) 中。使用 `--mode now` 可立即觸發心跳；`next-heartbeat` (預設值) 則會等待下一次排定的週期。

**旗標說明**：

* `--text <文字>`：(必要) 系統事件內容。
* `--mode <模式>`：`now` 或 `next-heartbeat`。
* `--json`：機器可讀輸出。

## `system heartbeat last|enable|disable` (心跳控制)

* `last`：顯示最近一次的心跳事件資訊。
* `enable`：重新啟用心跳機制（若先前已被停用）。
* `disable`：暫停心跳機制。

**旗標說明**：

* `--json`：機器可讀輸出。

## `system presence` (在線狀態)

列出 Gateway 目前掌握的系統在線條目（包含節點、執行實例及類似的狀態資訊）。

**旗標說明**：

* `--json`：機器可讀輸出。

## 注意事項

* 需要一個運行中且目前配置可觸達（本地或遠端）的 Gateway。
* 系統事件是**臨時性 (Ephemeral)** 的，重啟後將不會保留。