hermes agent 可通过本地配置微信私聊通道实现指令直连响应。需先确保 agent 已安装并运行于 localhost:3000，再启用 wechaty puppet（docker 或本地方式），配置 agent.config.yml 中 wechat 通道参数，最后扫码登录并可选设置白名单联系人。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让 Hermes Agent 直接通过微信私聊接收和响应你的指令，不再依赖网页端手动刷新或切换窗口，现在就能完成本地化私聊通道配置。
确认 Hermes Agent 已安装并可本地运行
打开终端，执行 hermes-agent --version，看到版本号（如 v0.8.3）说明核心已就绪。若提示 command not found，请先通过 npm install -g hermes-agent 全局安装。
运行 hermes-agent start，观察终端输出是否出现 HTTP server listening on http://localhost:3000 —— 这是后续微信对接的前提，【必须保持该进程持续运行】。
启用微信协议支持（WeChaty + Puppet）
Hermes Agent 默认不内置微信协议栈，需手动注入 Puppet 实例。
方法一：使用官方推荐的 puppet-wechaty（需 Docker 环境）
执行 docker run -d --name wechaty -p 8080:8080 -e WECHATY_LOG=verbose -e WECHATY_TOKEN=your_token wechaty/wechaty，其中 your_token 需替换为你在 WeChaty 官网申请的真实 token。
方法二：本地启动 Puppet（免 Docker，适合调试）
新建目录 wechat-puppet → 进入后执行 npm init -y → 安装 npm install wechaty@latest → 创建 app.js，写入 WeChaty 启动脚本并监听端口 8080 → 运行 node app.js。【确保该服务在 localhost:8080 可被 Hermes Agent 访问】
配置 agent.config.yml 绑定微信通道
第一步：在 Hermes Agent 项目根目录找到或新建 agent.config.yml 文件。
第二步：在 channels 节点下添加微信配置块：
channels:<br> wechat:<br> enabled: true<br> puppet: 'wechaty'<br> endpoint: 'http://localhost:8080'<br> token: 'your_wechaty_token'
第三步：保存文件后，在终端中重启 Hermes Agent（Ctrl+C 停止当前进程 → 再次执行 hermes-agent start）。
注意：token 必须与 Puppet 服务启动时使用的 token 完全一致，大小写敏感，填错会导致登录失败且无明确报错提示。
扫码登录微信账号并绑定私聊对象
终端会输出一段二维码 Base64 字符串，复制整段内容（含开头 data:image/png;base64,）→ 粘贴到浏览器地址栏回车 → 即可渲染出二维码。
用微信「扫一扫」扫描该二维码完成 Web 微信登录。登录成功后，Hermes Agent 终端将打印 [WeChaty] Login confirmed。
此时 Agent 已接管你的微信账号，但默认只响应好友私聊消息。若要指定仅响应某位联系人，需在配置中追加：whitelist: ['张三', '李四']（名字必须与微信通讯录中显示的备注名或昵称完全一致）。
