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

# browser

# `openclaw browser`

Quản lý máy chủ điều khiển trình duyệt của OpenClaw và chạy các hành động trình duyệt (tab, snapshot, screenshot, điều hướng, nhấp chuột, gõ phím).

Liên quan:

* Công cụ + API trình duyệt: [Browser tool](/tools/browser)
* Chuyển tiếp tiện ích mở rộng Chrome: [Chrome extension](/tools/chrome-extension)

## Cờ thường dùng

* `--url <gatewayWsUrl>`: URL WebSocket của Gateway (mặc định lấy từ cấu hình).
* `--token <token>`: token của Gateway (nếu cần).
* `--timeout <ms>`: thời gian chờ yêu cầu (ms).
* `--browser-profile <name>`: chọn một hồ sơ trình duyệt (mặc định từ cấu hình).
* `--json`: đầu ra có thể đọc bằng máy (nơi được hỗ trợ).

## Khởi động nhanh (cục bộ)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

## Hồ sơ

Profiles are named browser routing configs. Trong thực tế:

* `openclaw`: khởi chạy/đính kèm một phiên bản Chrome do OpenClaw quản lý riêng (thư mục dữ liệu người dùng tách biệt).
* `chrome`: điều khiển các tab Chrome hiện có của bạn thông qua chuyển tiếp tiện ích mở rộng 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
```

Dùng một hồ sơ cụ thể:

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

## Tab

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

## Snapshot / screenshot / hành động

Ảnh chụp nhanh:

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

Ảnh chụp màn hình:

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

Điều hướng/nhấp/gõ (tự động hóa UI dựa trên ref):

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

## Chuyển tiếp tiện ích mở rộng Chrome (gắn qua nút trên thanh công cụ)

Chế độ này cho phép tác tử điều khiển một tab Chrome hiện có mà bạn gắn thủ công (không tự động gắn).

Cài đặt tiện ích mở rộng dạng unpacked vào một đường dẫn ổn định:

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

Sau đó trong Chrome → `chrome://extensions` → bật “Developer mode” → “Load unpacked” → chọn thư mục đã in ra.

Hướng dẫn đầy đủ: [Chrome extension](/tools/chrome-extension)

## Điều khiển trình duyệt từ xa (proxy node host)

If the Gateway runs on a different machine than the browser, run a **node host** on the machine that has Chrome/Brave/Edge/Chromium. The Gateway will proxy browser actions to that node (no separate browser control server required).

Dùng `gateway.nodes.browser.mode` để kiểm soát định tuyến tự động và `gateway.nodes.browser.node` để ghim một node cụ thể nếu có nhiều node được kết nối.

Bảo mật + thiết lập từ xa: [Browser tool](/tools/browser), [Remote access](/gateway/remote), [Tailscale](/gateway/tailscale), [Security](/gateway/security)