Peekaboo Bridge (macOS UI 자동화)
OpenClaw 는 PeekabooBridge 를 로컬의 권한 인식 UI 자동화 브로커로 호스팅할 수 있습니다. 이를 통해peekaboo CLI 가
macOS 앱의 TCC 권한을 재사용하면서 UI 자동화를 구동할 수 있습니다.
이것이 무엇이고 (무엇이 아닌지)
- Host: OpenClaw.app 는 PeekabooBridge 호스트로 동작할 수 있습니다.
- Client:
peekabooCLI 를 사용합니다 (별도의openclaw ui ...표면 없음). - UI: 시각적 오버레이는 Peekaboo.app 에 유지되며, OpenClaw 는 얇은 브로커 호스트입니다.
브리지 활성화
macOS 앱에서:- 설정 → Enable Peekaboo Bridge
peekaboo 는 다른 사용 가능한 호스트로
폴백합니다.
클라이언트 검색 순서
Peekaboo 클라이언트는 일반적으로 다음 순서로 호스트를 시도합니다:- Peekaboo.app (전체 UX)
- Claude.app (설치된 경우)
- OpenClaw.app (얇은 브로커)
peekaboo bridge status --verbose 를 사용하여 어떤 호스트가 활성화되어 있는지와 사용 중인
소켓 경로를 확인하십시오. 다음으로 재정의할 수 있습니다:
보안 및 권한
- 브리지는 호출자 코드 서명 을 검증하며, TeamID 허용 목록이 적용됩니다 (Peekaboo 호스트 TeamID + OpenClaw 앱 TeamID).
- 요청은 약 10 초 후 타임아웃됩니다.
- 필요한 권한이 누락된 경우, 브리지는 시스템 설정을 실행하는 대신 명확한 오류 메시지를 반환합니다.
스냅샷 동작 (자동화)
스냅샷은 메모리에 저장되며 짧은 시간 창 이후 자동으로 만료됩니다. 더 긴 보존이 필요하면 클라이언트에서 다시 캡처하십시오.문제 해결
peekaboo가 “bridge client is not authorized” 를 보고하는 경우, 클라이언트가 올바르게 서명되었는지 확인하거나 디버그 모드에서만PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1로 호스트를 실행하십시오.- 호스트를 찾을 수 없는 경우, 호스트 앱 (Peekaboo.app 또는 OpenClaw.app) 중 하나를 열고 권한이 부여되었는지 확인하십시오.