Hermes Agent 更新后如果出现“缺少配置”“某个选项不存在”或旧配置不生效,优先运行 hermes config check,再按提示执行 hermes config migrate。这比手动乱改 config.yaml 更稳。
为什么更新后会缺配置
Hermes 的能力变化很快,新版本可能新增压缩、工具、平台、插件或上下文相关选项。旧的 ~/.hermes/config.yaml 里没有这些字段时,程序会尝试使用默认值,但某些功能需要你显式补齐。官方文档把 config check 和 config migrate 作为更新后的标准处理路径。
推荐修复顺序
- 先执行
hermes config看当前配置是否能正常读取。 - 执行
hermes config check,确认缺的是普通配置还是密钥。 - 执行
hermes config migrate,交互式补齐缺失项。 - 如果是 API Key、Bot Token、密码这类敏感信息,用
hermes config set KEY VALUE写入,它会自动放到.env。
配置优先级也要看清
Hermes 的配置优先级是 CLI 参数最高,其次是 config.yaml,然后是 .env,最后才是默认值。所以你更新后觉得“明明改了但没生效”,要检查启动命令里是否带了临时参数,例如 --model 或 --profile。
结论很简单:更新后的配置问题先交给官方命令处理,只有知道字段含义时再手动编辑。这样能避免把密钥写进错误文件,也能减少下一次升级继续踩坑。