OpenAgent 终端智能体

在终端中用本地、免费或自带密钥模型规划并执行任务。

Star 数
★ 279
最近更新
8 天前
License
Apache-2.0
主语言
TypeScript

30 秒速览

运行形态
命令行工具
可在哪里用
通用 · 跨平台OpenAI API · Claude API
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
Node.js 22+Shell / 命令行网络访问本地文件系统MCP Server
典型场景
希望在终端中用自然语言分析本地 CSV 并生成图表的数据使用者。
不适合
  • 需要图形化桌面或网页界面的用户
  • 无法安装 Node.js 22+ 的环境
  • 要求多提供商稳定版只来自默认分支的团队
维护状态
近 30 天有提交最近提交 2026-11-12最新版本 v4.1.4(2026-07-31)

这个 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 服务器声明。

  1. 希望在终端中用自然语言分析本地 CSV 并生成图表的数据使用者。
  2. 已有 Ollama 或 LM Studio、希望不配置云端密钥运行智能体的开发者。
  3. 需要在 OpenAI、Anthropic、Gemini、Groq、DeepSeek 或 OpenRouter 等提供商之间切换的团队。
  4. 希望优先轮换免费或低价模型,并在模型不可用时自动回退的个人用户。
  5. 需要让终端智能体执行网页检索,并按模型或密钥情况选择搜索后端的研究者。
  6. 希望通过 Claude 风格清单、OpenAgent 清单或 MCP 配置扩展终端工作流的高级用户。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npm install -g @haseeb_heaven/open-agent
  • npm install && npm run build
环境变量
OPENAI_API_KEY ANTHROPIC_API_KEY GEMINI_API_KEY OPENROUTER_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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
50/ 100 五分制 2.5 / 5
信任安全 12/29
可靠稳定 8/14
适用触发 9/18
规范维护 10/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全12 / 29 · 2.1/5

文档说明默认审批会提示、Plan 模式只读,并将 YOLO 标为包括危险操作的全自动批准;沙箱扩展也有逐次审批,体现了部分权限控制。扣分原因:CLI 同时提供 --yolo、扩展自动批准和可写工作区能力,给出的代码样本没有证明所有高影响工具均受同一限制;文档仅概述云端密钥和搜索后端配置,没有完整说明提示词、文件内容及遥测的传输和保留路径,也未见密钥保护实现、外部操作审计或明确回滚保障。

可靠稳定8 / 14 · 2.9/5

入口代码对启动失败、清理超时和 API 错误提供可读错误处理,依赖及 Node.js 版本要求也有说明。扣分原因:README、包信息和文档仍混有 Gemini CLI、open-agent 与 OpenAgent 名称,且 README 推荐的全局包名与包元数据不一致;所给材料没有建立所有提供商、可选依赖或回退路径的可用性保证。

适用触发9 / 18 · 2.5/5

README 和安装文档面向终端用户及贡献者,涵盖本地模型、云端 BYOK、多个操作系统和交互/无头用法。扣分原因:虽然列出模型、搜索后端和审批选项,材料没有明确界定 agent 对文件、网络、shell 和扩展的完整能力边界;样本技能的触发说明彼此局部,且存在要求调用特定子代理的描述,不能证明产品整体触发规则一致。

规范维护10 / 18 · 2.8/5

仓库提供文档索引、安装与快速入门、配置、错误参考、示例命令及 Apache-2.0 许可证。扣分原因:sandbox 文档出现多个历史产品名和 npm 包名,卸载说明还提及其他分发方式;给定材料没有提供可确认维护责任人的完整信息或足够的版本发布/变更记录,局限性也只在少数章节中说明。

有效结果7 / 13 · 2.7/5

产品定位为在终端中用自然语言规划、调用工具并支持本地或云模型,README 提供 CSV 分析等具体任务示例,输出格式支持 text 和 JSON。扣分原因:这些材料说明了预期效用,但没有给出任务质量、成功率、成本或资源消耗的可复核证据;本地模型虽可离线使用,舒适配置仍要求较多内存。

证据核验4 / 8 · 2.5/5

README 的安装、模型、密钥和测试命令有相应文档、包配置及入口代码可供追溯,测试脚本也公开列出。扣分原因:测试命令和测试样例只能证明仓库包含测试材料,不能证明其实际通过;不同文件的产品名、安装包名及继承关系存在不一致,所给源代码对 README 中若干主要安全和产品能力主张缺少直接交叉佐证,推断与已验证事实的边界也未始终标明。

风险与缓解建议
  • 涉及 shell、文件修改、扩展安装或云端模型时,请先核对当前审批模式与沙箱配置;--yolo 和扩展自动批准会降低交互确认。
  • 文档中的产品名和包名并不完全一致;安装或卸载前应依据所选发行渠道核对命令。
  • 本评估仅基于提供的静态材料,未执行程序、测试或依赖安全检查。
证据充分度:低 评估于 2026年11月8日 审查版本 9780412432f6 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/open-agent.svg?lang=zh)](https://followagents.com/zh/agents/open-agent)
<a href="https://followagents.com/zh/agents/open-agent"><img src="https://followagents.com/badge/open-agent.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 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 查看 ↗
  2. 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 查看 ↗
  3. 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 才能使用吗?
不必。Ollama 和 LM Studio 本地运行不需要密钥,项目也提供 --free 模型目录及无密钥搜索回退。选择付费云端模型时,费用和凭据由对应提供商决定。
它会访问哪些本地资源?
它在终端和当前工作区中使用工具;示例明确展示了读取 sales.csv、分析并绘图。扩展安装和 .env 密钥保存也涉及本地文件系统。
网页搜索没有 API 密钥还能工作吗?
可以。记录的无密钥回退顺序是 Exa 托管 MCP,然后是 DuckDuckGo;其他后端可通过各自环境变量启用。
支持哪些操作系统和运行时?
README 明确列出 Windows、macOS 和 Linux,并要求 Node.js 22+。
自动批准模式有什么风险?
-y, --yolo 会自动批准工具,扩展的 Auto 模式也会自动同意工作区信任。文档将这些模式限定为可信工作区使用。
OpenAgent 终端智能体 免费吗?
免费。OpenAgent 终端智能体 可以免费使用,不需要付费服务。
OpenAgent 终端智能体 开源吗?
开源。源码在 GitHub(haseeb-heaven/open-agent),许可证是 Apache-2.0。
OpenAgent 终端智能体 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 OpenAgent 终端智能体 的“信任与安全”打了 12/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
OpenAgent 终端智能体 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-12,在最近 30 天内。最新版本是 v4.1.4(2026-07-31)。
OpenAgent 终端智能体 是谁开发的?
OpenAgent 终端智能体 由 GitHub 账号 haseeb-heaven 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念