目前狀態

OpenClaw 的「在線狀態」是一種輕量級、盡力而為的檢視，涵蓋：

• 閘道本身，以及
• 連線至閘道且使用者可見的用戶端（Mac App、WebChat、節點等）

在線狀態會在控制介面的 Devices 頁面 （位於 Settings → Devices）和 macOS App 的 Instances 分頁中呈現即時連線中繼資料。

本頁說明閘道用戶端名冊。若要偵測你最近使用的 Mac，並將節點警示傳送至該處，請參閱 使用中電腦的在線狀態。

在線狀態欄位（會顯示的內容）

在線狀態項目是結構化物件，包含如下欄位：

• instanceId（選填，但強烈建議）：穩定的用戶端身分識別資訊（通常是 connect.client.instanceId）
• host：易於辨識的主機名稱
• ip：盡力取得的 IP 位址
• version：用戶端版本字串
• deviceFamily / modelIdentifier：硬體提示
• mode：ui、webchat、cli、backend、node、probe、test
• lastInputSeconds：自上次使用者輸入以來的秒數（若已知）
• reason：由用戶端提供的自由格式字串；閘道本身只會發出 self、connect 和 disconnect
• deviceId、roles、scopes：來自連線交握的裝置身分識別資訊，以及角色／範圍提示
• ts：上次更新時間戳記（自 Epoch 起算的毫秒數）

產生來源（在線狀態的來源）

在線狀態項目由多個來源產生，並加以合併。

1) 閘道自身項目

閘道啟動時一律會建立一個「自身」項目，讓使用者介面即使在尚無任何用戶端連線前，也能顯示閘道主機。

2) WebSocket 連線

每個 WS 用戶端一開始都會提出 connect 要求。交握成功後，閘道會為該連線新增或更新在線狀態項目。

暫時性的控制平面連線為何不會顯示

命令列介面命令、後端 RPC 用戶端和探測器通常只會短暫連線。為避免在整個在線狀態存留時間內保留這些頻繁變動，以 cli、backend 或 probe 模式運作的用戶端不會轉換成在線狀態項目。測試模式用戶端仍會受到追蹤，因為測試套件會用它們代替真正的用戶端。

3) system-event 信標

用戶端可透過 system-event 方法定期傳送資訊更豐富的信標。Mac App 會使用此方式回報主機名稱、IP、版本和存活狀態中繼資料。實體輸入活動不屬於此通用信標；它由使用中電腦的在線狀態所述的特定用途原生節點事件負責。Mac 會使用 system-presence-clear-last-input 標記這些信標；目前的閘道會使用這個向下相容標記，移除舊版 App 所保留的任何輸入新近程度資訊。信標也會攜帶固定的 30 天數值，讓忽略該標記的舊版閘道覆寫精確的新近程度，而不是予以保留。此相容性數值不會取樣任何新活動。

4) 節點連線（角色：節點）

當節點使用 role: node 透過閘道 WebSocket 連線時，閘道會新增或更新該節點的在線狀態項目（流程與其他 WS 用戶端相同）。

合併與去重規則（instanceId 為何重要）

在線狀態項目儲存在單一記憶體內映射中，鍵值不區分大小寫，並依序採用第一個可用值：已配對的裝置 ID、connect.client.instanceId，最後才以各連線 ID 作為備援。

暫時性的控制平面用戶端完全不會納入追蹤（請見上文），因此其連線 ID 絕不會成為鍵值。對於其他所有用戶端，使用連線 ID 作為備援，表示沒有穩定 instanceId 的用戶端重新連線時，會顯示為重複資料列。

存留時間與數量上限

在線狀態有意設計成暫時性資料：

• **存留時間：**早於 5 分鐘的項目會遭到清除
• **項目上限：**200（優先捨棄最舊的項目）

這可讓清單保持最新，並避免記憶體無限制增長。

遠端／通道注意事項（迴路 IP）

用戶端透過 SSH 通道／本機連接埠轉送進行連線時，閘道可能會將遠端位址視為 127.0.0.1。為避免將該通道位址記錄為用戶端的 IP，對於偵測為本機（迴路）的用戶端，連線處理程序會完全省略 ip，而不會將迴路位址寫入項目。

使用端

控制介面的 Devices 頁面

Devices 頁面會將 system-presence 與持久的配對及節點記錄結合。它會將閘道自身信標固定在最前方，並使用相符的裝置或執行個體 ID，取得即時平台、版本、型號和輸入新近程度中繼資料。

macOS 的 Instances 分頁

macOS App 會呈現 system-presence 的輸出，並根據上次更新後經過的時間套用小型狀態指示器（Active/Idle/Stale）。

偵錯提示

• 若要查看原始清單，請對閘道呼叫 system-presence。
• 若看到重複項目：
  • 確認用戶端在交握中傳送穩定的 client.instanceId
  • 確認定期信標使用相同的 instanceId
  • 檢查衍生自連線的項目是否缺少 instanceId（此時出現重複項目符合預期）

相關內容