Hermes Agent 是由 Nous Research 出品的開源 AI 智能體框架，核心亮點在于自學習成長機制—— 能在執(zhí)行任務中自動沉淀技能、持久化記憶，越用越懂你。本文覆蓋零基礎入門、一鍵安裝、核心命令行實操，并與同類型框架 OpenClaw 做深度對比，幫你快速選型。

一、核心定位與適用場景

先搞清楚它能做什么，再決定要不要學：

一句話總結：如果你需要一個能 “自己寫手冊、越用越聰明” 的本地智能體，選 Hermes；如果偏好可視化配置、依賴現成技能庫，OpenClaw 更合適。

二、零基礎入門：安裝前先選路徑

1. 環(huán)境要求（全系統適配）

• 支持系統：Linux、macOS、WSL2
• Windows：官方 Quickstart 仍優(yōu)先推薦 WSL2；倉庫也已經提供 PowerShell 安裝腳本，但更適合愿意折騰原生環(huán)境的用戶
• Python：3.11+，推薦 3.11
• 基礎依賴：Git
• 可選依賴：Node.js 22+、ffmpeg、ripgrep（不是必須，但會影響瀏覽器工具、語音能力和搜索體驗）
• 硬件：最低 2C4G，推薦 4C8G；如果要跑本地模型，建議 8C16G 及以上

Hermes Agent 跑本地 AI 模型時，主要吃內存（RAM），其次是 CPU 核心數。

2. 推薦安裝路徑

• Linux / macOS / WSL2 用戶：優(yōu)先用官方一鍵安裝腳本
• Windows 用戶：求穩(wěn)優(yōu)先用 WSL2
• Windows 原生用戶：可選 PowerShell 安裝腳本，或者從源碼手動安裝

3. Linux/macOS 一鍵安裝（推薦）

打開終端，執(zhí)行以下命令，自動完成 Python 3.11、依賴安裝與倉庫克隆，30秒即可搞定：

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

安裝完成后，重載 Shell 使命令生效：

# bash 用戶
source ~/.bashrc
# zsh 用戶
source ~/.zshrc

然后直接啟動：

hermes

4. Windows 推薦方案：WSL2 安裝（適合習慣 Linux 終端的用戶）

若習慣使用 Linux 終端，可在 Windows 上安裝 WSL2，然后執(zhí)行 Linux 一鍵安裝命令，步驟如下：

# 先安裝 WSL2（管理員身份運行 PowerShell）
wsl --install
# 重啟電腦后，打開 WSL2 終端，執(zhí)行 Linux 一鍵安裝命令
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

這條路徑和官方 Quickstart 保持一致，后續(xù)使用 Gateway、服務管理、日志查看時也更統一。

5. Windows 原生安裝 - 走 PowerShell 安裝腳本

在 PowerShell 中執(zhí)行：

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

這會自動處理 Python、倉庫下載、虛擬環(huán)境、依賴和基礎配置。

6. Windows 原生安裝 - 從源碼安裝（詳細步驟，適合普通用戶）

Windows 原生環(huán)境無需依賴 WSL，按以下步驟操作，全程可復制命令執(zhí)行，新手也能輕松完成。

（1）安裝基礎依賴軟件

• 安裝 Git：訪問 Git 官網，下載對應 Windows 版本，默認安裝即可（無需修改配置）。
• 安裝 Python 3.11+：訪問 Python 官網，下載對應版本，務必勾選“Add Python to PATH”（關鍵步驟，避免后續(xù)命令無法執(zhí)行），然后默認安裝。

驗證依賴安裝成功：打開 CMD 或 PowerShell，分別輸入以下命令，均能顯示版本號即為成功：

python --version
pip --version
git --version

（2）克隆項目并進入目錄

選擇一個合適的文件夾（如桌面），右鍵選擇“在此處打開終端/PowerShell”，執(zhí)行以下命令：

https://github.com/NousResearch/Hermes-Agent

git clone https://github.com/NousResearch/hermes-agent.git
cd Hermes-Agent

（也可以下載zip源碼后，把自己倉庫的.git文件夾復制到解壓的源碼項目里）
克隆之后推薦上傳到你自己的 GitHub/Gitee 私有倉庫，這樣換電腦后，直接拉取就能用已經沉淀過的技能

（3）創(chuàng)建并激活虛擬環(huán)境（推薦，避免污染系統）

虛擬環(huán)境可隔離項目依賴，避免與系統 Python 環(huán)境沖突，執(zhí)行以下命令：

python -m venv venv
venv\Scripts\activate

激活成功后，命令行前面會出現 \(venv\) 標識，后續(xù)操作需保持該標識處于激活狀態(tài)。

（4）安裝項目依賴

在激活虛擬環(huán)境的前提下，執(zhí)行以下命令，安裝項目所需全部依賴：

pip install -r requirements.txt
pip install -e .

若出現依賴安裝失敗，可先執(zhí)行以下命令更新 pip 和相關工具，再重新安裝依賴：

pip install --upgrade pip
pip install setuptools wheel

（5）驗證 Windows 安裝成功

執(zhí)行以下命令，若能顯示 Hermes Agent 版本信息，即為安裝成功：

hermes --version

7. 首次配置（全系統通用）

安裝后無需手動修改配置文件，運行以下命令進入交互式向導，按提示完成配置即可：

# 快速配置（推薦，全系統通用）
hermes setup
# 或分步配置（按需選擇）
hermes model  # 選擇模型提供商（OpenRouter/OpenAI/Ollama 等）
hermes tools  # 配置可用工具（web/terminal/file 等）

• 模型配置：粘貼對應模型提供商的 API Key（如 OpenRouter、OpenAI），推薦免費模型：nvidia/nemotron\-3\-super\-120b\-a12b:free。
• 本地模型（無 API Key 也可使用）：可搭配 Ollama 部署本地模型，全系統通用步驟如下：

# 1. 安裝 Ollama（Windows 直接訪問官網下載，Linux/macOS 執(zhí)行以下命令）
curl -fsSL https://ollama.com/install.sh | sh
# 2. 拉取本地模型（推薦 llama3.1，輕量且性能穩(wěn)定）
ollama pull llama3.1
# 3. 配置 Hermes 連接 Ollama，重新執(zhí)行配置向導
hermes setup

8. 驗證安裝（全系統通用）

運行以下命令，確認環(huán)境正常，無報錯即為安裝成功：

# 查看版本
hermes version
# 環(huán)境診斷（排查依賴/配置問題，全系統通用）
hermes doctor

9. Windows 常用補充命令（專屬）

Windows 環(huán)境下，每次打開終端使用 Hermes，需先執(zhí)行以下命令激活虛擬環(huán)境，匯總高頻命令如下，可直接復制使用：

# 1. 激活虛擬環(huán)境（每次打開終端必執(zhí)行）
venv\Scripts\activate
# 2. 啟動交互式對話
hermes
# 3. 退出 Hermes 對話
/exit
# 4. 退出虛擬環(huán)境
deactivate
# 5. 重新配置模型（Windows 專屬，無需重新安裝）
hermes model
# 6. 檢查 Windows 環(huán)境問題
hermes doctor
# 7. 啟動網關（Telegram/Discord 機器人等）
hermes gateway

10. Windows 常見報錯解決（專屬）

報錯1：'hermes' 不是內部或外部命令原因：未激活虛擬環(huán)境，或未執(zhí)行 pip install \-e \. 命令。

解決：先執(zhí)行venv\\Scripts\\activate 激活虛擬環(huán)境，若仍報錯，重新執(zhí)行 pip install \-e \.。

報錯2：端口被占用 / 網絡錯誤原因：防火墻攔截 Python，或代理影響網絡連接。

解決：關閉電腦防火墻（臨時），或切換代理節(jié)點，確保能正常訪問 GitHub。

報錯3：Python 版本不兼容原因：安裝的 Python 版本低于 3.10 或高于 3.11。

解決：卸載當前 Python 版本，重新安裝 3.10~3.11 之間的版本，務必勾選“Add Python to PATH”。

報錯4：「不是內部或外部命令」

這是 Windows 找不到名為 hermes 的可執(zhí)行文件 時的典型報錯，常見原因有：

1. 尚未安裝 Hermes Agent
   hermes 不是系統自帶命令，而是由 Python 包 hermes-agent 在安裝時寫入的「控制臺腳本」（入口在 pyproject.toml 的 [project.scripts] → hermes = "hermes_cli.main:main"）。未安裝時，命令行里輸入 hermes 就會報上述錯誤。
2. 已安裝但當前終端找不到腳本目錄
   通過 pip install 安裝后，hermes.exe 一般在當前 Python 環(huán)境的 Scripts 目錄（例如 ...\Python314\Scripts）。若該目錄 不在 PATH 環(huán)境變量 中，或你用的終端/IDE 沒繼承到更新后的 PATH，同樣會報「不是內部或外部命令」。
3. 與當前工作目錄無關
   該錯誤表示 系統按 PATH 查找失敗，而不是「當前文件夾里沒有 hermes」。

解決方式 A： 從本機源碼安裝（開發(fā)/自定義版本）

適用于倉庫已在本地（例如 D:\projects\hermes-agent）：

1. 安裝 Python 3.11+（與項目 requires-python 一致）。
2. 在項目根目錄執(zhí)行：
   • py -3 -m pip install -e ".[cli]"
     其中 [cli] 會裝上交互 CLI 所需的額外依賴（如 simple-term-menu）。
3. 新開一個終端（或重啟 IDE 終端），執(zhí)行 hermes --version 驗證；再執(zhí)行 hermes 進入交互界面。

若仍提示找不到命令，檢查「Python 的 Scripts 是否已加入用戶/系統 PATH」，或用完整路徑調用：<Python安裝目錄>\Scripts\hermes.exe。

方式 B： 官方推薦安裝（Linux / macOS / WSL）

官方 README 推薦用安裝腳本（Windows 原生未列為正式支持環(huán)境，「Windows 建議用 WSL2」）：

• 安裝完成后按文檔執(zhí)行 source ~/.bashrc（或 ~/.zshrc），再運行 hermes。

三、核心命令行大全：高頻操作速查

Hermes 命令簡潔清晰，按場景分類如下，復制即可用：

1. 基礎交互命令

2. 配置管理命令

3. 網關與部署命令（多平臺接入）

4. 運維與更新命令

5. 對話內快捷指令（聊天中直接輸入）

四、實戰(zhàn)示例：從 0 到 1 完成第一個任務

場景：用 Hermes 生成項目周報并沉淀技能

啟動對話：

hermes

發(fā)送任務指令：

“幫我讀取當前目錄下的 project\_log\.md 文件，總結本周工作內容，生成一份規(guī)范的周報，保存到 \~/reports/weekly\_report\.md。”

執(zhí)行過程：Hermes 自動調用 file 工具讀取文件、分析內容、生成報告，全程無需手動干預。

技能沉淀：任務完成后，Hermes 自動生成名為 generate\_weekly\_report 的技能，下次執(zhí)行同類任務只需說：

“生成周報” 直接調用已存技能，效率翻倍。

場景：多平臺消息接入（Telegram 機器人）

配置網關：

hermes gateway setup

按提示選擇 Telegram，粘貼 Bot Token（@BotFather 獲?。渲迷试S的用戶 ID（@userinfobot 查詢）。

啟動網關并安裝為服務（開機自啟）：

hermes gateway install

驗證：打開 Telegram 與機器人對話，發(fā)送 “你好”，測試回復。

五、深度對比：Hermes Agent vs OpenClaw

兩者均為優(yōu)秀的 AI Agent 框架，核心差異在于設計哲學與使用邏輯，以下是全維度對比：

1. 核心維度對比表

2. 適用場景選型建議

• 選 Hermes Agent 當且僅當： ? 需要智能體自我迭代，重復任務自動生成技能（如周報生成、數據匯總）； ? 重視長期記憶，希望智能體記住你的習慣、偏好、歷史任務； ? 追求本地可控，自托管部署，數據隱私優(yōu)先； ? 有一定終端基礎，愿意手動配置工具與模型。
• 選 OpenClaw 當且僅當： ? 偏好可視化操作，無需手動敲命令，快速搭建自動化流程； ? 依賴現成技能庫（5000+ 個社區(qū)貢獻技能），無需自己造輪子； ? 核心需求是跨平臺消息聯動，如微信 / 釘釘 / Slack 多渠道消息聚合； ? 非技術用戶，追求 “開箱即用” 的高效體驗。

3. 核心差異一句話總結

• Hermes：會成長的學徒—— 你教一次，它能舉一反三，自動學會新技能，越用越智能；
• OpenClaw：可配置的實習生—— 你給它操作手冊（技能），它按手冊執(zhí)行，不會主動學習，需要手動更新技能。

六、常見問題與排障

安裝失?。ㄒ蕾囧e誤）

• 問題：No module named yaml 或 cython 報錯；
• 解決：手動安裝依賴 pip install pyyaml cython，或重新運行安裝腳本。

網關連接失?。ㄈ?Telegram 無回復）

• 排查：檢查 API Key 是否正確、用戶 ID 是否配置、網關是否啟動（hermes gateway）；
• 日志查看：journalctl \-u hermes\-gateway（Linux）。

模型調用失敗（API 額度 / 密鑰錯誤）

• 解決：確認 API Key 有效，檢查額度，切換免費模型（如 OpenRouter 免費模型）。

七、總結與下一步

Hermes Agent 最有價值的地方，不只是“能調模型、能跑工具”，而是它把任務執(zhí)行、技能沉淀、記憶復用串成了一個長期閉環(huán)。如果你本來就習慣終端、愿意讓 Agent 融入自己的日常工作流，它會比很多一次性問答工具更耐用。

下一步你可以繼續(xù)做三件事：

1. 接入 Ollama，跑本地模型，降低使用成本
2. 配置 Gateway，把 Hermes 接到 Telegram / Discord / Slack
3. 嘗試讓它反復完成一類任務，觀察技能是否開始沉淀

以上就是Hermes Agent安裝與實戰(zhàn)指南：從安裝到與OpenClaw全方位對比的詳細內容，更多關于Hermes Agent安裝與實戰(zhàn)指南的資料請關注腳本之家其它相關文章！

最新評論