一、Hermes Agent 是什么？

Hermes Agent 是 Nous Research 開發(fā)的開源自我進(jìn)化型 AI 智能體（MIT 許可證）。和普通聊天機(jī)器人不同，它具備 內(nèi)置學(xué)習(xí)閉環(huán)：能從經(jīng)驗(yàn)中自動(dòng)創(chuàng)建技能、主動(dòng)持久化知識(shí)、搜索歷史對(duì)話，并跨會(huì)話不斷加深對(duì)用戶的理解。

簡(jiǎn)單來說，它 越用越聰明。

核心亮點(diǎn)一覽：

項(xiàng)目地址： NousResearch/hermes-agent

二、環(huán)境準(zhǔn)備

2.1 系統(tǒng)要求

• Windows 10/11（已啟用 WSL2）
• Docker Desktop for Windows（啟用 WSL2 后端）
• 網(wǎng)絡(luò)可訪問 Docker Hub 或已配置鏡像加速
• LLM API 密鑰（MiniMax、OpenRouter 等）或本地模型服務(wù)

2.2 安裝 Docker Desktop

1. 下載 Docker Desktop：https://www.docker.com/products/docker-desktop
2. 安裝時(shí)勾選 "Use WSL 2 instead of Hyper-V"
3. 安裝完成后 重啟電腦
4. 打開 CMD 驗(yàn)證：

docker --version

看到類似 Docker version 27.x.x 的輸出就說明安裝成功。

2.3 配置鏡像加速（國(guó)內(nèi)用戶必做 ??）

國(guó)內(nèi)直接訪問 Docker Hub 大概率超時(shí)，這一步別跳過。

方法 A：鏡像加速器

打開 Docker Desktop → Settings → Docker Engine，在 JSON 配置中添加：

{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.xuanyuan.me"
  ]
}

點(diǎn)擊 Apply & Restart。

方法 B：代理配置（適合有科學(xué)上網(wǎng)工具的同學(xué)）

Docker Desktop → Settings → Resources → Proxies，填入你的代理地址：

HTTP Proxy:  http://127.0.0.1:7890
HTTPS Proxy: http://127.0.0.1:7890

?? 兩種方法選一種即可。如果你本身網(wǎng)絡(luò)環(huán)境沒問題，可以跳過這步。

三、拉取 Docker 鏡像

在 Windows CMD 或 PowerShell 中執(zhí)行：

docker pull nousresearch/hermes-agent:latest

拉取完成后驗(yàn)證：

docker images | findstr hermes

看到 nousresearch/hermes-agent 那一行就說明鏡像到位了。

四、初始化配置（Setup）

4.1 創(chuàng)建數(shù)據(jù)目錄

mkdir %USERPROFILE%\.hermes

所有配置、密鑰、會(huì)話、技能、記憶都存儲(chǔ)在這個(gè)目錄中，后續(xù)升級(jí)也不會(huì)丟失。

4.2 運(yùn)行 Setup 向?qū)?/h3>

docker run -it --rm ^
  -v %USERPROFILE%\.hermes:/opt/data ^
  nousresearch/hermes-agent setup

向?qū)?huì)引導(dǎo)你配置 LLM 提供商、API 密鑰、工具等，跟著提示一步步選就行。

?? 如果拉取鏡像超時(shí)，請(qǐng)先完成第 2.3 節(jié)的鏡像加速配置。

4.3 數(shù)據(jù)目錄結(jié)構(gòu)說明

Setup 完成后，.hermes 目錄下會(huì)生成以下內(nèi)容：

五、接入 LLM 模型

這是最關(guān)鍵的一步。Hermes Agent 支持多種模型提供商，下面分別介紹三種常見方案。

5.1 方案一：MiniMax（推薦國(guó)內(nèi)用戶）

編輯 .env 文件：

notepad %USERPROFILE%\.hermes\.env

添加一行：

MINIMAX_CN_API_KEY=sk-api-xxxxx……你的密鑰

編輯 config.yaml：

notepad %USERPROFILE%\.hermes\config.yaml

修改 model 部分：

model:
  default: MiniMax-M2.5
  provider: minimax-cn
  base_url: https://api.minimaxi.com/v1

?? 踩坑提醒： 中國(guó)區(qū)域名是 minimaxi.com（多一個(gè) i），不是 minimax.io。寫錯(cuò)了會(huì)一直報(bào) 401。

5.2 方案二：本地模型（Qwen3、Ollama 等）

如果你有本地部署的 OpenAI 兼容 API，配置如下：

編輯 .env：

OPENAI_API_KEY=dummy
OPENAI_API_BASE=http://172.28.138.207:8007/v1

編輯 config.yaml：

model:
  default: Qwen3-30B-A3B
  provider: custom
  base_url: http://172.28.138.207:8007/v1
  api_key: dummy
  context_length: 32768

?? 關(guān)鍵提示：

• 模型跑在本機(jī)？容器內(nèi)用 http://host.docker.internal:端口 訪問
• 模型在局域網(wǎng)其他機(jī)器？直接用 IP 地址
• 千萬別寫 localhost，Docker 容器里的 localhost 是容器自己

5.3 方案三：OpenRouter（200+ 模型，海外用戶推薦）

編輯 .env：

OPENROUTER_API_KEY=sk-or-xxxxx

編輯 config.yaml：

model:
  default: anthropic/claude-sonnet-4
  provider: openrouter
  base_url: https://openrouter.ai/api/v1

5.4 模型要求

?? Hermes 要求模型至少 64K 上下文窗口。 如果使用本地模型，需確保推理框架啟動(dòng)時(shí)設(shè)了足夠大的 context size（如 --ctx-size 65536），否則會(huì)啟動(dòng)失敗。

六、啟動(dòng)與運(yùn)行

6.1 后臺(tái)運(yùn)行 Gateway（對(duì)接聊天平臺(tái)用）

docker run -d --name hermes ^
  --restart unless-stopped ^
  -v %USERPROFILE%\.hermes:/opt/data ^
  nousresearch/hermes-agent gateway run

參數(shù)說明：

• -d：后臺(tái)運(yùn)行
• --restart unless-stopped：意外退出自動(dòng)重啟
• -v：掛載數(shù)據(jù)目錄

6.2 交互式聊天（CLI 模式）

不想對(duì)接平臺(tái)，就想在命令行聊？直接：

docker run -it --rm ^
  -v %USERPROFILE%\.hermes:/opt/data ^
  nousresearch/hermes-agent

6.3 查看運(yùn)行狀態(tài)

docker exec -it hermes hermes status

七、微信 / Telegram 對(duì)接

7.1 微信對(duì)接

微信通過 Hermes 內(nèi)置的橋接功能實(shí)現(xiàn)。配置完成后，新用戶首次發(fā)消息會(huì)觸發(fā)配對(duì)機(jī)制：

docker exec -it hermes hermes pairing approve weixin <配對(duì)碼>

如果想跳過配對(duì)，允許所有用戶直接使用，在 .env 中添加：

WEIXIN_ALLOW_ALL_USERS=true

7.2 Telegram 對(duì)接

1. 在 Telegram 搜索 @BotFather，發(fā)送 /newbot 創(chuàng)建你的機(jī)器人
2. 獲取 Bot Token
3. 運(yùn)行 Gateway 配置向?qū)В?/li>

docker run -it --rm ^
  -v %USERPROFILE%\.hermes:/opt/data ^
  nousresearch/hermes-agent gateway setup

1. 選擇 Telegram，粘貼 Token
2. 重啟容器使配置生效：

docker restart hermes

八、常用命令速查表

九、配置文件詳解

9.1 config.yaml 核心字段

9.2 .env 常用變量

十、日常維護(hù)

10.1 升級(jí) Hermes

docker pull nousresearch/hermes-agent:latest
docker rm -f hermes
docker run -d --name hermes ^
  --restart unless-stopped ^
  -v %USERPROFILE%\.hermes:/opt/data ^
  nousresearch/hermes-agent gateway run

?? 鏡像是無狀態(tài)的，所有數(shù)據(jù)在宿主機(jī)的 .hermes 目錄中，升級(jí)不會(huì)丟失數(shù)據(jù)。

10.2 備份

定期備份數(shù)據(jù)目錄：

xcopy %USERPROFILE%\.hermes %USERPROFILE%\.hermes-backup /E /I /Y

關(guān)鍵文件：config.yaml、.env、MEMORY.md、USER.md、sessions/ 目錄。

10.3 清理舊鏡像

docker image prune -f

十一、常見問題排查

十二、安全建議

1. 不要將 .env 提交到 Git 倉庫，里面包含 API 密鑰
2. 微信、Telegram 等網(wǎng)關(guān)建議 開啟用戶白名單（WEIXIN_ALLOW_ALL_USERS=false）
3. 生產(chǎn)環(huán)境建議將 terminal.backend 設(shè)為 docker 或 ssh，提供沙箱隔離
4. 定期更換 API 密鑰，特別是在泄露風(fēng)險(xiǎn)后
5. 定期備份 .hermes 目錄
6. 用 docker restart 而不是 docker rm + run 來避免配置遺漏

寫在最后

Hermes Agent 是一個(gè)非常有意思的項(xiàng)目——它不只是一個(gè)聊天機(jī)器人，而是一個(gè)能不斷自我進(jìn)化、記住你的偏好、自動(dòng)積累技能的 AI 助手。配合 Docker 部署，整個(gè)過程其實(shí)并不復(fù)雜，核心就三步：拉鏡像 → 配模型 → 啟動(dòng)。

到此這篇關(guān)于Hermes Agent Windows Docker 部署完全指南如何從零開始搭建你的自我進(jìn)化AI 智能體的文章就介紹到這了,更多相關(guān)Hermes Agent Windows Docker 部署內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論