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.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 đặtGOLOGIN_EXECUTABLE_PATH.
Cài đặt
gologin-agent-browserchạy các phiên trình duyệt trên cloud, trừ khi bạn chọn local.gologin-local-agent-browserlà 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 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:targets.json liệt kê các profile:
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-browservẫ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