Hermes Agent Windows Docker 部署完全指南如何从零开始搭建你的自我进化AI 智能体

一、Hermes Agent 是什么？

Hermes Agent 是 Nous Research 开发的开源自我进化型 AI 智能体（MIT 许可证）。和普通聊天机器人不同，它具备 内置学习闭环：能从经验中自动创建技能、主动持久化知识、搜索历史对话，并跨会话不断加深对用户的理解。

简单来说，它 越用越聪明。

核心亮点一览：

项目地址： NousResearch/hermes-agent

二、环境准备

2.1 系统要求

• Windows 10/11（已启用 WSL2）
• Docker Desktop for Windows（启用 WSL2 后端）
• 网络可访问 Docker Hub 或已配置镜像加速
• LLM API 密钥（MiniMax、OpenRouter 等）或本地模型服务

2.2 安装 Docker Desktop

1. 下载 Docker Desktop：https://www.docker.com/products/docker-desktop
2. 安装时勾选 "Use WSL 2 instead of Hyper-V"
3. 安装完成后 重启电脑
4. 打开 CMD 验证：

docker --version

看到类似 Docker version 27.x.x 的输出就说明安装成功。

2.3 配置镜像加速（国内用户必做 ⚠️）

国内直接访问 Docker Hub 大概率超时，这一步别跳过。

方法 A：镜像加速器

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

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

点击 Apply & Restart。

方法 B：代理配置（适合有科学上网工具的同学）

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

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

💡 两种方法选一种即可。如果你本身网络环境没问题，可以跳过这步。

三、拉取 Docker 镜像

在 Windows CMD 或 PowerShell 中执行：

docker pull nousresearch/hermes-agent:latest

拉取完成后验证：

docker images | findstr hermes

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

四、初始化配置（Setup）

4.1 创建数据目录

mkdir %USERPROFILE%\.hermes

所有配置、密钥、会话、技能、记忆都存储在这个目录中，后续升级也不会丢失。

4.2 运行 Setup 向导

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

向导会引导你配置 LLM 提供商、API 密钥、工具等，跟着提示一步步选就行。

⚠️ 如果拉取镜像超时，请先完成第 2.3 节的镜像加速配置。

4.3 数据目录结构说明

Setup 完成后，.hermes 目录下会生成以下内容：

五、接入 LLM 模型

这是最关键的一步。Hermes Agent 支持多种模型提供商，下面分别介绍三种常见方案。

5.1 方案一：MiniMax（推荐国内用户）

编辑 .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

⚠️ 踩坑提醒： 中国区域名是 minimaxi.com（多一个 i），不是 minimax.io。写错了会一直报 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

💡 关键提示：

• 模型跑在本机？容器内用 http://host.docker.internal:端口 访问
• 模型在局域网其他机器？直接用 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 上下文窗口。 如果使用本地模型，需确保推理框架启动时设了足够大的 context size（如 --ctx-size 65536），否则会启动失败。

六、启动与运行

6.1 后台运行 Gateway（对接聊天平台用）

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

参数说明：

• -d：后台运行
• --restart unless-stopped：意外退出自动重启
• -v：挂载数据目录

6.2 交互式聊天（CLI 模式）

不想对接平台，就想在命令行聊？直接：

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

6.3 查看运行状态

docker exec -it hermes hermes status

七、微信 / Telegram 对接

7.1 微信对接

微信通过 Hermes 内置的桥接功能实现。配置完成后，新用户首次发消息会触发配对机制：

docker exec -it hermes hermes pairing approve weixin <配对码>

如果想跳过配对，允许所有用户直接使用，在 .env 中添加：

WEIXIN_ALLOW_ALL_USERS=true

7.2 Telegram 对接

1. 在 Telegram 搜索 @BotFather，发送 /newbot 创建你的机器人
2. 获取 Bot Token
3. 运行 Gateway 配置向导：

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 常用变量

十、日常维护

10.1 升级 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

💡 镜像是无状态的，所有数据在宿主机的 .hermes 目录中，升级不会丢失数据。

10.2 备份

定期备份数据目录：

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

关键文件：config.yaml、.env、MEMORY.md、USER.md、sessions/ 目录。

10.3 清理旧镜像

docker image prune -f

十一、常见问题排查

十二、安全建议

1. 不要将 .env 提交到 Git 仓库，里面包含 API 密钥
2. 微信、Telegram 等网关建议 开启用户白名单（WEIXIN_ALLOW_ALL_USERS=false）
3. 生产环境建议将 terminal.backend 设为 docker 或 ssh，提供沙箱隔离
4. 定期更换 API 密钥，特别是在泄露风险后
5. 定期备份 .hermes 目录
6. 用 docker restart 而不是 docker rm + run 来避免配置遗漏

写在最后

Hermes Agent 是一个非常有意思的项目——它不只是一个聊天机器人，而是一个能不断自我进化、记住你的偏好、自动积累技能的 AI 助手。配合 Docker 部署，整个过程其实并不复杂，核心就三步：拉镜像 → 配模型 → 启动。

到此这篇关于Hermes Agent Windows Docker 部署完全指南如何从零开始搭建你的自我进化AI 智能体的文章就介绍到这了,更多相关Hermes Agent Windows Docker 部署内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

最新评论