Hermes Agent API Key 配置 应该从哪里开始？
建议先打开「打开 401 / 429 排查」，按本页的步骤完成最小验证，再阅读相关排错和视频内容。
Topic guide
API Key 专题怎么读
先确认 Key 被当前进程读取，再区分 401、model not found 和 429。
- 01检查环境变量和 Provider
- 02短问答验证模型链路
- 03再恢复长工作流和 routing
这个专题适合谁
Hermes Agent API Key 配置 适合已经能启动 Hermes Agent，但卡在模型、API Key、限流、模型名或成本控制的人。先让一个模型稳定，再谈复杂 routing。
读完后的验收标准
一个低风险工作流连续运行 3 次，模型返回稳定，失败原因和成本都能记录。
先检查这三件事
01用短问答验证 Provider 和模型名，不要一开始跑长工作流
02区分 401、429、model not found 和上下文不足
03记录触发次数、失败率、重试次数和人工修改比例
常见误区
一上来配置复杂路由，导致排错面扩大
只看模型单价，不看失败重试和人工修改成本
改了环境变量却没有重启当前会话或后台进程
常见问题
API Key 相关问题怎么判断是否已经解决？
一个低风险工作流连续运行 3 次，模型返回稳定，失败原因和成本都能记录。
读完 Hermes Agent API Key 配置 后下一步做什么？
如果还没有真实场景，先下载免费 Starter 包，选择日报、Issue 分类或内容选题这类只读模板跑一次。
读完专题，建议做一次验证
只看教程不够。下载 Starter 包，选一个日报、Issue 分类或内容选题模板跑一次，确认输入、输出和日志都可复现。
⌘ 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 分钟阅读
Hermes Agent OpenRouter 401 和 429 报错：API Key、额度和限流排查
OpenRouter 返回 401、invalid key、429、rate limit 或 timeout 时，按 API Key、环境变量、额度、模型和触发频率定位。