Вспомогательное приложение для macOS

Peekaboo Bridge

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

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

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

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

В приложении 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

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

  • Мост проверяет цифровые подписи вызывающего кода; применяется разрешительный список TeamID (TeamID хоста Peekaboo + TeamID приложения OpenClaw).
  • Запросы истекают через ~10 секунд.
  • Если требуемые разрешения отсутствуют, мост возвращает понятное сообщение об ошибке, а не запускает Системные настройки.

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

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

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

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

Навыки