必须在WSL2或Linux/macOS中启动Hermes Agent微信网关,通过hermes gateway setup选择WeChat选项生成含时效token的链接,用手机浏览器打开扫码授权,再执行pairing指令完成绑定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想用 Hermes Agent 当微信里的 AI 管家,但卡在扫码这一步——终端没出二维码、手机扫了没反应、扫完不显示“Hermes Agent”联系人,这些都不是配置失败,而是扫码绑定路径没走对。必须在 WSL2 或 Linux/macOS 环境中启动网关服务,生成带有效 token 的动态链接,再用手机浏览器打开扫码,整个流程不可跳过任一环节。
确认运行环境与基础依赖
Herems Agent 无法在 Windows 命令行或 PowerShell 中直接运行微信网关,必须进入 WSL2 的 Ubuntu 终端(推荐 22.04 或 24.04)。【若仍在 Windows 原生系统中操作,后续所有步骤均无效】
执行系统更新与依赖安装:sudo apt update && sudo apt upgrade -y → sudo apt install -y python3-pip ffmpeg ripgrep curl wget python3-qrcode python3-pil
验证 Python 版本是否 ≥3.9:python3 --version。若输出为 3.8.x 或更低,需手动升级 Python,否则 gateway setup 会报错退出。
启动微信网关并生成扫码链接
这一步必须使用交互式 setup 流程,不能跳过选择环节。直接运行 hermes gateway setup 后,用方向键高亮「WeChat (iLink BotAPI)」,按回车确认。
终端将输出类似 QR code generated at: https://hermes.nous/weixin/qrcode?token=abc123... 的链接。注意:该链接含一次性 token,5 分钟后自动失效。
复制整条 URL,粘贴到手机 Safari 或 Chrome 中打开(【严禁用微信内置浏览器打开】),页面将自动渲染出动态二维码。
自动备份 OpenClaw 整体配置到远程存储(支持任意 rclone 后端:COS、S3、FTP、SFTP、WebDAV等)。 触发场景: - 创建/配置自动备份任务 - 设置备份周期、保留份数、目标目录 - 手动触发备份 - 查看/恢复备份 - OpenClaw 运行异常时的提醒
完成微信授权与账号绑定
第一步:打开手机微信 → 右上角「+」→「扫一扫」→ 对准网页中的二维码。
第二步:手机端弹出授权页时,点击「继续连接」。若提示“已连接 OpenClaw”,仍点「继续连接」——这会覆盖旧授权,不影响 Hermes 接入。
第三步:扫码成功后,终端立即打印 WeChat account linked: weixin_XXXXXX,同时你的微信联系人列表中会出现名称为 “Hermes Agent”、头像为蓝色图标的联系人。
第四步:向该联系人发送任意文字(如“hi”),终端将输出一行 pairing 指令,格式为 hermes pairing approve weixinXXXXXXXX。
执行配对验证激活消息通道
方法一:直接在终端中执行上一步得到的 pairing 指令,例如:hermes pairing approve weixin123456789。
方法二:若指令过长易输错,可用鼠标双击终端中该行 → 右键复制 → 粘贴执行。
执行成功后,终端显示 Pairing approved. Context token saved.,此时 Hermes Agent 已具备接收与响应私聊消息的能力,无需重启服务。


















