简要总结
Peekaboo Bridge
这页说明书在讲一个叫“Peekaboo Bridge”的小帮手。它就像一个传话员，可以让一个叫 peekaboo 的命令行工具，借用 OpenClaw 这个软件在电脑屏幕上做事的权限。这样，peekaboo 就能帮你自动点击按钮或者看看屏幕上的东西了。如果你想让 peekaboo 和 OpenClaw 一起工作，就需要看看这页。
五岁小孩版解释
Peekaboo Bridge 是一个特别的传话员。它住在 OpenClaw 软件里，专门帮 peekaboo 这个命令行工具和你的电脑屏幕“说话”。因为电脑屏幕很害羞，需要得到你的允许才能碰它。OpenClaw 软件已经得到了你的允许，所以 Peekaboo Bridge 就可以借用 OpenClaw 的“通行证”，让 peekaboo 去安全地操作屏幕了。
怎么打开这个传话员呢？ 很简单，就在 OpenClaw 软件里设置。
- 要做什么：找到设置开关。
怎么做：打开 OpenClaw 软件，找到“Settings”（就是“设置”的意思），然后在里面找到“Enable Peekaboo Bridge”（意思是“打开 Peekaboo 桥”），把它打开。
当你打开它，OpenClaw 就会悄悄启动一个小服务。如果你关掉它，服务就停了，
peekaboo就会去找别的帮手。
peekaboo 会找谁帮忙呢？
peekaboo 这个工具很聪明，它会按顺序找朋友帮忙：
- 先找 Peekaboo.app（它本事最大）。
- 如果没找到，就找 Claude.app（如果电脑里有的话）。
- 最后才找 OpenClaw.app（就是我们说的这个“传话员”）。
你可以用
peekaboo bridge status --verbose这个命令看看现在是谁在帮忙。如果你想指定一个特别的传话员，可以告诉电脑一个“秘密地址”：export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock。
安全很重要！ Peekaboo Bridge 很小心，它只相信认识的朋友。
- 它会检查来找它帮忙的工具是不是“好人”（检查代码签名）。
- 它只允许名单上的朋友（比如 Peekaboo 和 OpenClaw）来帮忙。
- 如果等朋友回话超过大约10秒钟，它就不等了。
- 如果它发现自己没有操作屏幕的权限，它会直接告诉你，而不会自己跑去打开系统设置。
关于“拍照片”（自动化截图）
当 peekaboo 通过桥让电脑“拍一张屏幕的照片”时，这张照片只会暂时记在脑子里（内存里），过一小会儿就自动忘记了。如果你需要把照片留久一点，记得让 peekaboo 重新拍一张哦。
如果遇到小麻烦
- 如果
peekaboo说“bridge client is not authorized”（桥的客户没被授权），说明它可能不被认为是“好人”。你需要确保这个工具是正确签名的。或者，只在调试的时候，可以告诉 OpenClaw 一个秘密口令PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1来允许未签名的朋友。 - 如果
peekaboo说找不到任何帮手，那你就需要打开 Peekaboo.app 或者 OpenClaw.app 其中一个软件，并且确认你已经给了它们操作屏幕的权限。