hermes agent原生支持个人微信扫码接入，无需公网ip或webhook，但需满足微信版本、服务运行、api配置及系统环境等前置条件，并严格按终端配置、扫码授权、上下文验证三步操作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在微信聊天框里直接和AI对话，不用切App、不用开网页，还能定时推送资讯、执行代码——Hermes Agent原生支持个人微信接入，全程扫码即可完成，但国内网络环境、配置顺序、授权覆盖等环节极易卡住。本文只讲你真正要做的动作，每一步都来自2026年8月实测有效的最新路径。
确认前置条件是否全部满足
这一步漏掉任何一项，后续扫码必然失败。【微信App版本必须为iOS 8.0.70或Android 8.0.69及以上】，旧版本无法识别iLink Bot协议；【Hermes Agent必须已成功安装并能正常启动】，运行hermes --help有输出才算过关；API Key必须提前填入配置（推荐DeepSeek，Kimi每日限额太紧）；Mac/Linux/WSL2三选一，原生Windows不支持。
检查命令：hermes status返回running且无报错，说明服务就绪。
用终端启动微信通道配置
方法一：交互式向导（新手首选）
在终端输入：hermes gateway setup → 按提示选择WeChat → 确认启用 → 等待二维码生成。
方法二：手动编辑配置文件
打开~/.hermes/config.yaml，在gateways:下添加：
weixin: enabled: true mode: ilink
保存后执行hermes restart生效。注意：不要手敲wechat或weixin拼写错误，yaml对缩进和冒号极其敏感。
手机微信扫码授权
第一步：打开电脑终端中显示的二维码界面，确保其完整可见且未被遮挡。
第二步：手机微信 → 右上角「+」→「扫一扫」→ 对准扫描。
第三步：手机端弹出授权页，底部出现「继续连接」按钮。
⚠️ 若提示“当前微信已连接另一个Agent”，说明此前绑过OpenClaw或QClaw，【点击「继续连接」会强制解除原有绑定，不可逆】。
第四步：授权成功后，手机微信自动跳转至与Hermes的对话窗口，发送任意文字（如“hi”），终端应立刻打印收到消息的日志。
验证消息收发与上下文连续性
① 在微信对话框发送“今天天气怎么样”，观察终端是否触发联网搜索技能；
② 等待回复后，紧接着发“那明天呢”，确认AI是否记住前序上下文并延续推理；
③ 发送一张截图图片，检查是否触发多模态解析（需模型支持视觉能力）；
④ 关闭终端再重启hermes，重新发消息，验证context_token是否自动恢复会话状态。
若第②步失效，说明持久化未生效，需检查~/.hermes/storage/目录权限是否为当前用户可读写。
处理常见卡点
坑1：二维码生成后空白或超时
原因：国内直连GitHub资源加载失败，导致iLink SDK初始化中断。
解法：临时切换镜像源，执行export HERMES_GITHUB_MIRROR=https://ghfast.top后再运行hermes gateway setup。
坑2：扫码后手机无反应或提示“该二维码已失效”
立即关闭弹窗，重新点击「授权接入」生成新码——旧码3分钟自动作废，不能重试。
坑3：消息发出后终端无日志，微信显示“消息已发出但未送达”
检查服务器时间是否准确，误差超过5分钟会导致iLink签名验签失败；执行sudo ntpdate -s time.apple.com（Mac）或sudo timedatectl set-ntp true（Linux）同步时间。
