hermes agent模型调用失败或api认证错误，通常因.env文件未正确配置或未被识别。该文件需存于指定路径、设严格权限、按标准命名规则填写密钥（如openai_api_key=sk-xxx），且多模型共存时须为每个provider提供独立有效变量，最后通过hermes config test验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装 Hermes Agent，但模型调用失败或提示 API 认证错误，则很可能是 .env 文件未正确配置或未被识别。以下是针对 .env 文件的详细配置说明与操作步骤：
一、.env 文件的作用与安全机制
.env 文件是 Hermes Agent 专门用于存储敏感凭证的环境变量文件，所有 API Key 均不应明文写入 config.yaml，而应通过该文件集中管理。Hermes 在运行时会自动加载此文件中的键值对，并根据 config.yaml 中指定的模型 provider 名称（如 openai、anthropic）匹配对应变量名（如 OPENAI_API_KEY），从而完成认证。
1、该文件默认位于 ~/.hermes/.env（Linux/macOS）或 C:\Users\用户名\AppData\Local\hermes\.env（Windows）。
2、文件权限需设为仅当前用户可读写，避免其他进程或用户意外访问。
3、Hermes 不会将 .env 文件内容输出到日志或调试信息中，保障密钥不外泄。
二、标准变量命名规则与填写格式
每个模型提供商对应一组预定义的环境变量名，必须严格按大小写和下划线书写，否则 Hermes 将无法匹配。变量值不可包含空格或引号，末尾不得有注释符号 #。
1、OpenAI 模型必须使用 OPENAI_API_KEY 变量名，值为完整密钥字符串（如 sk-xxx）。
2、Anthropic 模型必须使用 ANTHROPIC_API_KEY，值为以 sk-ant- 开头的密钥。
3、MiniMax 模型需同时设置 MINIMAX_API_KEY 和 MINIMAX_GROUP_ID，二者缺一不可。
4、OpenRouter 模型使用 OPENROUTER_API_KEY，且需确保 config.yaml 中 model.default 的 provider 部分设为 openrouter。
三、手动创建与验证 .env 文件的步骤
若 ~/.hermes/.env 不存在，需手动创建并赋予正确内容。创建后必须重启 Hermes 进程或终端会话，使新变量生效。
1、打开终端，执行命令进入配置目录：cd ~/.hermes（Linux/macOS）或在 Windows PowerShell 中执行 Set-Location "$env:LOCALAPPDATA\hermes"。
2、使用文本编辑器新建 .env 文件：nano .env（Linux/macOS）或 notepad .env（Windows）。
3、按实际使用的模型提供商，逐行输入对应变量（示例为 OpenAI + MiniMax 组合）：
OPENAI_API_KEY=sk-prod-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
MINIMAX_API_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
MINIMAX_GROUP_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
4、保存文件并退出编辑器（nano 中按 Ctrl+O 回车，Ctrl+X 退出；记事本中点击“文件→保存”）。
5、在终端中执行 hermes config test 命令，检查是否能成功调用已配置的模型。
四、多模型共存时的变量隔离策略
当 config.yaml 中同时启用多个模型（如主模型为 openai/gpt-4o，fallback 为 minimax/abab6.5s）时，.env 文件中必须为每个 provider 提供独立且有效的变量，否则 fallback 机制将跳过失效项直接报错。
1、所有变量名必须唯一，禁止重复定义同一变量（如两次写 OPENAI_API_KEY）。
2、若某模型暂时不用，可在对应行前加 # 注释掉，而非删除整行，便于后续快速启用。
3、变量值中禁止使用中文字符、全角符号、制表符或换行符，仅允许 ASCII 字符与连字符、下划线、数字、字母。
4、对于自定义 provider（如 majiabin），需在 .env 中定义其专属变量名（如 MAJIABIN_API_KEY），并在 config.yaml 的 model.provider 或 providers 列表中显式引用该变量名。
