Hermes-Agent微信接入配置-hermes-agent接入个人微信的避坑指南
最近GitHub上一款名为 Hermes Agent 的AI智能体爆火，凭借“自我进化、自带长期记忆、自动沉淀技能”的优势，直接媲美OpenClaw。
得益于腾讯之前推出的 QClaw (微信版“小龙虾” QClaw 上线，Agent 正在从能力竞争走向入口竞争)公开的官方接口：iLink Bot API，Hermes 也用的是这个适配器。
安装非常简单，一行命令即可。
(注：原生 windows 暂不支持，需要 WSL2)
代码语言：Javascript
AI代码解释
# Linux / macOS / WSL2 / Android (Termux)
curl -fsSL http://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 对话框中输入即可：
代码语言：javascript
AI代码解释
hermes pairing approve weixin E6JNGBCX
关键点
无需中转直接通过腾讯官方 API 接入，无需第三方桥接服务
长轮询机制不需要公网 IP、WebSocket 或 Webhook，普通家用网络即可
上下文持久化context_token 自动保存，重启后回复连续性
支持的功能
功能 | 说明 |
|---|---|
消息类型 | 文本、图片、视频、文件、语音 |
消息收发 | 私聊（已验证）、群聊（官方支持，实测未通） |
消息加密 | AES-128-ECB 自动加解密 |
格式化 | Markdown 自动转换（标题→【标题】、表格→键值列表） |
消息分片 | 4000字符上限，按逻辑边界智能分割 |
状态提示 | 处理时显示"正在输入"状态 |
断线恢复 | 重启后自动续接上下文，网络波动自动重试 |
去重机制 | 5分钟滑动窗口防重复处理 |
配置选项
代码语言：javascript
AI代码解释
# ~/.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 | 忽略所有私聊 | 忽略所有群消息（默认） |
常见故障排除
代码语言：javascript
AI代码解释
pip install aiohttp cryptography
之前微信一直没有允许可以连接，能见到方案：itchat/WeChatPadPro 也都属于自行破解，非允许的状态。
这次因为 OpenClaw 的带动，适配腾讯推出的 QClaw 官方公布了iLink Bot API 这套协议，配置中还有群聊的设置。
免责声明：本文内容来自用户上传并发布，站点仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。请核实广告和内容真实性，谨慎使用。
