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

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

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

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

* Мост проверяет **подписи кода вызывающих клиентов**; применяется allowlist TeamID (TeamID хоста Peekaboo + TeamID приложения OpenClaw).
* Предпочитайте подписанную идентичность моста/приложения вместо универсальной среды выполнения `node` для Accessibility. Предоставление Accessibility для `node` позволяет любому пакету, запущенному этим исполняемым файлом Node, наследовать доступ к автоматизации GUI; см. [разрешения macOS](/ru/platforms/mac/permissions#accessibility-grants-for-node-and-cli-runtimes).
* Время ожидания запросов истекает примерно через 10 секунд.
* Если необходимые разрешения отсутствуют, мост возвращает понятное сообщение об ошибке, а не запускает «Системные настройки».

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

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

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

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

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

* [приложение macOS](/ru/platforms/macos)
* [разрешения macOS](/ru/platforms/mac/permissions)