Hermes 配置修改手册
所有 Hermes Agent 的配置修改说明统一记录在此。每次改动后更新本文档。
---
一、文件结构速查
~/.hermes/ ├── config.yaml ← 主 Agent 配置(default profile) ├── route_store.yaml ← 中央路由声明(意图记录,不直接生效) ├── cron/jobs.json ← 定时任务 ├── .env ← API 密钥等环境变量 └── profiles/ ├── aistudy/config.yaml ├── brainup/config.yaml ├── caishang/config.yaml ├── eng/config.yaml ├── insurance/config.yaml ├── invest/config.yaml ├── mom/config.yaml ├── schedule/config.yaml └── spanish/config.yaml
核心原则: config.yaml 是唯一真正生效的配置文件。route_store.yaml 只是意图声明,需要通过 apply_route.py 脚本手动抄写才会生效(且 default profile 没有独立目录,抄写脚本对它无效)。
---
二、修改默认模型
改主模型
编辑对应 profile 的 config.yaml,找到 model: 段:
model: default: deepseek-v4-flash # ← 改这一行 provider: deepseek # ← 模型提供商 base_url: https://api.deepseek.com/v1 # ← API 地址
常用模型值:
场景
default
provider
base_url
DeepSeek Flash(推荐)
deepseek-v4-flash
deepseek
https://api.deepseek.com/v1
DeepSeek Pro
deepseek-v4-pro
deepseek
https://api.deepseek.com/v1
本地 122B
Qwen3.5-122B-A10B-4bit
Local Model
http://localhost:8000/v1
本地 35B
Qwen3.6-35B-A3B-8bit
Local Model
http://localhost:8000/v1
改杂活模型(auxiliary)
杂活包括:起标题、压缩对话、抓网页、搜索历史、权限判断、记忆整理等。
找到 auxiliary: 段,每个子项独立配置:
auxiliary: title_generation: provider: auto # auto = 自动跟随主模型 model: '' # 空 = 使用主模型 base_url: '' api_key: ''
两种模式:
模式
provider
model
效果
跟随主模型
auto
''(空)
杂活自动用主模型(推荐)
独立指定
deepseek
deepseek-v4-flash
杂活固定用某个模型
---
三、管理定时任务
定时任务配置文件:~/.hermes/cron/jobs.json
关闭任务(保留配置)
"enabled": false // ← 改这里
开启任务
"enabled": true
其他字段说明
字段
含义
name
任务名称
schedule_display
cron 表达式(如 0 20 * * * = 每天 20:00)
skill
使用的技能名
deliver
投递渠道(如 telegram)
---
四、用 /model 命令快速切换
在 Telegram 或 CLI 中输入 /model <别名> 可以切换主模型(不影响杂活模型)。
当前可用的别名(定义在 config.yaml 的 model_aliases: 段):
命令
切换到
/model deepseek-flash
deepseek-v4-flash
/model deepseek-pro
deepseek-v4-pro
/model qwen3.5
本地 Qwen3.5-122B
/model qwen3.6
本地 Qwen3.6-35B
/model qwen3-coder
本地 Qwen3-Coder
注意: /model 只改主模型,不改杂活模型。如果需要同时切换杂活模型,必须手动编辑 config.yaml 的 auxiliary: 段。
---
五、重启 Gateway
配置文件修改后,需要重启对应 profile 的 gateway 才生效:
# 主 Agent hermes gateway restart # 指定 profile hermes -p aistudy gateway restart hermes -p invest gateway restart # ... 以此类推
或者一次性重启所有:
# 主 Agent hermes gateway restart # 所有 profile for p in aistudy brainup caishang eng insurance invest mom schedule spanish; do hermes -p $p gateway restart done
---
六、当前配置状态
最后更新:2026-06-06
Profile
主模型
杂活模型
定时任务
default(主 Agent)
deepseek-v4-flash
auto(跟随主)
港闻晚报(已关闭)
aistudy
deepseek-v4-flash
auto(跟随主)
无
brainup
deepseek-v4-flash
auto(跟随主)
无
caishang
deepseek-v4-flash
auto(跟随主)
无
eng
deepseek-v4-flash
auto(跟随主)
无
insurance
deepseek-v4-flash
auto(跟随主)
无
invest
deepseek-v4-flash
auto(跟随主)
无
mom
deepseek-v4-flash
auto(跟随主)
无
schedule
deepseek-v4-flash
auto(跟随主)
无
spanish
deepseek-v4-flash
auto(跟随主)
无
API 密钥: DEEPSEEK_API_KEY 已在 ~/.hermes/.env 中配置。