小白教程：手把手教你Docker部署Hermes+接入个人微信（ClawBot）成为你的私人助手

Hermes是一个开源的自进化 AI 智能体框架，如果你接触过OpenClaw（小龙虾）那你应该有所了解，他们的区别在于OpenClaw靠人写代码驱动，Hermes靠经验自我进化。
​
一、通过Docker部署Hermes
1、打开Docker-项目-创建
2、在项目名称一栏可以填写 hermes-agent 。存放路径可以为空，系统会自动在 docker 目录下生成与项目同名的文件夹，用于集中存放配置文件与数据。将下方代码复制粘贴到Compose 配置区域，最后点立即部署，等待部署完毕，点击完成即可。

1. services:
   
2.   hermes:
   
3.     image: nousresearch/hermes-agent:latest
   
4.     container_name: hermes
   
5.     restart: unless-stopped
   
6.    
   
7.     # 网络与权限核心配置
   
8.     network_mode: host    # 使用宿主机网络，便于连接本地Ollama等服务
   
9.     user: "0:0"          # 强制以root运行，解决绿联挂载目录的写入权限
   
10.    
    
11.     #  启动命令（整合权限修复）
    
12.     entrypoint: ["sh", "-c"]
    
13.     command: |
    
14.       "chmod -R 777 /opt/data 2>/dev/null || true
    
15.       exec hermes gateway run"
    
16.    
    
17.     # 数据持久化
    
18.     volumes:
    
19.       - ./data:/opt/data
    
20.    
    
21.     #  环境变量
    
22.     environment:
    
23.       # 1. 基础路径与依赖
    
24.       - PATH=/opt/hermes/.venv/bin:/usr/local/bin:/usr/bin:/bin
    
25.       - HERMES_EXTRA_PIP_PACKAGES=aiohttp httpx python-dotenv
    
26.      
    
27.       # 系统设置
    
28.       - TZ=Asia/Shanghai
    
29.    
    
30.     # 资源限制
    
31.     deploy:
    
32.       resources:
    
33.         limits:
    
34.           memory: 4G
    
35.           cpus: "2.0"

复制代码

二、配置Hermes的大模型
1、点击容器-选择你部署完成的Hermes-终端-新增（/bin/bash）-确定

2、为Hermes配置大模型，复制下方命令，粘贴到终端命令输入框，回车 (Enter) 确认，开始配置。

1. hermes setup

复制代码

3、选择 Quick setup — provider, model & messaging，回车 (Enter) 确认。
4、随后选择 MiniMax China (domestic direct API)，回车 (Enter) 确认。

5、MINIMAX_CN_API_KEY:粘贴您准备好的 API 密钥，(出于安全保护，终端内不会显示粘贴的密钥字符)，回车 (Enter) 确认。
6、Base URL:：粘贴模型的 URL 地址，回车 (Enter) 确认。
7、Select default model:：选择您需要调用的模型版本，回车 (Enter) 确认。


三、添加微信为消息通道
1、添加消息通道，回车 (Enter) 确认。
2、按照微信选项，输入数字，回车 (Enter) 确认。

3、确认添加微信消息渠道，回车 (Enter) 确认。
4、用你需要添加的微信扫描二维码，如果二维码无法显示，可点击链接打开，扫码授权。

5、根据自己的需要，选择私信权限，可以按照推荐选择操作，回车 (Enter) 确认。
6、根据自己的需要，选择群聊权限，可以按照推荐选择操作，回车 (Enter) 确认。

7、确认添加授权的微信，回车 (Enter) 确认。
8、重启网关，回车 (Enter) 确认。

9、这一步可以测试Hermes的大模型是否配置正确，回车 (Enter) 确认进入对话窗口，发送任意消息，看是否回复你。完成这一步点击移除退出终端就可以了。

10、用刚才授权的微信，发送任意消息给Hermes他会回复你相应的匹配口令。如没有反应，请看本文下方常见问题。

11、再次点击容器-选择你部署完成的Hermes-终端-新增（/bin/bash）-确定

12、将你微信上收到的匹配口令输入到命令框，然后回车 (Enter) 确认。出现下图所示就代表添加成功了。

13、最后，我们通过微信就可以和我们的Hermes智能体进行沟通交流了。


常见问题：
1、微信没反应什么办？
如果你发送后没有反应，也不要着急，再次重启网关大概率可以解决。

• 点击容器-选择你部署完成的Hermes-终端-新增（/bin/bash）-确定
• 输入下方命令回车 (Enter) 确认
  

1. hermes gateway restart

复制代码

2、输入匹配码，提示错误怎么办？

1. 示例：
   
2. 错误：`hermes pairing approve weixin PBN4AA53`
   
3. 正确：hermes pairing approve weixin PBN4AA53
   
4. 在复制的情况下注意删掉单引号。

复制代码

你在部署过程中有任何问题都可以留言讨论，大家一起解决！

如果你想接着部署Hermes + Open WebUI那么安装Hermes时直接用下方代码。

1. services:
   
2.   hermes:
   
3.     image: nousresearch/hermes-agent:latest
   
4.     container_name: hermes
   
5.     restart: unless-stopped
   
6.    
   
7.     # 网络与权限核心配置（按你要求）
   
8.     network_mode: host    # 使用宿主机网络，便于连接本地Ollama等服务
   
9.     user: "0:0"          # 强制以root运行，解决绿联挂载目录的写入权限
   
10.    
    
11.     #  启动命令（整合权限修复）
    
12.     entrypoint: ["sh", "-c"]
    
13.     command: |
    
14.       "chmod -R 777 /opt/data 2>/dev/null || true
    
15.       exec hermes gateway run"
    
16.    
    
17.     # 数据持久化
    
18.     volumes:
    
19.       - ./data:/opt/data
    
20.    
    
21.     #  环境变量
    
22.     environment:
    
23.       # 1. 基础路径与依赖
    
24.       - PATH=/opt/hermes/.venv/bin:/usr/local/bin:/usr/bin:/bin
    
25.       - HERMES_EXTRA_PIP_PACKAGES=aiohttp httpx python-dotenv
    
26.       - API_SERVER_ENABLED=true
    
27.       - API_SERVER_KEY=MyUgNasKey123! #这里可以自己设置
    
28.       - API_SERVER_HOST=0.0.0.0
    
29.       - API_SERVER_PORT=8642
    
30.       
    
31.       # 3.系统设置
    
32.       - TZ=Asia/Shanghai
    
33.    
    
34.     # 👇 资源限制（绿联设备性能适配）
    
35.     deploy:
    
36.       resources:
    
37.         limits:
    
38.           memory: 4G
    
39.           cpus: "2.0"

复制代码

我的也是对接微信没反应，看日志说是权限问题，试了好多遍，都不行，一会按照这个步骤再试试。

感谢！成功了，权限没问题了，另外重启可以通过Docker页面进行，点击下就可以，比命令简单。

有什么实际的应用场景吗？

楼主大才

安装成功

✘ hermes Error Get "https://registry-1.docker.io/v2/": n... 15.0s

部置失败

V82ywT 发表于 2026-4-20 23:05
部置失败

提示什么啊

V82ywT 发表于 2026-4-20 23:02
✘ hermes Error Get "https://registry-1.docker.io/v2/": n... 15.0s

网络连接超时，连接镜像仓库超时。添加镜像加速器基本都能解决。
Docker-镜像-右上角的齿轮-加速器配置
将下面地址添加上

1. https://docker.1ms.run
   
2. https://docker.m.daocloud.io

复制代码