튜토리얼 카테고리 Skills 소개
ZH EN JA KO
👀

Peekaboo

UI 자동화 개발 도구

설치 명령어

npx clawhub@latest install peekaboo

설치 안내

1
환경 확인

Node.js 22 이상과 OpenClaw가 설치되어 있는지 확인하세요. 터미널에서 openclaw --version을 실행하여 확인할 수 있습니다.

2
설치 실행

위의 설치 명령어를 터미널에서 실행하세요. ClawHub가 자동으로 Peekaboo을(를) ~/.openclaw/skills/ 디렉토리에 다운로드하고 설치합니다.

3
설치 확인

openclaw skills list를 실행하여 설치된 스킬 목록을 확인하고, Peekaboo이(가) 목록에 표시되는지 확인하세요.

4
매개변수 설정 (선택사항)

아래 소개의 설정 안내에 따라 ~/.config/openclaw/openclaw.json5에 스킬 설정 항목을 추가하세요.

수동 설치 방법: Skill 폴더를 ~/.openclaw/skills/ 또는 프로젝트의 skills/ 디렉토리에 복사하세요. 폴더에 SKILL.md 파일이 포함되어 있어야 합니다.
화면 인식 UI 제어 플로우 녹화

상세 소개

Peekaboo는 OpenClaw에 macOS 데스크톱 UI 자동화 기능을 제공하며, 스크린샷과 시각 인식 기술로 UI 요소를 식별하고 마우스와 키보드 조작을 시뮬레이션하여 모든 데스크톱 앱을 제어합니다.

핵심 기능

  • 화면 인식: 현재 화면을 캡처하고 AI 비전 모델로 UI 요소의 위치와 상태를 식별
  • UI 제어: 마우스 클릭, 드래그, 키보드 입력 등을 시뮬레이션하여 데스크톱 앱 제어
  • 플로우 녹화: 사용자의 조작 플로우를 녹화하고 재생 가능한 자동화 스크립트를 자동 생성
  • 멀티 앱 연계: 여러 데스크톱 앱에 걸쳐 복합 작업 실행

설정 방법

{
  skills: {
    peekaboo: {
      screenshotInterval: 1000,
      clickDelay: 200,
      retryOnFail: true,
      permissions: {
        accessibility: true,
        screenRecording: true
      }
    }
  }
}

사용 시나리오

  • 데이터 입력, 보고서 내보내기 등 반복적인 데스크톱 조작 플로우를 자동화
  • 데스크톱 애플리케이션의 UI 기능 테스트
  • 조작 튜토리얼과 데모 비디오 녹화
  • 여러 데스크톱 앱에 걸쳐 복합 워크플로우 실행