Hermes Agent 支持五种模型切换方式:①会话内用 /model 命令即时切换,仅限已配置模型;②终端执行 hermes model 向导添加/更新 Provider 及密钥;③修改 config.yaml 或用 hermes config set 永久设默认模型;④通过环境变量或 --model 参数临时覆盖启动配置;⑤桌面版 GUI 下拉菜单一键切换。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想在 Hermes Agent 里快速换模型,不用重启、不改配置、不重装,只要几秒就能从 OpenAI 切到 OpenRouter 或本地 Ollama,日常调试、多模型对比、临时验证都够用。
会话内即时切换:/model 命令
这一步操作起来很简单,直接在对话框里输入斜杠指令就行。
输入 /model 回车,会列出当前已配置的所有模型 ID;若已知模型名(如 openai/gpt-4o 或 openrouter/anthropic/claude-3.5-sonnet),可直接输入 /model openai/gpt-4o 并回车,当前会话立即生效。
注意:该命令仅作用于当前会话,退出后自动还原为默认模型;无法切换未配置过的 Provider,比如没跑过 hermes model 添加 OpenRouter,就搜不到它的模型。
终端一键切换:hermes model 向导
这是首次接入新厂商或批量更新密钥的唯一可靠路径,必须在 Hermes 会话外运行——如果正开着聊天窗口,先输入 /quit 退出。
第一步:打开终端,执行 hermes model;
第二步:用方向键选择目标提供商(OpenRouter / OpenAI / Anthropic / Tencent Hy3 等);
第三步:粘贴对应 API Key(OpenRouter 是 sk-or-v1-xxx,OpenAI 是 sk-proj-xxx),回车确认;
第四步:从该 Provider 的模型列表中选一个,默认会写入 config.yaml 的 model.default 字段;
最后看到 Model provider updated successfully 提示即完成。此操作会同时校验密钥有效性,失败时会明确报错并中断流程。
永久设默认模型:改 config.yaml 或用命令
Linux/macOS 路径是 ~/.hermes/config.yaml,Windows 是 C:\Users\{用户名}\AppData\Local\hermes\config.yaml。
统一LLM网关 - 一个API对接70+AI模型,使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
用文本编辑器打开,找到 model: 区块下的 default: 行,把右边值改成目标模型 ID,例如 default: "google/gemma-2-9b-it";
保存文件后,必须重启 Hermes 服务才能生效——不重启,配置不会加载。
更稳妥的方式是终端执行:hermes config set model.default google/gemma-2-9b-it,它会自动校验 YAML 格式并重载配置,比手动编辑少出错。
临时覆盖启动参数:环境变量或 --model
适合脚本调用或 CI 流水线,完全不碰配置文件。
方法一:设置环境变量(Linux/macOS):export OPENAI_API_KEY="sk-proj-xxx" && export OPENAI_MODEL="gpt-4o" && hermes run;
方法二:Windows PowerShell:$env:OPENAI_API_KEY="sk-proj-xxx"; $env:OPENAI_MODEL="gpt-4o"; hermes run;
方法三:直接指定模型启动:hermes run --model openrouter/anthropic/claude-3.5-sonnet,该参数优先级最高,会跳过 config.yaml 中所有模型配置。
GUI 用户专用:桌面版下拉菜单
打开 Hermes Desktop 应用,在对话界面底部状态栏或右侧模型选择器点击下拉箭头;
滚动查找或直接输入模型 ID(如 tencent/hy3)筛选;
选中后当前会话立刻切换,无需输入命令——但该操作不会修改默认配置,关闭窗口后下次仍用原默认模型。

















