> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openclaw.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# 브라우저

# `openclaw browser`

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

관련 항목:

* 브라우저 도구 + API: [브라우저 도구](/tools/browser)
* Chrome 확장 프로그램 릴레이: [Chrome 확장 프로그램](/tools/chrome-extension)

## 공통 플래그

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

## 빠른 시작 (로컬)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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`: 전용 OpenClaw 관리 Chrome 인스턴스를 실행/연결 (격리된 사용자 데이터 디렉토리).
* `user`: Chrome DevTools MCP를 통해 기존에 로그인된 Chrome 세션을 제어합니다.
* `chrome-relay`: Chrome 확장 프로그램 릴레이를 통해 기존 Chrome 탭을 제어합니다.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser delete-profile --name work
```

특정 프로필 사용:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw browser --browser-profile work tabs
```

## 탭

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw browser tabs
openclaw browser open https://docs.openclaw.kr/ko-KR
openclaw browser focus <targetId>
openclaw browser close <targetId>
```

## 스냅샷 / 스크린샷 / 작업

스냅샷:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw browser snapshot
```

스크린샷:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw browser screenshot
```

탐색/클릭/타이핑 (참조 기반 UI 자동화):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw browser navigate https://example.com
openclaw browser click <ref>
openclaw browser type <ref> "hello"
```

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

이 모드는 에이전트가 수동으로 연결한 기존 Chrome 탭을 제어하도록 합니다 (자동 연결되지 않습니다).

고정된 경로에 확장 프로그램을 설치합니다:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw browser extension install
openclaw browser extension path
```

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

전체 가이드: [Chrome 확장 프로그램](/tools/chrome-extension)

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

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

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

보안 + 원격 설정: [브라우저 도구](/tools/browser), [원격 접속](/gateway/remote), [Tailscale](/gateway/tailscale), [보안](/gateway/security)