只需一次扫码，Hermes Agent 即可在本地 Mac 或 WSL2 环境中以个人微信身份实时响应，支持加密收发、连续上下文、图片文件，无需公网 IP 或第三方服务器。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在微信里直接和 Grok、GLM-5 或其他大模型聊天，不用打开终端、不依赖网页中转、不手动复制粘贴——只需一次扫码，让 Hermes Agent 以你个人微信身份在线响应，消息收发加密、上下文连续、支持图片与文件，整个过程在本地 Mac 或 WSL2 环境中完成，全程无需公网 IP 和第三方服务器。
确认基础环境已就绪
打开终端（Mac：Command + 空格 → 搜索“终端”；Windows：启动 Ubuntu WSL2），先验证 Hermes 是否已安装并可调用：
输入 hermes --help，若返回命令列表说明安装成功；若提示 command not found，请先运行 curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash 安装，并执行 source ~/.zshrc（Mac）或 source ~/.bashrc（WSL2）刷新环境。
确保已配置好模型：运行 hermes model，选择 xAI Grok OAuth 或 GLM-5 等可用提供商，完成授权流程。未配置模型将导致网关启动后无法生成回复。
启动微信网关配置向导
在终端中执行：
hermes gateway setup
向导启动后，用方向键 ↓ 移动至“Weixin”选项，【务必先按空格键选中，再按回车】——若跳过空格直接回车，该选项不会被启用，后续扫码无效。
其余配置项保持默认（连续按回车即可），向导会自动生成本地服务地址与凭证模板。
完成扫码绑定与凭证固化
步骤一：等待终端输出类似 http://localhost:8080/qrcode 的链接
步骤二：复制该链接，粘贴到 Chrome 或 Safari 浏览器地址栏中打开（不要在终端内点击）
步骤三：用目标微信手机客户端扫描页面上的二维码
步骤四：手机端弹出确认框时，点击“登录”，【切勿取消或等待超时】，否则需重新生成二维码
步骤五：终端出现 Weixin connection successful, account_id=weixin_abc123 提示，表示凭证已写入 ~/.hermes/weixin/accounts/ 目录
补全关键环境变量
方法一（推荐）：检查并编辑 ~/.hermes/.env 文件
用 nano ~/.hermes/.env 打开，确认包含以下三行（account_id 必须与上一步终端输出完全一致）：
WEIXIN_ACCOUNT_ID=weixin_abc123
WEIXIN_TOKEN=your_bot_token（若未自动生成，可临时设为任意非空字符串如 dummy）
WEIXIN_DM_POLICY=open（此行决定是否接收私聊，缺失将导致消息静默）
保存后执行 source ~/.hermes/.env 使变量立即生效。
启动网关并触发首次响应
运行：hermes gateway
终端持续输出日志，看到 Listening on http://localhost:8080 及 Connected to Weixin account weixin_abc123 即表示网关已就绪。
立刻打开微信，给刚扫码登录的账号发送任意文字（例如“你好”），1–3 秒内将收到 AI 回复。
