qclaw单客户端仅支持绑定1个微信账号;需解除当前绑定并重启才能切换;多账号需部署独立实例或通过企业api动态切换。
如果您尝试将qclaw与多个微信账号关联,但发现无法重复绑定或切换失败,则可能是由于qclaw对单个客户端实例设置了明确的微信号绑定上限。以下是解决此问题的步骤:
一、单个QClaw客户端支持绑定的微信号数量
QClaw官方未开放多微信并行登录能力。每个已部署的QClaw客户端实例仅允许绑定且仅能维持1个微信账号的实时授权状态。该限制源于微信OAuth2.0授权机制的安全策略,QClaw本身不支持Token复用或多账号会话隔离。
1、启动QClaw应用后,首次微信扫码完成授权即建立唯一绑定关系。
2、若尝试再次扫码绑定另一微信,系统将自动终止前一账号的长连接,并清空其会话上下文。
3、已绑定账号在微信端退出登录或主动解绑后,原QClaw客户端需重启才能触发新绑定流程。
二、切换绑定微信号的操作流程
切换绑定需主动解除当前微信授权,再重新触发绑定流程。此过程不保留历史指令记录与临时任务状态,但本地技能包配置与模型偏好设置不受影响。
1、在QClaw主界面右上角点击齿轮图标(如可见),选择“账号管理”选项。
2、点击“解除当前微信绑定”按钮,确认操作后等待界面提示“授权已清除”。
3、关闭并重新打开QClaw客户端,左下角将重新弹出微信关联二维码。
4、使用目标微信账号扫描新二维码,完成授权确认。
三、多微信号共存的替代方案
如需在不同微信账号间频繁切换控制权,可通过部署多个独立QClaw实例实现物理隔离。各实例使用不同安装路径与数据目录,互不干扰。
1、下载QClaw安装包,为第二个实例创建独立文件夹,例如命名为“QClaw_Work”。
2、在该文件夹内执行全新安装,避免覆盖默认安装路径。
3、启动新实例,完成第二微信账号的绑定流程。
4、两个QClaw进程可同时运行,分别对应不同微信账号,任务指令互不混淆。
四、企业级多账号统一管理方式
对于组织用户,QClaw提供API级账号托管能力,通过调用/v1/account/switch接口配合预置密钥,可在服务端动态切换受信微信ID,无需人工扫码。
1、联系腾讯QClaw企业支持获取tenant_id与api_secret。
2、构造POST请求,Header中携带X-QClaw-Tenant: {tenant_id}与Authorization: Bearer {api_secret}。
3、Body中传入目标微信UnionID与设备指纹标识,调用接口触发后台账号映射切换。
4、切换成功后,所有来自该微信的消息将路由至指定QClaw工作实例。











