8.26 微信接入龙虾(OpenClaw)

微信官方 ClawBot 插件,让你在微信里直接和龙虾对话。这是微信团队(@WeixinTeam)官方出品的方案,无需担心封号风险。

微信接入龙虾封面

背景

OpenClaw 是今年最火的开源 AI Agent 平台,GitHub 星标从 9000 飙到 300000+。它跑在你自己的电脑上,通过 Channel 插件接入各种聊天工具:Telegram、Discord、WhatsApp 都支持。

之前社区也有不少把 OpenClaw 接微信的方案(openclaw-wechat、openclaw-china 等),走的是代理服务模拟协议的路子。能用,但存在封号风险。

现在微信官方亲自下场了。ClawBot 插件直接内置在微信 App 里,扫个码就能用,不需要搞代理服务,也不用担心合规问题。

微信 ClawBot 官方插件页面
官方方案
ClawBot 是微信团队官方出品的插件,与社区的野路子方案完全不同,不用担心任何账号安全问题。建议优先使用官方方案。

接入步骤

操作很简单,就两步。

第一步:安装微信 Channel 插件

在你运行 OpenClaw 的电脑上执行:

npx -y @tencent-weixin/openclaw-weixin-cli@latest install

这条命令会安装微信 Channel 插件到 OpenClaw,然后生成一个二维码。

安装命令执行效果

第二步:微信扫码连接

用微信扫码,确认连接。扫完之后,微信里就会多出一个「微信 ClawBot」的对话,直接发消息就能和你的龙虾聊天了。

注意事项

  • 需要把微信更新到最新版,目前应该只有 iOS 支持
  • 如果更新后还看不到 ClawBot 入口,试试多重启几次微信
  • 一个 ClawBot 只能连接一个 OpenClaw 实例,即目前只能连一只龙虾
  • 建议使用官方方案,不要使用社区的非官方方案
注意
微信官方出了正式接口,就用正式的,省心也安全。不建议使用社区的代理服务模拟协议方案。

技术原理

微信官方的 @tencent-weixin/openclaw-weixin 插件基于 ClawBot ilink API,工作流程分三步:

OpenClaw 和 Claude Code 共用同一套微信 ClawBot ilink API

1. 认证环节

插件调用 ilink/bot/get_bot_qrcode 接口拿到一个二维码,用户用微信扫码后,服务端通过 ilink/bot/get_qrcode_status 长轮询返回认证结果,包括一个 bot_token

2. 收消息

ilink/bot/getupdates 接口做 HTTP 长轮询,服务端有新消息就返回,没有就挂着等。每条消息带一个 context_token,回复时必须带上用来关联对话上下文。

3. 发消息

调用 ilink/bot/sendmessage,带上 bot_token 认证和 context_token 关联,消息就能发回微信了。

ClawBot ilink 协议三步通信流程

本质上就是一个标准的 HTTP 长轮询 + Token 认证 的消息通道。接口跑在 https://ilinkai.weixin.qq.com,是微信官方的域名。

提示
这套接口和你接的是什么 AI 没有任何关系。它只是一个消息通道:微信把用户消息送过来,你把回复送回去。至于中间谁在处理消息,是 OpenClaw 还是 Claude Code 还是你自己写的脚本,接口层面完全一样。

相关链接