使用 openclaw system 掌控 Gateway 系統事件與狀態

開發後端服務時，最煩人的就是沒辦法直接跟運行中的系統「對話」。有時候你明明寫好了邏輯，卻不確定系統現在的狀態，或者想手動塞入一個緊急任務來測試反應，卻發現只能在那邊乾等下一次自動排程。

這種不確定感會拖慢開發進度。你需要一種直接介入 Gateway 運作的方法，不管是想手動觸發事件，還是想確認系統心跳是否還活著，透過 openclaw system 指令可以幫你省下很多通靈的時間。

需要準備的東西

• 一個正在運行的 Gateway（無論是本機或遠端）。
• 你的環境設定必須能正確連線到該 Gateway。

快速開始

你可以透過以下指令快速上手系統控制，包含發送事件與管理 Heartbeat：

# 立即觸發一個系統事件
openclaw system event --text "Check for urgent follow-ups" --mode now

# 開啟心跳偵測
openclaw system heartbeat enable

# 查看最後一次心跳紀錄
openclaw system heartbeat last

# 列出目前的系統 Presence
openclaw system presence

插入系統事件 (system event)

如果你想在 main session 中手動加入特定訊息，可以使用 system event。下一次 Heartbeat 觸發時，這條訊息會以 System: 開頭出現在 prompt 中。

• 使用 --text <text> 指定內容（必填）。
• 使用 --mode now 立即觸發 Heartbeat。
• 使用 --mode next-heartbeat 等待下一個排程（這是預設值）。
• 加入 --json 可以取得機器可讀的輸出格式。

控制心跳 (system heartbeat)

Heartbeat 是維持系統運作的關鍵，你可以隨時調整它的狀態：

• last: 顯示上一次 Heartbeat 事件的細節。
• enable: 如果 Heartbeat 之前被停用了，用這個指令重新開啟。
• disable: 暫停 Heartbeat 運作。

如果你需要將結果串接到其他工具，這些指令也都支援 --json flag。

查看系統狀態 (system presence)

想知道 Gateway 目前掌握了哪些資源嗎？使用 system presence 可以列出所有已知的 entry，例如 nodes、instances 以及相關的狀態資訊。

疑難排解

• 指令沒反應？ 請確認你的 Gateway 正在運行，且目前的 config 設定可以正確連線到它。
• 事件重啟後消失了？ 請注意，System events 是暫時性的 (ephemeral)，它們不會被持久化儲存，系統重啟後就會消失。

有任何設定上的疑難雜症嗎？試試 AI Setup Assistant。

下一步

• openclaw gateway 基礎設定
• openclaw session 管理技巧
• API 整合指南
• Node.js SDK 參考