OpenClaw 完整卸載指南與 Hermes Agent 安裝教學
核心摘要
本文提供兩套完整流程:(1)徹底移除 OpenClaw(小龍蝦 🦞),包含服務停止、配置清理、外部授權撤銷與 API Key 輪換;(2)安裝並設定 Nous Research 的 Hermes Agent,涵蓋一鍵部署、模型配置、Gateway 連接,以及從 OpenClaw 無痛遷移的實戰技巧。
為什麼需要完整卸載 OpenClaw?
OpenClaw(中文圈俗稱「小龍蝦」🦞)是 Peter Steinberger 開發的開源 AI Agent 框架,以「能真正執行任務的 AI」為賣點——讀取郵件、操作桌面、執行多步驟工作流程。儘管功能強大,但在安全層面存在幾個不容忽視的隱患。
首先是授權範圍過於廣泛。安裝過程中,你可能已授予 Google、Slack、Discord、GitHub、Notion、Microsoft 等多個平台的 OAuth 權限,這些權限一旦授出,即使卸載軟體也不會自動撤銷。其次是 API Key 外洩風險,OpenAI、Claude、DeepSeek 等服務的金鑰會被寫入本機配置檔,若未妥善清理,可能成為安全漏洞。
此外,OpenClaw 會在系統中留下後台常駐服務——macOS 的 launchd、Linux 的 systemd --user、Windows 的排程任務都可能持續運行。更麻煩的是多處殘留目錄,包括 ~/.openclaw、~/.clawdbot、~/.moltbot、~/.molthub 等隱藏資料夾,單純執行 rm -rf 一個目錄並不足以完全清除。
下面將分兩個部分,提供完整的清理與安裝流程。
Part 1:OpenClaw 完整卸載流程
步驟一:停止所有運行中的服務
在執行官方卸載程序之前,必須先確保沒有任何進程佔用相關檔案。
macOS 環境
launchctl list | grep -iE 'openclaw|molt|clawd'
# 若有輸出,逐一卸載
launchctl bootout gui/$(id -u)/ai.openclaw.gateway 2>/dev/null || true
Linux 環境(systemd --user)
systemctl --user stop openclaw-gateway
systemctl --user disable openclaw-gateway
Windows 環境(PowerShell,需以系統管理員身分執行)
Get-ScheduledTask | Where-Object { $_.TaskName -like "*openclaw*" } | Unregister-ScheduledTask -Confirm:$false
步驟二:執行官方卸載命令(建議優先使用)
只要 openclaw CLI 仍可使用,應優先採用官方卸載流程——它會自動處理大部分清理工作。
openclaw uninstall
執行後會出現互動式選單:
◆ Uninstall which components?
│ ◼ Gateway service (launchd / systemd / schtasks)
│ ◼ State + config (~/.openclaw)
│ ◼ Workspace (agent files)
│ ◻ macOS app
前三項預設已勾選,直接按 Enter 繼續即可。若你是透過 .app 在 macOS 上安裝,請額外勾選第四項。下一個提示 Proceed with uninstall? 預設為 Yes,直接回車確認。
若只需單獨處理 Gateway 服務:
openclaw gateway uninstall
步驟三:移除 CLI 二進位檔案
根據當初的安裝方式選擇對應的卸載指令:
| 安裝方式 | 卸載指令 |
|---|---|
| Homebrew | brew uninstall openclaw |
| 從原始碼編譯 | 直接刪除原始碼目錄 |
步驟四:清理殘留配置目錄(關鍵步驟)
即使官方卸載程序已執行完畢,仍需手動檢查並清除以下隱藏目錄:
rm -rf ~/.openclaw
rm -rf ~/.clawdbot ~/clawdbot
rm -rf ~/.moltbot ~/.molthub
rm -rf ~/Library/LaunchAgents/ai.openclaw.gateway.plist # macOS
rm -rf ~/.config/systemd/user/openclaw-gateway.service # Linux
⚠️ 重要提醒
在刪除前,建議先備份~/.openclaw/openclaw.json和~/.openclaw/agents/*/agent/auth-profiles.json。這些檔案記錄了你曾授權的服務與使用過的 API Key,對於下一步的「撤銷授權與金鑰輪換」至關重要。
若你曾設定自訂環境變數 OPENCLAW_CONFIG_PATH 或 OPENCLAW_STATE_DIR,記得將對應路徑一併刪除。
步驟五:撤銷外部平台授權(最常被忽略的環節)
卸載本機軟體並不等於撤銷你授予它的權限。OpenClaw 曾經可以讀取你的 Gmail、發送 Slack 訊息、建立 GitHub PR——這些 OAuth Token 若不主動撤銷,即使 OpenClaw 已從電腦上消失,Token 依然有效。
以下是各平台的撤銷路徑:
| 平台 | 撤銷路徑 |
|---|---|
| myaccount.google.com/permissions | |
| Slack | slack.com/apps/manage |
| Discord | 設定 → 授權的應用 → 取消授權 |
| GitHub | Settings → Applications → Authorized OAuth Apps → Revoke |
| Microsoft | account.live.com/consent/Manage |
| Notion | Settings → Connections → 移除 OpenClaw |
| Telegram | @BotFather → 檢查並刪除相關 Bot |
步驟六:輪換所有 API Key
務必將以下金鑰全部重新生成,並將舊金鑰作廢:
- OpenAI / Anthropic / Google Gemini / DeepSeek 等 LLM 服務的 API Key
- AWS / 阿里雲 / 騰訊雲 / GCP 的 Access Key
- 任何第三方 SaaS 的 API Token
- 資料庫連線憑證(若 OpenClaw 曾存取過)
步驟七:最終驗證檢查清單
執行完整清理流程後,透過以下六項檢查確認所有殘留已清除:
# 1. CLI 已移除
which openclaw # 預期:openclaw not found
openclaw --version 2>&1 # 預期:command not found
# 2. 配置目錄已清空
ls ~/.openclaw ~/.clawdbot ~/.moltbot ~/.molthub 2>&1
# 預期:No such file or directory
# 3. 後台服務已停止
launchctl list | grep -iE 'openclaw|molt|clawd' # macOS
systemctl --user list-units | grep -i openclaw # Linux
# 4. 預設埠已釋放
lsof -i :18789 # 預期:無輸出
# 5. 無殘留進程
ps aux | grep -i openclaw | grep -v grep # 預期:無輸出
六項檢查全部通過,代表你已與小龍蝦正式道別。🦞👋
Part 2:Hermes Agent 安裝與設定
Hermes Agent 是 Nous Research 推出的開源 AI 助理,與 OpenClaw 同屬「能實際執行任務的 Agent」領域,但在架構上更加開放與彈性。
Hermes Agent 的核心優勢包括:模型無關性——支援 OpenRouter(200+ 模型)、Nous Portal、OpenAI、Anthropic、Gemini,以及本機 Ollama;自我進化能力——會將你使用過的工作流程自動沉澱為可重用的 Skills,使用越多越聰明;統一 Gateway——Telegram、Discord、Slack、WhatsApp、Signal、Email、Home Assistant 一站式接入;部署彈性——從 $5 VPS 到 GPU 叢集,再到 Serverless 架構皆可運行;以及從 OpenClaw 自動遷移——安裝精靈會偵測 ~/.openclaw 並主動詢問是否遷移配置、Skills 與 Memory。
前置條件
唯一的硬性需求是 Git。其他依賴項目(uv、Python 3.11、Node.js 22、ripgrep、ffmpeg)都由安裝腳本自動處理,不需要 sudo 權限。
- ✅ 支援平台:Linux / macOS / WSL2 / Android (Termux)
- ❌ Windows 原生環境:請先安裝 WSL2,並在 WSL2 終端機內操作
步驟一:一鍵安裝
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安裝完成後,重新載入 Shell 環境:
source ~/.zshrc # 若使用 zsh
# 或
source ~/.bashrc # 若使用 bash
🔄 從 OpenClaw 遷移
如果你尚未刪除~/.openclaw(或有備份),安裝精靈會自動偵測並提示「是否將設定、Skills、Memory 一鍵遷移過來?」若想無痛過渡,建議先安裝 Hermes 再刪除 OpenClaw 殘留。
手動安裝(適合需要完全掌控的使用者)
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
# 若先前 clone 時未加 --recurse-submodules:
git submodule update --init --recursive
步驟二:選擇並設定 LLM Provider
首次執行安裝時會進入互動式設定精靈,你也可以隨時單獨重新執行:
hermes model # 切換 LLM Provider 與模型
hermes tools # 選擇啟用的工具
hermes gateway setup # 設定 Telegram / Discord / Slack 等 Gateway
hermes config set # 設定單一配置值
hermes setup # 重新執行完整精靈
選項 A:OpenRouter(最推薦,支援 200+ 模型)
- 前往 openrouter.ai 註冊並取得 API Key
- 執行
hermes model→ 選擇 OpenRouter - 貼上 API Key
- 建議模型:
anthropic/claude-sonnet-4、openai/gpt-4o、meta-llama/llama-3.1-405b
選項 B:本機 Ollama(免費且注重隱私)
# 先確保 Ollama 正在運行
ollama serve &
ollama pull hermes3:8b # 或其他支援 function calling 的模型
hermes model # 選擇 Ollama,填入 http://localhost:11434
選項 C:直接使用 OpenAI / Anthropic / Gemini
安裝精靈中各家服務都有專屬選項,只需貼入對應的 API Key 即可。
步驟三:連接訊息 Gateway(以 Telegram 為例)
- 在 Telegram 搜尋
@BotFather→ 輸入/newbot→ 取得 Bot Token - 執行:
hermes gateway setup
- 選擇 Telegram → 貼上 Bot Token → 設定允許對話的 User ID(可從
@userinfobot取得)
其他平台(Discord / Slack / WhatsApp / Signal / Email)的設定流程類似,都透過同一個 hermes gateway setup 入口進行。
步驟四:開始對話
hermes
第一次啟動後,試著下達以下指令,感受 Skills 系統的魔力:
幫我檢查目前專案的 git 狀態,如果有未提交的變更,整理一份 commit message 建議。
執行完畢後,Hermes 會將這個工作流程自動保存為一個 Skill。下次你只需說「幫我看一下 git」,它就能以更快、更精準的方式完成任務。
步驟五(選配):作為 MCP Server 接入編輯器
若你想在 VS Code / Zed / JetBrains 等編輯器中使用 Hermes:
pip install -e '.[mcp]'
hermes mcp
接著在編輯器的 MCP 設定中指向本機 Hermes 即可。
安全與使用建議
在日常使用 Hermes Agent 時,建議遵循以下最佳實踐。
首先是最小權限原則。給予 Hermes 的 API Key 應盡量只授予必要的 Scope,避免直接使用具有完整權限的 root token。這樣即使發生意外,影響範圍也能控制在最小。
其次是沙箱優先策略。對於涉及重大系統操作的任務,建議先在虛擬機或容器環境(例如你熟悉的 OrbStack + Docker)中測試,確認無誤後再於正式環境執行。
第三是定期審計工具權限。每隔一段時間執行 hermes tools 檢查已啟用的工具清單,將不再使用的工具關閉,減少潛在的攻擊面。
最後是備份 Memory 與 Skills。~/.hermes/ 目錄下的內容記錄了你的工作流程與知識積累,值得定期進行 snapshot 備份。
遇到問題時的資源
- 官方文件:hermes-agent.nousresearch.com/docs
- GitHub 專案:NousResearch/hermes-agent
- OpenClaw 卸載疑難:若遇到問題,可重新執行
openclaw uninstall,或參照 Part 1 步驟四逐個目錄手動清理
總結
完整的 OpenClaw 卸載流程包括:停止所有服務 → 執行官方 uninstall → 清理殘留目錄 → 撤銷外部授權並輪換 API Key → 執行六項驗證檢查。而 Hermes Agent 的安裝則相對簡潔:一行 curl 指令 → hermes model 選擇 Provider → hermes gateway setup 連接 Telegram → hermes 開始對話。
兩者的切換過程若操作得當,可以做到無縫遷移,同時確保系統安全與資料完整性。