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

前言

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

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

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

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

| 項(xiàng)目 | 說明 |

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

| 開發(fā)團(tuán)隊(duì) | Nous Research |

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

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

| 支持平臺(tái) | Linux、macOS、WSL2、Android（Termux） |

| 消息平臺(tái) | 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)境準(zhǔn)備

2.1 系統(tǒng)要求

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

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

推薦配置：

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

2.2 前置依賴

好消息是——幾乎不需要手動(dòng)裝任何東西。安裝腳本會(huì)自動(dòng)處理：

• 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

腳本會(huì)自動(dòng)完成以下操作：

1. 檢測(cè)系統(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. 注冊(cè) hermes 全局命令

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

3.2 重新加載 Shell 配置

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

# bash 用戶
source ~/.bashrc
# zsh 用戶（macOS 默認(rèn)）
source ~/.zshrc

3.3 驗(yàn)證安裝

hermes --version

如果輸出了版本號(hào)，說明安裝成功！

四、模型配置

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

4.1 交互式配置（推薦）

hermes setup

這會(huì)啟動(dòng)一個(gè)交互式向?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)用戶友好，性價(jià)比高 |

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

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

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

| 自定義端點(diǎn) | OpenAI 兼容 API | vLLM、SGLang 等 |

4.3 手動(dòng)配置示例

如果你想手動(dòng)編輯配置文件：

# 打開配置文件
hermes config edit

配置文件位于 ~/.hermes/config.yaml，API Key 等密鑰會(huì)自動(dòng)存入 ~/.hermes/.env。

使用 DeepSeek 的配置示例：

hermes config set model deepseek/deepseek-chat

hermes config set DEEPSEEK_API_KEY sk-your-key-here

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

# 先啟動(dòng) Ollama

ollama serve

  


# 配置 Hermes 使用本地模型

hermes config set model ollama/llama3

4.4 輔助模型配置（進(jìn)階）

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

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

默認(rèn)會(huì)自動(dòng)檢測(cè)并優(yōu)先使用 Gemini Flash，無需手動(dòng)配置。

五、開始使用

5.1 CLI 模式（命令行交互）

直接輸入：

hermes

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

常用斜杠命令：

| 命令 | 功能 |

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

| /new 或 /reset | 開啟新對(duì)話 |

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

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

| /usage | 查看 Token 使用量 |

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

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

如果你希望通過 Telegram、Discord、Slack 等平臺(tái)和 Agent 交互：

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

hermes gateway setup

  


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

hermes gateway

  


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

hermes gateway install

按照向?qū)崾荆斎敫髌脚_(tái)的 Bot Token 即可完成接入。一套網(wǎng)關(guān)進(jìn)程連接所有平臺(tái)，會(huì)話統(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 自動(dòng)創(chuàng)建的技能文件

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

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

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

常用管理命令：

hermes config? ? ? ? ? ? ? # 查看當(dāng)前配置

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

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

hermes config migrate? ? ? # 交互式補(bǔ)充缺失配置

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

七、從 OpenClaw 遷移

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

# 首次 setup 時(shí)會(huì)自動(dòng)檢測(cè) ~/.openclaw 目錄并提示遷移

hermes setup

  


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

hermes claw migrate

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

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

八、常見問題排查

? 問題 1：hermes: command not found

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

解決：

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

  


# 如果還不行，手動(dòng)添加到 PATH

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

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

原因： 國內(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"

  


# 方案二：手動(dòng)克隆后安裝

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 管理獨(dú)立的 Python 環(huán)境，通常不會(huì)沖突。如果仍有問題：

# 檢查 uv 是否正常

uv --version

  


# 手動(dòng)安裝 uv

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

  


# 重新運(yùn)行安裝腳本

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

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

原因： API Key 配置錯(cuò)誤或余額不足。

解決：

# 檢查當(dāng)前模型配置

hermes config

  


# 重新配置模型

hermes model

  


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

cat ~/.hermes/.env

? 問題 5：Docker 后端啟動(dòng)失敗

原因： Docker 未安裝或未運(yùn)行。

解決：

# 檢查 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)啟動(dòng)后 Telegram Bot 無響應(yīng)

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

解決：

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

cat ~/.hermes/logs/gateway.log

  


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

hermes gateway setup

  


# 確認(rèn) Bot Token 有效（在 Telegram 中找 @BotFather 驗(yàn)證）

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

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

解決：

# 查看會(huì)話列表

hermes sessions list

  


# 清理舊會(huì)話

hermes sessions clean --before 2026-04-01

  


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

hermes config edit? # 查看 memories/ 目錄

? 問題 8：hermes update更新失敗

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

解決：

cd ~/.hermes

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

hermes update? ? ? # 重新更新

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

九、進(jìn)階配置建議

9.1 終端后端選擇

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

| 后端 | 適用場(chǎng)景 | 安全性 |

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

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

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

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

| modal | 彈性云計(jì)算 | 云 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）

當(dāng)記憶使用超過 80% 時(shí)，Agent 會(huì)自動(dòng)合并和精簡條目。

9.3 定時(shí)任務(wù)

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

# 在對(duì)話中直接說

"每天早上 9 點(diǎn)給我發(fā)一份天氣報(bào)告"

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

十、總結(jié)

Hermes Agent 的安裝過程整體非常流暢，官方的一鍵腳本幾乎把所有臟活都干了。整個(gè)部署流程總結(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 深度進(jìn)化"路線——它不是最早上手的那個(gè)，但可能是越用越值的那個(gè)。如果你有一些重復(fù)性、會(huì)演化的工作流，愿意讓 AI 從日常使用中積累經(jīng)驗(yàn)，Hermes Agent 值得花時(shí)間認(rèn)真部署和打磨。

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

最新評(píng)論