一、Hermes Agent 是什么？
Hermes Agent 是 Nous Research 开发的开源自我进化型 AI 智能体（MIT 许可证）。和普通聊天机器人不同，它具备 内置学习闭环：能从经验中自动创建技能、主动持久化知识、搜索历史对话，并跨会话不断加深对用户的理解。
简单来说，它 越用越聪明。
核心亮点一览：
| 多模型支持 | OpenRouter、OpenAI、MiniMax、Qwen、本地模型等，随时切换 |
| 多平台网关 | Telegram、Discord、Slack、WhatsApp、Signal、微信、邮件、CLI |
| 持久化记忆 | MEMORY.md + USER.md + SQLite 全文搜索，跨会话保留 |
| 自动技能 | 复杂任务后自动创建可复用技能文档 |
| 工具生态 | 浏览器、终端、文件、代码执行、定时任务、子代理等 27+ 工具 |
| 六种后端 | local、Docker、SSH、Daytona、Singularity、Modal |
项目地址： NousResearch/hermes-agent
二、环境准备
2.1 系统要求
- Windows 10/11（已启用 WSL2）
- Docker Desktop for Windows（启用 WSL2 后端）
- 网络可访问 Docker Hub 或已配置镜像加速
- LLM API 密钥（MiniMax、OpenRouter 等）或本地模型服务
2.2 安装 Docker Desktop
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
💡 两种方法选一种即可。如果你本身网络环境没问题，可以跳过这步。
三、拉取 Docker 镜像
在 Windows CMD 或 PowerShell 中执行：
bash
docker pull nousresearch/hermes-agent:latest
拉取完成后验证：
bash
docker images | findstr hermes
看到 nousresearch/hermes-agent 那一行就说明镜像到位了。
四、初始化配置（Setup）
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 目录下会生成以下内容：
| config.yaml | 主配置文件（模型、工具、后端等） |
| .env | API 密钥和环境变量 |
| skills/ | 技能文档目录 |
| sessions/ | 会话历史记录 |
| MEMORY.md | 环境事实、经验教训 |
| USER.md | 用户偏好和沟通风格 |
| logs/ | 日志文件 |
五、接入 LLM 模型
这是最关键的一步。Hermes Agent 支持多种模型提供商，下面分别介绍三种常见方案。
5.1 方案一：MiniMax（推荐国内用户）
编辑 .env 文件：
bash
notepad %USERPROFILE%\\.hermes\\.env
添加一行：
MINIMAX_CN_API_KEY=sk-api-xxxxx……你的密钥
编辑 config.yaml：
bash
notepad %USERPROFILE%\\.hermes\\config.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
七、微信 / Telegram 对接
7.1 微信对接
微信通过 Hermes 内置的桥接功能实现。配置完成后，新用户首次发消息会触发配对机制：
bash
docker exec -it hermes hermes pairing approve weixin <配对码>
如果想跳过配对，允许所有用户直接使用，在 .env 中添加：
WEIXIN_ALLOW_ALL_USERS=true
7.2 Telegram 对接
bash
docker run -it –rm ^
-v %USERPROFILE%\\.hermes:/opt/data ^
nousresearch/hermes-agent gateway setup
bash
docker restart hermes
八、常用命令速查表
| docker exec -it hermes hermes status | 查看当前状态 |
| docker exec -it hermes hermes model | 切换模型/提供商 |
| docker exec -it hermes hermes tools | 配置工具 |
| docker exec -it hermes hermes setup | 重新运行 Setup 向导 |
| docker exec -it hermes hermes doctor | 诊断问题 |
| docker logs hermes | 查看容器日志 |
| docker logs hermes –tail 100 | 查看最后 100 行日志 |
| docker restart hermes | 重启容器 |
| docker stop hermes | 停止容器 |
| docker rm -f hermes | 删除容器（数据不丢失） |
九、配置文件详解
9.1 config.yaml 核心字段
| model.default | MiniMax-M2.5 | 默认模型名称 |
| model.provider | minimax-cn | 提供商标识 |
| model.base_url | https://api… | API 端点地址 |
| terminal.backend | local | 终端后端（local/docker/ssh） |
| display.personality | kawaii | 人格预设 |
| compression.enabled | true | 上下文压缩 |
9.2 .env 常用变量
| MINIMAX_CN_API_KEY | MiniMax 中国区 API 密钥 |
| OPENROUTER_API_KEY | OpenRouter 密钥 |
| OPENAI_API_KEY | 自定义端点 / OpenAI 密钥 |
| OPENAI_API_BASE | 自定义 API 基址 |
| TELEGRAM_BOT_TOKEN | Telegram Bot Token |
| WEIXIN_ALLOW_ALL_USERS | 微信是否允许所有用户 |
十、日常维护
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
十一、常见问题排查
| 拉取镜像超时 | 国内无法访问 Docker Hub | 配置镜像加速或代理（见第 2.3 节） |
| 401 invalid api key | API 密钥错误或区域不匹配 | 确认密钥有效，中国区用 minimax-cn |
| No inference provider | config.yaml 未配置模型 | 运行 hermes model 或手动编辑配置 |
| 容器访问不到本地模型 | Docker 网络隔离 | 用 host.docker.internal 替代 localhost |
| 微信配对提示 | 新用户安全验证 | hermes pairing approve weixin <码> |
| 模型拒绝启动 | 上下文窗口不足 64K | 推理框架设置 –ctx-size 65536 |
十二、安全建议
写在最后
Hermes Agent 是一个非常有意思的项目——它不只是一个聊天机器人，而是一个能不断自我进化、记住你的偏好、自动积累技能的 AI 助手。配合 Docker 部署，整个过程其实并不复杂，核心就三步：拉镜像 → 配模型 → 启动。
如果你在部署过程中遇到问题，可以在评论区留言，我会尽量回复。
