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（完整体验）
2. Claude.app（如已安装）
3. OpenClaw.app（轻量中介）

使用 peekaboo bridge status --verbose 查看当前活跃的 host 和使用的 socket 路径。你可以覆盖设置：

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

安全与权限

• Bridge 验证调用方的代码签名；维护一个 TeamID 允许列表（Peekaboo host TeamID + OpenClaw 应用 TeamID）。
• 请求在约 10 秒后超时。
• 如果缺少所需权限，Bridge 会返回清晰的错误信息，而不是打开系统设置。

快照行为（自动化）

快照存储在内存中，短时间窗口后自动过期。如果需要更长保留期，从 client 重新截取。

故障排查

• 如果 peekaboo 报告 “bridge client is not authorized”，确保 client 已正确签名，或仅在 debug 模式下设置 PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 运行 host。
• 如果找不到任何 host，打开某个 host 应用（Peekaboo.app 或 OpenClaw.app）并确认权限已授予。