本文介绍如何在 macOS 环境下完整卸载 Hermes Agent，包括判断安装方式、删除 Hermes 程序、清理配置目录、解决 .hermes 目录无法删除的问题，以及验证 Hermes 是否已经成功卸载。

Hermes Agent 怎么卸载
1. 确认 Hermes 安装方式，Hermes Agent 不一定通过 Python pip 安装。

# 首先执行：
hermes --version

Hermes Agent v0.20.4 (2026.8.18)
Install directory: /Users/Name/.hermes/hermes-agent
Python: 3.11.15
OpenAI SDK: 2.24.0

#或者 
Hermes 版本：v0.20.4
安装目录：
/Users/Name/.hermes/hermes-agent

说明它是 Hermes 独立安装程序，而不是 Python 包。

2. pip 卸载无效的情况

# pip卸载
pip uninstall hermes
如果出现：
WARNING: Skipping hermes as it is not installed.
表示 Hermes 不属于 pip 管理。

原因：
Hermes Agent 使用自己的安装目录：
~/.hermes
而不是：
site-packages/hermes
所以需要删除 Hermes 自己的目录。

3. 删除 Hermes 主目录，直接执行：

rm -rf ~/.hermes

正常情况下会删除：

~/.hermes/
├── hermes-agent
├── state
├── kanban.db
└── 配置文件

4. 处理 .hermes 删除失败如果出现：
rm: /Users/xxx/.hermes: Directory not empty
通常是 macOS 文件保护属性导致。
检查：
ls -ldeO ~/.hermes
如果看到：
uchg
说明目录被锁定。解除：
chflags -R nouchg ~/.hermes
然后重新删除
rm -rf ~/.hermes

5. 清理 ACL 权限，如果仍然无法删除：查看 ACL：

ls -le ~/.hermes

如果存在 ACL：
例如：
0: group:everyone deny delete

清除 ACL：
chmod -RN ~/.hermes

再次删除：
rm -rf ~/.hermes

6. 删除 Hermes 命令入口

#检查命令位置： 
which hermes
/Users/xxx/.local/bin/hermes
#删除：
rm -f ~/.local/bin/hermes
#如果是：
/usr/local/bin/hermes
#删除：
sudo rm -f /usr/local/bin/hermes

7. 清理 Shell 缓存
macOS 默认使用 zsh：
hash -r
或者重新打开终端。

8. 验证是否卸载完成

#执行：
hermes --version
#正常结果：
zsh: command not found: hermes
#检查目录：
ls ~/.hermes
#应该不存在。
: No such file or directory

 

9. 保留数据重新安装
如果只是 Hermes 登录异常、配置损坏，不想删除数据，可以备份：
mv ~/.hermes ~/.hermes_backup
之后重新安装 Hermes。

这样可以保留：

会话状态
本地数据库
Agent 配置