发 生了什么

OpenCLI 是 Apache Arrow/DataFusion PMC 成员 jackwener 发起 的开源项目，截至 2026 年 4 月 11 日 v1.7.0 正式发布，已在 GitHub 上积累 15,600 个 Star 和超过 1,500 次 Fork。该项目为 AI Agent 网页 自动化提供了一种本质上不同的架构：它不在每次浏览器交互时都调用 LLM，而是 仅用一次 AI 调用来生成一个确定性的 JavaScript Adapter 文件，此 后该 Adapter 可无限次执行，LLM 调用成本为零。

项目内置 91 个 Adapter，采用 Apache 2.0 协议授权。截至撰文 时，项目共有 845 次提交、39 个待处理 Issue 和 49 个开放中的 PR。

为何重要

目前 AI Agent 浏览器自动化的主流方案 ——包括 Browser Use 和 Stagehand——在每一次执行周期中都需要让 LLM 分析 DOM 结构或页 面截图。根据项目文档，这意味着执行 100 次任务就等于发起 100 次 LLM 调用，Token 成本持续累加，且结果具有不确定性，页面的细 微变化都可能导致任务中断。

OpenCLI 借用 数据库查询优化的类比重新定义了这一问题：在「 编译期」（Adapter 生成阶段）消耗算力，以换取低 成本、高可靠的「运行期」执行。最终效果是， 执行 100 次任务所消耗的 LLM Token 与执行 1 次相同。

第 二个结构性优势在于凭据隔离。传统浏览器自动化方案需要将 Cookie 或密码传递给控制进程。OpenCLI 的 Chrome 扩展通过 Chrome DevTools Protocol（CDP）直接连接到 用户本地正在运行的 Chrome 会话，这意味着凭据始终不会离开浏览器进程。对 于企业场景和个人数据使用场景而言，这一点尤为关 键——将 Session Token 暴露给外部系统往往是无法逾 越的安全红线。

对于在 LLM Agent 之上进 行工程构建的团队——尤其是使用 Claude Code、OpenAI Codex 或类似编程 Agent、 需要可靠网页工具调用的团队——OpenCLI 提供了一个稳定、成本可预测的接口层。标准 Unix 退出码使其可以直接组合进 CI/CD 流水线，无需额外封装。

技术细节

Adapter 生命周期

OpenCLI 的 Adapter 生成遵循项目文档中 记载的四阶段流水线：

  • 探索（Explore）：AI 对 目标网站结构进行一次性分析
  • 提炼（Synthesize）：提取并规 范化交互模式
  • 生成（Generate）：将确定性的 .js Adapter 文件写入磁 盘
  • 级联验证（Cascading Validation）：在正式提交前，对 Adapter 进行基于 实时页面状态的测试验证

自修复协议

OpenCLI 内置了自 修复协议（Self-Repair Protocol）：当 Adapter 因页面变更而执行失败时，系统可自 动触发重新生成流程，而非静默返回错误数据。这一机制直接解决了静态网页爬虫最 常见的失效模式。

CDP Session 复用

Browser Bridge Chrome Extension 通过 CDP 将用户当前活跃的 Chrome 会话暴露给本地运行的 OpenCLI 进程。这在架构上与启动一个无头浏览器实例有本质区别—— 该扩展接入的是一个已完成身份验证的会话，因此 可以访问 SSO、2FA 保护或会话 绑定数据背后的站点，且无需提取 任何凭据。

安装方式

工具链通过 npm 安装：

npm install -g @jackwener/opencli

Chrome 扩展需从克隆仓库的 extension/ 目录以开发者模式手动加载。连接状态可通过以 下命令验证：

opencli doctor

AI Agent 技能集成通过以下命令处 理：

npx skills add jackwener/opencli

内置 Adapter 示例

91 个内置 Adapter 涵盖项 目文档中记录的以下命令：

  • opencli bilibili trending --format json
  • opencli twitter search "AI agent" --format csv
  • opencli browser screenshot --url https://github.com

Adapter 同样覆盖了基 于 Electron 的桌面应用，包括 Cursor、Notion、Discord 和 ChatGPT 桌面客户端，均可通过 CDP 进行访问与 控制。

值得持续关注的方向

  • Adapter 生态扩张：目 前已有 49 个开放 PR，社区为更多站点贡献的 Adapter 正在持续合并中。关注 v1.8.x 的发 布节奏，可了解覆盖范围的扩展进展。
  • Agent 框架集 成：npx skills add 接口表明 OpenCLI 正在积 极寻求与 Claude Code 及类似 Agent 运行时的深度集成。若 Anthropic 或 OpenAI 工具团队发布官方插件公告，将 显著加速其普及进程。
  • 企业级凭据安 全审查：基于 CDP 的 Session 复用在此场景下属 于新颖方案。大型组织的安全团 队需要评估将 Chrome DevTools 端点暴露给本地 npm 进 程的攻击面，即便不涉及凭据提取。
  • 竞品的应对动作：Browser Use 和 Stagehand 均 处于活跃开发周期。若 OpenCLI 的 Adapter 编译模式在规 模化场景下被证明足够可靠，预计类似的「缓存执行」模式将 在 60 至 90 天内出现在上述项目中。
  • Electron 应用覆盖：基于 CDP 控制 Electron 应用在开源 Agent 工具领域仍属 未被充分探索的方向。随着 Electron 及各应 用更新其 Chromium 版本，需持续关注潜在的兼容性问题。