openclaw/Peekaboo

어떤 프로젝트인가요?

핵심 기능

• 01전체 화면, 단일 앱 또는 특정 창을 PNG 파일로 캡처합니다.
• 02실행 중인 앱의 구조화된 UI 맵을 요소 ID와 함께 생성해 대상을 지정할 수 있습니다.
• 03특정 요소나 창을 대상으로 클릭, 입력, 키 누르기, 스크롤, 드래그를 수행합니다.
• 04자연어 요청을 여러 단계의 동작으로 변환하는 에이전트를 실행합니다.
• 05MCP 서버를 통해 AI 클라이언트에 도구를 제공합니다.
• 06지정한 창에 백그라운드로 입력을 전달할 수 있습니다.

활용 사례

• AI 에이전트가 Safari나 Finder 같은 네이티브 macOS 앱을 조작하도록 합니다.
• 스크립팅 API 없이 데스크톱 소프트웨어에서 반복적인 클릭과 텍스트 입력을 자동화합니다.
• 문서화, 테스트 또는 버그 보고에 사용할 앱이나 창의 스크린샷을 캡처합니다.
• MCP를 지원하는 코딩 어시스턴트가 UI 상태를 살펴보고 검증할 수 있게 합니다.

빠른 시작

1. 1

   Homebrew로 CLI 설치하기

   brew install openclaw/tap/peekaboo
2. 2

   Peekaboo에 부여된 권한 확인하기

   peekaboo permissions status
3. 3

   화면 스크린샷 찍기

   peekaboo see --no-elements --mode screen --path /tmp/peekaboo-screen.png
4. 4

   실행 중인 앱을 검사해 구조화된 UI 맵 가져오기

   peekaboo see --app Finder --json

사용 전 알아둘 점

• !macOS 15 이상이 필요하므로 Windows와 Linux에서는 실행되지 않습니다.
• !완전히 작동하려면 먼저 화면 녹화 및 손쉬운 사용 권한을 수동으로 허용해야 합니다.
• !에이전트를 실행하려면 모델 제공업체를 구성해야 합니다.

토픽

자주 묻는 질문

Peekaboo은(는) 무엇인가요?

AI 에이전트나 MCP 클라이언트가 화면과 앱 창을 캡처하고 UI 요소를 살펴보며 클릭과 입력을 자동화할 수 있는 macOS CLI 및 메뉴 막대 앱입니다. Peekaboo는 화면 캡처, 접근성 검사, 네이티브 UI 자동화를 지원하는 macOS 명령줄 도구이자 메뉴 막대 앱입니다. 일반적인 사용 흐름은 현재 화면을 확인하고, 불투명 ID가 포함된 구조화된 UI 맵에서 요소를 선택한 다음 클릭, 입력, 키 누르기, 스크롤 또는 메뉴 명령으로 조작하는 방식입니다.

Peekaboo은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

Peekaboo은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

Peekaboo은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. Peekaboo의 마지막 커밋은 2026년 10월 20일입니다.

Peekaboo은(는) 어디에 사용할 수 있나요?

AI 에이전트가 Safari나 Finder 같은 네이티브 macOS 앱을 조작하도록 합니다. 스크립팅 API 없이 데스크톱 소프트웨어에서 반복적인 클릭과 텍스트 입력을 자동화합니다. 문서화, 테스트 또는 버그 보고에 사용할 앱이나 창의 스크린샷을 캡처합니다. MCP를 지원하는 코딩 어시스턴트가 UI 상태를 살펴보고 검증할 수 있게 합니다.

Peekaboo는 어떻게 설치하나요?

Homebrew로 CLI 설치하기: brew install openclaw/tap/peekaboo Peekaboo에 부여된 권한 확인하기: peekaboo permissions status 화면 스크린샷 찍기: peekaboo see --no-elements --mode screen --path /tmp/peekaboo-screen.png 실행 중인 앱을 검사해 구조화된 UI 맵 가져오기: peekaboo see --app Finder --json

Peekaboo은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/openclaw/Peekaboo