Hermes Agent config.yaml 配置指南：provider、日志与 profiles 完整详解

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

配置文件在哪里

默认配置文件位于 ~/.hermes/config.yaml（WSL2/Linux/macOS）或 C:Users你的用户名.hermesconfig.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，分别对应不同配色风格：