禁用hermes agent自动更新需四步:一、修改config.yaml中auto_update: false;二、设置环境变量hermes_auto_update=false;三、重命名scripts/下update相关脚本;四、启动时添加--no-browser或移除hermes update调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在运行 Hermes Agent 时发现其自动访问更新地址、弹出浏览器或强制拉取新版本,可能是由于默认启用了自动更新机制。以下是禁用该行为的具体操作步骤:
一、修改配置文件禁用自动更新
Hermes Agent 的自动更新行为由主配置文件控制,禁用需手动编辑 config.yaml 或 .env 文件,关闭相关开关。
1、打开 Hermes Agent 安装目录,定位到 config.yaml 文件(通常位于 ~/.hermes/config.yaml 或项目根目录下)。
2、使用文本编辑器打开该文件,查找包含 auto_update、check_updates 或 update_on_startup 的字段。
3、将对应字段值修改为 false,例如:auto_update: false 或 check_updates: false。
4、保存文件并退出编辑器。
5、重启 Hermes Agent 进程使配置生效。
二、通过环境变量覆盖更新行为
环境变量具有最高优先级,可覆盖配置文件中的设置,适用于无法直接修改 config.yaml 的部署场景。
1、在启动 Hermes Agent 前,设置环境变量 HERMES_AUTO_UPDATE 为 false。
2、Windows PowerShell 中执行:$env:HERMES_AUTO_UPDATE="false"。
3、Linux/macOS 终端中执行:export HERMES_AUTO_UPDATE=false。
4、随后运行 hermes 启动命令,更新检查将被跳过。
三、移除或重命名更新脚本
部分 Hermes Agent 版本会内置独立的更新触发脚本(如 update.sh、auto_updater.py 或 Windows 下的 install.ps1 引用逻辑),直接删除或隔离可阻断更新链路。
1、进入 Hermes Agent 安装目录下的 scripts/ 或 bin/ 子目录。
2、查找名称含 update、upgrade、auto 的可执行文件或脚本。
3、对确认为更新用途的文件执行重命名操作,例如将 update.sh 改为 update.sh.disabled。
4、确保当前用户对该目录无写入权限(可选加固),防止后续安装脚本恢复原文件。
四、禁用启动时的 Dashboard 自动打开行为
根据日志反馈,Hermes Agent v2.1.0+ 在启动时会尝试执行 hermes update 并自动打开浏览器访问 http://127.0.0.1:9119,该行为与更新检查强耦合,需单独拦截。
1、检查是否在系统服务或开机脚本中调用了 hermes update 命令,将其全部删除。
2、若使用 systemd 管理服务,编辑对应 unit 文件,在 ExecStart= 行末尾添加 --no-dashboard 参数(如支持)。
3、若通过批处理或 shell 脚本启动,移除所有含 update、dashboard、--port 的参数组合。
4、验证启动命令仅保留核心形式:hermes --no-browser 或 hermes serve --disable-webui(依实际版本参数为准)。











