Hermes Agent 多模型切换需启用 OpenRouter 后端：先在 openrouter.ai 创建并安全保存 API 密钥，再通过环境变量 OPENROUTER_API_KEY 注入，接着在 config.yaml 中配置 provider: "openrouter"、base_url 和 model，最后用 hermes run --model 命令动态切换。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在 Hermes Agent 中灵活调用不同大模型，但当前仅绑定单一本地或厂商模型，则可能是由于 OpenRouter 后端未启用或密钥未正确注入。以下是实现多模型自由切换的完整配置路径：
一、获取并安全存储 OpenRouter API 密钥
OpenRouter 要求每个请求携带有效 API 密钥作为身份凭证，该密钥是访问其 200+ 模型的唯一入口，必须通过官方渠道生成并离线保存。
1、访问 https://openrouter.ai/keys 并使用邮箱或 GitHub 账号登录。
2、点击页面右上角的 “Create new key” 按钮。
3、在弹出框中为密钥填写描述名称（如 “Hermes-Prod-OpenRouter”），然后点击 “Create key”。
4、页面立即显示新生成的密钥字符串，此时需 立即复制并存入本地加密文件或密码管理器——刷新后明文将永久不可见。
二、注入密钥至 Hermes Agent 运行环境
Hermes Agent 仅从系统级环境变量读取 OPENROUTER_API_KEY，不支持运行时界面输入或交互式设置，必须确保进程启动前变量已加载。
1、打开终端（Linux/macOS）或命令提示符（Windows WSL2），确认当前用户为 Hermes Agent 所在用户。
2、执行临时注入命令：export OPENROUTER_API_KEY="sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"（引号内替换为实际密钥）。
3、若需长期生效，将上述命令追加至对应 Shell 初始化文件：~/.zshrc（macOS/Linux Zsh） 或 ~/.bashrc（Linux Bash）；Windows 用户需在系统环境变量面板中新增用户变量。
4、执行 source ~/.zshrc（或对应文件）使配置即时生效，并验证变量存在：echo $OPENROUTER_API_KEY 应返回密钥前缀。
三、显式启用 OpenRouter 后端并指定模型路由
Hermes Agent 默认禁用所有外部模型提供商，必须手动修改配置文件以覆盖默认 LLM 行为，否则仍会回退至本地模型或报错。
1、定位主配置文件，路径通常为 ~/.hermes/config.yaml 或 ./config.yaml（取决于启动方式）。
2、在 llm: 配置节下添加或修改字段：provider: "openrouter"。
3、在同一层级补充两项必要参数：base_url: "https://openrouter.ai/api/v1" 和 model: "anthropic/claude-3-haiku"（可任选 OpenRouter 免费列表中的模型 ID）。
4、保存文件，使用 yamllint config.yaml 检查缩进与语法，避免因空格错误导致解析失败。
四、通过命令行动态切换模型
Hermes Agent 支持运行时模型热切换，无需重启服务或修改配置文件，适用于 A/B 测试、任务适配等场景。
1、在任意终端会话中，直接执行：hermes run --model google/gemma-2-9b-it（调用 Gemma 2）。
2、发起另一轮对话时，切换为图像理解模型：hermes run --model black-forest-labs/flux-schnell。
3、若需全局默认模型，编辑 ~/.hermes/.env 文件，在末尾追加 HERMES_DEFAULT_MODEL=meta-llama/llama-3.1-8b-instruct。
五、验证模型切换连通性与响应一致性
配置完成后必须执行最小化端到端请求，确认密钥传递、模型路由、HTTP 状态码及响应格式均符合预期，排除网络拦截或权限拒绝问题。
1、运行诊断命令：hermes doctor --check openrouter，观察输出中是否包含 "OpenRouter: OK" 标识。
2、手动触发一次短文本请求：hermes chat "Hello, what model are you?" --model anthropic/claude-3-haiku。
3、检查终端返回内容是否含明确模型标识（如 "I am Claude 3 Haiku"），且无 401 Unauthorized 或 404 Not Found 错误。
