`openclaw browser`

Quản lý server điều khiển browser của OpenClaw và thực hiện các thao tác trên browser (tabs, snapshots, screenshots, điều hướng, click, gõ phím).

Liên quan:

Browser tool + API: Browser tool
Chrome extension relay: Chrome extension

Các flag thường dùng

--url <gatewayWsUrl>: Gateway WebSocket URL (mặc định lấy từ config).
--token <token>: Gateway token (nếu cần).
--timeout <ms>: thời gian chờ request (ms).
--browser-profile <name>: chọn browser profile (mặc định từ config).
--json: output dạng machine-readable (nếu hỗ trợ).

Bắt đầu nhanh (local)

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

Profiles

Profiles là các cấu hình routing cho browser có tên riêng. Trong thực tế:

openclaw: khởi chạy/attach vào Chrome instance do OpenClaw quản lý riêng (thư mục user data độc lập).
chrome: điều khiển tab Chrome hiện có của các bạn qua Chrome extension relay.

openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser delete-profile --name work

Dùng một profile cụ thể:

openclaw browser --browser-profile work tabs

Tabs

openclaw browser tabs
openclaw browser open https://docs.openclaw.ai
openclaw browser focus <targetId>
openclaw browser close <targetId>

Snapshot / screenshot / actions

Snapshot:

openclaw browser snapshot

Screenshot:

openclaw browser screenshot

Điều hướng/click/gõ phím (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"

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

Cài extension chưa đóng gói vào đường dẫn cố định:

openclaw browser extension install
openclaw browser extension path

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

Hướng dẫn đầy đủ: Chrome extension

Điều khiển browser từ xa (node host proxy)

Nếu Gateway chạy trên máy khác với browser, các bạn chạy một node host trên máy có Chrome/Brave/Edge/Chromium. Gateway sẽ proxy các thao tác browser đến node đó (không cần browser control server riêng).

Dùng gateway.nodes.browser.mode để điều khiển auto-routing và gateway.nodes.browser.node để chỉ định một node cụ thể nếu có nhiều node kết nối.

Bảo mật + thiết lập từ xa: Browser tool, Remote access, Tailscale, Security

openclaw browser