2026年4月20日 星期一

Ubuntu 系統安裝 Hermes 與 OpenClaw 完整指南

🤖

Ubuntu 系統安裝 Hermes 與 OpenClaw

AI 代理框架完整部署指南 · 2025 最新版

# Ubuntu # Hermes Agent # OpenClaw # AI Agent

AI 代理(AI Agent)正在改變我們與電腦互動的方式。本文將帶你一步步在 Ubuntu 系統上安裝兩款超強的 AI 代理框架——Hermes AgentOpenClaw。 不管你是新手還是進階使用者,本指南都有詳細說明,確保你能順利完成安裝!

⚡ 兩款 AI 代理快速比較

🧠

Hermes Agent

  • 自動化安裝,極簡上手
  • 自動處理 Python 3.11 等依賴
  • 支援 Linux / macOS / WSL2
  • 互動式終端介面(TUI)
  • 適合新手首選 ✅
🦅

OpenClaw

  • 基於 Node.js 20+ 運行
  • 支援背景守護進程(Daemon)
  • 可連結 Telegram 等通訊軟體
  • 適合伺服器長期部署
  • 進階使用者首選 🚀

🧠

第一部分:安裝 Hermes Agent

過程最自動化、最適合新手的 AI 代理框架

1

確保系統已安裝 Git

📌 說明:Hermes 唯一要求你事先準備好的工具是 Git,用來下載程式碼。

sudo apt update && sudo apt install git -y
2

執行自動安裝腳本 ✨

📌 說明:這是一行神奇的自動化指令。它會自動下載程式庫、建立虛擬環境,並安裝所有必要工具(如 uv、ripgrep、ffmpeg 等),完全不需要手動干預。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
注意:執行後請耐心等待一到兩分鐘,直到畫面顯示安裝完成。
3

重新載入系統設定

📌 說明:安裝完成後,系統還不認識 hermes 這個新指令,需要重新載入設定檔讓它生效。

# bash 使用者
source ~/.bashrc

# zsh 使用者
source ~/.zshrc
驗證:輸入 hermes --version,如果顯示版本號(例如 v0.8.0),代表安裝大功告成!
4

設定您的 AI 模型密鑰 🔑

📌 說明:Hermes 是一個大腦框架,需要連接大語言模型(如 OpenAI、Anthropic 或 OpenRouter)才能運作。

hermes setup

畫面上會出現互動式選單,跟著精靈選擇提供商(例如 OpenRouter),並貼上您的 API 密鑰即可。

5

開始聊天!🚀

hermes

這會啟動互動式終端介面,您可以直接打字派發任務給它!也可以使用 hermes model 隨時切換大語言模型。


🦅

第二部分:安裝 OpenClaw

需要手動準備 Node.js 20+ 環境的進階 AI 代理

⚠️ 重要提醒:Ubuntu 內建套件庫的 Node.js 版本通常太舊,OpenClaw 要求 Node.js 20 或以上版本(推薦 22 甚至 24)。這是最容易卡關的地方!
1

安裝正確版本的 Node.js

📌 說明:透過 NodeSource 官方來源安裝最新版的 Node.js,確保版本符合 OpenClaw 的要求。

# 第一步:加入 NodeSource 儲存庫
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -

# 第二步:安裝 Node.js
sudo apt-get install -y nodejs
驗證:輸入 node --version,確認顯示 v20.x.x 或以上版本。
2

安裝 OpenClaw 核心程式

📌 說明:使用 npm(Node.js 的套件管理員)將 OpenClaw 安裝到全域環境中。

npm install -g openclaw@latest
🚫 防雷提醒:如果遇到 EACCES 權限錯誤,請不要加 sudo 執行,而是修改 npm 的全域預設路徑(prefix 設定)來解決。
3

初始化與背景服務設定 ⚙️

📌 說明:啟動設定精靈,可選擇將 OpenClaw 設定為 24 小時背景守護進程(Daemon)持續運行。

# 完整初始化(含背景 Daemon)
openclaw onboard --install-daemon

# 或只做基本初始化
openclaw init

精靈會引導你填入 API 密鑰(如 Anthropic 的 sk-ant-...),並詢問是否連結 Telegram 等通訊軟體。

4

執行您的第一個任務 🎯

openclaw run "請列出目前目錄下的所有檔案並總結"

OpenClaw 就會自動規劃任務、執行終端機指令並給出結果!


🔧

進階:Hermes 手動安裝方式

適合需要完全掌控安裝過程的進階使用者

# 1. 複製儲存庫(含子模組)
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# 2. 安裝 uv 並建立虛擬環境
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv
source .venv/bin/activate

# 3. 安裝 Python 依賴項(含所有功能)
uv pip install -e ".[all]"

# 4. 建立設定目錄並新增 API 密鑰
mkdir -p ~/.hermes
# 在 ~/.hermes/.env 中加入:OPENROUTER_API_KEY=您的密鑰

# 5. 設定模型並診斷系統
hermes model
hermes doctor

💡 給您的建議

🌱 新手推薦

先從 Hermes Agent 開始!自動安裝腳本幫你省去大量環境設定的麻煩,能最快體驗到 AI 代理的強大功能。

🚀 進階推薦

若需要 24 小時背景運行或整合 Telegram 通知,OpenClaw 的守護進程模式非常適合部署在伺服器上。

🏷️ 相關標籤

#Ubuntu #HermesAgent #OpenClaw #AIAgent #Linux教學 #NodeJS #Python #NousResearch

沒有留言:

張貼留言