一、先唠两句：你为什么需要接 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 API Key
动手之前，老粉按照上期教程已经配置好了，只需简单调整一下就
好今日头条把免费顶级模型Agnes集成到workbuddy里，积分焦虑瞬间解放 - 今日头条workbuddy教程
如图只需要把模型名称修改一下即可：
按照提示修改就可以了
如果是新来的朋友，按照步骤一步步来就可以了，你得先有一个 Agnes 的"通行证"——API Key。这东西相当于你调用接口的账号密码。
- 打开浏览器，访问 platform.agnes-ai.com，注册并登录一个账号。
- 在后台找到「API Key」/「密钥管理」这类入口（不同页面叫法可能不同，看到 Key 字样点进去就行），点「创建 / 申请新 Key」。
- 系统会生成一串 sk- 开头的密钥。记住他一会要用。
⚠️ 重点提醒：这个 Key 页面上只显示一次！ 生成后当场复制，粘到记事本里存好。关了页面再想找，只能重新生成一个。
安全提醒：API Key 等于你的账号密码。别截图发群里、别写进会公开分享的文档。本文里所有 Key 都用 sk-你的Agnes密钥 占位，你实际填的时候换成自己的真 Key 即可。三、核心：把模型加进 WorkBuddy
如果你更习惯在界面上点，可以在 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
热门跟贴