Hermes 配置文件详解

Hermes 的大部分行为都写在配置文件里。本篇逐节拆解 config.yaml 的结构，帮你做到「改一处，知其作用」。

配置文件在哪里

主配置文件是 ~/.hermes/config.yaml。密钥类内容单独存放在同目录的 ~/.hermes/.env，不会进 config.yaml，更安全。

两种修改方式：

hermes config edit          # 用默认编辑器打开
hermes config get  model    # 查看某项
hermes config set  model anthropic/claude-opus-4
hermes config check         # 校验配置合法性
hermes config migrate       # 跨版本迁移旧配置

hermes config set 会自动把值写到正确的位置，比手改文件省心。

主要配置节一览

下面按常用程度列出各节，名字以官方文档为准。

model

模型与提供商设置，决定 Hermes「用哪个脑子」。

model:
  primary: "anthropic/claude-opus-4"
  max_tokens: 8192
  temperature: 0.7

tools

工具集的开关与行为。

tools:
  enabled_toolsets: ["terminal", "web", "files"]
  auto: true              # Agent 是否自动决定用工具
  auto_approval: false    # 高风险工具是否需你确认
  max_uses: 30            # 单轮最多工具调用次数
  mcp:                    # 接入 MCP 服务器
    - name: my-mcp
      command: npx
      args: ["-y", "some-mcp-server"]

system

上下文压缩与日志。

system:
  context_compaction: auto   # 上下文过长时自动压缩
  logger: true

memory

记忆系统的关键节，注意默认值。

memory:
  memory_char_limit: 2200     # 默认记忆容量，可调大
  user_char_limit: 1375       # USER.md 的容量上限
  auto_compress: true
  external:                   # 外部记忆后端（可选）
    - provider: mem0
      config: {...}

提醒：许多旧资料写默认记忆上限是 5000，那是错误的。当前默认 memory_char_limit 是 2200，可按需调大。

skills

技能系统的开关。

skills:
  auto_discovery: true     # 自动发现可用技能
  auto_improve: true       # 使用中自我改进
  author: "your-name"

gateway

消息网关的开关与各平台凭据。

gateway:
  enabled: false
  telegram:
    enabled: true
    token: "${TELEGRAM_BOT_TOKEN}"

cron

定时任务的开关。

cron:
  enabled: false

ui

TUI 外观等。

ui:
  theme: "dark"
  show_line_numbers: true

agent

个性与语言偏好。

agent:
  personality: "你是一名严谨的助手"
  response_language: "中文"

paths

各类目录位置，默认可不写。

paths:
  memories_dir: "~/.hermes/memories"
  skills_dir: "~/.hermes/skills"
  plugins_dir: "~/.hermes/plugins"

修改后如何生效

多数配置在下次启动会话时自动生效。
网关、定时任务等服务类功能可能需要重启对应进程（hermes gateway、hermes cron）。
拿不准时，先 hermes config check 校验，再 hermes doctor 做整体体检。

本篇小结

主配置在 ~/.hermes/config.yaml，密钥在 .env。
用 hermes config set/get/edit/check/migrate 管理比手改更稳。
重点节：model、tools、system、memory、skills、gateway、cron、ui、agent、paths。
记忆默认上限 2200，并非 5000。

下一篇我们深入记忆系统，让 Hermes 真正「记住你」。