Hermes 接入任意 AI 模型:一文讲透 provider 配置,告别「配了用不了」
作者码锅 | 个人原创未经授权禁止转载系列定位Hermes Agent 入门实战系列 · 第 3 篇 / 共 8 篇前面两篇第 1 篇讲了为什么装 Hermes第 2 篇教你从装好到跑通。这篇解决一个新手指望最大的问题——怎么把 Hermes 接入自己的 API让它可以调用任意模型。先说结论原理只有一句话Hermes 调模型的方式和其他工具一样——所有 provider 底层都是 OpenAI 兼容格式的 API。这就意味着任何提供 OpenAI 格式接口的平台都能接入 Hermes。OpenAI、Anthropic → 直接用内置支持DeepSeek、商汤日日新、MiniMax → 走custom_providers自定义你公司自建的网关 → 也能配进去今天这篇把这个配置从「能配」讲到「配对了」。一个让 80% 新手困惑的问题评论区有人问“我在 config.yaml 里写的是custom:token.sensenova.cn但界面上下拉框显示的是Token.sensenova.cn两个对不上我是不是配错了”你没配错。就是这个设计。看这个对照位置值格式model.providercustom:token.sensenova.cn带custom:前缀全小写custom_providers[].nameToken.sensenova.cn不带前缀首字母大写Hermes 内部用custom:xxx作为 key 来定位 provider界面上显示的是name作为给人看的标签。key 和标签是两个东西格式自然不一样。记住一条规则配置里写custom:xxx界面上找xxx。能对上就行别纠结格式。完整配置文件详解打开~/.hermes/config.yamlprovider 相关部分长这样model:provider:custom:token.sensenova.cndefault:sensenova-6.8-flash-litebase_url:https://token.sensenova.cn/v1custom_providers:-name:Token.sensenova.cnbase_url:https://token.sensenova.cn/v1api_key:你的keymodels:-sensenova-6.8-flash-lite-deepseek-v4-flash-glm-5.24 个关键字段新手最容易搞混字段作用新手常犯错误model.provider告诉 Hermes 用哪个 provider填成了模型名应该填custom:xxxmodel.default默认用哪个模型填了一个没在custom_providers.models里声明过的名字base_urlAPI 地址漏掉末尾的/v1报 404api_key你的密钥格式不对或漏空格报 401base_url漏/v1是最常见的错误——几乎所有平台都是/v1结尾。填错之后每次调用都报 404。验证你配对了跑hermes config看 Model 这一段输出◆ Model Model: {provider: custom:token.sensenova.cn, default: sensenova-6.8-flash-lite, base_url: https://token.sensenova.cn/v1}能看到你填的 provider 和 default 配置生效了。再跑一次实际调用hermes-msensenova-6.8-flash-lite你好报错对照错误码原因解决404base_url 填错检查末尾有没有/v1401API key 不对重新复制注意别带空格429被限流换个模型或等一会Timeout网络问题国内换 DeepSeek / OpenRouter多 provider 切换两种方式方式一命令行临时切换hermes--providercustom:token.sensenova.cn--modeldeepseek-v4-flash只影响当前会话下次启动恢复默认。方式二改 config.yaml 持久生效改model.provider和model.default两个字段model:provider:custom:token.sensenova.cndefault:deepseek-v4-flash保存后下次启动生效。方式生效范围适合场景命令行指定当前会话临时换模型试试效果改 config.yaml持久生效固定用一个模型内置 provider 和自定义 providerHermes 支持两类 provider内置的OpenAI、OpenRouter、Anthropic 等主流平台直接用 key 就能跑。◆ API Keys OpenRouter (not set) OpenAI (not set) Anthropic (not set)自定义的走custom_providers前面已经讲过任何 OpenAI 兼容的 API 都能配。两者的关系底层机制一样。OpenAI 格式的 API 就是 OpenAI 格式的 API——不管是商汤日日新、DeepSeek 官方还是你公司自建网关只要 endpoint 是/v1/chat/completions就能配。进阶模型自动降级fallback用单个模型最怕的就是它挂了或者被限流整个 Hermes 就停摆了。Hermes 有一个 fallback 机制——主模型挂了自动切到备选模型不用你手动干预。配置hermes fallbackadd选一个备选模型。之后行为是主模型限流429→ 自动切到 fallback主模型挂了connection error→ 自动切到 fallback主模型恢复 → 切回去查看当前降级链hermes fallback list什么时候值得配 fallback你用的是一个经常限流的免费模型比如商汤日日新的 glm-5.2 经常 429配一个备选是合理的。高阶让多个模型一起回答问题MoAHermes 还有一个 MoAMixture of Agents功能——同时问多个模型然后用一个模型做聚合输出比单模型质量更高。默认 preset 的设定1. openai-codex:gpt-5.5 ← 参考模型 2. openrouter:deepseek-v4-pro ← 参考模型 聚合openrouter:claude-opus-4.8 ← 聚合模型三个模型各答一遍Claude Opus 再做一个总结。效果确实不错但默认 preset 全是付费模型。想用免费模型的自定义 presethermes moa configure选两个参考模型 一个聚合模型。比如商汤日日新的两个模型 DeepSeek 免费档做聚合。这个功能属于高阶玩法先把基础配置跑通有余力再玩。避坑速查表症状原因解决配置里的名字和界面对不上custom:xxxvsxxx格式不同正常现象能对上就行界面下拉框找不到我的 providercustom_providers段没写检查 config.yaml界面显示 “not configured”API key 没填重新填 key配置改了没生效改的不是~/.hermes/config.yaml路径别搞错模型列表没更新本地缓存了旧列表跑hermes model --refresh作者简介码锅一个喜欢研究 AI 技术的程序员。CSDN 上写技术教程和概念科普分享深度实操和避坑指南。版权声明本文为作者原创本文为博主「Hermes Agent 实战系列」第 3 篇。转载需注明出处。系列导航[第 1 篇] 用 ChatGPT 两年了为什么我要自己装一个 AI Agent[第 2 篇] 从零装 Hermes Agent5 步搞定附完整配置代码第 3 篇Hermes 接入任意 AI 模型一文讲透 provider 配置 ←你在这里[第 4 篇] Hermes v0.20.5 正式版解析待发布[第 5 篇] Hermes v0.21 正式版变化待发布

相关新闻

金砖大赛软件测试规程:自动化测试能力认证实战指南

金砖大赛软件测试规程:自动化测试能力认证实战指南

1. 这不是一场普通比赛,而是一张软件测试能力的“国际通行证” 如果你最近在招聘平台刷过测试工程师岗位,大概率会看到类似这样的JD:“熟悉ISTQB测试理论体系,具备跨平台自动化测试框架搭建经验,有金砖国家或‘一带一路…

2026/10/24 11:22:15 阅读更多 →
大连地区有害生物消杀机构排行:资质与实效双维度评测

大连地区有害生物消杀机构排行:资质与实效双维度评测

大连地区有害生物防治机构实力排行实测盘点进入夏季后,大连及其周边城市的酒店、餐饮、仓储等场景有害生物活跃度大幅提升,专业防治服务的需求进入全年峰值。本次排行完全基于实地抽检、第三方资质核验及客户真实反馈,所有入选机构均具备合法…

2026/11/5 18:27:49 阅读更多 →
GuruCE与Lauterbach合作:嵌入式调试与无侵入覆盖率分析新范式

GuruCE与Lauterbach合作:嵌入式调试与无侵入覆盖率分析新范式

1. 为什么这条合作消息值得嵌入式开发者停下来看一眼 作为一名常年和MCU、SoC打交道的嵌入式工程师,我对Lauterbach这个名字再熟悉不过。TRACE32几乎就是高性能调试工具的代名词,尤其在汽车电子、航空航天这些对可靠性和实时性要求极高的领域&#xff0c…

2026/11/5 15:18:57 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/18 13:59:04 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/18 15:33:23 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/18 17:05:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/18 14:33:19 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/18 17:05:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/18 14:13:08 阅读更多 →

日新闻

周新闻

月新闻