问题现象

执行 hermes pairing approve weixin SSR8GLWJ 后，微信用户发消息无任何响应

根本原因

文件权限不匹配 导致 gateway 无法读取 pairing 授权文件：

微信授权文件由宿主机创建 root ，而 gateway 以容器内 hermes 用户 uid=10000 运行，两者是不同命名空间，因此 root:root 0600 对 hermes [yaowan style='1'] 用户完全不可见

修复步骤

1️⃣ 在宿主机给文件赋予读写权限「或 chown hermes:hermes 」
2️⃣ 重启容器，使 gateway 重新加载 pairing 文件

📖 微信配置 · 安装步骤

以下内容可直接复制使用

1️⃣ 配置流程

第 1️⃣ 步：在宿主机安装 Hermes Agent「如尚未安装」

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

第 2️⃣ 步：获取 Pairing 验证码
在微信中给 bot 发任意消息，bot 会自动回复一个配对码「如 SSR8GLWJ 」

第 3️⃣ 步：在宿主机授权

hermes pairing approve weixin <配对码>

例如：

hermes pairing approve weixin SSR8GLWJ

第 4️⃣ 步：修复文件权限

⚠️ 关键步骤！必须确保容器内 gateway 进程能读取授权文件

如果宿主机用户与容器内 hermes 用户不同，需要授权：

sudo chown 10000:10000 ~/.hermes/pairing/weixin-approved.json

sudo chmod 644 ~/.hermes/pairing/weixin-approved.json

或者直接设置为完全可读「最快」：

sudo chmod 644 ~/.hermes/pairing/weixin-approved.json

第 5️⃣ 步：重启容器

docker restart <容器名>

第 6️⃣ 步：验证连接

tail -f ~/.hermes/logs/gateway.log | grep -i weixin

看到以下日志即为成功：

INFO gateway.run: ✓ weixin connected
INFO gateway.platforms.weixin: [Weixin] Connected account=xxx

2️⃣ 常见问题速查

3️⃣ 关键原理

宿主机 hermes CLI ──写入──▶ ~/.hermes/pairing/weixin-approved.json (root:root)

容器 gateway ──读取──▶ /opt/data/pairing/weixin-approved.json (hermes:hermes)

gateway 与 CLI 必须操作同一个文件，且该文件必须对容器内 hermes 用户 uid=10000 可读。建议始终在 宿主机 执行 pairing 命令，并确保后续文件权限为 644 644、所有者为 10000:10000

4️⃣ 一行命令「推荐懒人方案」

在宿主机执行，pairing + 授权一气呵成：

hermes pairing approve weixin <配对码> && \
sudo chmod 644 ~/.hermes/pairing/weixin-approved.json && \
sudo chown 10000:10000 ~/.hermes/pairing/weixin-approved.json && \
echo "✅ 授权完成，请重启容器使配置生效"

🦈本文档由亚特兰蒂斯后裔鲨鲨编写 🔱

购买服务器

购买雨云服务器

云服务器、网站搭建、游戏云、对象存储、裸金属物理机