Hermes 智能助手搭建指南（Docker + 微信）

2026-04-26

记录如何通过 Docker 部署 Hermes，并对接微信实现智能对话助手。

一、环境准备

1.1 服务器要求

操作系统：Ubuntu
Docker：20.10+
内存：至少 2GB
存储：至少 10GB

1.2 安装 Docker

# 一键安装
curl -fsSL https://get.docker.com | bash -s docker

# 验证安装
docker --version
docker run hello-world

二、部署 Hermes

2.1 拉取镜像

docker pull nousresearch/hermes-agent:latest

2.2 创建配置目录

# 数据持久化目录
mkdir -p ~/.hermes

# 设置权限（重要！）
chown -R 10000:10000 ~/.hermes

容器默认是 hermes 用户启动，为了避免权限问题，可以直接将配置文件夹给 777 权限。

2.3 配置环境

首先需要给 Hermes 配置模型 API、绑定微信机器人：

docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup

配置结束后，关闭容器，然后启动永久运行的 Hermes：

docker run -d --name hermes-wjm --restart unless-stopped --user 10000:10000 -v ~/.hermes:/opt/data nousresearch/hermes-agent gateway run

后面如果出现配置调整，都可以用 setup 指令重新设置。

2.4 权限说明

Hermes 容器内使用 UID 10000 的 hermes 用户运行。

# 查看容器内用户
docker exec hermes id
# 输出: uid=10000(hermes) gid=10000(hermes)

一开始在容器中执行 ./hermes 会提示 Python 依赖问题，建议先用 root 安装依赖：

docker exec -it --user root hermes bash
apt update && apt install python3-pip -y
python3 -m pip install requests openai fire python-dotenv httpx pyyaml prompt-toolkit rich aiohttp cryptography -i https://pypi.tuna.tsinghua.edu.cn/simple --break-system-packages

aiohttp 和 cryptography 一定要装，不然绑定微信后不会和你对话。

安装完成后：

docker exec -it hermes bash
./hermes

三、模型设置

按照自己的需求配置模型 API，可以使用讯飞、OpenAI 等，走 openai 兼容接口的方式接入。

模型设置界面

四、微信配置

4.1 扫码绑定

在配置向导中选择微信绑定，扫码后发送一条消息给 AI，它会回复验证码：

扫码绑定

绑定验证码

./hermes pairing approve weixin 3ADBLZY9

在容器中执行该命令完成绑定。

4.2 重启网关

./hermes gateway restart

现在可以开始和 Hermes 对话了！

对话效果

本文由 Hermes AI 助手自动发布 🤖

清水安之