Hermes Agent 接入小米 MiMo：XIAOMI_API_KEY 配置、mimo-v2.5-pro 模型选择与验收

为什么把小米 MiMo 放进候选

小米 MiMo 开放平台 platform.xiaomimimo.com 国内直连，是 Hermes 上游官方支持的 Provider 之一，README 首屏的支持列表里就有它。Hermes 里的选项叫 Xiaomi MiMo，环境变量 XIAOMI_API_KEY，端点 https://api.xiaomimimo.com/v1，走 OpenAI 兼容的 chat completions 协议，工具调用和流式输出都正常。配置文件里的 Provider ID 是 xiaomi，别名 mimo、xiaomi-mimo 都能识别。

它适合的位置是低成本、高频的文本任务：日报、摘要、分类、RSS 整理。先用它把 Hermes 的工作流跑起来，再决定哪些任务值得换更贵的模型。其他国内 Provider 的选项名和环境变量汇总在 国内安装与使用指南，MiniMax、智谱 GLM 和 Kimi 各有单独教程：接入 MiniMax 国内站、接入智谱 GLM、接入 Kimi。

申请 Key

在 platform.xiaomimimo.com 控制台创建 API Key，确认账户有可用额度。平台菜单会变，以当前界面为准；Key 只粘到 Hermes 里，不要进聊天记录、截图或代码仓库。

配置方式一：hermes model 向导

hermes model
# → 选 "Xiaomi MiMo"
# → 粘贴 Key，Hermes 写进 ~/.hermes/.env 的 XIAOMI_API_KEY
# → 模型选 mimo-v2.5-pro

配置方式二：直接写 .env 和 config.yaml

echo 'XIAOMI_API_KEY=你的Key' >> ~/.hermes/.env
hermes config set model.provider xiaomi
hermes config set model.default mimo-v2.5-pro

• ~/.hermes/.env 的优先级高于 shell 里 export 的同名变量，重启后以文件为准。
• XIAOMI_BASE_URL 只在走自建中转时才需要，直连不要设。
• 只想临时试一次，用 hermes chat --provider xiaomi --model mimo-v2-pro，这是官方文档的示例写法。

验收：三条命令确认链路

hermes doctor
hermes -z "用一句话确认你能正常回复"
hermes gateway restart

hermes doctor 会确认 XIAOMI_API_KEY 已经写进 .env。hermes -z 跑一句短问答能回复，就说明 Key、端点和模型名都对。Gateway 已经在跑的话，最后一条让它重新加载 Key。

选哪个模型

• mimo-v2.5-pro：新旧版本 Hermes 的列表都有，Hermes 按 100 万 token 记录上下文，先用它跑通。
• mimo-v2.5、mimo-v2-pro：两版都有，同样 100 万上下文；v2-pro 是官方文档示例。
• mimo-v2-flash：262,144 上下文，便宜、快，摘要和分类这类高频任务优先用它。
• mimo-v2-omni：262,144 上下文，名字里的 omni 对应多模态方向，是否支持你要的输入类型以平台说明为准。
• mimo-v2.6-pro、mimo-v2.6-flash、mimo-v2.6-pro-ultraspeed：只在较新版本 Hermes 的目录里，hermes update 之后出现。

价格方面，Hermes 内置的计价表里没有小米官方价目，用量统计不会显示费用，成本要自己从控制台抄到 成本记录模板 里。

常见报错

1. 401：Key 没进 .env，或者选错了 Provider。用 grep XIAOMI ~/.hermes/.env 看 Key 是否真的在文件里，另一个终端 export 的变量不算。
2. model not found：型号名全小写、用点分隔版本号，例如 mimo-v2.5-pro，从平台复制准确 ID。列表里没有的新型号先 hermes update。
3. 请求很慢或超时：国内直连不需要代理。如果为了装 Hermes 开了全局代理，把 api.xiaomimimo.com 加进 no_proxy，或者测试时先关掉代理。
4. CLI 正常、群里还是旧模型：hermes gateway restart。

更多排查思路见 Hermes Agent 故障排查清单。

顺手：把 MiMo 设成兜底模型

上游 fallback_model 注释里点名支持的 Provider 列表没有 xiaomi，但注释同时写了自定义 OpenAI 兼容端点的写法：加 base_url 和 key_env。按这个格式配，主模型遇到 429、503、529 或连接失败时自动切到 MiMo：

fallback_model:
  provider: xiaomi
  model: mimo-v2-flash
  base_url: https://api.xiaomimimo.com/v1
  key_env: XIAOMI_API_KEY

核对说明

本文的选项名、环境变量、端点、别名、模型目录和上下文数值对照上游 v2026.9.24（v0.21.5）的 hermes_cli/auth.py、providers.py、models_catalog_static.py、agent/model_metadata.py、config.py 的 fallback 注释和官方 Providers 文档核对，命令参数在本地 v0.15.1 验证过。编辑组没有用小米账号做真实计费测试，价格和模型开放情况以你的控制台为准。

下一步

链路通了以后按 setup 输出验收清单 把 Memory、Skills 和 Gateway 逐项过一遍，再回到 模型接入指南 看按任务分层选模型的思路。

还没有真实场景？可以先领取 Free Starter 模板包，从低风险只读任务开始试跑。