Agnes 2.5 Flash：免费的新一代编程模型

Agnes 2.5 Flash 是什么？

Agnes 2.5 Flash 是 agnes-2.0-flash 的继任者 — 后者正是 OpenClaw Launch 上通过 Agnes 密钥 已经能用的那个免费多模态模型。 Agnes AI 把 2.5 Flash 定位为「开发者日常主力模型」，主打编程、智能体工作流与复杂开发场景， 并称相比 2.0 有四个方面的显著提升：

• 对大型、陌生代码库的理解能力
• 在既有项目里发现并修复工程 Bug
• 跨文件、多步骤任务的执行
• 复杂推理

在 Agnes AI 的官方演示里，2.5 Flash 能在既有代码库中定位并修复 Bug、从零搭建完整应用、 在复杂项目里做跨文件的协同修改 — 官方将其结果描述为可与 Claude Opus 4.7 一较高下。 它提供512K token 上下文窗口与最高 65,536 个输出 token， 并使用标准的 OpenAI 兼容对话格式，所以您在 OpenClaw 上的配置无需任何改动就能用上它。

真的免费吗？

Agnes 目前将 Agnes 2.5 Flash 的输入和输出价格都列为每百万 token $0。 实际访问仍受 Agnes 账户权限与服务限制约束。面向更重度推理场景的Agnes 2.5 Pro Alpha 则会扣减您的 Agnes 余额。

可用状态（2026 年 7 月 27 日验证）

两个 2.5 代对话模型现在都已通过 Agnes 的 OpenAI 兼容 API 提供：

• agnes-2.5-flash — 已上线并成为推荐项。OpenClaw Launch 会把它列在 Agnes 模型选择器首位，并用于新的 Agnes 资助部署。
• agnes-2.5-pro-alpha — API 上已经可用。付费推理模型仍需用户主动选择，绝不会自动应用。

现有实例不会被静默切换。如果保存的主模型是 agnes-2.0-flash， 它会保持不变，直到您主动选择 2.5 Flash；2.0 也会继续作为兼容退路保留。

付费推理选项：Agnes 2.5 Pro Alpha

agnes-2.5-pro-alpha 是 Agnes 2.5 代的付费推理模型。 它已在模型选择器中提供，标注为 Agnes 2.5 Pro Alpha (Paid)。 切换之前有三点需要先了解：

• 它不是免费的。与 OpenClaw Launch 上其他所有 Agnes 模型不同， Pro Alpha 会按请求扣减您自己 Agnes 账户的余额。余额不足时， Agnes 会直接以额度不足的错误拒绝请求，而不会自动降级到别的模型。 打算长期使用请先在 Agnes 平台充值。
• 它是推理模型。它会先思考再作答，而这部分思考同样消耗输出 token — 在简短回复里往往占了绝大部分。我们为它声明了比 Flash 系列大得多的输出上限， 以确保您拿到的是真正的回答而不是空白；但同样一个问题，它的 token 消耗会明显高于 2.0 Flash。
• 它是 alpha 版本。「alpha」是 Agnes 自己的命名。 请把它当作用来评估的模型，而不是放在生产机器人上无人值守长期运行的模型， 并保留免费的 Flash 模型作为退路。

它同时支持图片输入，多模态提示的用法与 2.0 Flash 一致。 因为它是付费模型，我们不会替您选择它：它不会成为任何默认项，也不会被自动应用到您的实例上 — 只有您主动选择才会启用。

在 OpenClaw Launch 上怎么用

用的还是那把已经能解锁 2.0 Flash 的免费 Agnes 密钥。密钥保存好之后， 切换到 2.5 Flash 只需点击一次「换模型」。

1. 免费申请 Agnes 密钥 — 在 platform.agnes-ai.com 注册（无需信用卡）并创建 API 密钥，Agnes 密钥以 sk- 开头。 完整步骤见 Agnes 密钥设置指南。
2. 在 OpenClaw Launch 保存密钥 — 打开 API 密钥页面，找到 Agnes 卡片， 粘贴您的 sk- 密钥并点击保存。 我们会先向 Agnes API 校验再存储，且全程加密保存。
3. 设置对话模型 — 在 Agnes 卡片里点击「设为主模型」选择模型。推荐项是 agnes-2.5-flash，agnes-2.0-flash 则继续作为兼容退路。 同一个下拉列表里还会出现标注 (Paid) 的agnes-2.5-pro-alpha，选用它会扣减您的 Agnes 余额。 应用后对正在运行的实例即时生效 — 无需重新部署。

两个框架都适用。在 OpenClaw 上，模型通过您声明的 Agnes 提供方直连路由； 在 Hermes Agent 上，同一把密钥会在切换模型时 写入自定义提供方槽位。无论哪种，都会使用您自己的 Agnes 密钥；Flash 当前为 $0， Pro Alpha 则是付费模型。

要从 2.0 换到 2.5 吗？

先说 2.5 Flash：如果是编程和智能体类工作 — 建议换。 那正是它着力改进的场景，而且价格一样（$0）。 如果您的机器人主要做轻量闲聊，2.0 Flash 依然完全够用，也会继续保留。 因为切换是一次无需重新部署、零成本的换模型操作，最稳妥的做法就是： 在您的实例上试一试，满意就留下。

再说 2.5 Pro Alpha — 因为它要花钱，判断标准不一样。 如果您在复杂多步任务或调试上已经碰到 2.0 Flash 的能力上限， 且需要更强的推理行为，那它值得一试。 但如果是高频闲聊型机器人，就不建议整体切过去：每一轮都产生的推理 token 会累积起来， 而这类场景免费模型完全应付得来。比较务实的用法是： 日常保持 2.5 Flash，遇到某个难题时临时切到 Pro Alpha，做完再切回来。

常见问题排查

我的模型选择器里还没有 agnes-2.5-flash

• 请刷新 API 密钥页面。Agnes 2.5 Flash 现在已加入平台目录， 应显示为推荐选项。
• 确认您的 Agnes 密钥已在 API 密钥页面保存并校验通过 — 只有存在有效密钥时，Agnes 区块才会显示。

Model Not Found（404）

• 请使用准确 ID agnes-2.5-flash。如果已保存的密钥仍收到 404， 请重新保存密钥，并把失败时间提供给支持团队；该模型当前已由 Agnes API 提供。

401 未授权

• 确认密钥以 sk- 开头，且没有多余空格或换行。 必要时在 Agnes 后台重新生成一把再保存。

用 Agnes 2.5 Pro Alpha 时提示额度不足

• Pro Alpha 按您自己的 Agnes 余额计费，而且 Agnes 会在执行请求之前先预扣额度 — 所以余额偏低时，较长的提示词可能直接被拒绝，而短提示却仍然正常。 请在 Agnes 平台充值，或切回免费的 agnes-2.5-flash。
• 免费的 Flash 模型不会像 Pro Alpha 一样扣减余额 — 如果 Pro Alpha 因额度报错， 请切到 2.5 Flash 或 2.0 兼容退路。

Agnes 2.5 Pro Alpha 的回复是空的或被截断

• 这是推理模型的特性：它会先消耗输出 token 进行思考，再写出答案。 若输出上限设得太小，额度可能全被思考过程用掉，导致看不到正文。 通过模型选择器配置的实例已经带有适配推理模型的输出上限； 如果您自己手改过配置里较小的 max tokens，请调大。

常见问题

Agnes 2.5 Flash 是什么？

Agnes 2.5 Flash 是 Agnes AI 最新的免费旗舰模型，Agnes 2.0 Flash 的继任者。 它在代码理解、工程修复、多步任务执行与复杂推理上都有显著提升， 官方称其表现可与 Claude Opus 4.7 相比。Agnes 目前定价为 $0，并提供 512K token 上下文窗口。

Agnes 2.5 Flash 免费吗？

Agnes 目前将 Agnes 2.5 Flash 的输入与输出价格都列为每百万 token $0； 账户权限与服务限制仍然适用。另有会扣减 Agnes 余额的付费模型 Agnes 2.5 Pro Alpha。

现在就能在 OpenClaw Launch 上用 Agnes 2.5 Flash 吗？

可以。Agnes 2.5 Flash 已通过 Agnes API 可用，并显示为 OpenClaw Launch 推荐的 Agnes 模型。 选择后会更新正在运行的实例，无需重新部署。已保存为 agnes-2.0-flash 的现有实例 会保持不变，直到您主动切换。

Agnes 2.5 Pro Alpha 是什么？免费吗？

它是 Agnes 2.5 代的付费推理模型。它不免费：按请求扣减您自己 Agnes 账户的余额， 余额不足时请求会被拒绝。在 OpenClaw Launch 的模型选择器里， 它显示为「Agnes 2.5 Pro Alpha (Paid)」，并且不会被自动应用到您的实例上 — 推荐的默认项始终是免费模型。

为什么 Agnes 2.5 Pro Alpha 比 2.0 Flash 更费 token？

因为它是推理模型：在给出可见回答之前会先生成内部思考，而这部分同样按输出 token 计费， 在简短问题上往往占了大头。代价换来的是更强的多步任务与调试能力； 如果只是日常闲聊，免费的 Agnes 2.5 Flash 是更合适的选择。

它和 2.0 Flash 有什么区别？

2.5 Flash 是一次面向开发工作的大幅升级：更强的代码理解、在既有项目上更可靠的 Bug 修复、 更稳的多步与跨文件执行，以及更好的复杂推理。两者共用同一套 OpenAI 兼容 API； 2.5 Flash 将上下文扩展到 512K，而 2.0 继续作为兼容退路。

Hermes Agent 也能用吗？

可以。同一把免费 Agnes 密钥在 OpenClaw 和 Hermes Agent 实例上都能用。 保存一次密钥，然后在任一框架的选择器里选 Agnes 模型即可。