> 内容来源：Onevium 官方文档
> 文章: 连接微信：扫码、权限与私聊验证
> 原文: https://onevium.com/zh/docs/channels/wechat
> 语言：简体中文
> 更新于: 2026-09-09
> 适用版本: 1.1.23+

---

# 连接微信：扫码、权限与私聊验证

扫码绑定个人微信，配置项目与允许名单，验证私聊回复并处理连接恢复。

## 微信渠道适合什么

通过个人微信扫码连接 Onevium，在私聊中向项目助手发任务并接收结果。当前使用 iLink 接入，支持**单个机器人和私聊**；微信群不在支持范围内。

## 开始前准备

准备可扫码的微信账号、演示项目，以及已经能在 Onevium 正常对话的模型。电脑和 Onevium 需保持运行并能联网。

登录凭据由扫码过程取得，不需要手填微信 App ID 或 API Key。扫码确认只完成登录，后面还要保存机器人配置。验证码只填登录表单的专用字段，不发进普通聊天。

## 扫码并创建第一个连接

1. 从侧栏打开「渠道」，点「新建渠道」，创建类型选**机器人**，平台选**微信**。
2. 点「生成二维码」，用需要绑定的微信账号扫码，并在手机确认。若提示验证码，将微信显示的数字填入「微信验证码」后点验证。
3. 看到「微信已连接」后点「继续配置」。二维码或登录票据过期时重新生成，再完成后续保存。
4. 在配置表单填写下列内容，点「创建机器人」。创建后应用会尝试启动连接；查看最终状态，不能只看扫码成功。

| 字段     | 第一次建议                      |
| ------ | -------------------------- |
| 机器人名称  | 例如“微信项目助手”，便于在 Onevium 中识别 |
| 模型     | 选择已经验证可用的提供商与模型            |
| 工作目录   | 选无敏感资料的演示项目                |
| 会话模式   | 保留“每人独立会话”                 |
| 自动批准操作 | 先保留默认询问档；具体调用仍受工具规则约束      |
| 聊天范围   | 微信固定为“仅私聊”，不能切换到群聊         |
| 私聊策略   | 保留“仅允许名单用户”；扫码账号会自动加入      |
| 系统提示   | 写清职责，例如“回答项目文档问题，不修改文件”    |

同一连接凭据已被另一机器人使用时，先打开提示中的现有连接，不要重复绑定。重新连接现有机器人也不能换成另一个微信账号；需要另一账号时新建机器人。

## 谁能发消息，如何批准操作

默认允许名单已包含扫码账号。添加其他允许用户时填写平台用户 ID，一行一个，不是昵称；不要为了排错直接开放给所有人。

微信的工具审批使用文字提示。核对工具、输入与目标后，在提示所在的私聊回复 **允许／拒绝**，英文 **allow／deny** 也可识别。它不是钉钉那样的卡片按钮；没有待审批请求时，不能把这几个词当作全局授权。

自动批准操作、私聊准入和会话模式是不同设置。共享会话选项也不会让微信支持群聊。

## 验证两轮私聊

在微信端打开扫码关联的私聊，先发送：

```text
本次测试代号是 wechat-demo-1。
只回复这个代号，不执行其他操作。
```

收到回复后追问“刚才的测试代号是什么？”确认：

- Onevium 对应微信连接出现这段私聊与消息。
- 两轮回复回到正确的微信账号，第二轮能使用本次上下文。
- 如果触发工具审批，处理后任务确实继续；文字出现不等于文件操作已经成功。

当前接入不提供联系人昵称。需要易读名称时，在该连接的聊天设置中选中私聊，填写「本地名称」并保存；它只改变 Onevium 显示，不修改微信昵称。

## 消息与恢复的边界

| 内容或情况       | 当前处理                          |
| ----------- | ----------------------------- |
| 文字、图片、文件    | 可以收发；附件先用小文件测试，单个上限为 20 MiB   |
| 带转写文字的语音    | 使用平台提供的文字；不是在此自动识别所有语音        |
| 无转写语音、视频    | 当前不支持；改发文字、图片或文件              |
| 长回复         | 可能拆成多条文字；不提供飞书／钉钉式流式卡片        |
| 主动发送        | 需要该私聊已建立的回复上下文；提示要求时先从微信发送新消息 |
| 普通网络中断      | 自动重试，并保存已收到消息与游标用于恢复          |
| 登录失效或本地保存失败 | 需要处理错误；不能把重新扫码当作修复所有故障        |

恢复后先看已有消息和执行状态，不要连发同一任务来“催回复”。停止连接或关闭电脑期间不能承诺持续接收、执行；本地恢复记录也不等于跨系统绝不重复。

## 常见问题

| 现象            | 先检查                              |
| ------------- | -------------------------------- |
| 没有微信平台        | 核对顶部适用版本，创建类型选择机器人               |
| 扫码后仍等待        | 手机是否已确认；是否需要验证码；二维码是否过期          |
| 提示账号不匹配／凭据已占用 | 是否扫了另一个账号，或已有对应机器人               |
| 已连接却不回复       | 是否保存并运行、是否为私聊、发送账号是否在允许名单、模型是否可用 |
| 一直提示重连        | 网络与登录状态；要求重新登录时用“重新连接微信”扫码并保存    |
| 提示先发新消息       | 从同一微信私聊发一条新消息，建立有效回复上下文          |
| 保存或恢复消息失败     | 检查本地存储并保留错误记录，不先删除机器人或数据库        |

## 下一步

回到[渠道概览](https://onevium.com/zh/docs/team-channels)比较接入方式，按[权限指南](https://onevium.com/zh/docs/permissions)选择操作范围，模型连接问题见[提供商](https://onevium.com/zh/docs/providers)。先验证文字私聊，再验证你需要的附件或项目工具。