Peekaboo Bridge (macOS UI 自动化)

OpenClaw 可以将 PeekabooBridge 作为本地的、权限感知的 UI 自动化代理进行托管。这使得 peekaboo CLI 能够驱动 UI 自动化,同时复用 macOS 应用的 TCC 权限。

这是什么(以及不是什么)

• 主机:OpenClaw.app 可以作为 PeekabooBridge 主机。
• 客户端:使用 peekaboo CLI(没有独立的 openclaw ui ... 界面)。
• UI:可视化覆盖层保留在 Peekaboo.app 中;OpenClaw 是一个轻量级代理主机。

启用 bridge

在 macOS 应用中:

• 设置 → 启用 Peekaboo Bridge

启用后,OpenClaw 会启动一个本地 UNIX socket 服务器。如果禁用,主机将停止,peekaboo 将回退到其他可用主机。

客户端发现顺序

Peekaboo 客户端通常按以下顺序尝试主机:

1. Peekaboo.app(完整用户体验)
2. Claude.app(如果已安装)
3. OpenClaw.app(轻量级代理)

使用 peekaboo bridge status --verbose 查看哪个主机处于活动状态以及正在使用哪个 socket 路径。您可以通过以下方式覆盖:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

安全与权限

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

快照行为(自动化)

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

故障排除

• 如果 peekaboo 报告"bridge client is not authorized",请确保客户端已正确签名,或在调试模式下使用 PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 运行主机。
• 如果找不到主机,请打开其中一个主机应用(Peekaboo.app 或 OpenClaw.app)并确认已授予权限。