跳转到主要内容

​
Peekaboo Bridge(macOS UI 自动化)

OpenClaw 可以将 PeekabooBridge 托管为本地、权限感知的 UI 自动化代理。 这让 peekaboo CLI 驱动 UI 自动化,同时重用 macOS 应用的 TCC 权限。

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

  • 主机: OpenClaw.app 可以充当 PeekabooBridge 主机。
  • 客户端: 使用 peekaboo CLI(没有单独的 openclaw ui ... 表面)。
  • UI: 视觉叠加层留在 Peekaboo.app 中;OpenClaw 是一个薄代理主机。

​
启用桥接

在 macOS 应用中:
  • 设置 → Enable 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”,请确保客户端 已正确签名,或仅在调试模式下使用 PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 运行主机。
  • 如果未找到主机,请打开其中一个主机应用(Peekaboo.app 或 OpenClaw.app) 并确认已授予权限。