Hermes Agent是由Nous Research開源的一款強大的AI Agent框架。它支持接入飛書、Telegram、Discord等17個消息平臺，并具備上下文記憶、技能學習、定時任務等高級能力。

隨著項目的爆火，許多開發(fā)者在嘗試部署時卻在第一步“安裝”上犯了難——官方文檔提供了多種安裝方式，到底該選哪種？

本文基于官方文檔和實際部署經驗，逐一拆解四種安裝方式的優(yōu)缺點，幫你少走彎路。

先說結論：
這四種安裝方式在最終實現(xiàn)的功能上完全一致。不管你用哪種方式部署，CLI交互、Gateway消息平臺接入、定時任務、技能系統(tǒng)等所有能力都沒有區(qū)別。它們的核心差異僅在于安裝流程、運維方式和適用環(huán)境。

方式一：curl一鍵腳本（官方推薦）

這是官方文檔Quickstart頁面的首推方式。只需一行命令：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh

腳本會自動檢測你的操作系統(tǒng)，并安裝uv（Python 包管理器）、Python 3.11、Node.js 22、ripgrep、ffmpeg。隨后克隆倉庫到 \~/.hermes/hermes-agent，創(chuàng)建虛擬環(huán)境，安裝全部依賴，最后啟動配置向導讓你選擇LLM提供商。

優(yōu)點：

• 極度自動化： 將官方手動文檔中的10 個步驟全部自動化，5-10 分鐘即可搞定。
• 免 sudo 權限： Python 版本通過 uv 管理，不污染系統(tǒng)原有的 Python 環(huán)境。
• 自帶服務化方案： 運行 hermes gateway install 就能自動生成 systemd（Linux）或 launchd（macOS）服務，輕松實現(xiàn) 7×24 后臺運行。
• 升級簡單： 后續(xù)只需執(zhí)行 hermes update 即可。

潛在大坑：

• 缺乏容器級隔離： 雖然 Python 用了虛擬環(huán)境，但 Node.js、ripgrep、ffmpeg 都是粗暴地全局安裝在宿主機上的。如果你的服務器正跑著依賴特定 Node 版本的核心項目，極易引發(fā)環(huán)境沖突。
• 系統(tǒng)兼容性限制： 群暉 NAS 的 DSM 系統(tǒng)底層經過裁剪，不是標準 Linux，該腳本無法跑通。

方式二：手動安裝（uv + pip）

即官方文檔 "Manual Installation" 章節(jié)記錄的流程：克隆倉庫 → 安裝 uv → 創(chuàng)建 venv → 安裝依賴 → 創(chuàng)建配置目錄 → 配置 API 密鑰 → 配置 PATH → 選擇模型 → 驗證安裝。

優(yōu)點：

• 按需安裝（Extras）： 可以精確控制安裝范圍。比如只要 CLI 就裝 .[cli]，需要消息平臺裝 .[messaging]，不需要拉取冗余依賴。
• 便于調試開發(fā)： 使用可編輯模式安裝（pip install -e），改動源碼立刻生效，是二次開發(fā)的最佳選擇。
• 過程完全可控： 每一步都在掌控之中，排錯清晰。

不足：

門檻較高： 需要理解 uv、venv、extras、PATH 等概念，對非 Python 背景用戶不友好。

運維成本： 同樣沒有容器隔離，且后臺常駐需自行手寫配置 systemd。

方式三：官方Dockerfile構建

Hermes 倉庫根目錄提供了一個官方的 Dockerfile。需要注意的是，截至目前，官方并沒有在 GitHub Packages 或 Docker Hub 提供預構建的鏡像。你需要自己 clone 源碼后在本地執(zhí)行 docker build。

優(yōu)點：

• 環(huán)境絕對隔離： 容器化運行，不影響宿主系統(tǒng)，隨用隨刪。
• 高可用性： 配合 docker-compose 的 restart: unless-stopped，天然支持 7×24 運行和宕機自動恢復。
• 跨平臺一致性： 部署可復現(xiàn)，在任何支持 Docker 的平臺上行為一致。

不足：

• 國內網絡極度不友好： 官方 Dockerfile 中的 pip 和 npm 全部走默認源，國內網絡下構建極慢，甚至大概率超時報錯。
• 鏡像體積偏大： 基礎鏡像使用了完整的 debian:13.4 而非 slim 變體。
• 升級繁瑣： 升級需要重新 git pull 并重新 docker build，不如一鍵腳本方便。

方式四：自定義 Docker 構建（國內網絡/NAS 優(yōu)選）

在官方 Dockerfile 的基礎上自行修改：加入國內鏡像源、更換輕量級基礎鏡像、添加代理配置。這也是筆者在群暉 NAS 上最終采用的穩(wěn)定方案。

核心改動參考：

# 1. 更換為更輕量的基礎鏡像
FROM debian:12-slim
# 2. 加入國內鏡像源加速構建
RUN pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
RUN npm config set registry https://registry.npmmirror.com

同時在 docker-compose.yml 中注入代理環(huán)境變量，實現(xiàn)“國際 API 走代理，國內大模型直連”：

environment:
  - HTTP_PROXY=http://your-proxy:7890
  - NO_PROXY=api.minimaxi.com,open.bigmodel.cn

優(yōu)點：

• 保留了 Docker 容器化的全部優(yōu)勢（隔離、自動重啟、持久化）。
• 徹底解決網絡痛點： 極速完成依賴下載，完美契合國內網絡環(huán)境。
• 高度定制化： 可靈活預裝額外工具或定制 entrypoint。

不足：

• 需要具備一定的 Dockerfile 編寫和 docker-compose 使用經驗。
• 在入門級處理器（如 NAS 的 Atom 芯片）上首次構建耗時較長（約 1-1.5 小時）。
• NAS特別注意： 群暉DSM 有 seccomp 限制，構建時可能需要加上DOCKER_BUILDKIT=0。

總結與建議

為了方便大家快速決策，這里將4種安裝方式的核心差異整理成表格：

不管哪種方式裝完，要是覺得純命令行太繁瑣，試試Molili（OpenClaw中文版），簡單配置一下就能和Hermes聯(lián)動，中文界面操作起來特別絲滑，小白也能輕松上手，不用死記命令。兩者搭配著用，既能發(fā)揮Hermes自進化、長程運行的優(yōu)勢，又能靠Molili簡化操作，國內用起來效率翻倍～

到此這篇關于Hermes Agent四種部署測評，到底該選哪種？的文章就介紹到這了,更多相關Hermes Agent部署內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持腳本之家！

最新評論