跳转到主要内容
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 迁移。
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。
除非你选择本地运行时,否则 snapshot、click、close 等会话命令会发送到云端运行时。打开本地会话后,后续的每个命令都要传入 --runtime local,或者设置 GOLOGIN_AGENT_BROWSER_RUNTIME=local。
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 技能已弃用。

相关内容

npm 包

gologin-agent-browser-cli

源代码

GologinLabs/agent-browser