> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Peekaboo Bridge

# Peekaboo Bridge (автоматизация UI в macOS)

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`, чтобы увидеть, какой хост активен и какой
путь сокета используется. Вы можете переопределить его с помощью:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock
```

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

* Мост проверяет **подписи кода вызывающей стороны**; применяется список разрешённых TeamID
  (TeamID хоста Peekaboo + TeamID приложения OpenClaw).
* Запросы истекают по тайм‑ауту примерно через 10 секунд.
* Если требуемые разрешения отсутствуют, мост возвращает понятное сообщение об ошибке,
  а не запускает System Settings.

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

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

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

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