OpenCLI

不会记命令也没关系，说人话电脑就照做

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 3036 🐛 待处理 293 👀 关注 62

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 30950

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队jackwener

官网地址https://opencli.info

GitHubhttps://github.com/jackwener/OpenCLI

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议Apache-2.0

主要语言JavaScript

技术栈/模型ai-agent,ai-agents,ai-tools,browser-automation,browser-use,cli,playwright

GitHub 星标★ 30950

上线时间2026-03-14 00:00:00

代码更新2026-11-07

仓库体积17.5 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

把任意网站变成 CLI 的强大工具，让 AI 智能体可以直接使用你已登录的浏览器会话，无需重复登录与复杂配置，在命令行中即可操控网页、调用网站能力。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 30950

技术标签

ai-agent ai-agents ai-tools browser-automation browser-use

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Node.js >= 20.18.1（通过 npm 安装时必需）
npm（随 Node.js 一起安装）
Chrome / Chromium 浏览器（用于安装 Browser Bridge 扩展）
桌面端可选用 OpenCLIApp（macOS / Windows）

安装与启动步骤

1检查 Node 版本

OpenCLI 通过 npm 安装时要求 Node.js 不低于 20.18.1，先确认本机版本满足要求
```
node --version
```
2全局安装 OpenCLI

使用 npm 全局安装 @jackwener/opencli，适合纯命令行、CI 或服务器场景；桌面用户也可改用 OpenCLIApp
```
npm install -g @jackwener/opencli
```
3安装浏览器扩展

OpenCLI 通过 Browser Bridge 扩展加本地守护进程连接 Chrome，守护进程会按需自动启动。推荐从 Chrome 应用商店安装 OpenCLI 扩展
4手动加载扩展(可选)

若无法访问商店：从 GitHub Releases 下载最新的 opencli-extension-v{version}.zip，解压后在 chrome://extensions 开启开发者模式，点击“加载已解压的扩展程序”选择该文件夹
5验证环境

运行 doctor 命令自检环境、运行时与浏览器桥接是否正常，出现问题可据此排查
```
opencli doctor
```
6运行首个命令

列出全部可用命令，再分别拉取 HackerNews 与 B 站热门内容各 5 条，确认适配器可正常工作
```
opencli list
opencli hackernews top --limit 5
opencli bilibili hot --limit 5
```
7安装 AI 技能

可选：为 Claude Code、Cursor 等智能体安装 opencli 技能，会自动刷新已安装版本；也可用 --skill 只装需要的单个技能
```
npx skills add jackwener/opencli
```

关键配置

配置项	必填	说明	示例
`OPENCLI_PROFILE`	否	连接了多个 Chrome 配置文件时，指定要使用的 Browser Bridge profile 别名或 contextId	`default`
`OPENCLI_WINDOW`	否	覆盖浏览器窗口位置，取值为 foreground 或 background；命令行也支持 --window 参数	`background`
`OPENCLI_SITE_SESSION`	否	覆盖适配器的 siteSession 元数据，ephemeral 执行完即关闭一次性窗口，persistent 复用站点会话	`ephemeral`
`OPENCLI_BROWSER_CONNECT_TIMEOUT`	否	等待浏览器连接的超时秒数，默认 45	`45`
`OPENCLI_BROWSER_COMMAND_TIMEOUT`	否	等待单条浏览器命令执行完成的超时秒数，默认 60	`60`
`OPENCLI_CDP_ENDPOINT`	否	远程浏览器或 Electron 应用使用的 Chrome DevTools Protocol 端点	`http://localhost:9222`

如何确认成功

执行 opencli doctor 自检无报错，再运行 opencli list 能列出命令、opencli hackernews top --limit 5 能返回结果，即表示安装与环境配置成功。

常见问题

Q：npm 全局安装失败或提示版本不支持怎么办？

A：确认 node --version 不低于 20.18.1，升级 Node.js 后重试；macOS / Windows 桌面用户也可直接下载 OpenCLIApp，它自带运行时并托管 opencli 命令。

Q：提示连接不上浏览器怎么办？

A：确认已安装并启用 Browser Bridge 扩展，守护进程会在需要时自动启动；必要时调大 OPENCLI_BROWSER_CONNECT_TIMEOUT（默认 45 秒）后重试 opencli doctor。

Q：多个 Chrome 配置文件时如何指定？

A：设置环境变量 OPENCLI_PROFILE 为对应的 profile 别名或 contextId，即可让命令使用指定配置文件的登录会话。

Q：如何只为某个智能体安装单个技能？

A：使用 npx skills add jackwener/opencli --skill <技能名>，例如 --skill opencli-browser 或 --skill opencli-adapter-author。

Q：opencli browser 命令为何需要会话名？

A：opencli browser * 必须显式传入 <session> 位置参数，默认使用前台窗口并保持该会话标签占用，直到执行 close 或空闲清理。

注意事项

务必先安装 Chrome 扩展并确认浏览器桥接可用，否则依赖浏览器会话的命令无法执行。
npm 安装方式有 Node.js 版本下限（>= 20.18.1），版本过低会导致安装或运行失败。
浏览器类适配器默认使用后台适配器窗口并释放一次性标签；需要连续操作时可声明 siteSession: 'persistent' 或传 --site-session ephemeral。
仅修改环境变量时注意其默认值，例如 OPENCLI_VERBOSE 默认 false，需要详细日志可加 -v 参数。