Hermes Agent的所有配置都存储在~/.hermes/目录下，设计理念是一个目录管理一切，方便备份、迁移和版本控制。

核心目录结构

~/.hermes/
├── config.yaml     # 主配置文件（模型、终端、TTS、压缩等）
├── .env            # API 密钥和敏感信息
├── auth.json       # OAuth 凭证（如 Nous Portal）
├── SOUL.md         # Agent 身份人格定义
├── memories/       # 持久记忆存储
├── skills/         # Agent 创建的技能
├── cron/           # 定时任务
├── sessions/       # Gateway 会话数据
└── logs/           # 日志文件（自动脱敏）

配置文件详解

config.yaml —— 主控制台

# 模型配置
model:
  default: "anthropic/claude-sonnet-4"

# 终端后端设置
terminal:
  backend: docker
  docker_volumes:
    - "/home/user/projects:/workspace/projects"  # 读写挂载
    - "/home/user/datasets:/data:ro"               # 只读挂载
    - "/home/user/.hermes/cache/documents:/output" # 导出目录

# 记忆系统
memory:
  memory_enabled: true
  user_profile_enabled: true
  memory_char_limit: 2200   # 约 800 tokens
  user_char_limit: 1375     # 约 500 tokens

# 上下文压缩
compression:
  enabled: true
  threshold: 0.50   # 达到上下文 50% 时压缩
  target_ratio: 0.20
  protect_last_n: 20

# 推理深度控制
agent:
  reasoning_effort: "medium"  # none, minimal, low, medium, high, xhigh

.env —— 密钥保险箱

# 设置文件权限（重要！）
chmod 600 ~/.hermes/.env

# 示例内容
ANTHROPIC_API_KEY=sk-ant-xxxxx
OPENAI_API_KEY=sk-xxxxx
DISCORD_BOT_TOKEN=xxxxx

SOUL.md —— 给Agent注入灵魂

SOUL.md是Hermes的人格定义文件，位于系统提示的第一位，完全替代默认身份：

你是 Hermes，一位专业的 AI 编程助手。

## 性格特征
- 专业但不失幽默
- 注重代码质量和最佳实践
- 擅长解释复杂概念

## 专业领域
- Python / JavaScript / Rust
- 系统架构设计
- DevOps 自动化

记忆系统：memories/

参数	默认值	说明
memory_enabled	true	启用记忆系统
user_profile_enabled	true	启用用户画像
memory_char_limit	2200	记忆上限（~800 tokens）
user_char_limit	1375	用户画像上限（~500 tokens）

目录挂载与工作空间

terminal:
  backend: docker
  docker_volumes:
    - "/home/user/datasets:/data:ro"                    # 提供数据集
    - "/home/user/projects:/workspace/projects"         # 共享工作目录
    - "/home/user/.hermes/cache/documents:/output"       # 导出目录

定时任务：cron/

cron/
├── daily_report.yaml    # 每日报告
├── weekly_backup.yaml   # 每周备份
└── health_check.yaml    # 健康检查

配合消息平台的HOME_CHANNEL功能，定时任务结果可自动推送到指定频道。

日志管理

logs/
├── errors.log   # 错误日志
└── gateway.log  # Gateway 运行日志

🔒 日志中的API密钥、Token等敏感信息会被自动替换为***

安全最佳实践

措施	操作	说明
保护密钥文件	chmod 600 ~/.hermes/.env	防止未授权读取
分离密钥存储	不同服务用不同密钥	降低泄露风险
定期审计日志	检查logs/目录	发现异常访问
使用DM配对码	替代硬编码用户ID	更安全的授权方式

速查表

文件/目录	用途
config.yaml	主配置文件
.env	API密钥和敏感信息
auth.json	OAuth认证凭证
SOUL.md	Agent人格定义
memories/	持久记忆存储
skills/	Agent自创建技能
cron/	定时任务定义
logs/	运行日志

进阶技巧

• 备份整个目录：直接复制~/.hermes/即可完整备份配置、记忆和技能
• 多环境切换：使用Profile功能，每个配置独立目录
• 版本控制：将config.yaml和SOUL.md加入Git管理
• 上下文文件优先级：.hermes.md → AGENTS.md → CLAUDE.md → .cursorrules（先匹配生效）