跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 可以將 PeekabooBridge 作為本機、具備權限感知能力的 UI 自動化代理主機。這讓 peekaboo CLI 能驅動 UI 自動化，同時重用 macOS 應用程式的 TCC 權限。

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

  • 主機：OpenClaw.app 可以作為 PeekabooBridge 主機。
  • 用戶端：使用 peekaboo CLI（沒有獨立的 openclaw ui ... 介面）。
  • UI：視覺覆疊保留在 Peekaboo.app；OpenClaw 是精簡的代理主機。

​
與 Computer Use 的關係

OpenClaw 有三種桌面控制路徑，而且它們刻意保持分離：
  • PeekabooBridge 主機：OpenClaw.app 可以託管本機 PeekabooBridge socket。 peekaboo CLI 仍是用戶端，並使用 OpenClaw.app 的 macOS 權限來執行 Peekaboo 自動化原語，例如截圖、點按、選單、對話框、Dock 動作和視窗管理。
  • Codex Computer Use：內建的 codex Plugin 會準備 Codex 應用程式伺服器，確認 Codex 的 computer-use MCP 伺服器可用，然後讓 Codex 在 Codex 模式回合期間擁有原生桌面控制工具呼叫。OpenClaw 不會透過 PeekabooBridge 代理這些動作。
  • 直接 cua-driver MCP：OpenClaw 可以將 TryCua 的上游 cua-driver mcp 伺服器註冊為一般 MCP 伺服器。這會讓代理程式取得 CUA driver 自身的 schema，以及 pid/視窗/元素索引工作流程，而不必透過 Codex marketplace 或 PeekabooBridge socket 路由。
當你需要廣泛的 macOS 自動化介面，以及 OpenClaw.app 具備權限感知能力的橋接主機時，請使用 Peekaboo。當 Codex 模式代理程式應依賴 Codex 原生 computer-use Plugin 時，請使用 Codex Computer Use。當你想將 CUA driver 作為一般 MCP 伺服器暴露給任何由 OpenClaw 管理的執行階段時，請使用直接 cua-driver mcp。

​
啟用橋接

在 macOS 應用程式中：
  • 設定 → 啟用 Peekaboo Bridge
啟用後，OpenClaw 會啟動本機 UNIX socket 伺服器。若停用，主機會停止，且 peekaboo 會退回使用其他可用主機。

​
用戶端探索順序

Peekaboo 用戶端通常會依下列順序嘗試主機：
  1. Peekaboo.app（完整 UX）
  2. Claude.app（若已安裝）
  3. OpenClaw.app（精簡代理）
使用 peekaboo bridge status --verbose 查看目前啟用的主機，以及正在使用的 socket 路徑。你可以用以下方式覆寫： 
export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

​
安全性與權限

  • 橋接會驗證呼叫者程式碼簽章；會強制執行 TeamID 允許清單（Peekaboo 主機 TeamID + OpenClaw 應用程式 TeamID）。
  • 請求會在約 10 秒後逾時。
  • 如果缺少必要權限，橋接會回傳清楚的錯誤訊息，而不是啟動「系統設定」。

​
快照行為（自動化）

快照會儲存在記憶體中，並在短時間窗口後自動過期。如果你需要保留更久，請從用戶端重新擷取。

​
疑難排解

  • 如果 peekaboo 回報「橋接用戶端未獲授權」，請確認用戶端已正確簽署，或僅在偵錯模式下使用 PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 執行主機。
  • 如果找不到任何主機，請開啟其中一個主機應用程式（Peekaboo.app 或 OpenClaw.app），並確認已授予權限。

​
相關