零成本调用hermesagent高性能大模型需正确配置openrouter免费后端，可通过三种方式实现：一、.env注入密钥；二、config.yaml显式声明；三、hermes config set命令动态写入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在HermesAgent中零成本调用高性能大模型，但当前仍受限于本地算力或付费API门槛，则可能是由于OpenRouter免费模型后端未正确配置。以下是实现零成本体验AI智能体的三种独立可行路径：
一、通过.env环境变量注入OpenRouter密钥
该方式将密钥作为进程级环境变量传递，HermesAgent启动时自动读取并构造Authorization请求头，避免密钥硬编码于源码中，兼顾安全性与部署便捷性。
1、访问https://www.php.cn/link/42e1c072773f59e53d4cfa02d398c552，使用GitHub或邮箱登录账户。
2、点击右上角“Create new key”，在弹窗中输入描述名称（例如：hermes-free-tier），勾选“Allow all models”选项。
3、点击“Create key”后立即复制生成的密钥字符串（格式为sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx），该明文仅显示一次。
4、进入HermesAgent项目根目录，创建或编辑.env文件，在其中新增一行：OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx（注意：等号前后无空格，末尾无分号，不可含中文标点）。
5、在终端执行source .env（Linux/macOS）或set -a && source .env && set +a（确保子shell继承变量）。
二、在config.yaml中显式声明OpenRouter后端参数
该方式绕过环境变量依赖，直接在YAML配置文件中定义provider类型、基础地址与模型标识，适用于容器化部署或权限受限场景，确保配置与代码共存且可版本控制。
1、定位HermesAgent主配置文件，路径通常为./config.yaml或~/.hermes/config.yaml。
2、在llm:节点下添加以下完整结构（保持严格YAML缩进）：
provider: "openrouter"
base_url: "https://openrouter.ai/api/v1"
model: "google/gemma-2-9b-it"
3、确认所填model值确属OpenRouter官网https://www.php.cn/link/f0b2ec2a73b80edd3b7f6367cbb5b71d中标记为“Free”的模型ID，例如google/gemma-2-9b-it、mistral/mistral-7b-instruct或nousresearch/hermes-2-pro-mistral-7b。
4、保存文件后，检查YAML语法是否合法，可使用在线YAML验证器排除缩进错误导致的解析失败。
三、使用hermes config set命令动态写入配置
该方式调用HermesAgent内置CLI工具，自动识别配置存储位置并将密钥与模型参数分别写入~/.hermes/.env和~/.hermes/config.yaml，无需手动编辑文件，适合新手快速完成初始化。
1、确保已安装HermesAgent CLI，运行hermes --version验证版本不低于1.1。
2、执行密钥写入命令：hermes config set openrouter.api_key sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx（将x替换为实际密钥）。
3、执行模型指定命令：hermes config set llm.model google/gemma-2-9b-it。
4、执行后端启用命令：hermes config set llm.provider openrouter。
5、验证配置生效：运行hermes config get llm.provider应返回openrouter，且hermes config get llm.model返回对应免费模型ID。
