配置与选模型
config.yaml 与 .env 的分工,以及国内 Provider 配置要点
本文内容译自 Nous Research 官方文档,技术细节以英文原文为准。对照官方文档
配置存储位置
Hermes 将密钥与普通配置分开:
| 类型 | 文件 | 示例 |
|---|---|---|
| 密钥 / Token | ~/.hermes/.env | OPENROUTER_API_KEY |
| 非敏感设置 | ~/.hermes/config.yaml | model、terminal.backend |
推荐使用 CLI,会自动写入正确文件:
终端
hermes config set model anthropic/claude-opus-4.6 hermes config set terminal.backend docker hermes config set OPENROUTER_API_KEY sk-or-...
切换模型
随时运行 hermes model 即可更换 Provider,无厂商锁定。
国内常用 Provider
| 提供商 | 环境变量 | 说明 |
|---|---|---|
| 通义 / DashScopeCN | DASHSCOPE_API_KEY | Qwen 系列 |
| DeepSeekCN | DEEPSEEK_API_KEY | 直连 API |
| Kimi / MoonshotCN | KIMI_API_KEY | 含中国区 endpoint |
| MiniMax 中国CN | MINIMAX_CN_API_KEY | 国内 endpoint |
| OpenRouter | OPENROUTER_API_KEY | 多模型路由 |
| Z.AI / GLMCN | GLM_API_KEY | 智谱模型 |
完整列表见官方 Providers 文档。
终端后端(可选)
为安全起见,可将命令执行隔离到 Docker 或远程 SSH:
终端
hermes config set terminal.backend docker hermes config set terminal.backend ssh
检查配置
终端
hermes doctor hermes config check