브라우저 도구

개요

OpenClaw의 브라우저 도구는 에이전트가 격리된 브라우저 프로필을 통해 웹 페이지를 탐색하고 조작할 수 있게 한다. Chrome, Brave, Edge를 지원하며, 로컬 또는 원격 CDP(Chrome DevTools Protocol) 연결을 통해 작동한다.

브라우저 프로필

프로필	설명	용도
`openclaw`	OpenClaw가 관리하는 격리 프로필	기본 자동화 작업
`user`	DevTools MCP를 통한 사용자 브라우저	로그인된 세션 활용
`custom`	원격 CDP 엔드포인트 연결	클라우드 브라우저 서비스

openclaw 프로필 (기본)

OpenClaw가 자체 관리하는 브라우저 인스턴스를 사용한다. 사용자 브라우저와 완전히 격리되어 있어 기존 세션, 쿠키, 확장 프로그램에 영향을 주지 않는다.

user 프로필

사용자의 실제 브라우저에 DevTools MCP로 연결한다. 이미 로그인된 서비스에 접근할 때 유용하다.

custom 프로필

원격 CDP를 통해 클라우드 브라우저 서비스에 연결한다.

사용 가능한 액션

액션	설명
`click`	요소 클릭
`type`	텍스트 입력
`drag`	드래그 앤 드롭
`select`	드롭다운 선택
`snapshot`	페이지 접근성 스냅샷 (텍스트 기반)
`screenshot`	페이지 스크린샷 (이미지)

스냅샷 vs 스크린샷

스냅샷: 접근성 트리 기반의 텍스트 표현. 토큰 소모가 적고 빠름
스크린샷: 실제 화면 이미지. 시각적 확인이 필요할 때 사용

보안

브라우저 도구는 루프백(loopback) 전용 접근만 허용한다. 외부에서 브라우저 인스턴스에 직접 접근할 수 없다.

환경 변수를 통해 인증 정보를 전달할 수 있다.

{
  "tools": {
    "browser": {
      "profile": "openclaw",
      "env": {
        "LOGIN_USER": "${BROWSER_USER}",
        "LOGIN_PASS": "${BROWSER_PASS}"
      }
    }
  }
}

CLI 명령어

브라우저 상태 확인

openclaw browser status

현재 브라우저 인스턴스 상태, 활성 프로필, 열린 탭 수를 확인한다.

브라우저 열기

openclaw browser open [URL]

지정한 URL을 브라우저에서 연다.

스냅샷 캡처

openclaw browser snapshot

현재 페이지의 접근성 스냅샷을 출력한다.

원격 CDP 연결

클라우드 브라우저 서비스(Browserless, Browserbase 등)를 사용할 수 있다.

{
  "tools": {
    "browser": {
      "profile": "custom",
      "cdpEndpoint": "wss://chrome.browserless.io?token=YOUR_TOKEN"
    }
  }
}

원격 CDP를 사용하면 로컬에 브라우저를 설치하지 않아도 되며, 서버 환경에서도 브라우저 자동화가 가능하다.