首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >Hermes Agent 接入微信(实战)

Hermes Agent 接入微信(实战)

作者头像
技术人生黄勇
发布2026-04-14 11:15:03
发布2026-04-14 11:15:03
2.4K0
举报
文章被收录于专栏:技术人生黄勇技术人生黄勇

前两天刚介绍过拆解 Hermes Agent:开源 Agent 里唯一的闭环学习系统,昨天就看到官方文档宣布支持连接到微信(WeChat):

https://hermes-agent.nousresearch.com/docs/user-guide/messaging/weixin

得益于腾讯之前推出的 QClaw (微信版“小龙虾” QClaw 上线,Agent 正在从能力竞争走向入口竞争)公开的官方接口:iLink Bot API,Hermes 也用的是这个适配器。

于是上手安装实测了一下。

安装非常简单,一行命令即可。

(注:原生 Windows 暂不支持,需要 WSL2)

代码语言:javascript
复制
# 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 对话框中输入即可:
代码语言:javascript
复制
hermes pairing approve weixin E6JNGBCX
关键点
  1. 无需中转直接通过腾讯官方 API 接入,无需第三方桥接服务
  2. 长轮询机制不需要公网 IP、WebSocket 或 Webhook,普通家用网络即可
  3. 上下文持久化context_token 自动保存,重启后回复连续性

支持的功能

功能

说明

消息类型

文本、图片、视频、文件、语音

消息收发

私聊(已验证)、群聊(官方支持,实测未通)

消息加密

AES-128-ECB 自动加解密

格式化

Markdown 自动转换(标题→【标题】、表格→键值列表)

消息分片

4000字符上限,按逻辑边界智能分割

状态提示

处理时显示"正在输入"状态

断线恢复

重启后自动续接上下文,网络波动自动重试

去重机制

5分钟滑动窗口防重复处理

配置选项

代码语言:javascript
复制
# ~/.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
复制
pip install aiohttp cryptography

之前微信一直没有允许可以连接,能见到方案:itchat/WeChatPadPro 也都属于自行破解,非允许的状态。

这次因为 OpenClaw 的带动,适配腾讯推出的 QClaw 官方公布了iLink Bot API 这套协议,配置中还有群聊的设置。

看得出来,AI 时代改变了帝国的封闭。

欢迎评论区留言!

-END-

本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2026-04-12,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 技术人生黄勇 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 对话开始前,需要一次配对过程。
  • 按提示在 Hermes 对话框中输入即可:
  • 关键点
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档