配置 Hermes
Last updated on
先完成最小可用配置，理清 config.yaml、.env、provider 和 model 的关系。先跑通首次接入，再补进阶能力。
这一页先只做最小可用配置
Hermes 的配置能力很多，但第一次接入时，你不需要一次把所有功能都配完。
这一页只先解决 4 件事：
- 知道 Hermes 的配置文件主要放在哪里
- 分清哪些内容该写进
config.yaml - 分清哪些敏感信息更适合放进
.env - 完成第一次可用的 provider 和 model 设置
先理解 Hermes 的配置文件结构
根据官方配置文档，Hermes 的用户级配置目录在：
~/.hermes/其中第一次接入最重要的是这三个文件：
~/.hermes/config.yaml：放普通配置~/.hermes/.env：放 API Key 等敏感信息~/.hermes/auth.json：放 OAuth 登录类 provider 的认证信息
第一次接入，只要先把这几个位置认清就够了
其他像 SOUL.md、记忆、技能这些内容，等你主线跑通后再慢慢理解，不需要一开始全看完。
先分清 config.yaml 和 .env 各自放什么
2. API Key 这类敏感信息优先放进 .env
官方文档给出的建议很明确：
- 密钥放
.env - 普通设置放
config.yaml - 像 Nous Portal 这类交互式登录拿到的 OAuth 凭据，会写进
auth.json
这样做的好处是：
- 配置结构更清晰
- 敏感信息不会和普通设置混在一起
- 后面切换 provider 时更容易排查问题
3. 先知道一个容易混淆的点：配置优先级不是随便叠加的
Hermes 官方文档给出的优先级是：
- CLI flags
config.yaml.env- 默认值
所以如果你后面发现“我明明写了但没生效”，就要开始从优先级方向排查。
第一次接入，先完成一个最小配置思路
第一次配置，不追求全，只追求能用
你现在先完成一个 provider + 一个 model + 默认本地终端后端，就够了。
1. 先选一个你已经能用的 provider
第一次接入时，最简单的思路是：
- 不要同时配很多 provider
- 先选一个你自己已经能调用成功的 provider
- 把精力先放在“能不能跑起来”，而不是“功能是不是最全”
2. 再选一个上下文足够的模型
Hermes 官方文档明确提到，主模型至少要具备 64K context。
所以第一次配置时，模型不要只看“便不便宜”或“名字熟不熟”。
还要先确认：
- 上下文长度是否足够
- 这个模型是否适合 Agent 场景
3. 终端后端先保持最简单的 local
官方配置文档里提到很多终端后端，比如 local、docker、ssh 等。
第一次接入时，最简单的做法通常是：
- 先用
local - 等你真的需要更强隔离时，再考虑
docker
这样不容易把问题复杂化。
配置阶段，哪些命令最值得先知道
你后面最常用到的配置相关命令，通常是这些：
hermes confighermes config edithermes config set KEY VALhermes modelhermes setup对新手来说，最省心的通常是 hermes config set
官方资料里提到，hermes config set 会把密钥类内容写进 .env，把普通设置写进 config.yaml。
所以如果你不想一开始就手动编辑文件，这通常是最轻量的做法。
如果你不想一点点手动配置，也可以直接先跑 hermes setup，让 Hermes 用向导式流程把首次设置带过去。
如果你只想最快完成 provider 和 model 选择，优先记住 hermes model 就够了；如果你想一口气把工具和其他初始化也一起过一遍，再用 hermes setup。
这一步做完，什么状态算合格
满足下面这 4 条，就说明最小配置已经完成了
- 你已经知道 Hermes 的配置目录在
~/.hermes/ - 你已经分清
config.yaml和.env各自该放什么 - 你已经确定第一次接入要用哪个 provider 和哪个 model
- 你知道自己可以通过
hermes model或hermes setup完成首次配置
做到这里，配置阶段就完成了。
下一页继续看 使用 Hermes。