连接个人微信

首个接入切片支持：扫码者在微信 Bot 私聊发送文字，消息进入 PersonaBot 的 Inbox，由 Bot 使用自己的绑定身份回复原微信私聊。群消息、其他联系人、附件、历史／搜索以及定时或主动消息不属于本轮范围。企业微信是另一种接入方式。

#开始前

使用对应的 BotHarness 源码预览产品及 DSH 0.2.0-rc.1。先创建 PersonaBot，确认它能真实回复本地 DM。本机测试产品为 0.0.0-test.878，Provider 为 @botharness/im-provider@4.32.0-botharness.4，输入固定为 fork 589e5507d47ab21de5b39c776a598452744a5368；这不是已发布的 npm 产品。源码版已在微信客户端验证收件、模型与回复；压缩包安装后保留了连接及记录，并通过新一轮扫码者文字 → canonical Inbox → 模型 → 原私聊回复验证；Human 已确认微信收到 BH878-PACKED-OK。Human 于 2026-10-06 验收了首个切片。源码预览产物准备见产品 IM 安装。

#1. 扫码绑定微信 Bot

打开 设置 → IM bots → 微信 → 扫码绑定，开始绑定后，用目标微信账号扫码并在微信中确认。等待本地账号显示已连接。本轮客户端里的会话名是 微信 ClawBot；不同账号可能有所差异，请使用实际扫码创建的会话。

二维码是临时凭据。不要在公开 issue、截图或 Memory 中放入有效二维码、登录链接或账号令牌。接入入口截图应省略可用二维码。

入口截图来自配对前，未独立记录准确的 Client hash，仅用于说明入口。

#2. 绑定 PersonaBot 的外部身份

打开 PersonaBot 的 DM，点击顶部名称并选择 查看详细。在 外部身份 表中绑定已连接的微信账号；表中显示脱敏身份及启用／可用状态。绑定身份本身不会开启消息收件。

#3. 授权扫码者私聊并开启收件

展开 频道连接器与授权，选择扫码绑定者私聊并明确授权，再开启 微信私聊收件。此切片只投递到 Bot Inbox，不会把外部文字加入本地 Human DM 历史，也不会显示群收件、@ 或话题设置。对外回复使用当前 Bot 自己的绑定身份及有效的原消息续接能力。

#4. 核对真实文字与原私聊回复

在绑定的微信 Bot 私聊发送唯一测试文字，例如：请通过 bridge_reply 在此微信私聊只回复 WECHAT-SETUP-OK。 展开 Bot 收件箱，打开来源详情，确认平台为微信、范围为私聊。微信未提供昵称时，界面使用通用的“微信用户”标签；原始发送人、消息和 Source Event ID 保留在详情里。

两侧都需要核对：Inbox 状态变成已处理，并且回复出现在原微信私聊。仅有“平台已接受”不能证明送达或已读。iLink 回执里的 ID 是客户端生成的确认标识，不是已证明的原生服务端消息 ID。

第一条回复验证源码版，第二条验证重启后的本机安装产品；两次外部测试均未镜像进本地 Human DM。

#暂停与重新连接

关闭私聊收件会停止后续接收，并保留配置及历史。撤销目标授权或解绑身份会移除相应权限。重新扫码后身份指纹变化，需要明确重新授权；旧消息的续接能力不能跨身份复用。重启时沿用同一个 Profile，保留本地配对、canonical 来源与 Outbox 结果。

收不到文字时，检查账号连接、身份启用和扫码者私聊授权。其他联系人、群消息或非文字消息不在首个切片范围内。回复因原始续接能力缺失／过期被拒绝时，在绑定私聊发送新文字；Bot 不应借用另一个会话。发送结果不明时不能盲目重发。

#验证与范围

#878 记录源码版和安装版资格验证。本机安装测试重启后保留同一配对身份与扫码者私聊授权，随后产生一条已处理的 canonical 收件记录、一次成功的模型 bridge_reply、一条已接受 Outbox 结果，以及微信可见的 BH878-PACKED-OK 回复。Human 提供原生截图并授权公开使用。

入口、身份和 Inbox 图片来自真实源码版 QA；微信截图同时呈现源码版与安装版收发。Human 保留界面控制，未重拍最终 Profile，可按上面的步骤核对当前控件。截图不包含有效二维码、凭据或无关私人聊天列表。重新绑定、重复消息、错误路由与撤销拒绝有回归覆盖；未宣称完整真实异常／生命周期矩阵通过。公开 npm 发布和站点部署是独立动作。