Hermes Agent 完全卸载教程：清理环境与恢复系统

macOS 卸载教程

删除配置目录会清除所有会话、记忆、权限设置、API Key 配置。卸载前建议备份：cp -r ~/.hermes ~/.hermes.bak（完整安装的 ~/.hermes 实测 3GB 以上，备份前先确认磁盘空间）

第一步：使用自带卸载命令（推荐）

hermes uninstall --full --yes

如果只想卸载但保留配置，去掉 --full 参数：hermes uninstall

第二步：手动清理残留

如果卸载命令不可用，手动执行：

停止网关和所有 Hermes 进程：

hermes gateway stop 2>/dev/null
pkill -f hermes 2>/dev/null

pkill -f 按完整命令行匹配，会误伤命令行里含 hermes 的进程（包括你自己正开着的终端会话）。如果执行后终端莫名断开，先用 pgrep -af hermes 列出 PID，再 kill <PID>。

删除配置和数据目录：

rm -rf ~/.hermes/

删除命令链接（一共三个，别只删一个）：

rm -f ~/.local/bin/hermes ~/.local/bin/hermes-acp ~/.local/bin/hermes-agent

删除开机自启项（LaunchAgent）：

rm -f ~/Library/LaunchAgents/ai.hermes.gateway.plist

清理 Shell 配置（可选）：

# 检查是否有 hermes 相关内容
grep -n -i "hermes" ~/.zshrc ~/.bash_profile 2>/dev/null

# 如果有，手动编辑删除相关行
nano ~/.zshrc

保存后重新加载：

source ~/.zshrc

官方安装器是 git 检出 + uv 虚拟环境（全部在 ~/.hermes/ 内），不是 pip / pipx 包——不需要 pip3 uninstall 或 pipx uninstall；相关缓存也都在 ~/.hermes/ 里，随目录一并删除。

第三步：验证卸载完成

which hermes      # 应该输出空或提示 not found
ls ~/.hermes      # 应该提示 No such file or directory

卸载完成。如需重装，请参考 Hermes Agent 安装与配置完全指南。

Windows 卸载教程

删除配置目录会清除所有会话、记忆、权限设置、API Key 配置。卸载前建议备份：cp -r ~/.hermes ~/.hermes.bak（完整安装的 ~/.hermes 实测 3GB 以上，备份前先确认磁盘空间）

第一步：使用自带卸载命令（推荐）

打开 PowerShell（以管理员身份运行），执行：

hermes uninstall --full --yes

如果只想卸载但保留配置，去掉 --full 参数：hermes uninstall

第二步：手动清理残留

如果卸载命令不可用，手动执行：

停止所有 Hermes 进程：

hermes gateway stop 2>$null
taskkill /F /IM hermes.exe 2>$null

删除配置和数据目录：

Remove-Item -Recurse -Force "$env:USERPROFILE\.hermes"

删除命令链接（一共三个，别只删一个）：

Remove-Item -Force "$env:USERPROFILE\.local\bin\hermes.exe","$env:USERPROFILE\.local\bin\hermes-acp.exe","$env:USERPROFILE\.local\bin\hermes-agent.exe" -ErrorAction SilentlyContinue

删除计划任务（开机自启）：

打开任务计划程序，删除 Hermes 相关任务；或用命令 schtasks /Delete /TN <任务名> /F（任务名在任务计划程序里能看到）。

清理环境变量：

1. 按 Win + R，输入 sysdm.cpl，回车
2. 点击 高级 → 环境变量
3. 在 用户变量 中检查是否有 Hermes 相关的 PATH 条目
4. 如果有，选中并删除
5. 点击确定保存

官方安装器是 git 检出 + uv 虚拟环境（全部在 .hermes\ 内），不是 npm 包——不需要 npm uninstall -g hermes-agent；相关缓存也都在 .hermes\ 里，随目录一并删除。

第三步：验证卸载完成

where hermes                          # 应该提示找不到文件
Test-Path "$env:USERPROFILE\.hermes"  # 应该输出 False

卸载完成。如需重装，请参考 Hermes Agent 安装与配置完全指南。

Linux 卸载教程（Ubuntu / Debian）

删除配置目录会清除所有会话、记忆、权限设置、API Key 配置。卸载前建议备份：cp -r ~/.hermes ~/.hermes.bak（完整安装的 ~/.hermes 实测 3GB 以上，备份前先确认磁盘空间）

第一步：使用自带卸载命令（推荐）

hermes uninstall --full --yes

如果只想卸载但保留配置，去掉 --full 参数：hermes uninstall

已实测（2026-09）：这一条会删掉全部命令链接（hermes / hermes-acp / hermes-agent）、安装目录、托管运行时和整个 ~/.hermes，并自动还原 .bashrc / .profile 里安装时加的 PATH 行，同时停掉并删除 systemd 服务。

linger 不会自动恢复：安装时 hermes gateway install 会自动开启 linger（注销后仍运行），卸载不管这个。要恢复系统默认，手动执行：

bash sudo loginctl disable-linger <你的用户名>

第二步：手动清理残留

如果卸载命令不可用，手动执行：

停止网关和所有 Hermes 进程：

hermes gateway stop 2>/dev/null
systemctl --user disable --now hermes-gateway 2>/dev/null
pkill -f hermes 2>/dev/null

pkill -f 按完整命令行匹配，会误伤命令行里含 hermes 的进程（包括你自己正开着的终端会话）。如果执行后终端莫名断开，先用 pgrep -af hermes 列出 PID，再 kill <PID>。

删除配置和数据目录：

rm -rf ~/.hermes/

~/.hermes/ 里有配置、会话、记忆、API Key、托管的 Node/Python 和全部缓存，删掉它等于数据清零。

删除命令链接（一共三个，别只删一个）：

rm -f ~/.local/bin/hermes ~/.local/bin/hermes-acp ~/.local/bin/hermes-agent

删除 systemd 服务：

rm -f ~/.config/systemd/user/hermes-gateway.service
systemctl --user daemon-reload

恢复 linger 默认值：

sudo loginctl disable-linger <你的用户名>

清理 Shell 配置：

grep -n -i hermes ~/.bashrc ~/.profile 2>/dev/null

如果有输出（安装时自动加的 ~/.local/bin PATH 行），手动编辑删除对应行。

官方安装器是 git 检出 + uv 虚拟环境（全部在 ~/.hermes/ 内），不是 pip / npm 包——不需要 pip3 uninstall，也不需要 npm uninstall -g hermes-agent。

第三步：验证卸载完成

# 应该提示 command not found
which hermes

# 应该提示 No such file or directory
ls ~/.hermes

卸载完成。如需重装，请参考 Hermes Agent 安装与配置完全指南。