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

# Peekaboo Bridge

# Peekaboo Bridge (macOS UI 자동화)

OpenClaw는 **PeekabooBridge**를 로컬 권한 인식 UI 자동화 브로커로 호스팅할 수 있습니다. 이를 통해 `peekaboo` CLI는 macOS 앱의 TCC 권한을 재사용하면서 UI 자동화를 구동할 수 있습니다.

## 이것이 무엇인지 (그리고 무엇이 아닌지)

* **호스트**: OpenClaw\.app는 PeekabooBridge 호스트로 작동할 수 있습니다.
* **클라이언트**: `peekaboo` CLI 사용 (별도의 `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 허용 목록이 적용됩니다 (Peekaboo 호스트 TeamID + OpenClaw 앱 TeamID).
* 요청은 약 10초 후에 시간 초과됩니다.
* 필요한 권한이 없는 경우, 브리지는 시스템 설정을 실행하는 대신 명확한 오류 메시지를 반환합니다.

## 스냅샷 동작 (자동화)

스냅샷은 메모리에 저장되며 짧은 시간 후 자동으로 만료됩니다. 더 긴 유지가 필요하면 클라이언트에서 다시 캡처하십시오.

## 문제 해결

* `peekaboo`가 "브리지 클라이언트가 인증되지 않았습니다"라고 보고하는 경우, 클라이언트가 올바르게 서명되었는지 확인하거나 **디버그** 모드에서 `PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1` 환경 변수와 함께 호스트를 실행하십시오.
* 호스트를 찾을 수 없는 경우, 호스트 앱 중 하나를 열고 (Peekaboo.app 또는 OpenClaw\.app) 권한이 부여되었는지 확인하십시오.