gnes 2.5 接入 WorkBuddy 保姆级教程：照着做 5 分钟搞定

一、先唠两句：你为什么需要接 Agnes 2.5

之前我发过一版 Agnes 接入教程，最近后台一堆人私信："升级到 2.5 了，你的教程过时了！"——旧模型也能用，既然大家都想要最新版本的，这版我按 2.5 重新写了一遍，主打一个文件配置法，你照着一步步抄，5 分钟就能搞定。

先剧透下 2.5 强在哪：上下文直接拉到 26 万 token（一整本书丢进去都不满），最大输出 6.5 万 token；支持 xhigh / high / medium 三档推理力度（深度思考用 xhigh）；更重要的是，之前老被人吐槽的"出口 IP 被 Cloudflare 拦、报 403"的问题，2.5 已经修好了。

动手之前，老粉按照上期教程已经配置好了，只需简单调整一下就

好今日头条把免费顶级模型Agnes集成到workbuddy里，积分焦虑瞬间解放 - 今日头条workbuddy教程

如图只需要把模型名称修改一下即可：

按照提示修改就可以了

如果是新来的朋友，按照步骤一步步来就可以了，你得先有一个 Agnes 的"通行证"——API Key。这东西相当于你调用接口的账号密码。

1. 打开浏览器，访问 platform.agnes-ai.com，注册并登录一个账号。
2. 在后台找到「API Key」/「密钥管理」这类入口（不同页面叫法可能不同，看到 Key 字样点进去就行），点「创建 / 申请新 Key」。
3. 系统会生成一串 sk- 开头的密钥。记住他一会要用。

⚠️ 重点提醒：这个 Key 页面上只显示一次！ 生成后当场复制，粘到记事本里存好。关了页面再想找，只能重新生成一个。

安全提醒：API Key 等于你的账号密码。别截图发群里、别写进会公开分享的文档。本文里所有 Key 都用 sk-你的Agnes密钥 占位，你实际填的时候换成自己的真 Key 即可。

如果你更习惯在界面上点，可以在 WorkBuddy 的「设置」里找模型 / 自定义模型相关入口（不同版本入口名字可能略有差异，看到带"模型""自定义"字眼的就点进去）点击 Add Model 并填写以下参数：

提供商： CustomAPI Base

URL： https://apihub.agnes-ai.com/v1

API Key： YOUR_API_KEY

模型名称： agnes-2.5-flash

将 YOUR_API_KEY 替换为你实际的 API 密钥。

四、验证：真的通了吗？

配完了先别急着嗨，验证一下到底通没通。

基础验证（必做）在 WorkBuddy 里选中 agnes-2.5-flash，发一条：

"帮我写一句周末去爬山的朋友圈。"

它能正常给你吐出一句文案 → 基础接入成功

五、进阶玩法：解锁文生图 / 文生视频（多模态 MCP）

上面搞定的，是聊天模型这一层。Agnes 2.5 还有更狠的多模态生成能力——文生图、图生图、文生视频、图生视频，对应模型名是 agnes-image-2.1-flash（图像）和 agnes-video-v2.0（视频）。直接复制下面这一句话：

我想使用 Agnes Image 2.5 模型生成图片和视频。请访问其 API 平台
https://agnes-ai.com/doc/overview 并将其打包为一个 Skill。

skill安装好以后，再技能菜单上面就可以看到这个技能。然后让我们做一个图片和一个视频测试一下。

视频咋放不进去呢？

已经跑通了，完全没有问题。 六、好了，大招来了，因为很多朋友没有用workbuddy接入，我集合现在所有市面上的智能体，常见接入文档-最新版

OpenClaw接入方法：
https://agnes-ai.com/zh-Hans/docs/cid1

HermesAgents接入方法：
https://agnes-ai.com/zh-Hans/docs/cid2

Claude CLI接入方法：
https://agnes-ai.com/zh-Hans/docs/cid3

Claude Desktop接入方法:
https://agnes-ai.com/zh-Hans/docs/cid4

WorkBuddy接入方法:
https://agnes-ai.com/zh-Hans/docs/cid5

Cherry Studio接入方法:
https://agnes-ai.com/zh-Hans/docs/cid6

Opencode接入方法:
https://agnes-ai.com/zh-Hans/docs/cid7

Codex++接入方法:
https://agnes-ai.com/zh-Hans/docs/cid8

如果要调用图片视频模型 请配置好文本模型后让agent帮你配

最新：
https://github.com/AgnesAI-Labs/skills/tree/main

七、小蚂蚁说

工具接好了，只是个开始。

真正让 AI 变好用的，从来不是你接了多少模型，而是你会不会问问题——同一个 Agnes，有人拿它写周报，有人拿它做视频脚本，差的就是那几句"会问的话"。

2.5 把上下文拉到了 26 万 token，够你丢一整本书进去。但书放进去不会自己变成答案，你得知道往哪儿翻、问什么。

别光收藏，今晚就花 5 分钟接上，明天它就能替你干活了。

觉得有用，点个「在看」+ 关注小蚂蚁学AI