Puente Peekaboo

OpenClaw puede alojar PeekabooBridge como un broker de automatización UI

local y consciente de permisos. Esto permite que el CLI ''peekaboo'' maneje automatización UI mientras reutiliza

los permisos TCC de la app macOS.

- Host: OpenClaw.app puede actuar como host de PeekabooBridge.

- ''Cliente'': usa el CLI ''peekaboo'' (no hay superficie ''openclaw ui ...'' separada).

- UI: las superposiciones visuales permanecen en Peekaboo.app; OpenClaw es un host broker ligero.

En la app macOS:

- Configuración → Habilitar Peekaboo Bridge

Cuando está habilitado, OpenClaw inicia un servidor de socket UNIX local. Si está deshabilitado, el host

se detiene y ''peekaboo'' retrocederá a otros hosts disponibles.

Los clientes Peekaboo típicamente prueban hosts en este orden:

1. Peekaboo.app (UX completo)

2. Claude.app (si está instalado)

3. OpenClaw.app (broker ligero)

Usa ''peekaboo bridge status --verbose'' para ver qué host está activo y qué

ruta de socket está en uso. Puedes sobrescribir con:

export PEEKABOO_BRIDGE_SOCKET=/ruta/a/bridge.sock

- El puente valida firmas de código del llamador; una lista permitida de TeamIDs es

aplicada (TeamID del host Peekaboo + TeamID de la app OpenClaw).

- Las peticiones expiran después de ~10 segundos.

- Si faltan permisos requeridos, el puente retorna un mensaje de error claro

en lugar de lanzar Configuración del Sistema.

Los snapshots se almacenan en memoria y expiran automáticamente después de una ventana corta.

Si necesitas retención más larga, recaptura desde el cliente.

- Si ''peekaboo'' reporta "bridge client is not authorized", asegúrate que el cliente esté

debidamente firmado o ejecuta el host con ''PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1''

solo en modo debug.

- Si no se encuentran hosts, abre una de las apps host (Peekaboo.app u OpenClaw.app)

y confirma que los permisos estén concedidos.