Hermes Agent —— Nous Research 出品的開源 AI Agent 框架，主打"越用越聰明"。本文手把手帶你從安裝到配置到排坑，全流程實操記錄。

前言

2026 年 AI Agent 賽道卷出了天際。OpenClaw（龍蝦）憑借多 Agent 協(xié)同火爆出圈后，另一款產(chǎn)品悄然崛起——Hermes Agent（愛馬仕），口號是 ** "the agent that grows with you" **，主打單一 Agent 的深度自我進化。

和 OpenClaw 最大的不同在于：Hermes 不是"用完歸零"的工具，而是一個會從每次交互中學習、沉淀技能、記住你偏好的成長型搭檔。用得越久，它越懂你。

本文將從環(huán)境準備 → 一鍵安裝 → 模型配置 → 網(wǎng)關(guān)部署 → 常見問題排查，完整記錄一次真實的部署過程，幫你少走彎路。

一、Hermes Agent 是什么？（30 秒速覽）

| 項目 | 說明 |

|------|------|

| 開發(fā)團隊 | Nous Research |

| 開源協(xié)議 | MIT（完全免費） |

| 核心賣點 | 閉環(huán)學習系統(tǒng) + 四層記憶架構(gòu) + 40+ 內(nèi)置工具 |

| 支持平臺 | Linux、macOS、WSL2、Android（Termux） |

| 消息平臺 | Telegram、Discord、Slack、WhatsApp、飛書 |

| 支持模型 | Claude、OpenRouter、DeepSeek、Qwen、Ollama 本地模型等 |

官方資源：

• 官網(wǎng)：hermes-agent.nousresearch.com
• 文檔：hermes-agent.nousresearch.com/docs
• GitHub：https://github.com/NousResearch/hermes-agent
• Discord 社區(qū)：官網(wǎng)底部 Join Discord 入口

二、環(huán)境準備

2.1 系統(tǒng)要求

Hermes Agent 支持 Linux、macOS、WSL2，不支持原生 Windows。

Windows 用戶必須先安裝 WSL2（Windows Subsystem for Linux），然后在 WSL2 內(nèi)運行。

推薦配置：

• CPU：2 核以上
• 內(nèi)存：4GB 以上（推薦 8GB+）
• 磁盤：10GB+ 可用空間
• 網(wǎng)絡(luò)：能訪問 GitHub（或配置鏡像）

2.2 前置依賴

好消息是——幾乎不需要手動裝任何東西。安裝腳本會自動處理：

• Python 3.11
• Node.js v22
• uv（Python 包管理器）
• ripgrep
• ffmpeg
• 虛擬環(huán)境

你唯一需要確保的是系統(tǒng)里有 git：

# 檢查 git 是否已安裝

git --version

  


# Ubuntu/Debian

sudo apt install git

  


# macOS（通常自帶，或用 Homebrew）

brew install git

2.3 網(wǎng)絡(luò)加速（國內(nèi)用戶必看）

如果你在國內(nèi)服務(wù)器部署，GitHub 和 npm/pip 的訪問速度可能很慢。建議提前配置鏡像：

Git 鏡像加速：

git config --global url."https://mirror.ghproxy.com/https://github.com".insteadOf "https://github.com"

pip 鏡像加速：

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
pip config set install.trusted-host mirrors.aliyun.com

npm 鏡像加速：

npm config set registry https://mirrors.cloud.tencent.com/npm/ --global

安裝完成后如果不需要加速了，可以用 git config --global --unset-all url.https://mirror.ghproxy.com/https://github.com".insteadOf 清除配置。

三、一鍵安裝

3.1 執(zhí)行安裝腳本

打開終端，執(zhí)行以下命令：

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

腳本會自動完成以下操作：

1. 檢測系統(tǒng)架構(gòu)（x86_64 / arm64）
2. 安裝 uv、Python 3.11、Node.js v22
3. 克隆 Hermes Agent 倉庫
4. 創(chuàng)建 Python 虛擬環(huán)境并安裝依賴
5. 注冊 hermes 全局命令

整個安裝過程大約需要 3-10 分鐘（取決于網(wǎng)絡(luò)速度）。

3.2 重新加載 Shell 配置

安裝完成后，必須重新加載 shell 配置才能使用 hermes 命令：

# bash 用戶
source ~/.bashrc
# zsh 用戶（macOS 默認）
source ~/.zshrc

3.3 驗證安裝

hermes --version

如果輸出了版本號，說明安裝成功！

四、模型配置

安裝好之后，下一步是配置 LLM 提供商。Hermes 支持多種模型后端：

4.1 交互式配置（推薦）

hermes setup

這會啟動一個交互式向?qū)?，引?dǎo)你完成：

• 選擇模型提供商
• 輸入 API Key
• 基本偏好設(shè)置

或者直接用模型選擇命令：

hermes model

4.2 支持的模型提供商

| 提供商 | 配置方式 | 說明 |

|--------|---------|------|

| Nous Portal | OAuth 登錄，零配置 | 官方訂閱服務(wù)，最簡單 |

| Anthropic Claude | API Key 或 Claude Code 授權(quán) | 注意：目前尚未被封禁 |

| OpenRouter | API Key | 支持 200+ 模型，靈活度高 |

| DeepSeek | API Key | 國內(nèi)用戶友好，性價比高 |

| 阿里云 DashScope | API Key | 支持 Qwen 系列 |

| Ollama | 本地運行 | 完全離線，隱私優(yōu)先 |

| 小米 MiMo-V2 | Nous Portal 接入 | 曾限免兩周 |

| 自定義端點 | OpenAI 兼容 API | vLLM、SGLang 等 |

4.3 手動配置示例

如果你想手動編輯配置文件：

# 打開配置文件
hermes config edit

配置文件位于 ~/.hermes/config.yaml，API Key 等密鑰會自動存入 ~/.hermes/.env。

使用 DeepSeek 的配置示例：

hermes config set model deepseek/deepseek-chat

hermes config set DEEPSEEK_API_KEY sk-your-key-here

使用 Ollama 本地模型的配置示例：

# 先啟動 Ollama

ollama serve

  


# 配置 Hermes 使用本地模型

hermes config set model ollama/llama3

4.4 輔助模型配置（進階）

Hermes 有一個 Auxiliary Models 模塊，專門處理圖像分析、網(wǎng)頁提取、Skill 匹配等"側(cè)任務(wù)"，自動分配給輕量模型以節(jié)省成本：

# ~/.hermes/config.yaml
auxiliary:
? vision:
? ? api_key: ${GOOGLE_API_KEY}
? delegation:
? ? api_key: ${DELEGATION_KEY}

默認會自動檢測并優(yōu)先使用 Gemini Flash，無需手動配置。

五、開始使用

5.1 CLI 模式（命令行交互）

直接輸入：

hermes

即可進入全交互式終端界面，開始和 Agent 對話。支持所有內(nèi)置工具（文件操作、終端命令、網(wǎng)頁搜索等）。

常用斜杠命令：

| 命令 | 功能 |

|------|------|

| /new 或 /reset | 開啟新對話 |

| /model [provider:model] | 快速切換模型 |

| /skills | 瀏覽已安裝技能 |

| /usage | 查看 Token 使用量 |

| /tools | 查看可用工具列表 |

5.2 消息網(wǎng)關(guān)模式（手機/多平臺）

如果你希望通過 Telegram、Discord、Slack 等平臺和 Agent 交互：

# 第一步：交互式網(wǎng)關(guān)配置

hermes gateway setup

  


# 第二步：啟動網(wǎng)關(guān)

hermes gateway

  


# 第三步（可選）：安裝為系統(tǒng)服務(wù)，開機自啟

hermes gateway install

按照向?qū)崾?，輸入各平臺的 Bot Token 即可完成接入。一套網(wǎng)關(guān)進程連接所有平臺，會話統(tǒng)一管理。

六、目錄結(jié)構(gòu)說明

了解配置目錄結(jié)構(gòu)，有助于后續(xù)排查問題：

~/.hermes/

├── config.yaml ? ? # 主配置文件（模型、終端、TTS 等）

├── .env? ? ? ? ? ? # API Key 等密鑰（不要提交到 Git！）

├── auth.json ? ? ? # OAuth 憑證（Nous Portal 等）

├── SOUL.md ? ? ? ? # Agent 人格設(shè)定（系統(tǒng)提示詞 slot #1）

├── memories/ ? ? ? # 持久記憶（MEMORY.md、USER.md）

├── skills/ ? ? ? ? # Agent 自動創(chuàng)建的技能文件

├── cron/ ? ? ? ? ? # 定時任務(wù)

├── sessions/ ? ? ? # 網(wǎng)關(guān)會話記錄

└── logs/ ? ? ? ? ? # 日志（errors.log、gateway.log）

常用管理命令：

hermes config? ? ? ? ? ? ? # 查看當前配置

hermes config edit ? ? ? ? # 編輯配置文件

hermes config check? ? ? ? # 檢查缺失配置

hermes config migrate? ? ? # 交互式補充缺失配置

hermes update? ? ? ? ? ? ? # 更新到最新版本

七、從 OpenClaw 遷移

如果你之前是 OpenClaw 用戶，Hermes 提供了一鍵遷移工具：

# 首次 setup 時會自動檢測 ~/.openclaw 目錄并提示遷移

hermes setup

  


# 或手動觸發(fā)遷移

hermes claw migrate

遷移內(nèi)容包括：

• SOUL.md（人格設(shè)定）
• MEMORY.md / USER.md（記憶文件）
• 已有技能
• API Key 配置
• 消息平臺配置

八、常見問題排查

? 問題 1：hermes: command not found

原因： Shell 配置未重新加載。

解決：

source ~/.bashrc ? # 或 source ~/.zshrc

  


# 如果還不行，手動添加到 PATH

export PATH="$HOME/.hermes/bin:$PATH"

? 問題 2：安裝腳本下載超時 / 連接失敗

原因： 國內(nèi)網(wǎng)絡(luò)無法直接訪問 GitHub。

解決：

# 方案一：配置 Git 鏡像（見 2.3 節(jié)）

git config --global url."https://mirror.ghproxy.com/https://github.com".insteadOf "https://github.com"

  


# 方案二：手動克隆后安裝

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

cd hermes-agent

bash scripts/install.sh

? 問題 3：Python 版本沖突

原因： 系統(tǒng)已有 Python 版本和 Hermes 要求的 3.11 沖突。

解決： Hermes 使用 uv 管理獨立的 Python 環(huán)境，通常不會沖突。如果仍有問題：

# 檢查 uv 是否正常

uv --version

  


# 手動安裝 uv

curl -LsSf https://astral.sh/uv/install.sh | sh

  


# 重新運行安裝腳本

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

? 問題 4：模型調(diào)用失敗 / API Key 無效

原因： API Key 配置錯誤或余額不足。

解決：

# 檢查當前模型配置

hermes config

  


# 重新配置模型

hermes model

  


# 檢查 .env 文件中的 Key 是否正確

cat ~/.hermes/.env

? 問題 5：Docker 后端啟動失敗

原因： Docker 未安裝或未運行。

解決：

# 檢查 Docker 狀態(tài)

docker version

  


# 如果 Docker 未安裝

# Ubuntu

sudo apt install docker.io

sudo systemctl start docker

sudo usermod -aG docker $USER

  


# macOS：安裝 Docker Desktop

  


# 或者切換回本地后端

hermes config set terminal.backend local

? 問題 6：網(wǎng)關(guān)啟動后 Telegram Bot 無響應(yīng)

原因： Bot Token 配置錯誤或網(wǎng)絡(luò)問題。

解決：

# 檢查網(wǎng)關(guān)日志

cat ~/.hermes/logs/gateway.log

  


# 重新配置網(wǎng)關(guān)

hermes gateway setup

  


# 確認 Bot Token 有效（在 Telegram 中找 @BotFather 驗證）

? 問題 7：內(nèi)存占用過高

原因： Hermes 會話積累過多或技能文件膨脹。

解決：

# 查看會話列表

hermes sessions list

  


# 清理舊會話

hermes sessions clean --before 2026-04-01

  


# 檢查記憶使用量（系統(tǒng)提示中會顯示百分比）

hermes config edit? # 查看 memories/ 目錄

? 問題 8：hermes update更新失敗

原因： Git 倉庫有本地修改沖突。

解決：

cd ~/.hermes

git stash? ? ? ? ? # 暫存本地修改

hermes update? ? ? # 重新更新

git stash pop? ? ? # 恢復(fù)本地修改

九、進階配置建議

9.1 終端后端選擇

Hermes 支持 6 種終端后端，根據(jù)你的使用場景選擇：

| 后端 | 適用場景 | 安全性 |

|------|---------|--------|

| local | 個人開發(fā)機，快速上手 | 無隔離 |

| docker | 需要沙箱隔離 | 完全隔離 |

| ssh | 遠程服務(wù)器部署 | 網(wǎng)絡(luò)隔離 |

| modal | 彈性云計算 | 云 VM 隔離 |

| daytona | 托管云開發(fā)環(huán)境 | 云容器隔離 |

| singularity | HPC 集群 | 命名空間隔離 |

# 切換到 Docker 后端（推薦生產(chǎn)環(huán)境使用）

hermes config set terminal.backend docker

9.2 記憶系統(tǒng)調(diào)優(yōu)

# ~/.hermes/config.yaml

memory:

? memory_enabled: true

? user_profile_enabled: true

? memory_char_limit: 2200? ? # Agent 記憶上限（~800 tokens）

? user_char_limit: 1375? ? ? # 用戶畫像上限（~500 tokens）

當記憶使用超過 80% 時，Agent 會自動合并和精簡條目。

9.3 定時任務(wù)

Hermes 內(nèi)置 cron 調(diào)度器，支持自然語言設(shè)置定時任務(wù)：

# 在對話中直接說

"每天早上 9 點給我發(fā)一份天氣報告"

"每周五下午 5 點生成本周工作總結(jié)"

十、總結(jié)

Hermes Agent 的安裝過程整體非常流暢，官方的一鍵腳本幾乎把所有臟活都干了。整個部署流程總結(jié)下來就是三步：

# 1. 安裝

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

source ~/.bashrc

  


# 2. 配置模型

hermes setup

  


# 3. 開始使用

hermes

相比 OpenClaw 的"多 Agent 并行"思路，Hermes 走的是"單 Agent 深度進化"路線——它不是最早上手的那個，但可能是越用越值的那個。如果你有一些重復(fù)性、會演化的工作流，愿意讓 AI 從日常使用中積累經(jīng)驗，Hermes Agent 值得花時間認真部署和打磨。

以上就是從零部署Hermes Agent的保姆級安裝教程的詳細內(nèi)容，更多關(guān)于Hermes Agent安裝與部署教程的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論