OpenAgent 终端智能体
在终端中用本地、免费或自带密钥模型规划并执行任务。
- Star 数
- ★ 279
- 最近更新
- 8 天前
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 50/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 希望在终端中用自然语言分析本地 CSV 并生成图表的数据使用者。
- 不适合
- 需要图形化桌面或网页界面的用户
- 无法安装 Node.js 22+ 的环境
- 要求多提供商稳定版只来自默认分支的团队
- 维护状态
- 近 30 天有提交最近提交 2026-11-12最新版本 v4.1.4(2026-07-31)
- 源码审查
- 50/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
OpenAgent 是一个运行在 Windows、macOS 和 Linux 终端中的开源智能体,用户以自然语言描述任务,它负责规划、调用工具并交付结果。它以 npm CLI 形式发布,也可从源码构建;运行环境要求 Node.js 22+。模型层覆盖 Ollama、LM Studio 等本地运行时,以及 OpenAI、Anthropic、Gemini、Groq、DeepSeek、OpenRouter 等云端提供商,并通过 configs/models.toml 管理模型目录。它可以处理诸如读取 CSV、分析数据和绘图之类的工作,并提供模型选择、BYOK 密钥配置和网页搜索命令。扩展系统可安装 Slack marketplace 中的扩展,并识别 .claude-plugin/plugin.json、open-agent-extension.json 和 .mcp.json 清单。其部署边界是用户自己的终端与工作区;本地模型可以无密钥运行,云模型和部分搜索后端则需要网络及相应凭据。
用户通过 openagent 或 npm start 提交自然语言任务。OpenAgent 随后规划任务、使用工具,并在终端中返回结果;README 给出的示例会读取 sales.csv、分析客户数据并绘制前十名客户。模型可通过 -m, --model 或 --provider 选择,--free 会使用免费或低价模型目录并自动回退,--models 输出提供商模型清单。--byok 和会话内的 /byok [provider key] 将云端凭据写入 .env,而 /models 用于切换或检查模型。google_web_search 会根据现有密钥选择搜索后端;无密钥时按 Exa 托管 MCP、DuckDuckGo 的顺序回退,也能配置 Brave、Tavily、Serper 或 Gemini。扩展安装命令读取 Claude 风格清单、OpenAgent 清单或 .mcp.json,并可从相邻 .mcp.json 获取 MCP 服务器声明。
- 希望在终端中用自然语言分析本地 CSV 并生成图表的数据使用者。
- 已有 Ollama 或 LM Studio、希望不配置云端密钥运行智能体的开发者。
- 需要在 OpenAI、Anthropic、Gemini、Groq、DeepSeek 或 OpenRouter 等提供商之间切换的团队。
- 希望优先轮换免费或低价模型,并在模型不可用时自动回退的个人用户。
- 需要让终端智能体执行网页检索,并按模型或密钥情况选择搜索后端的研究者。
- 希望通过 Claude 风格清单、OpenAgent 清单或 MCP 配置扩展终端工作流的高级用户。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install -g @haseeb_heaven/open-agentnpm install && npm run build
- 环境变量
OPENAI_API_KEYANTHROPIC_API_KEYGEMINI_API_KEYOPENROUTER_API_KEY- 配置文件
.env.example.env- 运行环境
- Node.js 22+
如何安装或部署这个 Agent?
需要 Node.js 22+。最短安装路径是从 npm 全局安装:
npm install -g @haseeb_heaven/open-agent
openagent本地 Ollama 和 LM Studio 不需要 API 密钥。使用云端模型时,可复制 .env.example 为 .env 并设置对应变量,例如 OPENAI_API_KEY、ANTHROPIC_API_KEY、GEMINI_API_KEY 或 OPENROUTER_API_KEY;也可在程序中使用 BYOK 配置。
如需从源码使用 README 所称的最新多提供商版本,应检出 feature 分支:
git clone --branch feature https://github.com/haseeb-heaven/open-agent.git
cd open-agent
npm install && npm run build
npm start如何使用这个 Agent?
使用本地优先模式启动;如果 Ollama 正在运行,程序会优先使用它:
npm start使用免费或低价模型目录分析 CSV,并允许自动回退:
npm start -- --free "analyze this CSV"列出模型或交互式配置密钥:
npm start -- --models
npm start -- --byok也可以明确选择模型或提供商:
npm start -- -m openrouter-free
npm start -- -m ollama/llama3.1:8b
npm start -- --provider groq -m llama-3.1-8b-instant一个完整的源码示例是:
npm install && npm run build
npm start -- --free "analyze sales.csv and plot top 10 customers"会话中可使用 /models、/byok [provider key] 和 /websearch。自动批准工具只应在可信工作区使用:
npm start -- -y这个 Agent 有哪些优点和局限?
- 同时支持 Ollama、LM Studio、本地无密钥运行以及多个云端提供商,模型迁移空间较大。
--free提供免费或低价模型轮换与自动回退,不要求用户先注册项目账户。- 网页搜索具备 Exa 到 DuckDuckGo 的无密钥回退链,并支持 Brave、Tavily、Serper 和 Gemini。
- 扩展系统兼容 Claude 风格清单、OpenAgent 清单和
.mcp.json,可读取 MCP 服务器声明。 - 明确支持 Windows、macOS 和 Linux,并提供 npm 全局安装路径。
- 要求 Node.js 22+,无法直接用于较旧的 Node.js 环境。
- README 指明最新多提供商工作位于
feature分支,采用者需要评估非默认分支带来的稳定性和升级风险。 - Ollama 与 LM Studio 需要用户另行运行本地模型服务;云端模型则需要分别配置提供商密钥。
- 未提供作为可导入库、桌面应用或自托管 Web 服务运行的文档,主要交互边界是终端。
--yolo和扩展 Auto 模式会自动批准工具或工作区信任,仅适合可信工作区。
这个 Agent 与同类方案有什么区别?
OpenAgent 基于 Google 的 Gemini CLI,并由 Haseeb Mir 以 open-agent 分支形式修改。与其上游归属所暗示的单一 Gemini 入口相比,本仓库明确记录了 Ollama、LM Studio、OpenAI、Anthropic、Gemini、Groq、DeepSeek、OpenRouter 等多提供商路径;但来源没有给出功能或性能基准。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| OpenAgent 终端智能体 当前 | 50 · 缺口较多 | 命令行工具免费 | ★ 279 | 8 天前 | TypeScript | OpenAI API · Claude API |
| Mysti AI 编程团队 | 81 · 表现良好 | IDE 插件免费 + 模型费 | ★ 1.2k | 11 天前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| AgenC Core | 76 · 表现良好 | 命令行工具免费 + 模型费 | ★ 144 | 1 天前 | TypeScript | — |
| Codewhale 终端编码助手 | 79 · 表现良好 | 命令行工具免费 + 模型费 | ★ 41k | 今天 | Rust | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
文档说明默认审批会提示、Plan 模式只读,并将 YOLO 标为包括危险操作的全自动批准;沙箱扩展也有逐次审批,体现了部分权限控制。扣分原因:CLI 同时提供 --yolo、扩展自动批准和可写工作区能力,给出的代码样本没有证明所有高影响工具均受同一限制;文档仅概述云端密钥和搜索后端配置,没有完整说明提示词、文件内容及遥测的传输和保留路径,也未见密钥保护实现、外部操作审计或明确回滚保障。
入口代码对启动失败、清理超时和 API 错误提供可读错误处理,依赖及 Node.js 版本要求也有说明。扣分原因:README、包信息和文档仍混有 Gemini CLI、open-agent 与 OpenAgent 名称,且 README 推荐的全局包名与包元数据不一致;所给材料没有建立所有提供商、可选依赖或回退路径的可用性保证。
README 和安装文档面向终端用户及贡献者,涵盖本地模型、云端 BYOK、多个操作系统和交互/无头用法。扣分原因:虽然列出模型、搜索后端和审批选项,材料没有明确界定 agent 对文件、网络、shell 和扩展的完整能力边界;样本技能的触发说明彼此局部,且存在要求调用特定子代理的描述,不能证明产品整体触发规则一致。
仓库提供文档索引、安装与快速入门、配置、错误参考、示例命令及 Apache-2.0 许可证。扣分原因:sandbox 文档出现多个历史产品名和 npm 包名,卸载说明还提及其他分发方式;给定材料没有提供可确认维护责任人的完整信息或足够的版本发布/变更记录,局限性也只在少数章节中说明。
产品定位为在终端中用自然语言规划、调用工具并支持本地或云模型,README 提供 CSV 分析等具体任务示例,输出格式支持 text 和 JSON。扣分原因:这些材料说明了预期效用,但没有给出任务质量、成功率、成本或资源消耗的可复核证据;本地模型虽可离线使用,舒适配置仍要求较多内存。
README 的安装、模型、密钥和测试命令有相应文档、包配置及入口代码可供追溯,测试脚本也公开列出。扣分原因:测试命令和测试样例只能证明仓库包含测试材料,不能证明其实际通过;不同文件的产品名、安装包名及继承关系存在不一致,所给源代码对 README 中若干主要安全和产品能力主张缺少直接交叉佐证,推断与已验证事实的边界也未始终标明。
- 涉及 shell、文件修改、扩展安装或云端模型时,请先核对当前审批模式与沙箱配置;--yolo 和扩展自动批准会降低交互确认。
- 文档中的产品名和包名并不完全一致;安装或卸载前应依据所选发行渠道核对命令。
- 本评估仅基于提供的静态材料,未执行程序、测试或依赖安全检查。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v4.1.4 OpenAgent v4.1.4 — Bundle version metadata fix
发布说明摘录
OpenAgent v4.1.4 This patch release fixes stale CLI version metadata in the published bundle. Fixed - Rebuilt core generated version metadata before bundling. - Rebuilt the npm bundle from a clean output directory. - Verified that the bundled executable and telemetry metadata report 4.1.4. Installation ```bash npm install -g @haseeb_heaven/[email protected] ```在 GitHub 查看 ↗ -
v4.1.3 OpenAgent v4.1.3 — Fast provider failover
发布说明摘录
OpenAgent v4.1.3 This release improves response latency for explicit model selections and makes free-provider failover bounded and observable. Performance - Explicit Gemini model selections bypass the auto-model classifier on fresh turns, while model changes during an active sequence retain re-routing. - OPENAGENT_CLI_FAST_MODE=1 caps compatible-provider completions at 1024 tokens, skips the optional next-speaker follow-up, bounds provider requests to 3 seconds, and limits fast failover to one alternate candidate. …在 GitHub 查看 ↗ -
v4.1.1 v4.1.1 — Free-model picker, extensions market & post-release fixes
发布说明摘录
Ships the develop-branch feature set previously (mis-)tagged as an unreleased v4.1.0, renumbered to avoid colliding with main's already-released v4.1.0 (provider crash / test-isolation fixes — see that release). Features (from the develop v4.1.0 feature set) - feat(cli): /free-models interactive picker for free-tier models, plus /free shortcut - feat(cli): /extensions market — browse and install extensions from the registry Bugfixes (this release) …在 GitHub 查看 ↗
常见问题
必须购买模型 API 才能使用吗?
--free 模型目录及无密钥搜索回退。选择付费云端模型时,费用和凭据由对应提供商决定。它会访问哪些本地资源?
sales.csv、分析并绘图。扩展安装和 .env 密钥保存也涉及本地文件系统。网页搜索没有 API 密钥还能工作吗?
支持哪些操作系统和运行时?
自动批准模式有什么风险?
-y, --yolo 会自动批准工具,扩展的 Auto 模式也会自动同意工作区信任。文档将这些模式限定为可信工作区使用。OpenAgent 终端智能体 免费吗?
OpenAgent 终端智能体 开源吗?
OpenAgent 终端智能体 安全吗?
OpenAgent 终端智能体 还在维护吗?
OpenAgent 终端智能体 是谁开发的?
谢谢反馈,我们会据此改进页面。