> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # 目前狀態 OpenClaw 的「在線狀態」是一種輕量級、盡力而為的檢視，涵蓋： * **閘道**本身，以及 * **連線至閘道且使用者可見的用戶端**（Mac App、WebChat、節點等） 在線狀態會在控制介面的 **Devices** 頁面 （位於 **Settings → Devices**）和 macOS App 的 **Instances** 分頁中呈現即時連線中繼資料。 本頁說明閘道用戶端名冊。若要偵測你最近使用的 Mac，並將節點警示傳送至該處，請參閱 [使用中電腦的在線狀態](/zh-TW/nodes/presence)。 ## 在線狀態欄位（會顯示的內容） 在線狀態項目是結構化物件，包含如下欄位： * `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、版本和存活狀態中繼資料。實體輸入活動不屬於此通用信標；它由[使用中電腦的在線狀態](/zh-TW/nodes/presence)所述的特定用途原生節點事件負責。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`（此時出現重複項目符合預期） ## 相關內容 Mac 的實體輸入如何選取使用中的節點並傳送連線警示。 傳送輸入狀態指示器的時機及其調整方式。 輸出串流、分塊和各頻道的格式設定。 閘道元件，以及驅動在線狀態更新的 WebSocket 通訊協定。 `connect`、`system-event` 和 `system-presence` 的線上通訊協定。