Hermes agent小米的模型怎么用？三模全家桶完整攻略

Hermes Agent 是由 Nous Research 开发的“自进化”AI智能体框架，能从任务中自动提炼技能并越用越强。小米的模型（Xiaomi MiMo-V2系列）是小米于2026年3月发布的旗舰大模型，包含MiMo-V2-Pro（专业增强）、Omni（全模态）、Flash（极速）三款，总参数量超1T（42B激活参数），支持1M超长上下文，采用创新的混合注意力架构。它们的核心结合价值在于：顶级的开源Agent框架与高性能国产大模型的“强强联手”——Hermes负责“怎么干活”，小米模型负责“聪明地理解”，两者结合后Agent的自我进化能力和全模态感知能力都能得到质的提升。

本文大纲

👉 一、核心结论：两种方式，一路畅通
👉 二、小米模型简介：三款模型各有什么特点？
👉 三、方式一：通过Nous Portal一键接入（推荐，限免中）
👉 四、方式二：通过OpenRouter接入（替代方案）
👉 五、配置验证与模型切换
👉 六、多模型共存配置技巧
👉 七、常见问题与排障指南
👉 总结

一、核心结论：两种方式，一路畅通

在Hermes Agent中使用小米的模型，目前有两条成熟的路径：

接入方式	核心特点	当前状态	推荐指数
Nous Portal	官方集成，开箱即用，无需申请密钥	限免两周（4月8日-4月22日）	⭐⭐⭐⭐⭐
OpenRouter	聚合平台，模型选择更丰富	需要申请OpenRouter API Key	⭐⭐⭐⭐

两种方式都是通过Hermes Agent的标准模型接入机制实现的，核心是Hermes采用“声明式模型配置机制”——所有模型源均在配置文件中以provider+model_id形式注册，运行时动态加载，无需修改任何代码。

二、小米模型简介：三款模型各有什么特点？

在动手配置之前，先了解一下三款小米模型各自的特点，方便你按需选择：

模型名称	定位与特点	适用场景
MiMo-V2-Pro	旗舰基座模型，总参数量超1T（42B激活参数），1M超长上下文，混合注意力架构	重度Agent任务、复杂编程、长流程规划
MiMo-V2-Omni	全模态Agent基座，原生融合文本、视觉与音频感知	需要图像/视频/音频理解的综合任务
MiMo-V2-Flash	极速推理模型，轻量高效	快速响应场景、轻量级应用

其中，MiMo-V2-Omni是唯一通过Hermes Agent全模态认证的模型，支持视觉理解、语音转写、帧级视频摘要及多模态工作流编排。如果你需要Agent“看得见、听得懂、能动手”，Omni是不二之选。

三、方式一：通过Nous Portal一键接入（推荐，限免中）

这是目前最推荐的方式。小米与Nous Research达成官方合作，已将MiMo-V2系列模型深度集成到Hermes Agent中，开发者只需更新框架并登录Nous Portal，即可在限免期内免费调用。

限免信息：

• 限免周期：4月8日至4月22日24:00（北京时间）
• 限免范围：MiMo-V2 Pro、Omni、Flash三款模型全部免费调用

步骤1：更新Hermes Agent至最新版本

首先确保你的Hermes Agent是最新版本。运行以下命令：

# 更新Hermes Agent
hermes update

# 或者重新运行安装脚本
c​url -fsSL https://raw.githubusercontent​.com/NousResearch/hermes-agent/main/scripts/install.sh | b​ash

步骤2：进行Nous Portal授权登录

在终端中运行授权命令：

hermes auth

进入交互界面后，依次选择：

• 1. Add a credential
• 输入 nous
• 选择 2. Login with browser（浏览器登录）

系统会打开浏览器，引导你完成Nous Portal的OAuth登录流程。登录成功后，终端会显示授权成功的信息。

步骤3：选择小米模型

完成授权后，运行模型切换命令：

hermes model

在交互菜单中，选择 Nous Portal (Nous Research subscription)，随后会看到小米的三款模型：

• xiaomi/mimo-v2-pro
• xiaomi/mimo-v2-omni
• xiaomi/mimo-v2-flash

使用方向键选择你需要的模型，按回车确认即可。

步骤4：验证配置

配置完成后，发送一条消息测试回复是否正常。你也可以在对话中输入 /model 命令，确认当前使用的模型名称是否正确显示。

四、方式二：通过OpenRouter接入（替代方案）

如果你更习惯使用OpenRouter聚合平台，或者希望同时使用多个供应商的模型，也可以通过OpenRouter接入小米模型。

步骤1：申请OpenRouter API Key

访问OpenRouter官网（https://openrouter.ai/），注册并登录后，在“Keys”页面生成API Key。密钥格式通常为 sk-or-v1-xxxx，注意保存，只会显示一次。

步骤2：在Hermes中配置OpenRouter

运行模型切换命令：

hermes model

在交互菜单中选择 OpenRouter (100+ models, pay-per-use)，然后粘贴你申请的API Key。

步骤3：选择小米模型

完成Key配置后，在模型列表中找到小米的模型：

• openrouter/xiaomi/mimo-v2-pro
• openrouter/xiaomi/mimo-v2-omni
• openrouter/xiaomi/mimo-v2-flash

选择对应的模型即可完成配置。

五、配置验证与模型切换

无论使用哪种方式接入，配置完成后都可以通过以下方式验证和切换：

验证当前模型：
在Hermes对话界面中输入：

/model

系统会显示当前正在使用的模型名称和provider信息。如果看到 xiaomi/mimo-v2-pro 等字样，说明配置成功。

运行时切换模型：
有两种方式可以随时切换模型：

• 方式一：在终端中运行 hermes model，交互式选择目标模型
• 方式二：在对话中输入 /model xiaomi/mimo-v2-omni 直接切换

校验模型连通性：
启动Agent前，可以运行以下命令校验模型端点连通性与权限有效性：

hermes validate-config

六、多模型共存配置技巧

如果你希望同时保留多个模型配置，在不同任务间灵活切换，可以通过编辑配置文件实现。编辑 ~/.hermes/config.yaml：

providers:
  nous:
    api_key: ''  # Nous Portal使用OAuth，无需手动配置密钥
  openrouter:
    api_key: 'sk-or-v1-xxxxxxxx'
  custom-deepseek:
    api_key: 'sk-xxxxxxxx'
    base_url: 'https://api.deepseek.com/v1'

model:
  default: 'xiaomi/mimo-v2-pro'   # 默认启动的模型
  provider: 'nous'

配置完成后，可以通过 hermes model 命令在多个provider和模型之间自由切换。

七、常见问题与排障指南

Q1：授权时浏览器没有自动打开？
可以手动复制终端中显示的授权链接，粘贴到浏览器中打开完成登录。登录成功后回到终端继续操作即可。

Q2：模型列表中没有看到小米模型？
可能原因：Hermes Agent版本过旧。解决方案：运行 hermes update 更新至最新版本，或重新执行安装脚本。

Q3：限免期结束后怎么办？
限免期（4月22日后）结束后，小米模型将恢复标准计费。MiMo-V2-Pro在256K上下文以内，每百万输入Token 1美元，每百万输出Token 3美元；MiMo-V2-Omni输入每百万Token 0.4美元，输出2美元。届时你也可以将Hermes Agent切换到其他免费或低成本的模型继续使用。

Q4：配置完成后模型不回复？

• 检查 hermes validate-config 的输出，确认端点连通性
• 在对话中输入 /model 确认当前模型是否正确加载
• 检查网络连接是否正常

Q5：全模态功能无法使用？
注意：目前仅MiMo-V2-Omni支持全模态感知（图像、视频、音频、文本的融合理解）。其他模型虽支持多模态API，但未激活Hermes Agent原生多模态路由协议，仅能处理文本增强型输入。如需“看得见、听得懂”的能力，请务必选择Omni模型。

Q6：Windows环境下模型名称显示为空？
这是Windows环境的已知问题。解决方法：在聊天窗口中输入 /model 命令手动指定模型，看到模型名称正确显示即代表设置成功。

总结

在Hermes Agent中使用小米模型，最推荐的方式是通过Nous Portal一键接入：更新Hermes Agent → 运行 hermes auth 完成授权 → 运行 hermes model 选择小米模型，三步即可完成配置。当前正值小米限免活动期（4月8日-4月22日），三款模型全部免费调用，是体验国产顶尖大模型与全球顶级Agent框架结合的绝佳时机。如果需要更丰富的模型选择，也可以通过OpenRouter接入。配置完成后，可以通过 /model 命令随时切换，也可以编辑 config.yaml 实现多模型共存。

如果你想把Hermes Agent与小米模型这类强大组合的能力集成到更复杂的企业级自动化场景中——比如跨系统数据同步、智能审批、多Agent协同编排——可以了解一下「实在Agent」。它能把大模型调用、RPA流程编排和数据流转串成一条线，让你的AI助手从“会聊天”升级为“能干活”的生产力中枢。