openclaw system

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

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

常用命令

openclaw system event --text "Check for urgent follow-ups" --mode nowopenclaw system event --text "Check for urgent follow-ups" --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

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

注意事項

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

相關內容

• 命令列介面參考