macOS PeekabooBridge

概述

OpenClaw 可托管 PeekabooBridge，作为本地、权限感知的 UI 自动化代理。peekaboo CLI 驱动 UI 自动化，复用 macOS 应用的 TCC 权限。

三种桌面控制路径

路径	说明
PeekabooBridge host	OpenClaw.app 托管本地 socket，peekaboo CLI 作为客户端
Codex Computer Use	内置 codex 插件，Codex 拥有原生桌面控制工具调用
直接 cua-driver MCP	将 TryCua 的 cua-driver mcp 注册为普通 MCP 服务器

启用 Bridge

在 macOS 应用中：Settings → Enable Peekaboo Bridge

启用后 OpenClaw 启动本地 UNIX socket 服务器；禁用后 peekaboo 回退到其他可用主机。

客户端发现顺序

1. Peekaboo.app（完整 UX）
2. Claude.app（如已安装）
3. OpenClaw.app（轻量代理）

# 查看当前活跃主机
peekaboo bridge status --verbose
 
# 覆盖 socket 路径
export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

安全与权限

• Bridge 验证调用者代码签名，强制执行 TeamID 允许列表
• 请求超时约 10 秒
• 权限缺失时返回明确错误，而非打开系统设置

故障排查

• peekaboo 报告”bridge client is not authorized”：确保客户端已正确签名，或在 debug 模式下使用 PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1
• 找不到主机：打开 Peekaboo.app 或 OpenClaw.app 并确认权限已授予

相关链接

• platform-mac-permissions — macOS 权限管理
• platform-macos — macOS 伴侣应用