OpenCLI

环境要求

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

安装与启动步骤

1. 1检查 Node 版本

   OpenCLI 通过 npm 安装时要求 Node.js 不低于 20.18.1，先确认本机版本满足要求

   node --version

   复制

2. 2全局安装 OpenCLI

   使用 npm 全局安装 @jackwener/opencli，适合纯命令行、CI 或服务器场景；桌面用户也可改用 OpenCLIApp

   npm install -g @jackwener/opencli

   复制

3. 3安装浏览器扩展

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

4. 4手动加载扩展(可选)

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

5. 5验证环境

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

   opencli doctor

   复制

6. 6运行首个命令

   列出全部可用命令，再分别拉取 HackerNews 与 B 站热门内容各 5 条，确认适配器可正常工作

   opencli list
   opencli hackernews top --limit 5
   opencli bilibili hot --limit 5

   复制

7. 7安装 AI 技能

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

   npx skills add jackwener/opencli

   复制

关键配置

如何确认成功

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

常见问题

注意事项

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