Agenvoy
在自有环境中执行任务、生成工具,并把沙箱工具共享给多种 MCP 客户端。
- Star 数
- ★ 624
- 最近更新
- 1 天前
- License
- AGPL-3.0
- 主语言
- Go
- FA 评分
- 52/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 希望在本地控制数据的开发者,用自然语言搜索文件、整理资料并执行多步骤工作。
- 不适合
- 无法遵守 AGPL 网络服务源码公开要求且不购买商业许可的团队
- 需要原生 Windows 安装、不愿使用 WSL 的用户
- 不愿让本地代理执行命令或访问文件的组织
- 官网
- agenvoy.com ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-19最新版本 v1.3.19(2026-11-19)近 7 天每天 +3.6 ★
- 源码审查
- 52/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连接。
- 需要按任务在多个模型层级间路由,并让子代理协作且保留执行日志的团队。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
curl -fsSL https://agenvoy.com/scripts/install.sh | bash
- 安装说明涉及
- Windows · macOS · Linux · WSL
如何安装或部署这个 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 当前 | 52 · 缺口较多 | 命令行工具免费 | ★ 624 | 1 天前 | Go | Codex · Claude Code |
| Echo Agent | 64 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1k | 1 天前 | Python | — |
| Agent Swarm | 62 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 1.1k | 今天 | TypeScript | Codex · Claude Code |
| OpenAkita — 开源多Agent AI助手 | 50 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 2k | 1 个月前 | Python | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
程式入口顯示 TUI、daemon 與 MCP server,README 也描述本機運作、沙箱、敏感路徑確認及外部通訊;但本次程式摘錄沒有呈現這些邊界的實作細節,因此最小權限、資料流與敏感資料保護僅部分可核實。排程 Skill 使用 always-allow subagent,安裝 Skill 會清理 staging 並允許 sudo 安裝依賴;雖有套件選擇、雜湊比對與碰撞選項,仍不足以證明所有外部效果都有確認或復原機制。README 標示作者及議題入口,故來源歸屬較清楚。
README、Go 入口、模組清單與發佈工作流程支持產品大致一致的描述,但 README 的功能與安全聲稱多數未在摘錄程式碼中交叉印證,且 README 自稱處於檢視與清理期。Go 模組版本固定,發佈流程有建置及版本符號檢查;此摘錄未顯示依賴漏洞審核或替代來源策略。安裝 Skill 對下載、解壓、manifest 與缺檔情況提供明確中止訊息,入口也回報部分錯誤,故失敗訊息表現較佳。
README 指出個人、開發者、團隊及技術營運者等使用情境,也列出本機、Web、TUI、訊息平台及 MCP 用法。Skill 文件明確限定 Agenvoy 工具、路徑及執行入口,排程 Skill 列出觸發與排除條件,對適用範圍有實用界定;但環境需求與各整合能力的實際邊界仍主要依賴文件聲稱,沒有足夠程式摘錄完整核實。
README 提供功能、文件索引、安裝指引、範例、限制說明與雙語入口;LICENSE 明確提供 AGPL-3.0,另說明商業授權選項,故授權資訊完整。Go 入口和模組名稱清楚,但版本資訊主要由標籤與發佈流程呈現;摘錄沒有一般變更紀錄,README 的最佳化進度連結不能替代完整版本紀錄。作者與 issue 入口提供維護聯絡線索,但維護責任及回應承諾有限。
README 描述自動建工具、排程、檔案搜尋、多代理、MCP、語音與儀表板,並提供多個操作示例,顯示可能帶來可重用的工作自動化價值。輸出與進度可透過 TUI、Web 及聊天呈現是文件中的明確主張;本次程式摘錄只支持部分日誌呈現能力。安裝方式簡短,但長期 daemon、模型服務、外部平台、依賴安裝及排程的成本與資源需求沒有充分量化,因此成本效益僅部分可判斷。
README 將若干功能連到文件、示例、提交或發佈資訊;release workflow 也具體列出平台建置、版本符號檢查及產物雜湊流程。可是多項安全、沙箱及功能主張沒有與所附核心程式碼互相印證,所列其他團隊採用相似設計的說法也不構成本次樣本內的驗證。README 的描述與實作證據未總是清楚區分,故只給部分分數。
- README 宣稱敏感路徑確認、沙箱、OAuth token 保存及本機資料保護,但所附程式摘錄不足以核實其實作;使用前應逐項檢視權限與資料流。
- 安裝指引使用 curl | bash;擴充套件安裝流程還可能解壓套件、安裝系統依賴並使用 sudo。確認來源、內容及操作影響後再執行。
- 排程 Skill 說排程工作以 always-allow 執行。請確認排程任務的工具權限、外部效果及停止或復原方式符合預期。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
> v1.3.18 -> v1.3.19 Summary This hotfix extends manual human verification to page downloads with a session-scoped cache so users are not re-prompted across requests. It also skips interactive prompts in headless Linux environments and delegates shared browser checks upstream. <details> <summary>翻譯</summary> 此 hotfix 將手動真人驗證擴展至頁面下載並加入會話級快取,避免使用者在同一請求脈絡下重複受詢。同時在無圖形介面的 Linux 環境略過互動視窗提示,並將共用的瀏覽器檢查委派至上游套件。 </details> Changes FEAT - Add manual human verification to download_file (render: true) (@pardnchiu) [46189974] …在 GitHub 查看 ↗ -
发布说明摘录
> v1.3.17 -> v1.3.18 Summary Adds a human-assisted step for pages that block automated access: a challenge cannot be avoided, but the content is still needed, so Agenvoy asks the user to complete the check in a browser window. Interactive prompts across every interface now follow the configured reply language, since a prompt exists to be understood by the person answering it. <details> <summary>翻譯</summary> 新增真人協助步驟:網站的真人驗證避不開,但資訊仍需完整取得,因此改為請使用者在瀏覽器視窗完成驗證。各介面的互動提示改依設定的回覆語言顯示,因為提示的重點是讓回答的人看得懂。 </details> Changes FEAT …在 GitHub 查看 ↗ -
发布说明摘录
> v1.3.16 -> v1.3.17 Summary fetch_page now caches the original page and filters it against each task with the decision model at delivery, instead of cutting every page at 100 KiB; unrelated pages are withheld, long pages keep only related blocks, and pages over 1 MiB are checked within their first 1 MiB. calculate is rebuilt for exact and correctly ordered arithmetic, and the internal tool packages are reorganized around registration. <details> <summary>翻譯</summary> …在 GitHub 查看 ↗
常见问题
Agenvoy 可以免费使用吗?
它会把本地文件上传到托管服务吗?
代理能够执行哪些高风险操作?
能否与 Claude Code 和 Codex 共用工具?
部署网络服务时需要注意什么许可条件?
Agenvoy 官网是什么?
Agenvoy 安全吗?
Agenvoy 还在维护吗?
Agenvoy 是谁开发的?
谢谢反馈,我们会据此改进页面。