优先填入.env文件：在~/.hermes/.env中添加openrouter_api_key=密钥；其次可写入config.yaml的llm.openrouter.api_key字段；也可通过export命令设为shell环境变量或docker -e参数注入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已获取 OpenRouter API 密钥，但不确定该密钥应填入 Hermes Agent 的哪个位置，则可能是由于 Hermes Agent 支持多种密钥注入方式，且不同配置路径具有优先级差异。以下是明确的填写位置与对应操作步骤：
一、环境变量文件 .env
这是 Hermes Agent 默认优先读取密钥的位置，适用于所有模型提供商（包括 OpenRouter），无需修改代码或 YAML 配置即可生效。
1、打开或创建 Hermes Agent 的全局环境变量文件，路径为 ~/.hermes/.env。
2、在该文件中新增一行，格式为：OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx（将等号后替换为您的实际密钥）。
3、保存文件，确保无多余空格或中文标点；若文件不存在，需手动创建。
4、重新启动 Hermes Agent 进程，使新环境变量被加载。
二、主配置文件 config.yaml
当需要显式指定 OpenRouter 作为 LLM 提供商并绑定密钥时，可直接在 YAML 配置中声明，该方式对多模型切换场景更清晰可控。
1、定位 Hermes Agent 主目录下的配置文件，通常为 config.yaml 或 agent_config.yaml。
2、在 llm: 节点下添加 openrouter: 子节，并嵌套 api_key: 字段。
3、完整示例片段如下（注意缩进必须为两个空格）：
llm:
openrouter:
api_key: "sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
4、保存文件后，重启 Hermes Agent 启动命令（如 python main.py）以触发配置重载。
三、系统级 Shell 环境变量
该方式适用于临时调试或容器化部署场景，密钥仅在当前终端会话或进程生命周期内有效，不写入持久化文件。
1、在运行 Hermes Agent 的终端中执行导出命令（Linux/macOS）：
export OPENROUTER_API_KEY="sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
2、若使用 Windows 命令提示符，执行：
set OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3、确认设置成功：输入 echo $OPENROUTER_API_KEY（Linux/macOS）或 echo %OPENROUTER_API_KEY%（Windows），应返回密钥明文。
4、在此终端中直接运行 Hermes Agent 启动命令。
四、启动命令行参数注入
部分部署脚本或封装工具支持通过 CLI 参数动态传入密钥，适用于 CI/CD 流水线或一次性测试任务。
1、检查 Hermes Agent 是否支持 --openrouter-api-key 参数（可通过 hermes --help 查看）。
2、若支持，运行命令时附加该参数：
hermes --openrouter-api-key "sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
3、若参数不被识别，说明当前版本未启用该 CLI 接口，应回退至前三种方式之一。
五、Docker 容器环境变量注入
当 Hermes Agent 以 Docker 容器方式运行时，密钥不可硬编码进镜像，须通过运行时环境变量注入。
1、启动容器时使用 -e 参数传递密钥：
docker run -e OPENROUTER_API_KEY="sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -p 8000:8000 hermes-agent
2、若使用 docker-compose.yml，应在 environment: 下添加键值对：
environment:
- OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3、确保 compose 文件版本 ≥ 3.8，且服务重启后变量生效。
