桌面端 Claw 个人微信接入指南

OpenCowork 现在支持把个人微信账号接入到聊天频道里，通过扫码完成绑定，然后使用长轮询收发消息。

这篇教程对应的是个人微信扫码绑定方案，不是微信公众号、服务号、订阅号，也不是企业微信应用接入。

适用场景 / When to Use

适合以下需求：

• 你希望用自己的个人微信号收发 AI 回复
• 你希望把微信私聊消息接入 OpenCowork 的 Agent 能力
• 你希望在 OpenCowork 内统一管理聊天渠道，而不是单独维护网页端机器人

不适合以下需求：

• 微信公众号自动回复
• 企业微信应用消息
• 面向公开用户的大规模消息触达

工作原理 / How It Works

整体链路如下：

这个渠道不是通过 Webhook 推送，而是：

1. 在 OpenCowork 里点击“绑定微信”
2. 生成二维码
3. 你用微信扫码确认登录
4. OpenCowork 保存 token / accountId / userId
5. 渠道启动后通过 getupdates 长轮询获取新消息
6. 回复消息时通过 sendmessage 发回微信

前置要求 / Prerequisites

开始之前，请确认：

1. 你已经安装并启动 OpenCowork
2. 你的 OpenCowork 版本包含“官方微信”聊天频道
3. 你的机器可以访问默认微信网关地址：https://ilinkai.weixin.qq.com
4. 你准备用自己的个人微信扫码绑定

配置步骤 / Setup

1. 打开聊天频道页面

进入：

设置 → 聊天频道 → 官方微信

在左侧 China 分组里选择 官方微信。

位置：OpenCowork 设置页左侧导航 + 聊天频道列表中选中“官方微信”的截图

2. 确认默认网关地址

官方微信 渠道默认会使用：

https://ilinkai.weixin.qq.com

通常你不需要手动填写微信网关地址。

只有在你有自建或特殊转发网关时，才需要修改 baseUrl。

可选配置项说明：

3. 点击“绑定微信”

在 微信绑定 区块中点击：

绑定微信

OpenCowork 会向微信网关请求二维码，并在设置页中显示扫码区域。

如果返回的是扫码网页，OpenCowork 会自动转换为本地可显示的二维码截图，不需要你手动打开外部页面。

位置：点击“绑定微信”后显示二维码的截图

4. 用个人微信扫码确认

使用你的微信 App 扫描二维码，并在手机上完成确认。

成功后，OpenCowork 会自动拿到并保存：

• token
• accountId
• userId

同时页面状态会从“未绑定官方微信账号”变成“已绑定官方微信账号”。

5. 启动官方微信渠道

绑定完成后，点击页面底部的：

启动

启动后，OpenCowork 会开始执行：

• getupdates 长轮询收消息
• 自动把微信私聊消息送进 Agent 自动回复链路
• 使用 sendmessage 发回回复内容

位置：渠道状态从“已停止”切换到“运行中”的截图

6. 测试消息收发

现在你可以用另一个微信账号，向已绑定的微信号发送消息进行测试。

使用说明 / Usage Notes

当前支持能力

当前官方微信渠道更适合做私聊自动回复，已覆盖：

• 文本消息接收
• 基于上下文的文本回复
• OpenCowork 自动回复链路接入
• 账号绑定信息持久化

当前限制

这套个人微信接入有几个你需要提前知道的限制：

1. 不是公众号方案

它不是公众号客服接口，也不是微信开放平台消息推送方案。

如果你的目标是：

• 公众号菜单
• 模板消息
• 关注后自动回复
• 面向大量用户的公开服务

那么应该走公众号/服务号的另一套实现。

2. 回复依赖上下文令牌

官方微信渠道在回复时依赖服务端返回的 context_token。

这意味着：

• 已经发生过对话的私聊可以正常回复
• 没有上下文的陌生会话，不适合直接主动发送首条消息

3. 当前以私聊为主

目前更适合个人微信私聊消息场景，群聊、复杂媒体能力不属于这篇教程的主线能力。

项目开源地址：https://github.com/AIDotNet/OpenCowork

交流群