Hermes Agent 的 API 地址或 Key 明明改了,但 Open WebUI 还是连旧配置,这通常不是 Hermes 没重启,而是 Open WebUI 只在第一次启动时读取这些环境变量,之后连接信息会写进它自己的内部数据库。官方文档已经明确提醒了这一点。
正确处理方式
- 如果只是改连接参数,直接进 Open WebUI 的 Admin 设置里修改,不要只改 Docker 环境变量。
- 如果你想完全按新环境变量重来,就删除 Open WebUI 的数据卷,再重新启动。
- 同时确认 Hermes 端
API_SERVER_KEY已同步更新,否则前端改对了也会继续报认证错。
为什么很多人会误判成 Hermes 问题
因为你看到的是“我改了 OPENAI_API_BASE_URL 和 OPENAI_API_KEY,页面却没变”,直觉会以为 Hermes 还在缓存。其实缓存配置的是 Open WebUI 自己,不是 Hermes Agent。
这题最省时间的结论就是:改环境变量只对首次启动有效。已有实例要么去 Admin UI 改,要么清掉 Open WebUI 数据卷重建。
官方开源地址:https://github.com/NousResearch/hermes-agent;官方文档入口:https://hermes-agent.nousresearch.com/。