可在Hermes Agent中零代码修改、不重启服务地调用OpenRouter超200模型，需依次完成：获取并安全保存OpenRouter密钥、通过.env注入密钥启用OpenRouter后端、在config.yaml或CLI中配置provider为openrouter、运行时用/model命令动态切换模型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在Hermes Agent里不用改代码、不重启服务，直接调用OpenRouter上200多个模型——比如从gemma-2-9b-it秒切到claude-3-haiku，或临时试跑google/gemma-3-27b-it，关键是要让密钥生效、路由通、模型名写对。
获取OpenRouter密钥并安全保存
密钥是调用OpenRouter模型的唯一凭证，生成后仅明文显示一次，漏复制就只能删旧建新。
1. 打开浏览器，访问 https://openrouter.ai/keys，用GitHub或邮箱登录账户。
2. 点击右上角“Create new key”，在弹窗中填写描述名（如“hermes-prod-2026”），勾选“Allow all models”。
3. 点击“Create key”，页面立即显示形如 【sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx】 的密钥字符串——必须立刻全选复制，关闭页面后明文永久消失。
4. 把密钥存进本地密码管理器或加密文本文件，绝不可截图、发聊天工具、提交到Git仓库。
通过.env文件注入密钥并启用OpenRouter后端
这是生产环境最稳妥的方式，避免密钥硬编码，且能被Hermes Agent自动加载。
1. 进入Hermes Agent项目根目录，执行 cd hermes-agent（若已在此目录可跳过）。
2. 创建或编辑 .env 文件：nano .env（或用VS Code打开）。
3. 写入两行，严格按格式（无空格、无引号、无注释）：
OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
OPENAI_BASE_URL=https://openrouter.ai/api/v1
4. 保存退出，确保项目已安装 python-dotenv：运行 pip3 install python-dotenv（若提示已存在则跳过）。
5. 检查启动脚本（如 main.py 或 run_agent.py）是否含 from dotenv import load_dotenv; load_dotenv() ——缺失会导致密钥读取失败。
配置config.yaml启用OpenRouter provider
不显式声明provider，Hermes Agent默认走本地模型或OpenAI兼容接口，不会识别OpenRouter路由。
方法一：直接修改配置文件
1. 找到配置文件路径，通常为 ~/.hermes/config.yaml 或项目根目录下的 config.yaml。
2. 在 llm: 节点下添加三行（注意YAML缩进，用空格不用Tab）：
provider: "openrouter"
base_url: "https://openrouter.ai/api/v1"
model: "google/gemma-2-9b-it"
3. 保存文件，确认无语法错误——多一个冒号、少一个空格都会导致Agent启动失败。
方法二：用CLI命令一键设置（推荐新手）
1. 终端执行 hermes config set llm.provider openrouter。
2. 执行 hermes config set llm.base_url https://openrouter.ai/api/v1。
3. 执行 hermes config set llm.model google/gemma-2-9b-it ——这条会覆盖默认模型，后续对话自动走OpenRouter。
运行时动态切换模型
配置完成≠固定死模型，Hermes Agent支持会话中实时换模型，无需改配置、不中断上下文。
第一步：启动Agent并进入交互模式
执行 hermes run 或直接输入 hermes，看到 hermes> 提示符即就绪。
第二步：查看当前模型与全部可用选项
输入 /model 并回车，屏幕列出当前激活模型（标有 →）和所有OpenRouter支持的模型ID。
第三步：选择目标模型
① 若模型在列表中：用 ↑↓ 键高亮，按 Enter 确认；
② 若需调用列表外模型（如 anthropic/claude-3.5-sonnet）：选 “Enter custom model name”，然后键入完整ID；
③ 若想快速指定：直接输入 /model openrouter/mistralai/mistral-7b-instruct 回车即生效。
第四步：验证调用成功
输入任意问题（如“你好，请用中文回答”），观察响应头是否含 X-Model-Used: mistralai/mistral-7b-instruct 类字段，或直接看回复风格是否匹配目标模型特征。
