Hermes Agent 移除方法教學

AI資訊

Hermes Agent 移除方法教學

Hermes Agent 移除方法教學：徹底清除不留痕跡

Hermes Agent雖然強大，但轉換其他AI代理或系統升級時需要完全移除。2026年最新官方卸載指南結合香港用戶常見環境（WSL2、Docker、macOS），提供一鍵自動、手動徹底清除與資料保留三種方案。這份完整教學確保無殘留、無服務掛起、無環境衝突，讓你輕鬆切換到PaperClip AI或其他框架。

 

移除前安全檢查清單

停止所有服務（避免檔案鎖定）：

# 停止閘道服務
hermes gateway stop --all

# 檢查殘留程序（Linux/macOS）
ps aux | grep hermes
pkill -f hermes

# Windows WSL2
wsl --shutdown

 

備份重要資料（選擇性）：

# 匯出記憶與技能（轉移用）
tar -czf hermes-backup-$(date +%Y%m%d).tar.gz ~/.hermes/

 

方法一：官方一鍵卸載（99%用戶推薦）

終極指令，自動偵測安裝路徑與環境：

hermes uninstall

 

互動選單說明：

Hermes Agent Uninstaller v0.8.0
1. 保留配置檔案 (~/.hermes/) - 未來重裝可用
2. 完全移除（含配置、記憶、技能） - 全新開始
3. 取消卸載

選擇 [1/2/3]: 2

 

執行結果：

✓ 停止所有閘道服務
✓ 移除全域指令：/usr/local/bin/hermes
✓ 刪除Python套件：118個依賴
✓ 清除啟動服務：systemd/launchd/cron
✓ 移除原始碼：~/hermes-agent
✓ 清理快取：pip/npm
卸載完成！系統已恢復乾淨狀態

 

方法二：手動徹底清除（開發者首選）

當一鍵卸載失效或Docker殘留時使用：

Linux/macOS 完整清除

#!/bin/bash
# hermes-complete-uninstall.sh

echo " 停止所有Hermes服務..."
hermes gateway stop --all 2>/dev/null || true
pkill -f hermes 2>/dev/null || true

echo " 移除全域指令..."
sudo rm -f /usr/local/bin/hermes ~/.local/bin/hermes

echo " 移除原始碼目錄（自動搜尋）..."
rm -rf ~/hermes-agent ~/.hermes-agent

echo " 清除Python環境..."
pip uninstall hermes-agent tinker-atropos -y 2>/dev/null || true
pip cache purge

echo " 移除Node.js套件..."
rm -rf node_modules package-lock.json 2>/dev/null || true

echo "清除配置與資料..."
rm -rf ~/.hermes

echo "停用系統服務..."
# systemd
systemctl --user disable hermes-gateway 2>/dev/null || true
systemctl --user stop hermes-gateway 2>/dev/null || true
# macOS launchd
launchctl remove ai.hermes.gateway 2>/dev/null || true
# Cron任務
crontab -l | grep -v hermes | crontab -

echo " 徹底清除完成！"

 

Windows WSL2 專用清除

# PowerShell (系統管理員)
wsl --shutdown

# Ubuntu終端內執行上述Linux腳本
wsl -d Ubuntu-22.04 bash -c "
  hermes-complete-uninstall.sh
"

# Windows啟動項目
schtasks /delete /tn "Hermes Agent" /f

 

方法三：Docker容器環境清理

停止並移除所有容器：

docker stop $(docker ps -aq --filter "name=hermes") 2>/dev/null || true
docker rm $(docker ps -aq --filter "name=hermes") 2>/dev/null || true
docker image rm hermes-agent:latest 2>/dev/null || true
docker volume rm $(docker volume ls -q | grep hermes) 2>/dev/null || true
docker system prune -f

 

docker-compose專案：

cd ~/hermes-agent  # 或你的專案目錄
docker-compose down -v --remove-orphans
rm -rf docker-compose.yml .env

 

驗證完全移除

終端檢查指令：

# 指令是否存在
which hermes || echo " hermes指令已移除"

# 程序檢查
ps aux | grep hermes || echo " 無Hermes程序運行"

# 服務檢查
systemctl --user list-units | grep hermes || echo "服務已停用"

# 檔案殘留掃描
find ~ -name "*hermes*" -type d 2>/dev/null || echo "無配置殘留"

 

完美移除輸出：

hermes指令已移除
無Hermes程序運行
服務已停用
無配置殘留

 

常見問題與緊急救援

問題場景	解決方案
hermes: command not found 但仍有殘留	執行手動清除腳本
Docker容器無法停止	docker kill $(docker ps -aq --filter "name=hermes")
WSL2網路異常後殘留	wsl --unregister Ubuntu-22.04 重裝Ubuntu
macOS權限錯誤	sudo rm -rf ~/.hermes
Telegram Bot仍在運作	/stop 或聯絡@BotFather刪除Bot

 

香港環境特殊清理

家用路由器端口釋放：

# 檢查占用端口
netstat -tulpn | grep :8000
# 釋放Telegram Webhook
curl -X DELETE https://api.telegram.org/bot/deleteWebhook

 

VPS雲端徹底清除：

# 香港Vultr/Hostinger
sudo apt purge python3.11 python3-pip nodejs npm -y
sudo rm -rf /opt/hermes /var/lib/hermes
sudo reboot

 

移除後系統優化

清理Python快取：

pip cache purge
rm -rf ~/.cache/pip ~/.cache/node

 

重置環境變數：

# 編輯 ~/.bashrc 或 ~/.zshrc
nano ~/.bashrc
# 移除HERMES_*相關行
source ~/.bashrc

 

開機加速：

# 移除啟動服務
sudo update-rc.d -f hermes remove 2>/dev/null || true

 

為何需要徹底移除？

1. 避免衝突：多AI框架共存易產生Python依賴衝突

2. 節省資源：閘道背景服務耗RAM與Token

3. 安全考量：已知CVE漏洞需完全清除

4. 遷移順暢：PaperClip AI需要乾淨環境

 

可以瀏覽/報讀 「香港AI學院」的 「Hermes Agent AI教學課程」以了解及學習更多Hermes Agent各種設定、功能、技巧和應用。