hermes agent模型调用失败时，应优先检查环境变量配置：可通过shell临时导出、系统级永久配置、.env文件（推荐）、windows powershell用户级设置或docker compose注入五种方式正确设置openai_api_key等关键变量。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装 Hermes Agent，但模型调用失败或配置未生效，则可能是由于环境变量未正确设置。以下是使用环境变量对 Hermes Agent 进行配置的具体操作步骤：
一、通过 shell 环境变量临时配置
该方式适用于快速测试或单次会话调试，变量仅在当前终端会话中有效，关闭终端后失效。
1、打开终端（Linux/macOS）或 PowerShell（Windows WSL2）
2、执行以下命令导出 OpenAI API Key（请将 sk-xxxxxxxxxxxxxxxxxxxxxxxx 替换为您的实际密钥）：
export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
3、可选：同时指定模型名称，例如 gpt-4o：
export OPENAI_MODEL="gpt-4o"
4、启动 Hermes Agent CLI：
hermes
二、通过系统级环境变量永久配置
该方式确保每次新打开终端时自动加载配置，适用于日常稳定使用场景。
1、确认当前 shell 类型（Bash 或 Zsh）：
echo $SHELL
2、编辑对应配置文件：
若为 Bash：vi ~/.bashrc
若为 Zsh：vi ~/.zshrc
3、在文件末尾添加以下两行（替换为您的真实密钥）：
export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
export OPENAI_MODEL="gpt-4o"
4、使配置立即生效：
source ~/.bashrc
或
source ~/.zshrc
5、验证是否设置成功：
echo $OPENAI_API_KEY
三、通过 .env 文件配置（推荐用于多模型切换）
该方式与代码逻辑解耦，便于在不同项目或模型供应商间切换，Hermes Agent 启动时会自动读取根目录下的 .env 文件。
1、进入 Hermes Agent 项目根目录（如 ~/hermes-agent）
2、复制示例配置文件：
cp .env.example .env
3、编辑 .env 文件：
vi .env
4、取消注释并填写对应字段，例如启用 OpenAI：
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
OPENAI_MODEL=gpt-4o
5、若需使用 Minimax 国内模型，可填写：
MINIMAX_CN_API_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
6、保存退出后直接运行 hermes 即可生效
四、Windows PowerShell 全局环境变量配置
该方式适用于 Windows 原生环境或 WSL2 外部调用，确保 Hermes 安装脚本及 gateway 子命令均能识别变量。
1、以管理员身份打开 PowerShell
2、执行以下命令设置用户级环境变量：
[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', 'sk-xxxxxxxxxxxxxxxxxxxxxxxx', 'User')
3、同样设置模型名：
[System.Environment]::SetEnvironmentVariable('OPENAI_MODEL', 'gpt-4o', 'User')
4、重启所有 PowerShell 窗口
5、验证设置：
$env:OPENAI_API_KEY
五、Docker Compose 环境中注入变量
该方式适用于容器化部署，避免将密钥硬编码进镜像，保障安全性。
1、确保 docker-compose.yml 中 services.hermes-agent.environment 下已声明变量名：
environment:
- OPENAI_API_KEY
- OPENAI_MODEL
2、在宿主机执行 export 命令预先加载：
export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
export OPENAI_MODEL="gpt-4o"
3、启动服务：
docker-compose up -d
4、检查容器内变量是否注入成功：
docker exec -it hermes-agent printenv | grep OPENAI
