openclaw browser

OpenClaw의 브라우저 제어 서버를 관리하고 브라우저 작업(탭, 스냅샷, 스크린샷, 내비게이션, 클릭, 타이핑)을 실행합니다.

관련 문서:

• 브라우저 도구 + API: Browser tool
• Chrome 확장 프로그램 릴레이: Chrome extension

공통 플래그

• --url <gatewayWsUrl>: 게이트웨이 WebSocket URL (설정에서 기본값).
• --token <token>: 게이트웨이 토큰 (필요한 경우).
• --timeout <ms>: 요청 타임아웃 (ms).
• --browser-profile <name>: 브라우저 프로필 선택 (설정에서 기본값).
• --json: 기계 판독 가능 출력 (지원되는 경우).

빠른 시작 (로컬)

openclaw browser --browser-profile chrome tabs
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

프로필

프로필은 이름이 지정된 브라우저 라우팅 설정입니다. 실제로는:

• openclaw: 전용 OpenClaw 관리 Chrome 인스턴스를 시작/연결합니다(격리된 사용자 데이터 디렉토리).
• chrome: Chrome 확장 프로그램 릴레이를 통해 기존 Chrome 탭을 제어합니다.

openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser delete-profile --name work

특정 프로필 사용:

openclaw browser --browser-profile work tabs

탭

openclaw browser tabs
openclaw browser open https://docs.openclaw.ai
openclaw browser focus <targetId>
openclaw browser close <targetId>

스냅샷 / 스크린샷 / 작업

스냅샷:

openclaw browser snapshot

스크린샷:

openclaw browser screenshot

내비게이션/클릭/타이핑 (ref 기반 UI 자동화):

openclaw browser navigate https://example.com
openclaw browser click <ref>
openclaw browser type <ref> "hello"

Chrome 확장 프로그램 릴레이 (도구 모음 버튼으로 연결)

이 모드를 사용하면 에이전트가 수동으로 연결한 기존 Chrome 탭을 제어할 수 있습니다(자동 연결하지 않음).

언패킹된 확장 프로그램을 안정적인 경로에 설치:

openclaw browser extension install
openclaw browser extension path

그런 다음 Chrome → chrome://extensions → “개발자 모드” 활성화 → “압축해제된 확장 프로그램을 로드합니다” → 출력된 폴더 선택.

전체 가이드: Chrome extension

원격 브라우저 제어 (노드 호스트 프록시)

게이트웨이가 브라우저와 다른 머신에서 실행되는 경우, Chrome/Brave/Edge/Chromium이 있는 머신에서 노드 호스트를 실행하세요. 게이트웨이가 해당 노드로 브라우저 작업을 프록시합니다(별도의 브라우저 제어 서버가 필요 없음).

gateway.nodes.browser.mode로 자동 라우팅을 제어하고, 여러 노드가 연결된 경우 gateway.nodes.browser.node로 특정 노드를 고정할 수 있습니다.

보안 + 원격 설정: Browser tool, Remote access, Tailscale, Security