openclaw system

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

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

常用命令

openclaw system event --text "檢查是否有緊急的後續事項" --mode nowopenclaw system event --text "檢查是否有緊急的後續事項" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"openclaw system heartbeat enableopenclaw system heartbeat lastopenclaw system presence

system event

預設會將系統事件加入主要工作階段的佇列。下一次心跳偵測會將其作為 System: 行注入提示詞。使用 --mode now 可立即觸發心跳偵測；next-heartbeat（預設）則會等待下一個排定的執行週期。

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

旗標：

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

system heartbeat last|enable|disable

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

system presence

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

注意事項

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

相關內容

• 命令列介面參考