Chuyển đến nội dung chính
Local Agent Browser CLI nay đã trở thành một phần của Agent Browser CLI. Gói npm gologin-local-agent-browser-cli đã bị đánh dấu là lỗi thời: hãy cài đặt gologin-agent-browser-cli và dùng --runtime local. Các script gọi gologin-local-agent-browser vẫn hoạt động bình thường, xem Chuyển từ Local Agent Browser CLI.
Agent Browser CLI có hai runtime với cùng một bộ lệnh. Runtime cloud chạy các phiên trong Gologin Cloud Browser. Runtime local chạy các phiên trong Orbita, trình duyệt của Gologin, ngay trên máy của bạn. Trang này nói về runtime local. Snapshot, ref và các lệnh khác hoạt động như mô tả trong trang Agent Browser CLI.

Khi nào dùng local, khi nào dùng cloud


Yêu cầu

  • Node.js 20 trở lên. Runtime local khởi chạy Orbita thông qua Gologin Node.js SDK, và SDK này cần Node.js 20.
  • Gologin API token trong GOLOGIN_TOKEN. Xem Lấy token.
  • Một profile ID cho mỗi phiên. Khác với runtime cloud, runtime local không tạo profile tạm thời.
  • Orbita. Nếu chưa được cài đặt, Gologin SDK sẽ tải Orbita về ~/.gologin/browser ở lần khởi chạy đầu tiên. Nếu Orbita nằm ở nơi khác, hãy đặt GOLOGIN_EXECUTABLE_PATH.

Cài đặt

Gói này cài đặt hai lệnh:
  • gologin-agent-browser chạy các phiên trình duyệt trên cloud, trừ khi bạn chọn local.
  • gologin-local-agent-browser là bí danh tương thích, chạy các lệnh trong runtime local.

Chọn runtime local

Thêm --runtime local vào lệnh, hoặc đặt runtime một lần cho toàn bộ shell:
--local và local đặt ở đầu cũng dùng được: gologin-agent-browser local open https://example.com --profile your_profile_id.
Các lệnh phiên như snapshot, click và close sẽ chạy trên runtime cloud trừ khi bạn chọn local. Sau khi mở một phiên local, hãy thêm --runtime local vào mọi lệnh tiếp theo, hoặc đặt GOLOGIN_AGENT_BROWSER_RUNTIME=local.
Các lệnh Gologin API như api, browser và proxy luôn gọi trực tiếp API, bất kể runtime nào.

Biến môi trường

Runtime local lưu cấu hình, danh sách profile và lịch sử job trong ~/.gologin-local-agent-browser/, cùng thư mục mà CLI cũ đã dùng.

Bắt đầu nhanh

--visible (hoặc --headed) và --headless (hoặc --background) chọn chế độ cửa sổ cho một lần open. open-visible và open-background là các lệnh tắt tương ứng.

Lệnh trình duyệt

Các lệnh phiên giống như trong runtime cloud: snapshot, click, type, fill, find, wait, press, scroll, tabs, cookies, storage-export, eval, screenshot, pdf, upload và nhiều lệnh khác. Xem tài liệu tham khảo lệnh. Hiện tại back, forward và reload chỉ hoạt động trong runtime cloud. find xác định một phần tử trên trang đang mở và thao tác với nó chỉ trong một bước. Hãy dùng lệnh này khi ref bị lỗi thời trên các trang động:

Lệnh profile

Các lệnh này chạy trong runtime local ngay cả khi không có --runtime local: profile-create và profile-update nhận một mẫu theo tình huống sử dụng và một proxy. --proxy-country us thêm proxy của Gologin, còn --proxy-host kết hợp với --proxy-port dùng để đặt proxy của riêng bạn.

Runbook và tác vụ hàng loạt

Runbook là một tệp JSON chứa danh sách các bước CLI:
Chạy runbook trên một profile, hoặc trên nhiều profile song song:
targets.json liệt kê các profile:
Kiểm tra kết quả bằng jobs và job <jobId>. --status nhận giá trị running, ok, partial hoặc failed:

Chuyển từ Local Agent Browser CLI

  • Các script gọi gologin-local-agent-browser vẫn hoạt động. Lệnh này hiện đến từ gologin-agent-browser-cli.
  • Profile, cấu hình và lịch sử job trong ~/.gologin-local-agent-browser/ vẫn giữ nguyên vị trí.
  • Với AI agent, hãy cài đặt Agent Browser skill. Skill này hỗ trợ cả hai runtime, còn Local Agent Browser skill riêng biệt đã bị đánh dấu là lỗi thời.

Liên quan

  • Agent Browser CLI — tài liệu tham khảo đầy đủ về lệnh và runtime cloud
  • Gologin Web Access CLI — các lệnh thu thập dữ liệu và trình duyệt trong cùng một CLI
  • AI Skills — các skill cho Claude Code và các agent khác
  • Node.js SDK — chạy profile từ mã của riêng bạn

Gói npm

gologin-agent-browser-cli

Mã nguồn

GologinLabs/agent-browser