Peekaboo Bridge（macOS UI 自動化）

OpenClaw 可提供 PeekabooBridge 作為本機、具權限感知的 UI 自動化中介服務。這讓 peekaboo CLI 能在重用 macOS 應用程式 TCC 權限的情況下驅動 UI 自動化。

這是什麼（以及不是什麼）

• Host：OpenClaw.app 可作為 PeekabooBridge host。
• Client：使用 peekaboo CLI（沒有獨立的 openclaw ui ... 介面）。
• UI：視覺覆蓋層由 Peekaboo.app 處理；OpenClaw 是一個輕薄的中介 host。

啟用 Bridge

在 macOS 應用程式中：

• Settings → Enable Peekaboo Bridge

啟用後，OpenClaw 會啟動一個本機 UNIX socket 伺服器。停用時，host 會停止，peekaboo 會退回到其他可用的 host。

Client 探索順序

Peekaboo client 通常依照以下順序嘗試 host：

1. Peekaboo.app（完整 UX）
2. Claude.app（若已安裝）
3. OpenClaw.app（輕薄中介）

使用 peekaboo bridge status --verbose 查看哪個 host 處於活動狀態以及使用的 socket 路徑。你可以覆蓋設定：

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

安全性與權限

• Bridge 會驗證 caller 程式碼簽章；強制執行 TeamID 允許清單（Peekaboo host TeamID + OpenClaw app TeamID）。
• 請求在約 10 秒後逾時。
• 若必要的權限缺失，Bridge 會回傳明確的錯誤訊息，而非開啟系統設定。

快照行為（自動化）

快照儲存於記憶體中，短時間後自動過期。若需要更長的保留時間，請從 client 端重新擷取。

疑難排解

• 若 peekaboo 回報「bridge client is not authorized」，確保 client 已正確簽章，或在除錯模式下設定 PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 來執行 host。
• 若找不到任何 host，開啟其中一個 host 應用程式（Peekaboo.app 或 OpenClaw.app）並確認權限已授予。