Puente Peekaboo

OpenClaw puede alojar PeekabooBridge como un intermediario (broker) de automatización de interfaz de usuario local y con permisos. Esto permite que la línea de comandos (CLI) de peekaboo impulse la automatización de la interfaz de usuario reutilizando los permisos TCC de la aplicación de macOS.

Qué es (y qué no es)

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

Relación con el uso del ordenador

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

Anfitrión PeekabooBridge: OpenClaw.app puede alojar el socket local de PeekabooBridge. La CLI de peekaboo sigue siendo el cliente y utiliza los permisos de macOS de OpenClaw.app para primitivas de automatización de Peekaboo, como capturas de pantalla, clics, menús, cuadros de diálogo, acciones del Dock y gestión de ventanas.
Uso de ordenador de Codex: el complemento codex incluido prepara el servidor de aplicaciones de Codex, verifica que el servidor MCP computer-use de Codex esté disponible y luego permite que Codex gestione las llamadas a herramientas nativas de control del escritorio durante los turnos en modo Codex. OpenClaw no transmite esas acciones a través de PeekabooBridge.
cua-driver MCP directo: OpenClaw puede registrar el servidor cua-driver mcp upstream de TryCua como un servidor MCP normal. Esto proporciona a los agentes los esquemas propios del controlador CUA y el flujo de trabajo pid/window/element-index sin enrutar a través del mercado de Codex o del socket PeekabooBridge.

Use Peekaboo cuando desee la superficie de automatización de macOS amplia y el anfitrión del puente con reconocimiento de permisos de OpenClaw.app. Use el Uso de ordenador de Codex cuando un agente en modo Codex deba confiar en el complemento nativo de uso de ordenador de Codex. Use cua-driver mcp directo cuando desee que el controlador CUA esté expuesto a cualquier tiempo de ejecución gestionado por OpenClaw como un servidor MCP normal.

Habilitar el puente

En la aplicación 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 del cliente

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

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

Use peekaboo bridge status --verbose para ver qué anfitrión 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 la persona que llama; se aplica una lista de permitidos de TeamIDs (TeamID del anfitrión de Peekaboo + TeamID de la aplicación OpenClaw).
Las solicitudes agotan el tiempo de espera después de ~10 segundos.
Si faltan los permisos necesarios, el puente devuelve un mensaje de error claro en lugar de abrir Configuración del Sistema.

Comportamiento de las instantáneas (automatización)

Las instantáneas se almacenan en memoria y caducan automáticamente después de un breve período. 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 host con PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 solo en modo debug.
Si no se encuentra ningún host, abre una de las aplicaciones host (Peekaboo.app u OpenClaw.app) y confirma que se hayan otorgado los permisos.