Automatiza tu UI en macOS con Peekaboo Bridge y OpenClaw

Seguro te ha pasado: intentas automatizar una tarea en macOS y terminas peleando con los diálogos de permisos de accesibilidad una y otra vez. Configurar herramientas de automatización de UI suele ser frustrante porque cada proceso nuevo requiere gestionar sus propios privilegios de TCC.

La mejor forma de solucionar esto es usar un broker que centralice los permisos. Con Peekaboo Bridge, puedes usar OpenClaw para ejecutar comandos de UI sin configurar permisos individuales para cada script.

Requisitos previos

• OpenClaw.app instalado en macOS.
• peekaboo CLI.

Inicio rápido

Configura el bridge en menos de 5 minutos siguiendo estos pasos:

1. Abre OpenClaw.app y ve a Settings.
2. Activa la opción Enable Peekaboo Bridge.
3. Verifica qué host está activo con este comando:

peekaboo bridge status --verbose

Si prefieres usar una ruta de socket específica en lugar de la predeterminada, define esta variable de entorno:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Cómo funciona el Bridge

OpenClaw funciona como un host ligero (broker) que permite a la CLI de peekaboo controlar la interfaz. Es importante entender estos puntos:

• Orden de descubrimiento: La CLI busca hosts en este orden: Peekaboo.app, Claude.app y finalmente OpenClaw.app.
• Seguridad: El bridge valida las firmas de código (code signatures). Solo permite conexiones de TeamIDs autorizados (Peekaboo y OpenClaw).
• Timeouts: Las solicitudes expiran tras 10 segundos para evitar procesos colgados.
• Snapshots: Las capturas de pantalla se guardan en memoria y expiran rápido. Si necesitas conservarlas, debes capturarlas de nuevo desde el cliente.

Solución de problemas

• Error “bridge client is not authorized”: Esto ocurre si el cliente no está firmado. Puedes saltarte esta validación en modo debug usando: PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1.
• No se encuentran hosts: Asegúrate de que OpenClaw.app esté abierto y que hayas aceptado los permisos de sistema necesarios en macOS.

¿Necesitas ayuda con una configuración específica? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Guía de comandos de peekaboo CLI
• Gestión de permisos TCC en macOS