必须通过腾讯ilink bot api原生对接微信个人号，流程包括：一、在ilink.qq.com注册获取appid/secret/token并启用长轮询；二、克隆适配器、安装依赖、复制weixin.py、打补丁、配置yaml；三、hermes gateway setup扫码认证；四、设置.env环境变量控制访问策略；五、验证消息分片与上下文持久化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将 Hermes Agent 直接接入微信个人号，而非依赖第三方桥接服务，则必须通过腾讯官方 iLink Bot API 完成原生对接。该方式无需公网 IP、Webhook 或 WebSocket，仅需长轮询机制即可在家庭网络环境下稳定运行。以下是基于 iLink Bot API 的完整配置流程：
一、准备 iLink Bot 开发者资质与凭证
使用 iLink Bot API 前，需在腾讯 iLink 开放平台完成注册并获取合法凭证。该步骤是所有后续配置的基础，缺失任一凭证将导致网关无法初始化。
1、访问 https://ilink.qq.com/developer，使用企业微信或已实名的微信扫码登录。
2、进入「创建应用」页面，选择「Bot 类型」，填写应用名称、简介及头像，提交审核。
3、审核通过后，在「应用详情」页复制以下三项关键凭证：AppID、AppSecret、iLink Token。
4、在「Webhook 配置」区域，将「长轮询模式」设为启用，并确认「消息加解密」开关处于关闭状态（Hermes 当前仅支持明文模式）。
二、配置 Hermes Agent 的 weixin 平台适配器
需将 iLink 凭证注入 Hermes 的微信平台模块，使其能正确调用 iLink Bot API 接口。此过程涉及文件复制、代码补丁与 YAML 配置三步，缺一不可。
1、执行命令克隆适配器仓库：git clone https://github.com/RongleCat/hermes-wechat.git。
2、安装运行依赖：cd hermes-wechat && uv add aiohttp cryptography qrcode[pil]。
3、将 weixin.py 复制至 Hermes 的 platforms 目录：cp weixin.py /path/to/hermes/platforms/。
4、运行补丁脚本注册平台：python patch.py --hermes-dir /path/to/hermes。
5、编辑 ~/.hermes/config.yaml，在 platforms: 下添加如下段落：
wechat:
type: weixin
ilink_token: your_iLink_Token
ilink_app_id: your_AppID
poll_timeout: 35
chunk_size: 4000
三、启动网关并完成扫码认证
网关启动后将主动向 iLink 服务发起会话初始化请求，并生成一次性登录二维码。该二维码与微信个人号强绑定，仅可成功扫描一次，且需在 5 分钟内完成确认操作。
公众号运营：文章发布至草稿、样式封面、评论与用户管理、数据统计等。用户要求将 Markdown 发送到公众号草稿、查看阅读量统计或类似后台操作时，使用本技能。
1、在终端中执行：hermes gateway setup。
2、在交互式菜单中使用方向键高亮选择 WeChat (ilink / ClawBot)，按回车确认。
3、等待终端输出二维码（若已安装 qrcode[pil]）或显示形如 https://ilink.qq.com/qrcode?token=xxx 的 URL。
4、使用微信客户端扫描该二维码，随后在手机端点击「确认登录」按钮。
5、终端显示 Login successful. Session token saved to ~/.hermes/ 即表示认证完成。
四、设置访问控制策略与环境变量
为保障账号安全，必须显式声明私聊与群聊的响应策略。所有策略均通过环境变量控制，修改后需重启网关才生效。默认策略为禁用群聊，仅开放私聊。
1、编辑 ~/.hermes/.env 文件，添加以下四行：
WEIXIN_ACCOUNT_ID=your_wechat_account_id
WEIXIN_TOKEN=your_iLink_Token
WEIXIN_DM_POLICY=open
WEIXIN_GROUP_POLICY=disabled
2、若需启用白名单机制，追加 WEIXIN_ALLOWED_USERS=user_id_1,user_id_2，其中 user_id 可从首次收到的私聊消息日志中提取。
3、保存文件后执行：hermes gateway restart 使新策略立即生效。
五、验证上下文持久化与消息分段能力
iLink Bot API 支持 context_token 自动续签与长消息自动切片，Hermes 通过 chunk_size: 4000 参数控制单条消息最大字符数。测试该能力可确认会话连续性是否正常建立。
1、向 Hermes Agent 发送一条含 4500 字符的测试消息（例如粘贴一篇技术文档摘要）。
2、观察 Hermes 日志是否出现 [weixin] Splitting long message into 2 chunks 提示。
3、等待 Agent 回复后，立即发送第二条消息（如「继续」），检查回复是否延续前文语义而非重置对话上下文。
4、手动终止并重启 Hermes 进程：hermes stop && hermes start，再次发送「上一句说了什么？」，确认仍能准确引用历史内容。
