系統

​

openclaw system

閘道的系統層級輔助工具：將系統事件加入佇列、控制心跳偵測，以及檢視目前狀態。

所有 system 子命令都使用閘道 RPC，並接受共用的用戶端旗標：

旗標	預設值	說明
--url <url>	設定時為 gateway.remote.url	閘道 WebSocket URL。
--token <token>	無	閘道權杖（如有需要）。
--timeout <ms>	30000	RPC 逾時時間（毫秒）。
--expect-final	關閉	等待最終回應（代理程式）。
--json	關閉	輸出 JSON。無論此旗標為何，heartbeat last/enable/disable 和 system presence 一律會輸出原始 RPC JSON 承載資料；system event 使用此旗標在 JSON 與純文字 ok 行之間切換。

​

常用命令

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（預設）則會等待下一個排定的執行週期。

傳入 --session-key 可指定特定工作階段，例如將非同步任務的完成訊息轉送回啟動該任務的頻道。

**搭配 --session-key 時的時序例外：**提供 --session-key 時，--mode next-heartbeat 會改為立即喚醒指定目標，而非等待下一個排定的執行週期。指定目標的喚醒會使用心跳偵測意圖 immediate，因此能略過執行器的尚未到期閘門；否則，該閘門會延後（實際上等同捨棄）具有 event 意圖的喚醒。若要延遲傳送，請省略 --session-key，讓事件進入主要工作階段，並隨下一次例行心跳偵測送出。

旗標：

• --text <text>：必要的系統事件文字。
• --mode <mode>：now 或 next-heartbeat（預設）。
• --session-key <sessionKey>：選用；指定特定代理程式工作階段，而非代理程式的主要工作階段。不屬於解析後代理程式的索引鍵，會回退至該代理程式的主要工作階段。

​

system heartbeat last|enable|disable

• last：顯示上一次心跳偵測事件。
• enable：重新開啟心跳偵測（若已停用，請使用此選項）。
• disable：暫停心跳偵測。

​

system presence

列出閘道目前已知的系統狀態項目（節點、執行個體及類似的狀態行）。

​

注意事項

• 需要有可透過目前設定連線的執行中閘道（本機或遠端）。
• 系統事件是暫時性的，不會在重新啟動後保留。

​

相關內容

• 命令列介面參考