配置 Hermes Agent

Hermes 的配置都集中在 ~/.hermes/。普通设置和密钥分开存，CLI 会自动把值写到正确位置，不建议手动到处改文件。

目录结构

核心目录如下：

~/.hermes/
├── config.yaml
├── .env
├── auth.json
├── SOUL.md
├── memories/
├── skills/
├── cron/
├── sessions/
└── logs/

config.yaml 存模型、终端后端、TTS、压缩、记忆限制、toolset 等非密钥配置。.env 存 API key、bot token、password 等 secret。auth.json 存 OAuth provider 凭据。SOUL.md 是 agent 主身份，会进入 system prompt 的靠前位置。

常用命令

hermes config
hermes config edit
hermes config set KEY VAL
hermes config check
hermes config migrate

示例：

hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...

hermes config set 会判断值的类型：API key 进入 .env，普通配置进入 config.yaml。

配置优先级

解析顺序从高到低：

1. CLI 参数，例如 hermes chat --model anthropic/claude-sonnet-4。
2. ~/.hermes/config.yaml。
3. ~/.hermes/.env。
4. 内置默认值。

规则很简单：secret 放 .env；模型、终端后端、压缩、记忆、工具开关放 config.yaml。非 secret 同时存在时，config.yaml 优先。

环境变量替换

config.yaml 支持 ${VAR_NAME}：

auxiliary:
  vision:
    api_key: ${GOOGLE_API_KEY}
    base_url: ${CUSTOM_VISION_URL}

delegation:
  api_key: ${DELEGATION_KEY}

多个变量可以拼在同一个值里，例如 url: "${HOST}:${PORT}"。未设置的变量会保留原样；裸 $VAR 不会展开。

终端后端

terminal.backend 决定 agent 的 shell 命令在哪里执行：

• local：直接在本机执行，适合个人开发。
• docker：容器隔离，适合安全沙箱和 CI。
• ssh：远程服务器执行，适合强隔离或远程硬件。
• modal、daytona、vercel_sandbox：云端沙箱。
• singularity：HPC / shared machine 场景。

最小配置：

terminal:
  backend: local
  cwd: "."
  timeout: 180

不确定时先用 local 跑通，再切到 Docker、SSH 或云沙箱。终端不可用时先跑 hermes doctor，再检查对应后端的依赖和环境变量。