前两天刚介绍过拆解 Hermes Agent:开源 Agent 里唯一的闭环学习系统,昨天就看到官方文档宣布支持连接到微信(WeChat):
https://hermes-agent.nousresearch.com/docs/user-guide/messaging/weixin
得益于腾讯之前推出的 QClaw (微信版“小龙虾” QClaw 上线,Agent 正在从能力竞争走向入口竞争)公开的官方接口:iLink Bot API,Hermes 也用的是这个适配器。
于是上手安装实测了一下。
安装非常简单,一行命令即可。
(注:原生 Windows 暂不支持,需要 WSL2)
# Linux / macOS / WSL2 / Android (Termux)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装完成后,它检测到了 OpenClaw,如官方介绍,它可以导入龙虾的设置。

导入了灵魂SOUL和用户USER设定,消息设定导入 .env,大模型供应商信息,以及一些支持的 Skills。
下面跳过的部分,应该是它支持的多Agent,记忆,Discord 之类的国外社交平台等等,我的 OpenClaw 没设置。

导入和跳过的信息列表展示完后,执行了合并操作。

接着设置大模型,我选择的是智谱GLM-5。
毕竟是目前最强的开源模型了:8小时从零构建Linux桌面 |最强开源模型 GLM-5.1

接着就可以设置连接到微信了:

手机微信扫码后,显示已经连接 OpenClaw,询问是否解除?


点击“继续连接”后,可以看到手机微信界面跳到了之前连 QClaw 的对话框。
安装界面后续还询问了三个设置,有一个“Group chats” 按默认设置关闭了。
主要担心平台发现参与了群聊,封号就不合适了。
快速安装完成,显示成功界面:


hermes pairing approve weixin E6JNGBCX
支持的功能
功能 | 说明 |
|---|---|
消息类型 | 文本、图片、视频、文件、语音 |
消息收发 | 私聊(已验证)、群聊(官方支持,实测未通) |
消息加密 | AES-128-ECB 自动加解密 |
格式化 | Markdown 自动转换(标题→【标题】、表格→键值列表) |
消息分片 | 4000字符上限,按逻辑边界智能分割 |
状态提示 | 处理时显示"正在输入"状态 |
断线恢复 | 重启后自动续接上下文,网络波动自动重试 |
去重机制 | 5分钟滑动窗口防重复处理 |
配置选项
# ~/.hermes/.env
WEIXIN_ACCOUNT_ID=your-account-id # 必填
WEIXIN_TOKEN=your-bot-token # 必填(扫码自动获取)
# 访问控制
WEIXIN_DM_POLICY=open # 私聊策略:open/allowlist/disabled
WEIXIN_GROUP_POLICY=disabled # 群策略:open/allowlist/disabled
WEIXIN_ALLOWED_USERS=user_id_1 # 私聊白名单
WEIXIN_GROUP_ALLOWED_USERS=group_id_1 # 群白名单
访问策略说明
策略值 | 私聊行为 | 群聊行为 |
|---|---|---|
open | 任何人可私聊(默认) | 所有群响应 |
allowlist | 仅白名单用户 | 仅白名单群 |
disabled | 忽略所有私聊 | 忽略所有群消息(默认) |
常见故障排除
pip install aiohttp cryptography之前微信一直没有允许可以连接,能见到方案:itchat/WeChatPadPro 也都属于自行破解,非允许的状态。
这次因为 OpenClaw 的带动,适配腾讯推出的 QClaw 官方公布了iLink Bot API 这套协议,配置中还有群聊的设置。
看得出来,AI 时代改变了帝国的封闭。
欢迎评论区留言!
-END-