Agenvoy
在自有环境中执行任务、生成工具，并把沙箱工具共享给多种 MCP 客户端。
- Star 数
- ★ 536
- 最近更新
- 3 天前
- License
- AGPL-3.0
- 主语言
- Go
- FA 评分
- 70/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 希望在本地控制数据的开发者，用自然语言搜索文件、整理资料并执行多步骤工作。
- 不适合
- 无法遵守 AGPL 网络服务源码公开要求且不购买商业许可的团队
- 需要原生 Windows 安装、不愿使用 WSL 的用户
- 不愿让本地代理执行命令或访问文件的组织
- 源码审查
- 70/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
Agenvoy 是台湾开发的自托管 AI Agent Harness，以单一 Go 二进制文件在用户电脑上运行。它整合模型路由、上下文、长期记忆、工具、定时任务、子代理和执行流程，可将对话转化为文件处理、实时研究、自动化及报告等实际成果。使用者可通过 TUI、内置 Web 控制台、Telegram 或 Discord 操作，并查看命令的实时输出。它同时充当 MCP 客户端和 MCP 服务器，既能连接外部 MCP 服务，也能向 Claude Code、Codex及其他兼容客户端提供同一套沙箱工具。文件与服务由本地守护进程掌控；敏感路径、主目录外访问及受限操作仍需确认。项目采用 AGPL-3.0 与商业许可双重授权，网络服务衍生版本需要注意源码公开及界面署名要求。
用户提交请求后，Agenvoy 会拆分步骤、选择模型或子代理、调用工具并汇总结果。它能搜索本地文件并回答问题、查询实时数据、通过 run_command 执行命令并把进度流式传送至 TUI 和 Web 控制台，也能用自然语言建立 cron 定时任务。若缺少合适工具，它会生成、沙箱测试、保存工具，并在执行失败后自动修复；这些工具随后可通过内置 MCP Server 供 Agenvoy、Claude Code、Codex及其他 MCP 客户端复用。其 MCP Client 使用官方 Go SDK，支持 stdio/HTTP MCP 服务器、实时工具刷新及 HTTP MCP OAuth，并将令牌保存在操作系统钥匙串。Web 界面还提供语音交互、唤醒词检测、可打断语音回复，以及会话、工具、日程和记忆管理；图像生成、STT 与 TTS 则依赖已配置的提供商。
- 希望在本地控制数据的开发者，用自然语言搜索文件、整理资料并执行多步骤工作。
- 需要每天自动生成股价、代码提交或运营报告的技术人员，以一句话建立定时任务并推送结果。
- 同时使用 Claude Code、Codex及其他 MCP 客户端的团队，共享同一套已测试的沙箱工具。
- 缺少现成集成时，希望代理自行生成、测试、保留并在失败后修复工具的用户。
- 需要从外部访问本地代理、但不想开放入站端口的用户，通过 Telegram 或 Discord连接。
- 需要按任务在多个模型层级间路由，并让子代理协作且保留执行日志的团队。
如何安装或部署这个 Agent？
macOS 或 Linux 可执行官方的一行安装命令：
curl -fsSL https://agenvoy.com/scripts/install.sh | bashWindows 需要先以管理员身份打开 PowerShell，查看并安装一个 WSL Linux 发行版：
wsl --online --list
wsl --install <distribution-name>重启电脑、打开 WSL 终端后，再执行同一个安装命令：
curl -fsSL https://agenvoy.com/scripts/install.sh | bash若要在 MacBook 上可靠运行日程，文档建议额外执行：
sudo pmset -c sleep 0安装后还需要选择并配置模型提供商。可使用订阅模型，也可创建 Ollama Cloud 免费 API 密钥，在 /model add 中选择 Ollama Cloud 并添加 gemma4:31b。材料未给出启动守护进程或首次启动所用的确切命令。
如何使用这个 Agent？
配置模型后启动本地守护进程；来源未提供对应的精确 CLI 命令。守护进程运行后，在浏览器打开 http://127.0.0.1:17989，即可管理会话、工具、日程和记忆。可以直接提出“找出去年所有发票”之类的文件查询，或要求代理汇总当天 GitHub 提交并生成进度报告。建立自动化时，可用自然语言描述任务，例如每天早上八点报告台积电股价；代理会继续询问推送位置、输出格式和运行时间。若需连接 Telegram 或 Discord，需要配置相应 bot token；本地守护进程会主动建立出站连接，无须开放入站端口。Claude Code、Codex或其他 MCP 客户端也可连接 Agenvoy 的 MCP Server 来调用共享工具，但来源没有提供可复制的客户端配置片段。
这个 Agent 有哪些优点和局限？
- 单一 Go 二进制同时提供本地守护进程、TUI、内置 Web 控制台以及 MCP 客户端和服务器能力。
- 可在缺少能力时生成、沙箱测试、保存并在失败后修复工具，而非只调用预装工具。
- Claude Code、Codex及其他 MCP 客户端可以复用同一套沙箱工具，减少重复实现。
- 敏感路径、主目录外访问和受限操作需要确认，命令输出还能实时显示在 TUI 与 Web 控制台。
- Telegram 和 Discord 采用由本地守护进程发起的出站连接，无须暴露主机端口。
- Windows 仅记录了通过 WSL 安装的路径，没有原生 Windows 安装说明。
- 实际效果和费用取决于所配置的模型、图像生成、STT、TTS及外部 MCP 服务；免费 Ollama Cloud 方案也有使用上限。
- AGPL-3.0 对网络可访问的衍生服务有源码公开要求，Web 界面的 License 与 Source 项也必须保留；无法满足时需商业许可。
- 来源给出安装脚本，却未给出守护进程首次启动命令或完整 MCP 客户端配置，部署前仍需查阅额外文档。
- Telegram 和 Discord 自 v0.34.4 起默认不再把语音输入自动回复为语音，需通过 STT/TTS 工具生成并发送音频文件。
这个 Agent 与同类方案有什么区别？
普通聊天系统主要返回答案；Agenvoy 的定位是把请求拆成步骤，在本机调用工具、处理文件、执行命令并交付结果。与各自在 Claude Code 或 Codex 中重复创建工具相比，它通过 MCP Server 提供共享的沙箱工具库，也能在缺少工具时自动生成新工具。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Agenvoy 当前 | 70 · 存在缺口 | 命令行工具免费 | ★ 536 | 3 天前 | Go | Codex · Claude Code |
| Echo Agent | 60 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.1k | 1 天前 | Python | — |
| Agent Swarm | 47 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 851 | 今天 | TypeScript | Codex · Claude Code |
| OpenAkita — 开源多Agent AI助手 | 45 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 2k | 9 天前 | Python | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 明确声称使用 bubblewrap 沙箱、限制敏感路径、访问主目录外位置前确认、流式展示命令输出，并将 MCP OAuth 令牌保存在系统钥匙串；这些证据足以支持一般程度的最小权限、用户确认、敏感数据处理和外部效果可见性，但缺少相应实现代码、完整权限矩阵、网络目的地清单及工具生成/计划任务的逐项批准规则，因此未给满分。检查点恢复只证明任务可续跑，不等同于撤销文件修改、工具安装或计划任务，故回滚较弱。依赖有明确版本，发布物附 SHA-256，但未见依赖审计、SBOM、漏洞扫描、签名或来源验证。作者、贡献者入口、许可证和提交归属较清楚，但给定发布者未经验证，且 README 中 agenvoy/Agenvoy 与 pardnchiu/agenvoy 命名并存，归属链并非完全清晰。
README、go.mod 与发布工作流共同描述了单一 Go 二进制、支持平台和版本化发布，整体一致；工作流还记录并防止版本注入符号失效，体现了针对已知发布故障的防护。依赖均固定版本，并为 Linux amd64/arm64 与 macOS arm64 使用原生构建，但大量第三方服务、模型和库的可用性及降级策略没有完整说明。可见的 CI 错误信息、实时命令输出和失败后自动修复有帮助，但缺少运行时代码和错误目录，无法确认所有失败是否可诊断。
目标用户、研究、文件处理、定时报告、团队共享工具及技术运维等场景描述具体且覆盖充分，因此受众与场景获满分。README 列出核心能力、平台支持、MCP、聊天渠道和部分限制，但没有完整说明不支持的操作、权限边界或各提供商约束。自然语言调度示例会追问推送位置、格式和时间，说明一定的触发精度；然而自动生成工具、自我修复及自动路由何时启动、如何避免误触并不明确。环境适配覆盖 macOS、Linux 和 WSL，并说明本地端口及 Mac 睡眠设置，但发布矩阵缺少 Windows 原生、Linux 发行版前提、bubblewrap 可用性和硬件要求。
README 的受众、能力、示例、安装、文档、许可证和作者结构清楚，外部文档导航完整，信息架构与示例质量较高。安装覆盖 macOS、Linux 和 WSL，但主要采用 curl 管道直接执行脚本，所给材料没有脚本内容、校验步骤、卸载/升级说明或完整先决条件。名称总体可识别，但 Agenvoy、agen、agenvoy/Agenvoy 与 pardnchiu/agenvoy 并存，略损稳定性。已披露聊天语音默认流程暂停、平台范围及睡眠注意事项，但没有集中列出更广泛的已知限制。AGPL-3.0 正文、双重许可说明及第 7(b) 附加要求明确，故许可证获满分。发布徽章、里程碑和自动生成发布说明提供更新路径，但没有完整变更日志样本或兼容性政策。作者和 issue 渠道明确，不过维护承诺、响应窗口和经验证的组织责任未给出。
产品输出面向实际交付，支持聊天、TUI、Web、文件、计划任务及共享工具，通常具有可用性；但材料多为说明和演示链接，缺少实际输出格式、质量标准和复杂任务样例，因此未满分。自动创建并跨 Agenvoy、Claude Code、Codex 和 MCP 客户端复用沙箱工具，相比普通聊天代理具有清晰的增量价值，证据描述具体。单一二进制、自托管和模型分层有助于控制成本，README 也提供订阅与免费选项；但未量化令牌、存储、维护、安全审查或外部服务成本，成本收益只能评为一般充分。
“Validated designs”将多项能力对应到具体日期、提交或版本，发布工作流也明确展示构建、版本注入校验、打包和校验和生成，因此声明追踪性很强。README 的单二进制、Go 模块和发布流程可由 go.mod 与工作流部分互证，许可证声明由 LICENSE 支持；然而多数运行时安全、工具生成、记忆、调度和自我修复能力在所给代码材料中没有第二来源佐证。事实、示例和营销性判断大体分区，但“其他团队采用类似方向即确认其解决真实问题”等表述属于推论且未清楚标注为推论，因此事实与推断分离未获满分。
- 不要把“本地运行”或“无需入站端口”理解为无数据外传：模型提供商、Telegram、Discord、MCP 服务、OAuth 和实时研究都可能产生出站数据流；启用前应逐项核对目的地、保留策略和密钥权限。
- 安装命令会将远程脚本直接传给 shell。应先下载并审阅脚本、核对发布归档的 SHA-256，并确认标签、源码修订与二进制版本一致；现有材料未提供签名或可验证构建证明。
- 自动生成、自我修复和共享工具会扩大可执行代码面。应将生成工具视为不受信代码，验证 bubblewrap 是否实际启用，并限制网络、文件、凭据和计划任务权限。
- 检查点和任务恢复不代表副作用可撤销。对文件改写、工具安装、市场扩展和定时任务应另行准备备份、审计记录与明确删除流程。
- AGPL-3.0 及 README 所述第 7(b) 附加要求可能影响修改版和网络服务部署；无法满足源码披露要求时需单独评估商业许可。