Мост Peekaboo

OpenClaw может размещать PeekabooBridge как локальный, учитывающий разрешения брокер автоматизации UI. Это позволяет CLI peekaboo управлять автоматизацией UI, повторно используя разрешения TCC приложения macOS.

Что это такое (и чем не является)

• Хост: OpenClaw.app может выступать хостом PeekabooBridge.
• Клиент: используйте CLI peekaboo (без отдельной поверхности openclaw ui ...).
• UI: визуальные оверлеи остаются в Peekaboo.app; OpenClaw — тонкий хост-брокер.

Связь с Computer Use

У OpenClaw есть три пути управления рабочим столом, и они намеренно остаются раздельными:

• Хост PeekabooBridge: OpenClaw.app может размещать локальный сокет PeekabooBridge. CLI peekaboo остается клиентом и использует разрешения macOS OpenClaw.app для примитивов автоматизации Peekaboo, таких как снимки экрана, щелчки, меню, диалоги, действия Dock и управление окнами.
• Codex Computer Use: встроенный Plugin codex подготавливает сервер приложений Codex, проверяет доступность MCP-сервера Codex computer-use, а затем позволяет Codex владеть вызовами инструментов нативного управления рабочим столом во время ходов в режиме Codex. OpenClaw не проксирует эти действия через PeekabooBridge.
• Прямой MCP cua-driver: OpenClaw может зарегистрировать вышестоящий сервер TryCua cua-driver mcp как обычный MCP-сервер. Это дает агентам собственные схемы CUA-драйвера и рабочий процесс pid/окно/индекс элемента без маршрутизации через маркетплейс Codex или сокет PeekabooBridge.

Используйте Peekaboo, когда вам нужна широкая поверхность автоматизации macOS и учитывающий разрешения хост-мост OpenClaw.app. Используйте Codex Computer Use, когда агент в режиме Codex должен полагаться на нативный Plugin Codex для computer-use. Используйте прямой cua-driver mcp, когда хотите предоставить CUA-драйвер любой среде выполнения, управляемой OpenClaw, как обычный MCP-сервер.

Включение моста

В приложении macOS:

• Настройки → Включить Peekaboo Bridge

Когда включено, OpenClaw запускает локальный сервер UNIX-сокета. Если отключено, хост останавливается, и peekaboo вернется к другим доступным хостам.

Порядок обнаружения клиентов

Клиенты Peekaboo обычно пробуют хосты в таком порядке:

1. Peekaboo.app (полный UX)
2. Claude.app (если установлено)
3. OpenClaw.app (тонкий брокер)

Используйте peekaboo bridge status --verbose, чтобы увидеть, какой хост активен и какой путь к сокету используется. Можно переопределить с помощью:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Безопасность и разрешения

• Мост проверяет подписи кода вызывающих клиентов; применяется allowlist TeamID (TeamID хоста Peekaboo + TeamID приложения OpenClaw).
• Предпочитайте подписанную идентичность моста/приложения вместо универсальной среды выполнения node для Accessibility. Предоставление Accessibility для node позволяет любому пакету, запущенному этим исполняемым файлом Node, наследовать доступ к автоматизации GUI; см. разрешения macOS.
• Время ожидания запросов истекает примерно через 10 секунд.
• Если необходимые разрешения отсутствуют, мост возвращает понятное сообщение об ошибке, а не запускает «Системные настройки».

Поведение снимков (автоматизация)

Снимки хранятся в памяти и автоматически истекают через короткий промежуток времени. Если требуется более длительное хранение, повторно сделайте снимок из клиента.

Устранение неполадок

• Если peekaboo сообщает "bridge client is not authorized", убедитесь, что клиент правильно подписан, или запускайте хост с PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 только в режиме отладки.
• Если хосты не найдены, откройте одно из приложений-хостов (Peekaboo.app или OpenClaw.app) и убедитесь, что разрешения предоставлены.

Связанные материалы

• приложение macOS
• разрешения macOS