Saltar al contenido principal

​
Peekaboo Bridge (automatización de UI en macOS)

OpenClaw puede alojar PeekabooBridge como un intermediario local de automatización de UI con reconocimiento de permisos. Esto permite que la CLI peekaboo controle la automatización de la UI reutilizando los permisos TCC de la app de macOS.

​
Qué es (y qué no es)

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

​
Habilitar el bridge

En la app de macOS:
  • Ajustes → Habilitar Peekaboo Bridge
Cuando está habilitado, OpenClaw inicia un servidor local de socket UNIX. Si está deshabilitado, el host se detiene y peekaboo volverá a otros hosts disponibles.

​
Orden de descubrimiento del cliente

Los clientes de Peekaboo normalmente prueban los hosts en este orden:
  1. Peekaboo.app (UX completa)
  2. Claude.app (si está instalada)
  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 sobrescribirlo con: 
export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

​
Seguridad y permisos

  • El bridge valida firmas de código del llamador; se aplica una lista de permitidos de TeamIDs (TeamID del host de Peekaboo + TeamID de la app OpenClaw).
  • Las solicitudes expiran después de ~10 segundos.
  • Si faltan permisos requeridos, el bridge devuelve un mensaje de error claro en lugar de abrir Ajustes del Sistema.

​
Comportamiento de snapshots (automatización)

Las snapshots se almacenan en memoria y caducan automáticamente después de una ventana corta. Si necesita una retención más prolongada, 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 apps host (Peekaboo.app u OpenClaw.app) y confirme que los permisos estén concedidos.