OpenAgent 终端智能体
在终端中用本地、免费或自带密钥模型规划并执行任务。
- Star 数
- ★ 280
- 最近更新
- 6 天前
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 67/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 希望在终端中用自然语言分析本地 CSV 并生成图表的数据使用者。
- 不适合
- 需要图形化桌面或网页界面的用户
- 无法安装 Node.js 22+ 的环境
- 要求多提供商稳定版只来自默认分支的团队
- 源码审查
- 67/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 配置扩展终端工作流的高级用户。
如何安装或部署这个 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 终端智能体 当前 | 67 · 存在缺口 | 命令行工具免费 | ★ 280 | 6 天前 | TypeScript | OpenAI API · Claude API |
| Mysti AI 编程团队 | 58 · 缺口较多 | IDE 插件免费 + 模型费 | ★ 1.1k | 2 天前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| Aura IDE | 77 · 表现良好 | 桌面应用免费 + 模型费 | ★ 56 | 14 天前 | Python | OpenAI API · Claude API |
| Aivo | 57 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 194 | 今天 | Rust | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 明确区分本地与云端模型、列出密钥变量、说明工具及扩展安装的批准模式，并警告仅在受信任工作区使用 YOLO/Auto；工作流权限也较窄且第三方 Actions 固定到提交。扣分在于没有展示工具级权限隔离、发送给各模型和搜索服务的具体数据范围、密钥存储保护措施、依赖漏洞扫描政策或通用任务回滚机制。上游 Gemini CLI、Google LLC、修改者和 Apache-2.0 均有明确归属，因此来源署名满分。
README、package.json、工作流和测试共同显示明确的 Node 版本、构建测试命令、多提供商及搜索回退，并有针对缺失目录和静态分析失败的可读诊断。扣分在于未提供实际执行结果，部分测试允许缺少密钥或配额时跳过，外部模型、托管 MCP、搜索服务和 npm 均可能不可用；此外 OpenAgent 名称与仍输出 gemini 文件名等遗留内容存在一致性瑕疵。
终端用户、CSV 分析、本地模型、免费模型、BYOK、云端提供商、交互及非交互场景均被清楚覆盖，且 Windows、macOS、Linux 与多种本地运行方式有明确说明，因此受众场景和环境适配证据充分。扣分在于能力边界主要靠命令和简短警告表达，未完整说明文件、Shell、网络和扩展能力的限制；触发方式虽有精确 CLI 标志与斜杠命令，但未展示冲突处理或完整优先级规则。
README 的安装、快速开始、模型、搜索、扩展、文档、测试、归属和许可证结构清晰，npm 与源码安装步骤具体，完整 Apache-2.0 文本也存在。扣分在于缺少可见 FAQ 和集中式已知限制说明；版本号存在但未提供变更日志或发布迁移记录；OpenAgent、Gemini 遗留二进制名及 Google 安全入口并存，使命名和维护责任不够稳定，且发布者身份仍未知。
示例展示从自然语言任务到终端调用的直接工作流，多提供商、模型目录、搜索回退和扩展机制相较单一聊天接口具有实际增量价值；本地、免费和 BYOK 选项也提供成本选择。扣分在于材料未展示真实产出样例、质量结果、延迟、资源需求或费用比较，测试源码只能证明测试结构存在，不能静态证明任务效果。
主要声明可追溯到具体配置、命令、注册表、文档入口和测试代码；包名、版本、Node 要求、脚本及平台构建在多个文件间得到一定交叉印证。扣分在于没有执行日志、发布物校验或独立来源，营销性的“free”“no vendor lock-in”等表述缺少限定数据，源码中的测试政策名称也不能当作通过结果。整体仍能区分可见事实与未验证运行表现，但不够彻底。
- 静态材料未说明发送到云端模型、托管 Exa MCP 或其他搜索后端的提示、文件内容和元数据边界；处理敏感仓库前应单独核实。
- 不要在不受信任的工作区启用 --yolo 或 --auto；这些模式会绕过工具或扩展信任确认。
- BYOK 可将密钥写入 .env，但给定材料未说明文件权限、加密、脱敏日志、轮换或泄漏恢复措施。
- SECURITY.md 指向 Google 的漏洞入口，而发布者是未验证的个人分叉；提交安全报告前应确认该入口确实负责此分叉。
- 构建产物仍使用 gemini 名称，且源码安装推荐 feature 分支；应核对实际发布包、分支和所审修订是否对应。
常见问题
必须购买模型 API 才能使用吗？
--free 模型目录及无密钥搜索回退。选择付费云端模型时，费用和凭据由对应提供商决定。它会访问哪些本地资源？
sales.csv、分析并绘图。扩展安装和 .env 密钥保存也涉及本地文件系统。网页搜索没有 API 密钥还能工作吗？
支持哪些操作系统和运行时？
自动批准模式有什么风险？
-y, --yolo 会自动批准工具，扩展的 Auto 模式也会自动同意工作区信任。文档将这些模式限定为可信工作区使用。