Перейти к основному содержанию
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) и убедитесь, что разрешения предоставлены.

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