OpenClaw 브라우저 제어 가이드: 자동화 및 프로필 설정

브라우저 자동화를 구현하다 보면 드라이버 설정이나 세션 관리 때문에 정작 중요한 로직에 집중하지 못할 때가 많죠. 특히 원격 환경이나 기존 브라우저 세션을 제어해야 할 때는 설정이 더 복잡해지곤 합니다.

openclaw browser를 사용하면 OpenClaw의 브라우저 제어 서버를 관리하고 탭 조작, 스냅샷 촬영, 클릭 등 다양한 액션을 아주 간단하게 실행할 수 있습니다. 복잡한 설정 없이 CLI에서 바로 브라우저를 제어하는 방법을 알아보세요.

openclaw browser

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

관련 문서:

• 브라우저 도구 + API: Browser tool

공통 플래그

• --url <gatewayWsUrl>: Gateway WebSocket URL (기본값은 설정 파일 참조).
• --token <token>: Gateway 토큰 (필요한 경우).
• --timeout <ms>: 요청 타임아웃 (ms).
• --browser-profile <name>: 브라우저 프로필 선택 (기본값은 설정 파일 참조).
• --json: 기계 읽기 가능한 출력 형식 (지원되는 경우).

빠른 시작 (로컬)

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

명령어를 찾을 수 없는 경우

만약 openclaw browser가 알 수 없는 명령어라고 나온다면, ~/.openclaw/openclaw.json 파일의 plugins.allow 설정을 확인해 보세요.

plugins.allow 항목이 있다면, 아래와 같이 내장된 브라우저 플러그인이 명시적으로 포함되어 있어야 합니다.

{
  plugins: {
    allow: ["telegram", "browser"],
  },
}

플러그인 허용 목록(allowlist)에서 browser가 제외되어 있다면, browser.enabled=true 설정만으로는 CLI 서브명령어가 활성화되지 않습니다.

관련 문서: Browser tool

프로필

프로필은 이름이 지정된 브라우저 라우팅 설정입니다. 실제 사용 사례는 다음과 같습니다.

• openclaw: OpenClaw가 관리하는 전용 Chrome 인스턴스를 실행하거나 연결합니다 (격리된 사용자 데이터 디렉토리 사용).
• user: Chrome DevTools MCP를 통해 기존에 로그인된 Chrome 세션을 제어합니다.
• 커스텀 CDP 프로필: 로컬 또는 원격 CDP 엔드포인트를 지정합니다.

openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser create-profile --name chrome-live --driver existing-session
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"

MCP를 통한 기존 Chrome 사용

내장된 user 프로필을 사용하거나, 직접 existing-session 프로필을 생성할 수 있습니다.

openclaw browser --browser-profile user tabs
openclaw browser create-profile --name chrome-live --driver existing-session
openclaw browser create-profile --name brave-live --driver existing-session --user-data-dir "~/Library/Application Support/BraveSoftware/Brave-Browser"
openclaw browser --browser-profile chrome-live tabs

이 경로는 호스트 전용입니다. Docker, 헤드리스 서버, Browserless 또는 기타 원격 설정의 경우 CDP 프로필을 대신 사용하세요.

원격 브라우저 제어 (node host proxy)

Gateway가 브라우저와 다른 머신에서 실행 중이라면, Chrome/Brave/Edge/Chromium이 설치된 머신에서 node host를 실행하세요. Gateway가 해당 노드로 브라우저 액션을 프록시하므로 별도의 브라우저 제어 서버를 설치할 필요가 없습니다.

자동 라우팅을 제어하려면 gateway.nodes.browser.mode를 사용하고, 여러 노드가 연결된 경우 특정 노드를 고정하려면 gateway.nodes.browser.node를 사용하세요.

보안 및 원격 설정 관련: Browser tool, Remote access, Tailscale, Security

다음 단계

• Browser tool 상세 가이드
• Gateway 보안 설정

AI Setup Assistant