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

将个人微信账号接入OpenCowork，听起来是不是有点复杂？其实整个流程很清晰——核心就三件事：搞清适用场景、走通配置步骤、理解消息收发原理。个人微信可以通过扫码绑定到OpenCowork的聊天频道里，然后靠长轮询来收发消息，顺便还能用上Agent的自动回复能力。

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 发回微信

整个过程，就像在PC端登录微信一样顺畅，只是背后多了一层自动化的消息处理。

前置要求 / Prerequisites

开始之前，务必确认这几个条件：

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

   个人微信
   扫码绑定

配置步骤 / Setup

1. 打开聊天频道页面

进入：

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

2. 确认默认网关地址

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

https://ilinkai.weixin.qq.com

通常情况下你

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

可选配置项说明：

配置项	是否必填	说明
baseUrl	否	微信网关地址，默认使用官方地址
routeTag	否	某些环境下用于路由分流
token	否	扫码成功后自动写入
accountId	否	扫码成功后自动写入
userId	否	扫码成功后自动写入

3. 点击“绑定微信”

在 微信绑定 区块中点击：

OpenCowork 会向微信网关请求二维码，并在设置页中显示扫码区域。如果返回的是扫码网页，OpenCowork 会自动转换为本地可显示的二维码截图，不需要你手动打开外部页面——这个细节很贴心。

4. 用个人微信扫码确认

使用你的微信 App 扫描二维码，并在手机上完成确认。成功后，OpenCowork 会自动拿到并保存 token、accountId 和 userId。同时页面状态会从“未绑定官方微信账号”变成“已绑定官方微信账号”。

5. 启动官方微信渠道

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

启动后，OpenCowork 会开始执行 getupdates 长轮询收消息，自动把微信私聊消息送进 Agent 自动回复链路，并使用 sendmessage 发回回复内容。

6. 测试消息收发

现在你可以用另一个微信账号，向已绑定的微信号发送消息进行测试。整个过程如同行云流水，消息来回的响应都交给OpenCowork处理。

使用说明 / Usage Notes

当前支持能力

当前官方微信渠道更适合做

，已覆盖：

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

当前限制

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

1. 不是公众号方案

它不是公众号客服接口，也不是微信开放平台消息推送方案。如果你的目标是公众号菜单、模板消息、关注后自动回复或者面向大量用户的公开服务，那么应该走公众号/服务号的另一套实现。

2. 回复依赖上下文令牌

官方微信渠道在回复时依赖服务端返回的 context_token。这意味着已经发生过对话的私聊可以正常回复，但没有上下文的陌生会话，不适合直接主动发送首条消息。从实际效果看，这更像是一个被动响应的机制。

3. 当前以私聊为主

目前更适合个人微信私聊消息场景，群聊、复杂媒体能力不属于这篇教程的主线能力。如果你的需求超出了这个范畴，可能需要考虑其他方案。