大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



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

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

核心亮点一览：

项目地址： NousResearch/hermes-agent

---

2.1 系统要求

• Windows ¹⁰⁄₁₁（已启用 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 验证：

bash

docker –version

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

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

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

方法 A：镜像加速器

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

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

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

---

在 Windows CMD 或 PowerShell 中执行：

bash

docker pull nousresearch/hermes-agent:latest

拉取完成后验证：

bash

docker images | findstr hermes

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

---

4.1 创建数据目录

bash

mkdir %USERPROFILE%.hermes

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

4.2 运行 Setup 向导

bash

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

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

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

4.3 数据目录结构说明

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

---

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

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

编辑 .env 文件：

bash

notepad %USERPROFILE%.hermes.env

添加一行：

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

编辑 config.yaml：

bash

notepad %USERPROFILE%.hermesconfig.yaml

修改 model 部分：

yaml

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：

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：

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（对接聊天平台用）

bash

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 模式）

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

bash

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

6.3 查看运行状态

bash

docker exec -it hermes hermes status

---

7.1 微信对接

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

bash

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 配置向导：

bash

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

1. 选择 Telegram，粘贴 Token
2. 重启容器使配置生效：

bash

docker restart hermes

---

---

9.1 config.yaml 核心字段

9.2 .env 常用变量

---

10.1 升级 Hermes

bash

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 备份

定期备份数据目录：

bash

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

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

10.3 清理旧镜像

bash

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 部署，整个过程其实并不复杂，核心就三步：拉镜像 → 配模型 → 启动。

如果你在部署过程中遇到问题，可以在评论区留言，我会尽量回复。