Hermes Agent 配置模型

Hermes 是模型无关的:同一套智能体能力,可以跑在不同的 LLM 之上。本章讲清如何接入与切换模型。


支持的 Provider

Provider说明接入方式
Nous PortalNous 官方门户,含工具网关(搜索/绘图/TTS/云浏览器)OAuth 登录
OpenRouter聚合 200+ 模型API Key
OpenAIGPT 系列API Key
AnthropicClaude 系列API Key
本地 vLLM自托管开源模型本地端点
自定义端点任意 OpenAI 兼容 APIBase URL + Key

此外还支持 NVIDIA NIM(Nemotron)、Xiaomi MiMo、z.ai/GLM、Kimi/Moonshot、MiniMax、Hugging Face 等。


交互式选择模型

最简单的方式是运行:

hermes model

它会列出可用 Provider 与模型,按提示选择并填入凭据即可。

在对话中也可随时切换:

/model openrouter:nous:hermes-3-405b

/model 不带参数会列出可选项。


配置文件方式

模型配置最终落在 ~/.hermes/config.yaml。一个最简示例:

provider: openrouter
model: nous:hermes-3-405b

也可以用命令行直接设置:

hermes config set provider openrouter
hermes config set model nous:hermes-3-405b

凭据与环境变量

API Key 等敏感信息可放在 .env 文件或 Shell 环境变量中,Hermes 会自动读取:

# ~/.hermes/.env 或当前 Shell
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
OPENROUTER_API_KEY=sk-or-...

安全提示:不要把密钥提交到 Git。~/.hermes/ 应保持私有权限。


三种典型接入方式

1)Nous Portal(最省心)

OAuth 一键登录,附带官方工具网关(Web 搜索、图像生成、TTS、云浏览器)在同一订阅下可用:

hermes setup        # 向导中选择 Nous Portal 并完成 OAuth
hermes portal info  # 查看当前 Portal 配置

2)OpenRouter(模型最多)

一个 API Key 即可访问 200+ 模型,适合做模型对比与成本优化:

hermes config set provider openrouter
# 在 .env 中放入 OPENROUTER_API_KEY
hermes model        # 选择具体模型

3)本地 vLLM(隐私最强)

把开源模型部署在自己的 GPU 上,数据与推理全程不出本地网络:

provider: openai            # 走 OpenAI 兼容协议
base_url: http://localhost:8000/v1
model: NousResearch/Hermes-3-Llama-3.1-405B

模型选择建议

目标建议
上手体验 / 全家桶Nous Portal(含工具网关)
频繁对比 / 控成本OpenRouter,按任务切换模型
隐私 / 合规本地 vLLM 自托管
强工具调用任务原生支持工具调用的强模型
省钱的后台/定时任务给 Cron 任务配较便宜的模型

由于 Hermes 内置 11 种工具解析器,即便不同模型输出工具调用的格式不同,也能较好兼容。但工具密集型任务仍建议使用工具调用能力强的模型。


下一步