使用 OpenClaw 驅動 Peekaboo Bridge 實現 macOS UI 自動化

做 macOS UI 自動化最煩人的通常不是寫程式碼，而是處理沒完沒了的系統權限。每次換個工具或改個設定，TCC 權限彈窗就跳出來擋路，開發節奏被打斷真的很痛苦。

如果你正在找一個更輕量的方法來跑自動化，OpenClaw 現在支援作為 PeekabooBridge 的託管主機。這讓你可以直接用 peekaboo CLI 來操作 UI，同時復用 macOS app 已經拿到的權限，不用再重複授權。

需要準備的東西

打開 OpenClaw.app，進入 Settings。
找到並勾選 Enable Peekaboo Bridge。這會啟動一個本地 UNIX socket server。
檢查連接狀態。在終端機輸入以下指令查看目前使用哪一個主機：
Terminal window
```
peekaboo bridge status --verbose
```
如果你需要覆蓋預設的 socket 路徑，可以設定環境變數：
Terminal window
```
export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock
```

OpenClaw 在這裡扮演的是「薄橋樑」的角色。所有的視覺圖層（visual overlays）依然保留在 Peekaboo.app 中，OpenClaw 只是負責轉發指令。peekaboo 客戶端會按照以下順序尋找主機：

安全性方面，橋樑會驗證呼叫者的 caller code signatures，只有在白名單內的 TeamID（Peekaboo 與 OpenClaw）才能通過。此外，所有的請求都有約 10 秒的超時限制。

關於 Snapshot（快照）行為，這些資料是儲存在記憶體中的，並且會在短時間內自動過期。如果你需要長時間保留資料，請記得從客戶端重新擷取。

出現「bridge client is not authorized」錯誤：請確保你的客戶端有正確的程式碼簽章。如果你是在 debug 模式下運行，可以嘗試使用 PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1。
找不到任何主機：請打開 OpenClaw.app 並確認已經在系統設定中授予必要的權限。
權限缺失：當權限不足時，橋樑會直接回傳錯誤訊息，而不會主動彈出系統設定視窗。

如果你在設定過程遇到任何問題，可以直接詢問我們的 AI Setup Assistant。

OpenClaw Expert

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。