Local Agent Browser CLI 现已并入 Agent Browser CLI。
gologin-local-agent-browser-cli npm 包已弃用:请安装 gologin-agent-browser-cli 并使用 --runtime local。调用 gologin-local-agent-browser 的脚本仍可继续使用,详见从 Local Agent Browser CLI 迁移。cloud 运行时在 Gologin Cloud Browser 中运行会话。local 运行时则在你自己的电脑上,通过 Gologin 浏览器 Orbita 运行会话。本页介绍本地运行时。快照、引用(refs)及其他命令的用法与 Agent Browser CLI 页面所述一致。
何时使用 local,何时使用 cloud
要求
- Node.js 20 或更高版本。本地运行时通过 Gologin Node.js SDK 启动 Orbita,而该 SDK 需要 Node.js 20。
- 在
GOLOGIN_TOKEN中设置 Gologin API 令牌。参见获取令牌。 - 每个会话都需要一个配置文件 ID。与云端运行时不同,本地运行时不会创建临时配置文件。
- Orbita。如果尚未安装,Gologin SDK 会在首次启动时将其下载到
~/.gologin/browser。如果 Orbita 位于其他位置,请设置GOLOGIN_EXECUTABLE_PATH。
安装
gologin-agent-browser:除非你选择本地运行时,否则在云端运行浏览器会话。gologin-local-agent-browser:兼容别名,在本地运行时中执行命令。
选择本地运行时
可以为单个命令传入--runtime local,也可以为整个 shell 一次性设置运行时:
--local 以及在命令前加 local 同样有效:gologin-agent-browser local open https://example.com --profile your_profile_id。
api、browser 和 proxy 等 Gologin API 命令无论使用哪种运行时,都会直接调用 API。
环境变量
本地运行时会把配置、配置文件列表和任务历史保存在
~/.gologin-local-agent-browser/ 中,与旧版 CLI 使用的文件夹相同。
快速开始
--visible(或 --headed)和 --headless(或 --background)用于为单次 open 选择窗口模式。open-visible 和 open-background 是它们的快捷命令。
浏览器命令
会话命令与云端运行时相同:snapshot、click、type、fill、find、wait、press、scroll、tabs、cookies、storage-export、eval、screenshot、pdf、upload 等。参见命令参考。back、forward 和 reload 目前仅在云端运行时中可用。
find 可以在当前页面上定位元素并一步完成操作。在动态页面上引用(refs)失效时,可以使用它:
配置文件命令
即使不使用--runtime local,这些命令也会在本地运行时中执行:
profile-create 和 profile-update 支持使用场景模板和代理。--proxy-country us 会添加 Gologin 代理,--proxy-host 配合 --proxy-port 则设置你自己的代理。
Runbook 与批量任务
Runbook 是一个包含 CLI 步骤列表的 JSON 文件:targets.json 列出要运行的配置文件:
jobs 和 job <jobId> 查看结果。--status 可取 running、ok、partial 或 failed:
从 Local Agent Browser CLI 迁移
- 调用
gologin-local-agent-browser的脚本仍可继续使用。该命令现在由gologin-agent-browser-cli提供。 ~/.gologin-local-agent-browser/中的配置文件、配置和任务历史保持原位不变。- 对于 AI 智能体,请安装 Agent Browser 技能。它同时支持两种运行时,而独立的 Local Agent Browser 技能已弃用。
相关内容
- Agent Browser CLI — 完整命令参考和云端运行时
- Gologin Web Access CLI — 在一个 CLI 中使用抓取和浏览器命令
- AI 技能 — 适用于 Claude Code 和其他智能体的技能
- Node.js SDK — 通过你自己的代码运行配置文件
npm 包
gologin-agent-browser-cli
源代码
GologinLabs/agent-browser