零订阅体验Agenvoy:Ollama Cloud与本地模型接入的省钱完整教程

原创2026-11-01 16:14:001,418 阅读

零订阅体验Agenvoy:Ollama Cloud与本地模型接入的省钱完整教程

Agenvoy 是一款用 Go 编写的本地 AI Agent,支持 7×24 小时自托管运行。本文带你用 零订阅、免费额度 的方式跑通它:一条命令安装,通过 Ollama Cloud 免费 API key 或 本地 Ollama 接入大模型,全程不花一分钱 💰

Agenvoy本地AI Agent项目封面

为什么能"零订阅":Agenvoy 的多模型路由架构

和"一个程序绑一个模型"不同,Agenvoy 把模型接入和Agent 执行解耦了。它内建 13 个模型供应商(含 Ollama Cloud),并支持 compat 通道连接任意 OpenAI 兼容端点(本机 Ollama、LM Studio、自建网关等),详见技术文档 doc/doc.zh.md。

Agenvoy多供应商LLM路由与本地模型接入架构图

这套架构带来两个省钱关键能力:

能力 说明 省钱意义
多供应商并存 Ollama Cloud、本地 Ollama、Copilot、OpenAI 等可同时注册 免费模型当"日常主力",不够用时再切
顺序回退 + 分级路由 首选模型失败时按注册顺序自动切换;model_tag 可为每个模型设 S/A/B/C 等级,dispatcher 按任务类型选档 简单任务自动落到低成本模型,好钢用在刀刃上

也就是说:Ollama Cloud 免费额度 + 本地模型 就足以支撑日常使用,订阅版模型完全可以不碰。

第一步:一行命令安装 Agenvoy

macOS / Linux 打开终端执行:

curl -fsSL https://agenvoy.com/scripts/install.sh | bash
agen

Windows 用户先装 WSL(wsl --install <发行版名>),在 WSL 终端内执行上面同样两条命令。

如果想从源码构建(可体验 gitcode 镜像克隆):

git clone https://gitcode.com/gh_mirrors/ag/Agenvoy
cd Agenvoy
make build
agen

💡 安装后浏览器打开 http://127.0.0.1:17989 就是自带的 Web 控制台,全程由本机提供服务,数据不出设备。

第二步:免费接入 Ollama Cloud(3 步拿免费 API key)

这是官方推荐的"想免费尝鲜"方案,README.md 的 Developer Recommendations 一节明确列出了这条路线:

  1. 拿 key:登录 Ollama 官网,进入 Settings → Keys 页面创建一个 API key(免费方案带有额度上限,够日常尝鲜);
  2. 填 key:在 TUI 中输入 /model add,切换到 API Key 标签页,选中 Ollama Cloud,粘贴你的 key。key 会写入操作系统 keychain(条目名为 OLLAMA-CLOUD_API_KEY,注意连字符是名称的一部分),不会落盘到任何配置文件;
  3. 选模型:key 验证通过后会自动拉取可用模型列表,勾选官方推荐的 gemma4:31b 回车即可。

整个过程的交互逻辑在 internal/runtime/tui/commandModelAdd.go 中实现,走的是标准 OpenAI 兼容协议,没有任何私有 header 的坑。

Agenvoy TUI终端界面:模型列表与token用量统计

第三步:接入本地 Ollama(自动探测,零配置)

如果不想依赖云端额度,本地跑 Ollama 是更彻底的选择,而 Agenvoy 对本机标准端口做了自动探测:

  • 启动 /model add 时,它会向 http://localhost:11434/v1(Ollama)和 http://localhost:8080/v1(llama.cpp)发起 GET /models 探测;
  • 有响应的端点会以 Ollama Local / Llama.cpp Local 追加在 Custom 标签页末尾,选中后直接进入模型勾选界面,不再询问网址和 key;
  • 这两个端点由 configs/jsons/local_compat.json 内建,不会写入任何配置。

本地端点模型以 <名称>@<模型> 格式注册,例如 ollama@gemma3:4b。

非标准端口/远程主机则走 Local/Custom 手动添加:

/model add → Custom → Local/Custom
  URL:  http://<主机>:<端口>/v1
  名称: ollama(端点名转小写作为前缀)
  key:  留空跳过

随后模型列表同样来自端点自己的 GET /models,勾选保存即完成。

查看剩余额度:Shift+U 一按就懂

免费方案最关心的"还能用多少",Agenvoy 给得很直接:

  • TUI 输入区为空时按 Shift+U,即时显示 Ollama Cloud 剩余百分比额度,状态栏右侧也有常驻显示;
  • Web 聊天界面会在每条回复上挂标签展示;
  • /usage 命令可查 24h / 7d / 28d 的逐模型 token 用量。

省钱组合小贴士 🧩

场景 建议
日常轻量任务 Ollama Cloud 免费 key + gemma4:31b
长文本 / 大文件 本地 Ollama 跑大参数模型,额度无上限
双保险 两个模型都注册,本地优先、云端兜底(或反过来),靠顺序回退自动切换
精打细算 用 model_tag 把免费模型标记为 C 级(快且便宜、稳定调工具),dispatcher 会把简单请求自动分给它

📌 若某次响应慢或失败,每个候选模型会先做 10 秒健康检查、最多 4 轮回退,session 已固定模型时不回退——所以"哪个当主力"建议按上表明确排序。

常见问题 FAQ

Q1:Ollama Cloud 免费额度用完了怎么办? Shift+U 会显示剩余额度;用尽后可切到本地 Ollama 模型继续用,两者在注册表里平级,互不影响。

Q2:key 存在哪里?会泄露吗? 凭据优先存操作系统 keychain(Linux 无 secret-tool 时落 ~/.config/agenvoy/.secrets,权限 0600),不写进 config.json,不进 Git。

Q3:本地 Ollama 换了端口还能自动识别吗? 标准端口(11434)自动探测;换端口就用 Local/Custom 填新 URL,网址会记录到 config.json 的 compats 字段。

总结

用 Ollama Cloud 免费 key + 本地 Ollama 这两条免费路线,Agenvoy 就能以零订阅成本跑起来:一条命令安装、/model add 三步接入、Shift+U 随时看额度。模型只是可插拔的"大脑",工具生成、定时任务、MCP 这些 Agent 核心能力全都照常可用——先用免费额度把功能摸透,需要更强模型时再按同一套流程加一行配置即可。🚀

登录后查看全文
Agenvoy