Openclaw용 OpenClaw 네이티브 브라우저

검색 API 키 없이 인증된 웹 세션 및 탭 관리를 지원하는 OpenClaw 에이전트용 안정적인 네이티브 WKWebView 브라우저입니다.

yungookim
v0.1.0
Feb 17, 2026
0
1.7k
0

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install openclaw-browser-2

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 openclaw-browser-2 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

OpenClaw 네이티브 브라우저란 무엇인가요?

OpenClaw 네이티브 브라우저는 AI 에이전트에게 웹상의 실제 존재감을 부여하도록 설계된 고성능 WKWebView 구현체입니다. 기본적인 헤드리스 스크레이퍼와 달리, 이는 전체 탭 관리와 네이티브 URL 바가 있는 가시적인 창을 제공하는 Openclaw Skills 중 하나입니다. 이를 통해 에이전트는 표준 검색 API의 한계를 넘어 Perplexity, Grok, ChatGPT와 같은 현대적이고 복잡한 웹 애플리케이션과 인간처럼 상호작용할 수 있습니다.

이를 Openclaw Skills 컬렉션에 포함하면 웹 검색을 위한 유료 API 키가 필요하지 않습니다. 브라우저는 영구 쿠키와 세션을 유지하므로 에이전트가 여러 작업에 걸쳐 서비스에 로그인된 상태를 유지할 수 있습니다. 이중 창 아키텍처는 에이전트가 툴바를 통해 탐색을 관리하는 동시에 깨끗한 IPC 인터페이스를 통해 특정 콘텐츠 창과 상호작용할 수 있도록 보장합니다.

OpenClaw 네이티브 브라우저 활용 사례

  • Claude 또는 ChatGPT와 같은 인증된 웹 애플리케이션 탐색 및 상호작용
  • 외부 API 키에 의존하지 않고 웹 검색 및 조사 수행
  • 다양한 브라우저 탭에서 복잡한 다단계 워크플로우 자동화
  • 데이터 추출 및 분석을 위한 스크린샷 및 DOM 스냅샷 캡처
  • 실제 사용자 상호작용 및 JavaScript 실행이 필요한 웹사이트 처리

OpenClaw 네이티브 브라우저 작동 원리

  1. OpenClawBrowserSkill은 싱글톤으로 초기화되어 Openclaw Skills에 강력한 추가 기능이 됩니다.
  2. pywebview 메인 스레드를 관리하기 위해 전용 자식 프로세스가 생성되어 브라우저가 에이전트의 로직을 방해하지 않도록 합니다.
  3. 탭 및 URL 관리를 위한 시각적 UI를 제공하기 위해 프레임리스 툴바 창이 생성됩니다.
  4. 모든 새 탭에 대해 네이티브 WKWebView 콘텐츠 창이 인스턴스화됩니다.
  5. JavaScript 실행, 요소 클릭 또는 텍스트 입력을 위해 stdin/stdout을 통한 JSON 기반 IPC로 명령이 전달됩니다.
  6. 브라우저는 처리를 위해 데이터, 제목 또는 스냅샷을 에이전트에게 반환합니다.

OpenClaw 네이티브 브라우저 설정 가이드

이 도구를 Openclaw Skills와 통합하려면 리포지토리를 복제하고 pip를 사용하여 패키지를 설치하세요.

git clone https://github.com/yungookim/openclaw-browser.git ~/clawd/openclaw-browser
cd ~/clawd/openclaw-browser
pip install -e .

터미널에서 다음 명령을 실행하여 설치를 확인합니다.

python -c "import sys; sys.path.insert(0, '/Users/$USER/clawd/openclaw-browser'); from src import OpenClawBrowserSkill, __version__; print(f'openclaw-browser v{__version__} ready')"

OpenClaw 네이티브 브라우저 데이터 스키마 및 분류 체계

이 스킬은 탐색 및 상호작용을 관리하기 위해 구조화된 API를 활용합니다. 다음은 Openclaw Skills에 추가된 이 기능 내에서 사용 가능한 데이터 및 메서드 요약입니다.

기능 메서드 목적
탐색 load(url) 활성 탭에 URL 로드
상태 snapshot() HTML 콘텐츠 및 메타데이터 반환
상호작용 click(selector) CSS 선택자에 대한 네이티브 클릭 수행
입력 type_text(selector, text) 특정 입력 필드에 텍스트 입력
탭 new_tab(url) 새 브라우저 인스턴스를 열고 추적
인증 login_claude() 특수 로그인 도우미 흐름 실행

OpenClaw 네이티브 브라우저 고급 기능

  • Perplexity, Grok, Claude, ChatGPT를 포함한 주요 AI 플랫폼을 위한 내장 로그인 도우미
  • 독립적인 전환 및 닫기 기능이 있는 멀티 탭 오케스트레이션
  • 장기 실행 작업을 위한 네이티브 macOS 쿠키 저장소를 통한 영구 세션 관리
  • 에이전트 실행 중 깨끗하고 방해받지 않는 개발자 경험을 위한 프레임리스 UI 아키텍처
  • 브라우저가 자식 프로세스에서 실행되도록 보장하여 충돌이 메인 에이전트 스레드에 영향을 주지 않도록 하는 하위 프로세스 격리

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*