Puente de cucú

OpenClaw puede alojar PeekabooBridge como un broker local de automatización de UI que tiene en cuenta los permisos. Esto permite que la CLI peekaboo controle la automatización de UI mientras reutiliza los permisos TCC de la app de macOS.

Qué es esto (y qué no es)

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

Relación con Computer Use

OpenClaw tiene tres rutas de control de escritorio, y se mantienen separadas intencionalmente:

• Host de PeekabooBridge: OpenClaw.app puede alojar el socket local de PeekabooBridge. La CLI peekaboo sigue siendo el cliente y usa los permisos de macOS de OpenClaw.app para primitivas de automatización de Peekaboo, como capturas de pantalla, clics, menús, diálogos, acciones del Dock y gestión de ventanas.
• Codex Computer Use: el Plugin codex incluido prepara el servidor de apps de Codex, verifica que el servidor MCP computer-use de Codex esté disponible y luego permite que Codex sea propietario de las llamadas a herramientas nativas de control de escritorio durante turnos en modo Codex. OpenClaw no actúa como proxy de esas acciones a través de PeekabooBridge.
• MCP cua-driver directo: OpenClaw puede registrar el servidor cua-driver mcp upstream de TryCua como un servidor MCP normal. Eso da a los agentes los propios esquemas del controlador CUA y el flujo de trabajo de pid/ventana/índice de elemento sin enrutar a través del marketplace de Codex ni del socket de PeekabooBridge.

Usa Peekaboo cuando quieras la amplia superficie de automatización de macOS y el host de puente con permisos de OpenClaw.app. Usa Codex Computer Use cuando un agente en modo Codex deba depender del Plugin nativo de uso de computadora de Codex. Usa cua-driver mcp directo cuando quieras exponer el controlador CUA a cualquier runtime gestionado por OpenClaw como un servidor MCP normal.

Habilitar el puente

En la app de macOS:

• Settings → Enable 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 de clientes

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 (broker ligero)

Usa peekaboo bridge status --verbose para ver qué host está activo y qué ruta de socket está en uso. Puedes sobrescribirlo con:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Seguridad y permisos

• El puente 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).
• Prefiere la identidad firmada del puente/app sobre un runtime node genérico para Accesibilidad. Conceder Accesibilidad a node permite que cualquier paquete iniciado por ese ejecutable de Node herede acceso de automatización de GUI; consulta permisos de macOS.
• Las solicitudes expiran después de ~10 segundos.
• Si faltan permisos requeridos, el puente devuelve un mensaje de error claro en lugar de iniciar System Settings.

Comportamiento de instantáneas (automatización)

Las instantáneas se almacenan en memoria y expiran automáticamente tras una ventana breve. Si necesitas una retención más larga, vuelve a capturar desde el cliente.

Solución de problemas

• Si peekaboo informa "bridge client is not authorized", asegúrate de que el cliente esté firmado correctamente 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.

Relacionado

• app de macOS
• permisos de macOS