若Hermes Agent未接入微信扫码即用，需完成微信网关配置：一、推荐用官方iLink Bot API直连，执行hermes gateway setup并扫码绑定；二、可用wechat-bridge桥接，配置bridge_url后扫码登录；三、借CowAgent中转，设LLM为openai并指向其API；四、用hermes-wechat原生适配器，安装依赖后扫码建立双向通道。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功部署Hermes Agent本地服务，但尚未将其接入微信实现扫码即用的AI助手功能，则可能是由于未完成微信网关配置或桥接服务未就绪。以下是实现该目标的多种可行路径：
一、使用官方iLink Bot API直连（推荐首选）
此方式基于腾讯官方推出的iLink Bot API，合规性高，无需公网IP与Webhook，仅需扫码授权即可建立稳定连接，适用于个人微信账号，且支持私聊基础交互。
1、确保Hermes Agent已通过安装脚本完成部署：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash。
2、执行网关初始化命令：hermes gateway setup，在交互式菜单中选择wechat选项。
3、系统将自动生成本地二维码，使用微信“扫一扫”功能扫描该码，完成Bot账号绑定。
4、绑定成功后，Hermes Agent会自动监听来自该Bot账号的私聊消息，并以同一Bot身份回复。
二、通过wechat-bridge桥接方案（兼容性强）
该方案采用第三方开源项目wechat-bridge模拟微信客户端协议，可绕过iLink Bot API的灰度限制，在部分未开放iLink权限的地区或账号仍可运行，但需注意其非官方性质带来的稳定性与账号风险。
1、在服务器上克隆并安装wechat-bridge：git clone https://github.com/wechaty/wechat-bridge && cd wechat-bridge && npm install。
2、启动桥接服务：npm start，确认服务默认运行于http://localhost:8788。
3、编辑Hermes Agent配置文件config.yaml，在gateways节点下启用微信模块并指定bridge_url：bridge_url: "http://localhost:8788"。
4、重启Hermes Agent服务，使用微信扫描bridge控制台输出的二维码完成登录。
三、借助CowAgent中转层（快速验证型）
CowAgent提供OpenAI兼容API接口，可作为Hermes Agent的模型后端与消息中间件，其内置微信扫码模块封装了iLink与协议层细节，适合希望跳过底层配置、专注功能验证的用户。
1、下载并运行CowAgent：docker run -p 8000:8000 -e OPENAI_API_KEY=dummy zhayujie/cowagent。
2、访问http://localhost:8000，点击“微信扫码登录”，获取Bot账号。
3、在Hermes Agent中配置LLM provider为openai，base_url指向http://localhost:8000/v1，api_key任意填写（如sk-xxx）。
4、运行hermes chat，此时所有对话将经由CowAgent转发至微信Bot，并返回响应。
四、使用hermes-wechat原生适配器（开发者向）
该方案由社区维护，直接对接Hermes Gateway架构，完整支持function calling能力透传至微信消息流，是唯一能实现在微信中触发搜索、文件处理、天气查询等多步工具调用的路径。
1、克隆适配器仓库：git clone https://github.com/RongleCat/hermes-wechat。
2、安装依赖：uv add aiohttp cryptography qrcode pillow。
3、修改hermes-wechat/config.py，填入Hermes Agent的本地监听地址（如http://127.0.0.1:8000）。
4、执行python main.py，扫描控制台生成的二维码，完成双向通道建立。
