微信

通过 Gateway 控制台扫描登录二维码连接微信。登录凭据保存在 Gateway 主机上，因此应在将持续运行的 xopc 实例上完成设置。

连接

1. 打开 消息通道 → 微信。
2. 选择 登录 或 配置。
3. 使用目标微信账号扫描二维码。
4. 如果微信要求，在手机上确认登录。
5. 私聊策略保持为 配对。
6. 保存可选账号和流式设置。

登录后发送测试消息，并在 xopc 中批准配对请求。

访问策略

推荐使用配对：未知发送者必须提供一次性验证码，消息才会进入 Agent。也可以在 Gateway 主机批准：

xopc channels pairing approve weixin <code> --account default

固定用户使用 白名单；只有有意公开的助手才使用 开放；需要阻止私聊时选择 停用。

多账号

只有需要多个微信身份或不同路由时才增加账号设置。先完整验证一个账号，并使用清晰的账号名称，方便解释配对请求和日志。

故障排查

• 二维码过期：关闭对话框并重新开始登录。
• 登录成功但收不到消息：确认保存凭据的是同一个 Gateway，并且它持续运行。
• 未知用户没有收到验证码：确认私聊策略是配对而不是白名单。
• 回复失败：先验证本地聊天，再查看微信通道日志。

不要把已保存登录文件复制到不受信任的电脑。凭据撤销或迁移到新 Gateway 主机后，请重新登录。