微信OpenClaw插件ClawBot上线:代码拆解+安装教程+玩法合集
这几天微信上线了一个新插件——ClawBot。
打开微信 → 我 → 设置 → 插件,你会看到一个红色图标的新面孔。

我拆了这个插件的代码,看看它到底怎么工作的
好奇心驱使,我把腾讯官方的插件源码完整读了一遍。
整个流程可以用一句话概括:
扫码登录拿Token → 长轮询收消息 → 交给AI处理 → 把回复发回去。
展开说就是五个部分:
1. 登录:扫个码就行
插件连接腾讯的 ilinkai.weixin.qq.com 服务器,拿到一个二维码。你用微信扫码确认,服务器返回一个 bot_token——之后所有通信都靠这个token。
支持多账号,每扫一次码就多连一个微信号,互不干扰。
2. 收消息:你发的每一条消息都会到
插件通过 getUpdates 接口持续等待新消息。微信的做法是hold住请求(默认35秒),有新消息就立刻返回,没消息就等到超时再返回空结果。
每次请求带一个同步游标,服务器根据它知道上次到哪了,只返回新消息。这个游标存在本地,重启也不丢。
3. 什么类型的消息都能处理
不只是文字。图片、视频、文件、语音全都支持。
●图片和文件从微信CDN下载后自动解密(AES-128-ECB加密)
●语音消息会转成WAV格式,如果微信已经转好了文字就直接用文字
●引用消息的原文也会一起传给AI
●陌生人的消息会被自动过滤,只有配对过的用户才能触发AI
4. AI怎么回复
AI生成的Markdown会自动转成纯文本发到微信——代码块保留内容去掉围栏,链接只保留文字。
如果要发图片或文件,流程是:本地加密 → 上传到CDN → 把下载凭证塞进消息发出去。
单条消息上限4000字,超长自动分段发送。
5. 小细节:AI思考的时候有”正在输入”
AI在想答案的时候,你的微信里会显示”对方正在输入…”。插件每5秒发一次心跳保持这个状态,回复完了自动取消。
这个细节让体验特别像在跟一个真人聊天。
怎么装
30秒搞定
# 前提:已安装OpenClaw
npx -y @tencent-weixin/openclaw-weixin-cli install
终端弹出二维码,微信扫码确认,看到 ✅ 就成功了。
想连第二个微信号?
openclaw channels login --channel openclaw-weixin
再扫一次码就行。
推荐设置
# 多账号隔离,两个号的对话不串台
openclaw config set agents.mode per-channel-per-peer
# 重启生效
openclaw gateway restart
微信里的隐藏命令
连上以后,你可以在微信里直接给AI发这些命令:
|
|
|
|---|---|
/echo 你好 |
|
/toggle-debug |
|
debug模式特别实用,能看到每个环节花了多少毫秒,方便调优。
上线一天,已经有人开始造东西了
这个插件用的是一套全新的 iLink 协议,昨天才公开。但开发者的速度非常快。
weixin-agent-sdk
GitHub: wong2/weixin-agent-sdk ⭐ 525
有人从腾讯官方包里提取了核心协议,做成了一个通用SDK。几行代码就能搭一个微信AI助手:
import { Agent } from 'weixin-agent-sdk'
const agent = new Agent({
onMessage: async (msg) => {
return '收到:' + msg.text
}
})
await agent.login() // 弹出二维码
await agent.start() // 开始收消息
不绑定OpenClaw,任何AI框架都能用。这意味着门槛一下子就降下来了。
claude-plugin-weixin
GitHub: m1heng/claude-plugin-weixin ⭐ 454
这个更直接——把微信消息接进了Claude Code的终端。你在终端写代码的时候,微信消息直接弹出来,Claude帮你回。
不需要公网IP,不需要部署服务器,本地就能跑。
openclaw-weixin 协议文档
GitHub: hao-ji-xing/openclaw-weixin ⭐ 50
有人把整个 iLink 协议写了一份完整的技术文档——接口地址、请求格式、加密方式、登录流程、错误码,全部记录清楚。
想自己从零开发的人,看这份文档就够了。
夜雨聆风