메인 콘텐츠로 건너뛰기

​
openclaw browser

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

​
공통 플래그

  • --url <gatewayWsUrl>: 게이트웨이 WebSocket URL (기본 설정에서 사용).
  • --token <token>: 게이트웨이 토큰 (필요할 경우).
  • --timeout <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
탐색/클릭/타이핑 (참조 기반 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 확장 프로그램

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

게이트웨이가 브라우저가 실행되는 컴퓨터와 다른 컴퓨터에서 실행되는 경우, Chrome/Brave/Edge/Chromium이 있는 컴퓨터에서 노드 호스트를 실행하십시오. 게이트웨이는 해당 노드로 브라우저 작업을 프록시합니다 (별도의 브라우저 제어 서버가 필요하지 않음). gateway.nodes.browser.mode를 사용하여 자동 라우팅을 제어하고, 여러 노드가 연결된 경우 특정 노드를 고정하려면 gateway.nodes.browser.node를 사용합니다. 보안 + 원격 설정: 브라우저 도구, 원격 접속, Tailscale, 보안