Peekaboo 桥接
PeekabooBridge integration for macOS UI automation
OpenClaw 可以托管 PeekabooBridge 作为本地、感知权限的 UI 自动化
代理。这允许 ''peekaboo'' CLI 驱动 UI 自动化，同时重用
macOS 应用的 TCC 权限。
这是什么（以及不是什么）
- 主机：OpenClaw.app 可以充当 PeekabooBridge 主机。
- ''客户端''：使用 ''peekaboo'' CLI（没有单独的 ''openclaw ui ...'' 界面）。
- UI：视觉叠加层保留在 Peekaboo.app 中；OpenClaw 是一个精简的代理主机。
启用桥接
在 macOS 应用中：
- 设置 → 启用 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"，请确保客户端
properly signed or run the host with ''PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1''
仅在 调试 模式下。
- 如果未找到主机，请打开其中一个主机应用（Peekaboo.app 或 OpenClaw.app）
并确认已授予权限。