配置文件根目录

完整目录结构

~/.hermes/
├── config.yaml          # 主配置文件（模型、工具、安全策略、网关等）
├── .env                 # 环境变量（API Key 等敏感信息）
├── auth.json            # OAuth 登录凭证
├── SOUL.md              # Agent 人格定义（系统提示核心）
├── memories/            # 持久记忆
│   ├── MEMORY.md        # 系统推断的核心事实记忆
│   ├── USER.md          # 用户指定的长期偏好
│   └── daily-log/       # 每日会话日志（按日期命名）
├── skills/              # 自动创建的技能
├── sessions/            # 会话持久化数据（SQLite）
└── logs/                # 运行日志

核心配置文件说明

config.yaml（主配置）

YAML 格式，是 Hermes Agent 的核心配置文件，顶层必须包含以下一级键：

model:        # 模型选择（如 openai/gpt-4o、kimi/k2、deepseek/v4）
tools:        # 工具调用权限（默认全禁用，须显式设 true 启用）
security:     # 安全策略（敏感词拦截、输出长度限制）
memory:       # 记忆持久化策略
gateway:      # 消息网关配置（飞书/微信/钉钉等平台接入）

注意：YAML 格式必须用空格缩进，不能用 Tab，文件需 UTF-8 编码。缺失任一必要区块可能导致 Agent 启动失败或能力降级。

.env（环境变量）

存放 API Key 等敏感信息，与 config.yaml 分离，便于备份和版本控制时忽略。

SOUL.md（人格定义）

Agent 的系统提示核心，定义 Agent 的行为风格、价值观和交互方式。

你当前环境的路径

你是 Windows 系统，对应的配置目录为：

C:\Users\Administrator\AppData\Local\hermes\

主配置文件完整路径：

C:\Users\Administrator\AppData\Local\hermes\config.yaml