可通过四步实现Hermes Agent接入OpenRouter降本：一、配置OpenRouter为默认提供商并设免费模型；二、按任务类型动态绑定专属模型；三、启用自动降级至备用免费模型；四、用环境变量隔离多账号计费。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用 Hermes Agent，但希望降低模型调用成本，OpenRouter 提供了丰富的免费与低价模型选项，可直接替换高成本 API 服务商。以下是实现 OpenRouter 模型切换并控制成本的具体方案：
一、配置 OpenRouter 为默认模型提供商
通过修改 Hermes Agent 的全局模型配置，将所有请求路由至 OpenRouter，利用其按调用量计费及部分模型永久免费的特性，显著压降支出。
1、确保已注册 OpenRouter 账户并获取 API Key（官网 https://openrouter.ai/keys）。
2、在终端中执行配置命令：
hermes config set model.provider openrouter
3、设置默认模型为免费额度可用型号：
hermes config set model.model meta-llama/llama-3.1-8b-instruct:free
4、验证配置是否生效：
hermes config get model
二、按任务类型动态指定 OpenRouter 模型
Hermes Agent 支持多上下文模型路由，可在不同任务场景中绑定专属 OpenRouter 模型，在保障效果前提下避免统一使用高价模型。
1、编辑配置文件 ~/.hermes/config.yaml，添加分场景模型定义：
2、在 default 区块保留轻量免费模型用于日常交互；
3、在 coding 区块指定 coder-specialized 免费模型如 google/gemma-2-9b-it:free；
4、在 complex 区块启用需付费但性能更强的模型（如 anthropic/claude-3.5-sonnet），并配合 --max-cost $0.02 参数限制单次推理预算。
三、启用 OpenRouter 模型自动降级策略
当所选模型不可用或触发配额限制时，Hermes Agent 可自动回退至备用免费模型，保障服务连续性且不产生额外费用。
1、在配置文件中启用 fallback 功能：
model:
fallback: true
2、定义主备模型链：
primary: meta-llama/llama-3.1-70b-instruct
secondary: qwen/qwen-2.5-7b-instruct:free
3、确认 secondary 模型确属 OpenRouter 免费列表内型号（可通过 curl -H "Authorization: Bearer YOUR_KEY" https://openrouter.ai/api/v1/models 查询实时状态）。
四、结合环境变量实现多账号 OpenRouter 切换
针对测试、开发、生产等不同环境，可分别绑定独立 OpenRouter 账号密钥，复用同一套 Hermes 配置实现隔离计费与额度管理。
1、为开发环境创建专用 API Key 并保存至环境变量：
export HERMES_OPENROUTER_DEV_KEY="sk-or-v1-xxxdev"
2、在启动命令中注入该变量：
HERMES_OPENROUTER_KEY=$HERMES_OPENROUTER_DEV_KEY hermes serve
3、配置文件中模型 provider 保持为 openrouter，无需硬编码密钥；
4、生产环境切换时仅需替换环境变量值并重启服务，全程不修改配置文件。
