Puente de cucú

OpenClaw puede alojar PeekabooBridge como un intermediario local de automatización de UI con control de 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)

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

# Relación con Computer Use

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

• Anfitrión 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 administración de ventanas.
• Codex Computer Use: el Plugin codex incluido prepara el servidor de app 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 redirige esas acciones a través de PeekabooBridge.
• MCP directo de cua-driver: OpenClaw puede registrar el servidor cua-driver mcp upstream de TryCua como un servidor MCP normal. Eso ofrece a los agentes los esquemas propios 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 anfitrión de puente con control de permisos de OpenClaw.app. Usa Codex Computer Use cuando un agente en modo Codex deba depender del Plugin nativo de computer-use de Codex. Usa cua-driver mcp directo cuando quieras exponer el controlador CUA a cualquier runtime administrado por OpenClaw como un servidor MCP normal.

# Habilitar el puente

En la app de macOS:

• Configuración → Habilitar Peekaboo Bridge

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

# Orden de descubrimiento de clientes

Los clientes de Peekaboo suelen probar anfitriones en este orden:

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

Usa peekaboo bridge status --verbose para ver qué anfitrión está activo y qué ruta de socket está en uso. Puedes sobrescribirla 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 anfitrión Peekaboo + TeamID de la app OpenClaw).
• Las solicitudes agotan el tiempo de espera después de ~10 segundos.
• Si faltan permisos requeridos, el puente devuelve un mensaje de error claro en lugar de abrir 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 intervalo breve. Si necesitas una retención más larga, vuelve a capturarlas 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 anfitrión con PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 solo en modo debug.
• Si no se encuentra ningún anfitrión, abre una de las apps anfitrionas (Peekaboo.app u OpenClaw.app) y confirma que se hayan concedido los permisos.

# Relacionado

• app de macOS
• permisos de macOS