hermes agent通过五种机制实现多环境配置管理：一、environments目录隔离；二、hermes_前缀环境变量动态覆盖；三、kustomize风格base+overlay配置叠加；四、cli profile保存完整配置集；五、git分支版本控制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在开发、测试与生产环境中运行Hermes Agent，但发现配置项混用或切换困难，则可能是由于缺乏统一的多环境配置管理机制。以下是解决此问题的步骤：
一、使用environments目录结构隔离配置
Hermes Agent项目原生支持基于目录的环境隔离机制，通过environments/子目录组织不同场景下的配置文件，避免硬编码与手动替换。每个环境对应独立YAML文件，由运行时自动加载。
1、进入项目根目录，确认存在environments/文件夹：
ls environments/
2、查看默认环境配置示例：
cat environments/default.yaml
3、为新环境创建专属目录与配置文件：
mkdir -p environments/staging && cp environments/default.yaml environments/staging/config.yaml
4、在启动Agent时显式指定环境：
hermes run --env staging
二、利用环境变量动态覆盖配置项
当需在不修改YAML文件的前提下临时调整参数（如API密钥、数据库地址），可通过操作系统环境变量实现运行时注入。Hermes Agent会优先读取以HERMES_为前缀的大写变量，并映射至对应配置路径。
1、导出环境变量并启动Agent：
export HERMES_DATABASE_URL="sqlite:///staging.db" && export HERMES_LLM_PROVIDER="openrouter" && hermes run
2、验证变量是否生效：
hermes config show | grep -E "(database|llm)"
3、将常用变量写入.env.staging文件，并通过dotenv加载：
pip install python-dotenv && python -c "from dotenv import load_dotenv; load_dotenv('.env.staging')"
三、启用Kustomize风格的配置叠加层
对于需要复用基础配置但仅差异化少量字段的场景，可采用Kustomize兼容的base+overlay模式。该方式无需模板引擎，直接通过YAML合并逻辑实现配置继承，适用于CI/CD流水线中标准化部署。
1、在environments/base/下存放通用配置：
mkdir -p environments/base && cp environments/default.yaml environments/base/base.yaml
2、为各环境创建overlay目录及patch文件：
mkdir -p environments/prod/overlays && echo "database:\n url: postgresql://prod-user@db:5432/hermes" > environments/prod/overlays/db-patch.yaml
3、使用Hermes内置配置合并工具生成最终配置：
hermes config merge --base environments/base/base.yaml --overlay environments/prod/overlays/ > environments/prod/final.yaml
4、运行时加载合并后配置：
hermes run --config environments/prod/final.yaml
四、通过CLI Profile管理多套完整配置集
Hermes Agent提供hermes profile子命令，支持保存、切换和导出命名配置集。每个Profile包含完整运行时上下文（模型、工具集、网关、存储等），适合开发者在本地快速切换调试目标。
1、保存当前配置为dev-profile：
hermes profile save dev --include-all
2、切换至staging-profile并覆盖部分参数：
hermes profile use staging --override llm.provider=anthropic --override gateway.type=telegram
3、列出所有已保存Profile：
hermes profile list
4、导出某Profile为独立YAML供团队共享：
hermes profile export staging > profiles/staging.yaml
五、结合Git分支进行配置版本控制
将不同环境的配置目录纳入Git版本管理，通过分支策略保障配置变更可追溯、可审计。例如：使用main分支托管生产配置，develop分支维护开发配置，release/*分支冻结发布快照。
1、为production环境新建分支：
git checkout -b release/v1.2.0-configs
2、仅提交environments/prod/及其依赖文件：
git add environments/prod/ && git commit -m "chore(config): pin prod config for v1.2.0"
3、在CI脚本中检出对应分支并加载配置：
git checkout release/v1.2.0-configs && hermes run --env prod
4、设置Git钩子防止敏感字段误提交：
echo "environments/**/.env" >> .gitignore && git update-index --skip-worktree environments/prod/.env
