主動電腦存在狀態

主動電腦狀態會告知閘道，哪個已連線的 macOS 節點最近接收到 實體滑鼠或鍵盤輸入。OpenClaw 使用此訊號將其中一台 Mac 標記為 active、 為代理程式提供穩定的作用中節點提示，並將節點連線警示路由到你最可能正在使用的電腦。

這與系統狀態不同，後者是閘道用戶端的即時 名冊；也與持久的 node.presence.alive 信標不同，後者會 記錄行動節點上次喚醒的時間，但不會將其視為已連線。

​

需求

• OpenClaw macOS 應用程式已配對，並以節點模式連線。
• 已啟用 Settings -> Permissions -> Active computer detection。此功能預設為關閉。
• 已授予簽署過的 OpenClaw 應用程式 Accessibility 權限。
• 若要接收連線警示，還需授予 Notifications 權限，且 Mac 節點須公開 system.notify。

活動回報目前由原生 macOS 節點實作。iOS、 Android、watchOS 和無頭節點主機可以回報連線或背景 最後出現狀態，但不會競爭主動電腦的指定資格。

​

檢查主動電腦

1. 在 macOS 應用程式中開啟 Settings -> Permissions，啟用 Active computer detection，並在 macOS System Settings 中授予 Accessibility。

2. 確認 Mac 節點已連線：

   openclaw nodes status --connected
   

3. 在該 Mac 上移動滑鼠或按下按鍵，然後執行：

   openclaw nodes status
   openclaw nodes describe --node <node-id-or-name>
   

最新且符合資格的 Mac 會標記為 active。狀態輸出會顯示其距離上次輸入的 時間；describe 會公開 active、lastActiveAtMs 和 presenceUpdatedAtMs。 活動會刻意合併，因此在近期回報後再次輸入，顯示內容最多可能需要約 15 秒才會反映。

​

活動如何成為狀態資訊

macOS 回報器每兩秒取樣一次 HID 系統的閒置時鐘。 節點連線就緒時會回報一次，之後回報較新的實體 活動，頻率不會超過每 15 秒一次。閒置期間，每三分鐘傳送一次 保持連線訊息。閒置時間上限為 30 天，以避免非常舊的取樣 隨時間向前漂移，並錯誤成為最新電腦。

停用 Active computer detection 會停止取樣，並透過目前的節點連線 傳送經驗證的清除事件。閘道會立即移除 該 Mac 保留的活動時間戳記，並重新計算主動電腦； 其他節點功能與進行中的工作仍保持連線。若已連線的 閘道版本早於此清除動作，Mac 節點會重新連線一次，讓中斷連線時的 清理程序移除保留的活動資訊。

只有在以下條件全都成立時，閘道才會接受活動：

• 事件屬於該節點 ID 目前已驗證的連線；
• 節點具備有效的 accessibility: true 權限；
• 承載內容包含有界整數 idleSeconds 值。

閘道會從自身觀察時間減去 idleSeconds，以推導出 lastActiveAtMs。它絕不信任節點提供的系統時鐘時間戳記。在 已連線且符合資格的 Mac 中，最新的 lastActiveAtMs 勝出；若時間相同，則採用最近一次的 狀態更新。

狀態資訊僅限於程序本機，並與連線綁定。中斷目前 工作階段的連線、以使用相同節點 ID 的另一個工作階段取代它，或撤銷 Accessibility，都會清除該節點的活動狀態，並重新計算主動 Mac。

​

隱私權與模型上下文

活動分享預設為關閉，且與用於 UI 自動化的 Accessibility 授權 彼此獨立。OpenClaw 傳送的是閒置時間，而非輸入內容。它不會傳送按鍵值、 滑鼠座標、應用程式名稱、視窗標題或原始輸入事件。 macOS 回報器會讀取硬體 HID 狀態，因此合成的電腦控制 事件不會讓自動化 Mac 看起來像是你實際使用的電腦。

持續活動不會建立面向模型的系統事件。動態 執行階段行只包含已驗證的節點 ID：

active_node=<node-id>

確切時間戳記和由節點控制的顯示名稱不會進入提示詞，以 避免提示詞注入和快取頻繁變動。代理程式需要目前詳細資訊時， 可以改用 nodes 工具讀取 node.list 或 node.describe。

​

連線警示的路由方式

節點在核准後完成首次成功的閘道交握後， OpenClaw 會等待 750 毫秒，讓正在連線的 Mac 提交第一個 活動取樣。接著，它會嘗試向活動最新且支援通知的已連線 Mac 傳送通知。

• 若主要傳送成功，其他 Mac 都不會收到警示。
• 若沒有可用的主動 Mac，或主要傳送失敗，OpenClaw 會等待五 秒，然後嘗試所有其他公開 system.notify 的已連線 Mac。
• 之後的重新連線不會發出通知。閘道會將成功連線 記錄在配對中繼資料中，因此閘道重新啟動時，不會對每個 先前已連線的節點重播警示。

警示會綁定至已驗證的節點身分。同一節點的替代工作階段 會接手其待處理的首次連線警示；若傳送時該節點 已不再連線，警示便會取消。

​

疑難排解

症狀	檢查
沒有任何列標記為 active	確認已啟用主動電腦偵測、原生 macOS 節點已連線，且 openclaw nodes describe --node <id> 顯示 permissions.accessibility: true。
錯誤的 Mac 仍維持主動狀態	實際操作該 Mac、等待合併時間窗結束，然後重新執行 openclaw nodes status。合成的電腦控制動作不算在內。
上次輸入資料消失	檢查 Mac 是否中斷連線、其節點工作階段是否遭取代，或 Accessibility 是否遭撤銷。每種情況都會刻意清除活動資訊。
警示出現在多台 Mac 上	主要傳送無法使用或失敗，因此執行了延遲後援。確認主動 Mac 已連線、允許通知，且公開 system.notify。
代理程式未提及主動 Mac	活動變更後開始新的對話輪次。執行階段提示穩定且精簡；如需目前的確切中繼資料，請使用 nodes 工具。

如需 TCC 復原資訊，請參閱 macOS 權限。如需節點 連線與命令失敗的相關資訊，請參閱節點疑難排解。

​

相關內容

• 節點
• 節點命令列介面
• 系統狀態
• 閘道通訊協定
• macOS 應用程式