Puente Peekaboo

Puente Peekaboo (automatización de la IU de macOS)

OpenClaw puede alojar PeekabooBridge como un intermediario (broker) de automatización de la IU local y con conocimiento de permisos. Esto permite que la CLI de peekaboo impulse la automatización de la IU reutilizando los permisos TCC de la aplicación de macOS.

Qué es esto (y qué no es)

• Host: OpenClaw.app puede actuar como un host de PeekabooBridge.
• Cliente: utilice la CLI de peekaboo (no hay una superficie de openclaw ui ... separada).
• IU: las superposiciones visuales permanecen en Peekaboo.app; OpenClaw es un host de intermediario ligero.

Habilitar el puente

En la aplicación de macOS:

• Ajustes → Habilitar Peekaboo Bridge

Cuando está habilitado, OpenClaw inicia un servidor de socket UNIX local. Si está deshabilitado, el host se detiene y peekaboo recurrirá a otros hosts disponibles.

Orden de descubrimiento del cliente

Los clientes de Peekaboo suelen intentar los hosts en este orden:

1. Peekaboo.app (UX completa)
2. Claude.app (si está instalado)
3. OpenClaw.app (intermediario ligero)

Use peekaboo bridge status --verbose para ver qué host está activo y qué ruta de socket está en uso. Puede anularlo con:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Seguridad y permisos

• El puente valida las firmas de código de quien llama; se impone una lista de permitidos de TeamIDs (TeamID del host de Peekaboo + TeamID de la aplicación OpenClaw).
• Las solicitudes caducan después de ~10 segundos.
• Si faltan los permisos necesarios, el puente devuelve un mensaje de error claro en lugar de iniciar Configuración del Sistema.

Comportamiento de instantáneas (automatización)

Las instantáneas se almacenan en memoria y caducan automáticamente después de un breve período. Si necesita una retención más larga, vuelva a capturar desde el cliente.

Solución de problemas

• Si peekaboo informa “bridge client is not authorized”, asegúrese de que el cliente esté firmado correctamente o ejecute el host con PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 solo en modo debug.
• Si no se encuentran hosts, abra una de las aplicaciones host (Peekaboo.app u OpenClaw.app) y confirme que se hayan otorgado los permisos.