Chuyển đến nội dung chính

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ờ 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ộ)

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.
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ể:
openclaw browser --browser-profile work tabs

Tab

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:
openclaw browser snapshot
Ảnh chụp màn hình:
openclaw browser screenshot
Điều hướng/nhấp/gõ (tự động hóa UI dựa trên ref):
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:
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

Đ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, Remote access, Tailscale, Security