OpenClaw 完整卸載指南與 Hermes Agent 安裝教學

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_PATHOPENCLAW_STATE_DIR,記得將對應路徑一併刪除。

步驟五:撤銷外部平台授權(最常被忽略的環節)

卸載本機軟體並不等於撤銷你授予它的權限。OpenClaw 曾經可以讀取你的 Gmail、發送 Slack 訊息、建立 GitHub PR——這些 OAuth Token 若不主動撤銷,即使 OpenClaw 已從電腦上消失,Token 依然有效。

以下是各平台的撤銷路徑:

平台 撤銷路徑
Google 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+ 模型)

  1. 前往 openrouter.ai 註冊並取得 API Key
  2. 執行 hermes model → 選擇 OpenRouter
  3. 貼上 API Key
  4. 建議模型:anthropic/claude-sonnet-4openai/gpt-4ometa-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 為例)

  1. 在 Telegram 搜尋 @BotFather → 輸入 /newbot → 取得 Bot Token
  2. 執行:
hermes gateway setup
  1. 選擇 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 備份。


遇到問題時的資源


總結

完整的 OpenClaw 卸載流程包括:停止所有服務 → 執行官方 uninstall → 清理殘留目錄 → 撤銷外部授權並輪換 API Key → 執行六項驗證檢查。而 Hermes Agent 的安裝則相對簡潔:一行 curl 指令 → hermes model 選擇 Provider → hermes gateway setup 連接 Telegram → hermes 開始對話。

兩者的切換過程若操作得當,可以做到無縫遷移,同時確保系統安全與資料完整性。