OpenRouter
适合：先跑通、想快速切换模型、需要成本和速度路由
配置：准备 API Key，使用 `hermes model` 选择 Provider，再跑一次短对话。
检查：注意模型名称、上下文窗口、单次请求价格和限速。
01 / Provider
先按场景选入口
第一次接入只选一个 Provider。等 CLI、Memory、Skills 都稳定后，再考虑路由和多模型策略。
Nous Portal
适合：想用 Nous 侧模型入口，且希望少维护第三方路由规则
配置：浏览器登录（OAuth），不需要 API Key：运行 hermes setup --portal，或在 hermes model 里选 Nous Portal。
检查：Nous Portal 是境外服务，国内能否稳定登录请先自测；再确认订阅额度和要用的模型是否开放。
Ollama
适合：隐私优先、本地实验、低成本文本任务
配置：先让本地模型服务稳定运行，再让 Hermes 指向本地端点。启动 Ollama 前设置 OLLAMA_CONTEXT_LENGTH=64000。
检查：Hermes 要求上下文至少 64K，小于这个值启动时会被拒绝；显存和响应速度也会直接影响体验。
OpenAI 兼容端点
适合：自托管网关、企业代理、内部模型平台
配置：准备 base URL、model name 和 Key，先用最小请求测试。
检查：检查 streaming、tool calling、超时和错误格式是否兼容。
国内网络访问 OpenRouter 不稳？可以直接用 MiniMax、智谱 GLM、Kimi、小米 MiMo 等国内可直连的 Provider，详见 国内安装与使用。
配置和重配命令
`hermes model` 用来处理模型配置。切换 Provider 后，先退出当前会话，再重新打开 Hermes 验证。
hermes model # 交互式选择 provider 和模型
hermes config set model.provider openrouter # 不进向导，直接改 provider
hermes config set model.default <模型 ID> # 直接改默认模型
hermes setup model --reconfigure
hermes config check
hermes doctor
hermesOpenRouter 路由思路
高频低风险任务优先控制成本；代码、研究、长文档再切换更强模型。路由配置先小范围测试，避免把所有任务都打到贵模型。
provider_routing:
sort: price
only:
- <preferred-provider>
ignore:
- <unstable-provider>02 / 任务匹配
不同任务用不同模型
日报、摘要、分类
低成本模型
看稳定性和批量价格
代码审查、需求拆解
强推理模型
看上下文和工具调用能力
客服草稿、销售跟进
稳定通用模型
看语气稳定性和延迟
研究、论文、长文档
长上下文模型
看 64K 以上上下文和引用整理能力
本地隐私任务
Ollama / 自托管
看本机资源和响应速度
03 / 命令面
模型接入的命令面
选好 provider 只是第一步。模型来源的日常运维有专门一组命令：刷新模型列表、配置失败兜底、管理认证凭证、在本地开兼容代理，全程不用打开配置文件。它们对应模型层最常见的三类故障：列表过期、主入口挂掉、凭证失效。
hermes model 与 --refresh
hermes model 是交互式入口：先挑 provider，再从拉回的列表里定默认模型。各家 /v1/models 的返回会被缓存，新模型刚上线却在列表里找不到时，加 --refresh 清掉缓存重新拉一遍，不必重装，也不必手改配置文件。缓存换来的是列表秒开，代价是偶尔滞后，记住这个开关就够了。
hermes fallback 备用链
hermes fallback 为主模型配置失败后的备用 provider 链。主入口限流、超时或停机时，请求按链路顺序自动切到下一家。长期挂机的 Gateway 和定时任务最怕主模型单点故障，上线前先把这条链配好；链上每一家都提前用短对话跑一遍，免得真正切换的那一刻才发现备用入口的 Key 早已失效。
auth、portal 与 proxy
登录和退出 Provider 都走 hermes auth：hermes auth add 添加凭证（支持 OAuth 的 Provider 加 --type oauth 走浏览器登录），hermes auth logout 退出，hermes auth reset 清掉限流和认证失败后的冷却。旧教程里的 hermes login 早已删除。hermes proxy start 会在本地起一个 OpenAI 兼容代理，目前只支持 Nous Portal 和 xAI。走 Nous Portal 的用户用 hermes portal status 查看订阅状态；注意新版里不带参数的 hermes portal 会直接发起登录，并把 Provider 切到 Nous。
换 provider 不改代码
上游官方文档的 Providers 页列出的 Provider 包括 Nous Portal、OpenRouter、NVIDIA NIM、Hugging Face、OpenAI，以及 MiniMax、智谱 GLM、Kimi、小米 MiMo、通义千问、DeepSeek 等国内 Provider，还有自有 OpenAI 兼容端点。在它们之间切换不需要改任何代码，用 hermes model 重选一次即可；CLI 下次开会话生效，网关要开新会话或 hermes gateway restart。
模型运维速查
排查模型问题时按这个顺序走：先 --refresh 排除缓存过期，再确认 fallback 链是否生效，最后检查 login 与 auth 的凭证状态。proxy 跑起来之后，本地其他只认 OpenAI 协议的工具可以共用这一份认证，不必为每个工具单独配 Key。
hermes model --refresh # 清缓存，重拉各家 /v1/models
hermes fallback add # 给主模型加一级备用 provider
hermes auth add <provider> # 添加凭证（OAuth 型加 --type oauth）
hermes auth reset <provider> # 清掉限流、认证失败后的冷却
hermes proxy start --provider nous # 本地 OpenAI 兼容代理（仅 Nous Portal / xAI）
hermes portal status # Nous Portal 订阅状态能完成 1 次 20 秒内的短对话。
模型上下文至少 64K：这是 Hermes 的硬性下限，更小的窗口启动时就会被拒绝。
能在失败时看到明确错误：401、429、timeout、model not found。
有一个低成本默认模型，也有一个高质量备用模型。
Gateway 或工作流不会无限重试同一个模型错误。
高频任务已经设置输入长度、触发频率和人工确认边界。
OpenRouter 配置与报错排查
本页负责选 Provider 和定路由。具体到 OpenRouter 的 Key、模型名、成本记录和两类最常见报错，按下面的顺序读。
配置教程
Hermes Agent 接入 OpenRouter：配置步骤、模型选择与成本控制
Key、模型名、Provider Routing、按任务分层选模型和成本记录，附 32 秒视频。
报错排查
OpenRouter 401 / 429 报错：API Key、额度和限流
invalid key、rate limit、timeout 时按 Key、环境变量、额度、模型和触发频率定位。
报错排查
OpenRouter 报 model not found 怎么排查
从模型名、Provider、环境变量、会话重启和上下文窗口五个层面逐项检查。
国内 Provider
Hermes Agent 接入 MiniMax 国内站：配置步骤、模型选择与报错排查
分清 minimax.io 和 minimaxi.com，选 MiniMax (China)、写 MINIMAX_CN_API_KEY、用 MiniMax-M2.7 跑通验收。
国内 Provider
Hermes Agent 接入智谱 GLM：GLM_API_KEY、端点自动探测与 Coding Plan
一个 Z.AI / GLM 选项背后有四个端点，Hermes 自动探测并缓存；Insufficient balance 多半是端点错位。
国内 Provider
Hermes Agent 接入 Kimi：Moonshot 国内站 Key 与 Kimi Code 怎么配
分清 KIMI_CN_API_KEY、sk-kimi- 开头的 Kimi Code Key 和海外站 Key，Hermes 按前缀自动改写端点。
国内 Provider
Hermes Agent 接入小米 MiMo：XIAOMI_API_KEY 配置、模型选择与验收
Xiaomi MiMo 选项、XIAOMI_API_KEY、mimo-v2.5-pro 与 mimo-v2-flash 怎么选，以及兜底模型写法。
国内网络
不用梯子的 Provider：MiniMax、智谱、Kimi、DeepSeek
OpenRouter 访问不稳定时，先用国内可直连的 Provider 跑通，配置思路相同。