需完成openrouter密钥配置才能在hermes agent中调用其模型服务，包括：一、登录openrouter.ai/keys创建并保存api密钥；二、通过export命令设置openrouter_api_key环境变量并持久化；三、修改config.yaml中llm配置为provider: "openrouter"、base_url和model；四、发起测试请求验证http 200响应及choices字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Hermes Agent中接入OpenRouter提供的多模型服务，但尚未完成密钥配置，则无法触发模型调用请求。以下是完成OpenRouter密钥配置的具体步骤：
一、获取OpenRouter API密钥
OpenRouter要求用户登录后生成专属API密钥，该密钥是后续所有请求的身份凭证，必须妥善保管且不可泄露。
1、访问 https://openrouter.ai/keys 并使用邮箱或GitHub账号登录。
2、点击页面右上角的 “Create new key” 按钮。
3、在弹出框中为密钥填写描述名称（如“Hermes-Agent-Prod”），然后点击 “Create key”。
4、页面将显示新生成的密钥字符串，此时需立即复制并保存至安全位置——刷新后将无法再次查看明文。
二、在Hermes Agent中设置环境变量
Hermes Agent通过读取系统级环境变量识别OpenRouter密钥，不支持界面内手动输入，必须通过终端或配置文件注入。
1、打开Hermes Agent运行所在机器的终端（Linux/macOS）或命令提示符（Windows）。
2、执行命令设置临时环境变量：export OPENROUTER_API_KEY="sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"（将引号内替换为实际密钥）。
3、若需持久化生效，将上述命令追加至对应Shell配置文件（如Linux/macOS的 ~/.bashrc 或 ~/.zshrc，Windows的系统环境变量面板）。
4、重新启动Hermes Agent服务进程，确保新环境变量被加载。
三、修改Hermes Agent配置文件
Hermes Agent默认不启用OpenRouter后端，需显式指定模型路由地址与认证方式，否则仍会尝试调用本地模型。
1、定位Hermes Agent主目录下的配置文件，通常为 config.yaml 或 settings.json。
2、在 llm 配置节下添加或修改字段：provider: "openrouter"。
3、补充 base_url: "https://openrouter.ai/api/v1" 和 model: "google/gemma-2-9b-it"（可选任意OpenRouter支持的免费模型ID）。
4、保存文件，确认缩进格式符合YAML/JSON规范，避免解析失败。
四、验证密钥连通性
配置完成后需发起一次最小化请求，验证密钥是否被正确传递、OpenRouter接口是否响应成功，排除网络或权限问题。
1、在Hermes Agent控制台或调试界面发起一条简单指令，例如：“返回‘test’二字”。
2、观察日志输出中是否出现 HTTP 200 OK 及含 "openrouter.ai" 的请求URL。
3、检查响应体是否包含非空 "choices" 字段及有效文本内容。
4、若返回 401 Unauthorized，说明密钥未生效或已失效；若返回 403 Forbidden，需确认账户余额是否为零或模型访问权限受限。
