Hermes Agent 模型接入教程

围绕 OpenRouter、模型名、Provider Routing、API Key、限流和成本控制整理中文教程。

查看模型接入指南返回文章合集

Search intent

这个分类解决什么搜索需求

安装后遇到模型配置、模型不可用或成本控制问题。

适合已经能启动 Hermes Agent，但卡在 OpenRouter、模型名、API Key、限流或成本的人。

Focus

重点内容

OpenRouter API Key

模型名和 Provider

401 / 429 / model not found

Provider Routing 和成本记录

建议阅读顺序

01先让一个模型完成短问答
02再排查身份、模型名和限流
03稳定后按任务分层选择模型和 routing

读完后怎么验收

短问答可稳定返回

能判断错误属于 Key、模型名还是限流

能记录每个工作流的模型成本

读前先判断

01先让一个模型完成短问答

02再排查 Key、模型名、限流和上下文窗口

03稳定后才做模型分层和成本记录

常见误区

一开始就配置复杂 Provider Routing

只看模型价格，不看失败重试成本

改了环境变量但没有重启 shell 或后台进程

常见问题

Hermes Agent 模型接入教程应该先看哪一篇？

建议先点击「查看模型接入指南」，它是本分类的主线入口。主线看完后，再按阅读顺序补相关文章。

这个分类读完后怎么判断有效？

短问答可稳定返回；能判断错误属于 Key、模型名还是限流；能记录每个工作流的模型成本

如果模型接入相关教程看完仍然卡住怎么办？

先把问题缩小到一个可复现样例，记录当前系统、命令、模型、输入、错误日志和预期输出，再回到排错清单逐层定位。

⌘ api

模型接入·2026-10-08·9 分钟阅读

Hermes Agent 接入 MiniMax 国内站：Key 申请、MiniMax (China) 选项与 M2.7 验收

国内账号怎么把 MiniMax 接进 Hermes Agent：分清 minimax.io 和 minimaxi.com，选 MiniMax (China)、写 MINIMAX_CN_API_KEY、用 M2.7 跑通验收，以及 401、模型名、think 标签等常见报错。对照上游 v0.21.5 核对。

⌘ api

模型接入·2026-10-08·10 分钟阅读

Hermes Agent 接入智谱 GLM：GLM_API_KEY、国内端点自动探测、Coding Plan 与模型选择

智谱 GLM 在 Hermes Agent 里只有 Z.AI / GLM 一个选项，Hermes 会在海外、国内和 Coding Plan 四个端点间自动探测。本文讲 GLM_API_KEY 怎么配、探测缓存在哪、GLM_BASE_URL 何时要设、glm-5 等模型怎么选，以及 Insufficient balance 怎么排。

⌘ api

模型接入·2026-10-08·9 分钟阅读

Hermes Agent 接入 Kimi：Moonshot 开放平台国内站 Key、Kimi Code 订阅 Key 与模型选择

Kimi 接入 Hermes Agent 的关键是分清三种 Key：Moonshot 国内站的 KIMI_CN_API_KEY、sk-kimi- 开头的 Kimi Code Key、海外站的 KIMI_API_KEY。本文讲选项怎么选、Kimi Code 端点的自动改写、kimi-k2.5 怎么挑，以及 401、404 怎么排。

⌘ api

模型接入·2026-10-08·7 分钟阅读

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

小米 MiMo 是 Hermes Agent 上游官方支持的国内 Provider。本文讲 Xiaomi MiMo 选项、XIAOMI_API_KEY 怎么写进 .env、mimo-v2.5-pro 和 mimo-v2-flash 怎么选、三条命令验收，以及 401、model not found 排查和兜底写法。

⌘ api

模型接入·更新 2026-10-07·8 分钟阅读