Hermes Agent如何彻底卸载？Linux/macOS/Windows清洁删除指南（2026最新）

为什么要彻底卸载？

在折腾 Hermes Agent 的过程中，你可能会遇到这些问题：换电脑、换服务器、想重装最新版、或者单纯想清理干净。普通卸载往往残留配置文件和数据库，下次安装会出各种奇怪问题。

本文专门解决「卸载不干净」的痛点，覆盖 macOS、Linux（Ubuntu/Debian/CentOS）、Windows WSL2 三种系统环境，手把手把 Hermes Agent 从你的机器里移除得干干净净。

一、macOS 彻底卸载步骤

1. 停止并移除 Gateway 服务

如果你的 Hermes Gateway 以服务方式运行，先停止并卸载：

# 停止服务
launchctl unload ~/Library/LaunchAgents/hermes-gateway.plist

# 移除服务文件
rm -f ~/Library/LaunchAgents/hermes-gateway.plist

# 确认已停止
launchctl list | grep hermes

2. 删除 Hermes 主程序和数据

# 删除主程序目录（所有数据，包括记忆、配置、skills）
rm -rf ~/.hermes

# 删除 npm 全局包
npm uninstall -g hermes-agent 2>/dev/null

# 删除 Python 虚拟环境（如有）
rm -rf ~/hermes-venv

# 验证清理完成
ls -la ~ | grep hermes  # 应该无输出

3. 清理 PATH 和配置文件

# 检查 shell 配置文件是否写入 hermes 路径
grep -i hermes ~/.bashrc ~/.zshrc ~/.bash_profile 2>/dev/null

# 如有，编辑删除对应行，例如：
# export PATH="$HOME/.hermes/bin:$PATH"
# 手动用 nano 或 vim 编辑删除

二、Linux / WSL2 彻底卸载步骤

1. 停止 systemd 服务

# 查看所有 hermes 相关服务
systemctl --user list-units | grep hermes

# 停止并禁用（把 your-profile 换成你的 profile 名）
systemctl --user stop hermes-gateway-yourprofile
systemctl --user disable hermes-gateway-yourprofile

# 如果是 root 服务（全局安装）
sudo systemctl stop hermes-agent
sudo systemctl disable hermes-agent

2. 删除 Hermes 主程序和数据

# 删除主程序目录（所有数据，包括记忆、配置、skills）
rm -rf ~/.hermes

# npm 全局包
npm uninstall -g hermes-agent 2>/dev/null

# 如果用 pip 安装了 hermes
pip uninstall hermes-agent -y 2>/dev/null

# Python 虚拟环境（如有）
rm -rf ~/hermes-venv

# 查找是否还有残留
sudo find / -name "*hermes*" -type d 2>/dev/null | grep -v proc

3. 清理 Shell 配置

# 检查配置文件中是否有 hermes 路径
grep -r "hermes" ~/.bashrc ~/.profile ~/.zshrc ~/.bash_profile 2>/dev/null

# 典型需要删除的配置：
# export HERMES_HOME=~/.hermes
# export PATH="$HERMES_HOME/bin:$PATH"
# source ~/.hermes/venv/bin/activate

三、Windows WSL2 彻底卸载步骤

1. 停止 WSL 内的服务

# 在 WSL 终端内执行
systemctl --user stop hermes-gateway-*
systemctl --user disable hermes-gateway-*
rm -rf ~/.hermes

2. 卸载 WSL 发行版（可选，如需完全清理）

# 以管理员身份打开 PowerShell
wsl --unregister Ubuntu
wsl --unregister Debian
# 或你的具体发行版名称

3. 清理 Windows 本地 Hermes 数据

# 在 PowerShell 中执行
Remove-Item -Recurse -Force $env:USERPROFILE\.hermes
Remove-Item -Recurse -Force $env:USERPROFILE\AppData\Local\hermes-agent

四、卸载后重新安装的注意事项

彻底卸载后，第二次安装 Hermes Agent 相当于全新环境。以下几点需要特别注意：

• API Key 备份：.env 文件里存储了所有 API Key，重新安装前确认已备份。
• Gateway 配置：Telegram / Discord 的 Bot Token 需要重新配置。
• 记忆丢失：~.hermes 目录包含 SQLite 数据库（会话历史）和 SOUL.md，删除后 AI 会丢失对你的记忆。
• Skills 丢失：所有手动安装和 AI 自动创建的 Skills 都会被删除。

五、常见问题

Q1：卸载后重新安装，但启动报错「Port already in use」

说明之前的服务没有完全停止：

# 查找占用端口的进程
lsof -i :18789
# 或
ss -tlnp | grep 18789

# 杀掉对应进程
kill -9 <PID>

Q2：.hermes 目录删不掉，提示「Permission denied」

# 强制删除
sudo rm -rf ~/.hermes

# 如果是符号链接，先删链接
unlink ~/.hermes

Q3：npm 卸载提示找不到包

# 确认包名
npm list -g --depth=0 | grep hermes

# 正确卸载
npm uninstall -g @nousresearch/hermes-agent

Q4：想保留配置只重装程序，怎么操作？

保留 ~/.hermes 目录，只重装 npm 包即可：

npm install -g @nousresearch/hermes-agent@latest

Q5：卸载后 npm 全局命令 still exists

# 找到命令实际位置
which hermes
# 或
npm list -g hermes-agent

# 手动删除
sudo rm -f $(which hermes)

总结

彻底卸载 Hermes Agent 的核心就三步：停止服务 → 删除 ~/.hermes → 清理 shell 配置。各系统命令略有不同，但逻辑一致。卸载干净后重新安装，可以避免 90% 的奇怪报错。

如果你只是想升级到最新版，直接运行 hermes update 即可，无需卸载重装。

相关推荐

• Hermes Agent 安装教程：Windows/Linux/macOS 详细图解
• Hermes Agent 版本升级迁移：安全升级完整步骤
• Hermes Agent 常见问题FAQ：安装配置使用全覆盖
• Linux安装Hermes Agent完整教程
• Hermes Agent Skills技能扩展安装配置教程