Hermes Agent 配置指南：config.yaml 完整详解-China AI Hub

维护咨询大模型部署问题解决技能定制大模型训练

站长交流微信: aixbwz

Hermes Agent 的所有配置都集中在一个文件里——config.yaml。搞懂这个文件，你就能完全掌控 Hermes 的行为。本文详细介绍每个配置项的含义和最佳实践。

配置文件在哪里

默认配置文件位于 ~/.hermes/config.yaml（WSL2/Linux/macOS）或 C:\Users\你的用户名\.hermes\config.yaml（Windows）。

# 查看配置文件位置
hermes config --path

首次运行 setup 向导时会自动创建这个文件，也可以手动编辑。

完整配置示例

# ~/.hermes/config.yaml

# 主设置
provider: minimax-cn       # 当前使用的模型提供商
model: MiniMax-M2.7-highspeed  # 模型名称
api_key: your-api-key-here

# 多提供商配置
providers:
  minimax-cn:
    name: MiniMax
    base_url: https://api.minimaxi.com/v1
    api_key: your-minimax-key
    models:
      - MiniMax-M2.7-highspeed
      - MiniMax-M2.7

  deepseek:
    name: DeepSeek
    base_url: https://api.deepseek.com/v1
    api_key: your-deepseek-key
    models:
      - deepseek-chat

  anthropic:
    name: Anthropic
    base_url: https://api.anthropic.com/v1
    api_key: your-anthropic-key
    models:
      - claude-opus-4-6
      - claude-sonnet-4

# 显示设置
display:
  skin: default    # 皮肤主题：default/ares/mono/slate
  show_thinking: true   # 是否显示思考过程
  color: true      # 是否启用彩色输出

# 工具设置
tools:
  enabled:
    - terminal
    - file
    - web
    - delegate
  disabled: []

# Skill 设置
skills:
  auto_load: true   # 是否自动加载匹配的 Skill
  search_path:
    - ~/.hermes/skills

# 系统提示词
system_prompt: |
  你是一个专业的 AI 助手。
  代码风格遵循最佳实践。
  回复要简洁清晰。

# 代理设置（可选）
proxy:
  enabled: false
  http: http://127.0.0.1:7890
  https: http://127.0.0.1:7890

# 日志设置
logging:
  level: info      # debug/info/warning/error
  file: ~/.hermes/logs/hermes.log

# 历史记录
history:
  max_entries: 1000
  save_dir: ~/.hermes/history

配置项详解

1. 主设置（required）

provider: minimax-cn
model: MiniMax-M2.7-highspeed
api_key: your-key

最基础的三个配置，指定用什么模型。没有这三个 Hermes 跑不起来。

2. 多提供商配置（providers）

可以同时配置多个模型提供商，随时切换：

providers:
  minimax-cn:
    base_url: https://api.minimaxi.com/v1
    api_key: your-key
    models:
      - MiniMax-M2.7-highspeed
      - MiniMax-M2.7

切换方法：

# 对话中切换
/hermes model minimax-cn/MiniMax-M2.7

# 或者编辑 config.yaml 后
/hermes reload

3. 显示设置（display）

display:
  skin: default
  show_thinking: true
  color: true

skin：可选 default/ares/mono/slate，分别对应不同配色风格：

default：金黄色 Herms 风格（默认）
ares：深红色战斗风格
mono：简洁黑白风格
slate：冷蓝色开发者风格

# 切换皮肤
/hermes skin slate

show_thinking：设为 true 时会显示 AI 推理过程，方便调试复杂任务。

4. 工具设置（tools）

tools:
  enabled:
    - terminal
    - file
    - web
    - browser
    - delegate
  disabled:
    - mcp

控制哪些工具可用。如果不想让 AI 执行终端命令，可以把 terminal 从 enabled 里移除或加到 disabled 里。

5. Skill 设置（skills）

skills:
  auto_load: true
  search_path:
    - ~/.hermes/skills
    - /mnt/c/Users/29980/Desktop/my-skills

auto_load：开启后 AI 会根据任务描述自动搜索并加载匹配的 Skill。

search_path：指定额外的 Skill 搜索目录，方便管理自定义 Skill。

6. 系统提示词（system_prompt）

system_prompt: |
  你是一个专业的 Python 后端开发工程师。
  代码风格遵循 PEP 8，使用类型注解。
  如果发现安全漏洞必须立即指出。
  回复简洁，不废话。

设置默认角色。也可以在对话中用 /system 临时覆盖：

/system 你现在是一个翻译专家，只翻译技术文档

7. 代理设置（proxy）

proxy:
  enabled: true
  http: http://127.0.0.1:7890
  https: http://127.0.0.1:7890

如果你的网络需要代理才能访问某些 API，在这里配置。支持 http/https/socks5 协议。

8. 日志设置（logging）

logging:
  level: info
  file: ~/.hermes/logs/hermes.log
  max_size: 10MB
  backup_count: 3

level：debug 最详细，error 最简略。日常用 info 就行。

max_size：单个日志文件最大大小，超出后自动轮转。

backup_count：保留几个旧日志文件。

常见配置问题

配置文件格式错误

YAML 对缩进非常敏感。确保使用空格（不是 Tab），层级要对齐：

# 正确
providers:
  minimax-cn:
    api_key: xxx

# 错误（Tab 或缩进不对）
providers:
	minimax-cn:
	  api_key: xxx

如果不确定格式是否正确，运行：

hermes config --validate

API Key 无效或过期

某些服务商的 Key 有有效期限制。如果突然报 401 错误，先去服务商控制台检查 Key 状态。

# 测试配置是否正确
hermes doctor

这个命令会逐项检查依赖、连接、认证，发现问题会提示。

模型不支持

有时 provider 配置里写了模型名称，但实际 provider 不支持这个模型。

# 列出当前 provider 支持的所有模型
/hermes models

多环境配置

如果需要在不同环境（公司/家里/测试）使用不同配置，可以用 profiles：

# 创建新配置环境
hermes profile create work

# 在不同 profile 间切换
hermes profile use work
hermes profile use home

# 列出所有 profile
hermes profile list

每个 profile 有独立的 config.yaml，方便管理多套密钥和配置。

配置热重载

修改 config.yaml 后不需要重启 Hermes，热重载即可生效：

hermes reload

或者在对话中：

/reload

常见问题

Q：config.yaml 在哪里？
默认在 ~/.hermes/config.yaml，WSL2 下是 /home/wl/.hermes/config.yaml。

Q：改了配置不生效怎么办？
先运行 hermes reload，不行就重启 hermes。

Q：可以同时用几个 provider？
可以。配置好多 provider 后用 /model 切换。

Q：不小心配置错了怎么恢复？
hermes config --reset 会重置为默认配置。

Q：Key 写在配置文件里安全吗？
本地文件还好，但不要把配置文件传到 Git 或公开的地方。敏感 Key 也可以用环境变量代替：api_key: ${MINIMAX_API_KEY}。

配置文件是 Hermes 的核心，搞懂它之后你就能完全按自己的需求定制 AI 助手了。

文章版权归作者所有，未经允许请勿转载。

THE END

玩转AI