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

一、核心定位與適用場(chǎng)景

先搞清楚它能做什么，再?zèng)Q定要不要學(xué)：

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

二、零基礎(chǔ)入門：安裝前先選路徑

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

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

Hermes Agent 跑本地 AI 模型時(shí)，主要吃內(nèi)存（RAM），其次是 CPU 核心數(shù)。

2. 推薦安裝路徑

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

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

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

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

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

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

然后直接啟動(dòng)：

hermes

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

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

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

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

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

在 PowerShell 中執(zhí)行：

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

這會(huì)自動(dòng)處理 Python、倉(cāng)庫(kù)下載、虛擬環(huán)境、依賴和基礎(chǔ)配置。

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

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

（1）安裝基礎(chǔ)依賴軟件

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

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

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

（2）克隆項(xiàng)目并進(jìn)入目錄

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

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

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

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

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

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

python -m venv venv
venv\Scripts\activate

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

（4）安裝項(xiàng)目依賴

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

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

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

pip install --upgrade pip
pip install setuptools wheel

（5）驗(yàn)證 Windows 安裝成功

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

hermes --version

7. 首次配置（全系統(tǒng)通用）

安裝后無(wú)需手動(dòng)修改配置文件，運(yùn)行以下命令進(jìn)入交互式向?qū)?，按提示完成配置即可?/p>

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

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

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

8. 驗(yàn)證安裝（全系統(tǒng)通用）

運(yùn)行以下命令，確認(rèn)環(huán)境正常，無(wú)報(bào)錯(cuò)即為安裝成功：

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

9. Windows 常用補(bǔ)充命令（專屬）

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

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

10. Windows 常見(jiàn)報(bào)錯(cuò)解決（專屬）

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

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

報(bào)錯(cuò)2：端口被占用 / 網(wǎng)絡(luò)錯(cuò)誤原因：防火墻攔截 Python，或代理影響網(wǎng)絡(luò)連接。

解決：關(guān)閉電腦防火墻（臨時(shí)），或切換代理節(jié)點(diǎn)，確保能正常訪問(wèn) GitHub。

報(bào)錯(cuò)3：Python 版本不兼容原因：安裝的 Python 版本低于 3.10 或高于 3.11。

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

報(bào)錯(cuò)4：「不是內(nèi)部或外部命令」

這是 Windows 找不到名為 hermes 的可執(zhí)行文件 時(shí)的典型報(bào)錯(cuò)，常見(jiàn)原因有：

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

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

適用于倉(cāng)庫(kù)已在本地（例如 D:\projects\hermes-agent）：

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

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

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

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

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

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

Hermes 命令簡(jiǎn)潔清晰，按場(chǎng)景分類如下，復(fù)制即可用：

1. 基礎(chǔ)交互命令

2. 配置管理命令

3. 網(wǎng)關(guān)與部署命令（多平臺(tái)接入）

4. 運(yùn)維與更新命令

5. 對(duì)話內(nèi)快捷指令（聊天中直接輸入）

四、實(shí)戰(zhàn)示例：從 0 到 1 完成第一個(gè)任務(wù)

場(chǎng)景：用 Hermes 生成項(xiàng)目周報(bào)并沉淀技能

啟動(dòng)對(duì)話：

hermes

發(fā)送任務(wù)指令：

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

執(zhí)行過(guò)程：Hermes 自動(dòng)調(diào)用 file 工具讀取文件、分析內(nèi)容、生成報(bào)告，全程無(wú)需手動(dòng)干預(yù)。

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

“生成周報(bào)” 直接調(diào)用已存技能，效率翻倍。

場(chǎng)景：多平臺(tái)消息接入（Telegram 機(jī)器人）

配置網(wǎng)關(guān)：

hermes gateway setup

按提示選擇 Telegram，粘貼 Bot Token（@BotFather 獲?。?，配置允許的用戶 ID（@userinfobot 查詢）。

啟動(dòng)網(wǎng)關(guān)并安裝為服務(wù)（開機(jī)自啟）：

hermes gateway install

驗(yàn)證：打開 Telegram 與機(jī)器人對(duì)話，發(fā)送 “你好”，測(cè)試回復(fù)。

五、深度對(duì)比：Hermes Agent vs OpenClaw

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

1. 核心維度對(duì)比表

2. 適用場(chǎng)景選型建議

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

3. 核心差異一句話總結(jié)

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

六、常見(jiàn)問(wèn)題與排障

安裝失敗（依賴錯(cuò)誤）

• 問(wèn)題：No module named yaml 或 cython 報(bào)錯(cuò)；
• 解決：手動(dòng)安裝依賴 pip install pyyaml cython，或重新運(yùn)行安裝腳本。

網(wǎng)關(guān)連接失?。ㄈ?Telegram 無(wú)回復(fù)）

• 排查：檢查 API Key 是否正確、用戶 ID 是否配置、網(wǎng)關(guān)是否啟動(dòng)（hermes gateway）；
• 日志查看：journalctl \-u hermes\-gateway（Linux）。

模型調(diào)用失敗（API 額度 / 密鑰錯(cuò)誤）

• 解決：確認(rèn) API Key 有效，檢查額度，切換免費(fèi)模型（如 OpenRouter 免費(fèi)模型）。

七、總結(jié)與下一步

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

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

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

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

最新評(píng)論