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。
该技能指导用户根据设计灵感创建视觉情绪板。它提供分步说明，用于提取颜色、排版和UI模式，并将其组织成文档化的设计方向。工作流程包括根据用户反馈进行迭代优化，最终形成可供实施的设计系统。
用文本编辑器打开，找到 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）筛选；
选中后当前会话立刻切换，无需输入命令——但该操作不会修改默认配置，关闭窗口后下次仍用原默认模型。
