配置与优先级

~/.hermes 目录、config.yaml 与 .env 的分工、配置优先级、hermes config 命令，以及终端后端、压缩、预算等常用配置项。

所有设置都存放在 ~/.hermes/：config.yaml（模型、终端、TTS、压缩等设置）、.env（API Key 与秘密）、auth.json（Nous Portal 等的 OAuth 凭证）、SOUL.md 等。管理命令：

hermes config              # 查看当前配置
hermes config edit         # 在编辑器里打开 config.yaml
hermes config get KEY      # 打印解析后的值
hermes config set KEY VAL  # 设置值（自动路由到正确的文件）

优先级（从高到低）：命令行参数（如 hermes chat --model …，单次调用覆盖）→ ~/.hermes/config.yaml（所有非秘密设置的主文件）→ ~/.hermes/.env（环境变量回退，秘密必须放这里）→ 内置默认值。经验法则：秘密（API Key、机器人令牌、密码）放 .env，其余（模型、终端后端、压缩、记忆限额、工具集）放 config.yaml；两者都设了时，非秘密设置以 config.yaml 为准。组织部署时管理员可通过系统级托管目录固定某些配置和秘密值，普通用户无法覆盖。配置值支持环境变量替换。

常用配置段：运行时限制；终端后端——terminal.backend 取 local、docker、ssh、modal、daytona、vercel_sandbox、singularity 七种之一，决定智能体的 shell 命令实际在哪里执行；terminal.temp_dir 控制本地后端会话临时产物位置（默认放在 ~/.hermes/cache/terminal 而不是可能很小的内存 /tmp，闲置 24 小时后自动清理；hermes doctor 会报告其大小）；技能设置；记忆配置；上下文文件截断与文件读取安全；工具输出截断限制；Git worktree 隔离；上下文压缩；迭代预算与挂钟时间预算；Verify-on-Stop（编码验证）；常驻目标（/goal）；凭证池策略；提示缓存（Claude 在原生 Anthropic、OpenRouter、Nous Portal 上默认带跨会话 1 小时前缀缓存）；辅助模型（视觉、压缩等）；推理强度与 Fast 模式；工具使用强制与工具循环护栏；TTS/STT/语音模式；流式输出；显示设置；隐私；群聊会话隔离；未授权私信行为；时区；Discord 等平台；安全。具体键名与默认值以官方 Configuration 页为准。