openclaw browser

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

관련 항목:

일반 플래그

  • --url <gatewayWsUrl>: Gateway WebSocket URL (구성에서 기본값).
  • --token <token>: Gateway 토큰 (필요한 경우).
  • --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

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

Gateway가 브라우저와 다른 머신에서 실행되는 경우, Chrome/Brave/Edge/Chromium이 있는 머신에서 node 호스트를 실행하세요. Gateway는 브라우저 액션을 해당 node로 프록시합니다 (별도의 브라우저 제어 서버 불필요).

gateway.nodes.browser.mode를 사용하여 자동 라우팅을 제어하고, 여러 node가 연결된 경우 gateway.nodes.browser.node를 사용하여 특정 node를 고정합니다.

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

← 문서로 돌아가기