HermesAgent卸载与重装教程

本文详细讲解了在Windows系统上彻底卸载并纯净重装Hermes Agent的完整流程，特别针对因旧版本残留导致的配置错乱、命令冲突和启动失败等常见痛点——从强制终止进程、深度清理WSL子系统内的程序文件与虚拟环境，到扫描清除Windows侧隐藏的注册表项、环境变量及临时缓存，再到借助HiBit Uninstaller进行顽固残留扫荡，最后通过权威验证和国内加速一键脚本完成零干扰重装，助你一步回归稳定高效的AI智能体运行环境。

如果您已完成 Hermes Agent 的使用或需更换部署方式，但发现重新安装后出现配置错乱、命令冲突或启动失败等问题，则很可能是旧版本残留文件未被清除。以下是彻底卸载并重装 Hermes Agent 的完整操作指南：

一、停止所有 Hermes Agent 进程

在执行任何清理操作前，必须确保 Hermes Agent 及其相关后台服务已完全终止，避免文件被占用导致删除失败。

1、打开 Windows 终端（PowerShell 或 CMD），以管理员身份运行。

2、执行命令查询正在运行的 Hermes 相关进程：ps -ef | grep hermes（WSL 环境下）或 tasklist | findstr "python node"（Windows 原生命令行）。

3、若发现匹配进程，记录 PID 后执行强制终止：kill -9 [PID]（WSL）或 taskkill /F /PID [PID]（Windows）。

4、关闭所有 WSL 实例：在 PowerShell 中运行 wsl --shutdown，确保 Ubuntu 子系统完全退出。

二、清除 WSL 中 Hermes Agent 全部残留路径

Hermes Agent 在 WSL 环境中默认将核心文件、虚拟环境、配置与记忆数据分散存储于多个目录，需逐一确认并删除。

1、启动 WSL：在 PowerShell 中输入 wsl，进入 Ubuntu 终端。

2、删除主程序目录：rm -rf ~/.hermes/hermes-agent。

3、删除本地数据与记忆库：rm -rf ~/.local/share/Hermes。

4、删除 Python 虚拟环境（如存在）：rm -rf ~/.hermes/env 或检查 ~/.venv/ 下是否含 hermes 前缀环境并一并移除。

5、清理 shell 配置中注入的 alias 或 PATH 条目：执行 nano ~/.bashrc，定位并删除包含 hermes 或 export PATH=.*hermes 的行，保存退出后运行 source ~/.bashrc 刷新。

三、清理 Windows 主机侧关联文件与注册表项

尽管 Hermes Agent 本身不直接写入 Windows 注册表，但部分依赖组件（如 Node.js、Python 安装器、Git）或用户手动配置可能遗留全局路径引用，需同步核查。

1、检查系统环境变量 PATH：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”和“用户变量”的 PATH 中查找并删除含 hermes、hermes-agent 或指向 WSL 用户目录的条目。

2、删除 Windows 侧可能存在的临时缓存：%TEMP%\hermes* 与 %LOCALAPPDATA%\Temp\hermes*（在文件资源管理器地址栏粘贴路径后回车，手动删除匹配文件夹）。

3、检查 Windows 应用与功能列表：打开“设置→应用→已安装的应用”，确认无名称含 Hermes 或 Agent 的条目；如有，点击“卸载”按钮执行标准卸载流程。

四、使用 HiBit Uninstaller 强制扫描顽固残留

针对手动清理后仍疑似存在隐藏注册表项、服务或启动项的情况，可借助专业卸载工具进行深度扫描与清除。

1、以管理员身份运行 HiBit Uninstaller。

2、在主界面选择“系统工具”→“注册表清理”，点击“扫描”按钮。

3、扫描完成后，在结果中筛选关键词：hermes、nousresearch、hermes-agent，勾选全部匹配项后点击“清理”。

4、切换至“启动项管理”，检查 Startup 标签页中是否存在异常启动项，尤其注意名称含 hermes 或指向 WSL 脚本的条目，右键选择“禁用并删除”。

5、返回主界面，点击“垃圾文件清理”，启用“临时文件”、“日志文件”、“缩略图缓存”选项，执行全盘扫描并清理。

五、验证残留是否清零并执行纯净重装

完成上述四步后，必须验证关键路径与命令是否已完全失效，方可开始重装，避免新旧版本混杂引发不可预知错误。

1、重启 WSL：在 PowerShell 中执行 wsl --shutdown 后再次输入 wsl 重新进入。

2、逐项验证以下命令是否返回“command not found”或“No such file or directory”：hermes --version、which hermes、ls ~/.hermes、ls ~/.local/share/Hermes。

3、确认无残留后，立即执行国内镜像一键安装：curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash。

4、安装完毕后，强制刷新 shell 配置：source ~/.bashrc。

5、运行健康检查：hermes doctor，确保所有检测项显示 ✅。

今天关于《HermesAgent卸载与重装教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！