跳转到主要内容

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 可以将 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 套接字。peekaboo CLI 仍然是客户端，并使用 OpenClaw.app 的 macOS 权限来执行 Peekaboo 自动化原语，例如截图、点击、菜单、对话框、Dock 操作和窗口管理。
  • Codex Computer Use：内置的 codex 插件会准备 Codex 应用服务器，验证 Codex 的 computer-use MCP 服务器可用，然后让 Codex 在 Codex 模式轮次中拥有原生桌面控制工具调用。OpenClaw 不会通过 PeekabooBridge 代理这些操作。
  • 直接 cua-driver MCP：OpenClaw 可以将 TryCua 的上游 cua-driver mcp 服务器注册为普通 MCP 服务器。这样智能体就能使用 CUA 驱动自己的架构以及 pid/窗口/元素索引工作流，而无需经由 Codex marketplace 或 PeekabooBridge 套接字路由。
当你需要广泛的 macOS 自动化能力以及 OpenClaw.app 具备权限感知能力的桥接主机时，请使用 Peekaboo。当 Codex 模式智能体应依赖 Codex 的原生 computer-use 插件时，请使用 Codex Computer Use。当你想将 CUA 驱动作为普通 MCP 服务器暴露给任何由 OpenClaw 管理的运行时时，请使用直接 cua-driver mcp。

​
启用桥接

在 macOS 应用中：
  • Settings → 启用 Peekaboo Bridge
启用后，OpenClaw 会启动一个本地 UNIX 套接字服务器。如果禁用，主机会停止，peekaboo 将回退到其他可用主机。

​
客户端发现顺序

Peekaboo 客户端通常按以下顺序尝试主机：
  1. Peekaboo.app（完整 UX）
  2. Claude.app（如果已安装）
  3. OpenClaw.app（轻量代理）
使用 peekaboo bridge status --verbose 查看哪个主机处于活动状态，以及正在使用哪个套接字路径。你可以用以下方式覆盖： 
export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

​
安全和权限

  • 桥接会验证调用方代码签名；会强制执行 TeamID 允许列表（Peekaboo 主机 TeamID + OpenClaw 应用 TeamID）。
  • 请求会在约 10 秒后超时。
  • 如果缺少所需权限，桥接会返回清晰的错误消息，而不是启动系统设置。

​
快照行为（自动化）

快照存储在内存中，并会在一个很短的窗口期后自动过期。如果你需要更长时间的保留，请从客户端重新捕获。

​
故障排除

  • 如果 peekaboo 报告 “bridge client is not authorized”，请确保客户端已正确签名，或仅在debug模式下使用 PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 运行主机。
  • 如果找不到任何主机，请打开其中一个主机应用（Peekaboo.app 或 OpenClaw.app），并确认已授予权限。

​
相关内容