乐于分享
好东西不私藏

微信OpenClaw插件ClawBot上线:代码拆解+安装教程+玩法合集

微信OpenClaw插件ClawBot上线:代码拆解+安装教程+玩法合集

嗨,我是Thea,打过ACM-ICPC世界总决赛,做过微软搜索算法工程师,去年手搓了月入万刀的AI应用,在这里记录我的AI成长历程,希望能帮到一起学AI的你✨

这几天微信上线了一个新插件——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 你好
直接回显文字(不经过AI),顺便看通道耗时
/toggle-debug
开关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 协议写了一份完整的技术文档——接口地址、请求格式、加密方式、登录流程、错误码,全部记录清楚。

想自己从零开发的人,看这份文档就够了。

本站文章均为手工撰写未经允许谢绝转载:夜雨聆风 » 微信OpenClaw插件ClawBot上线:代码拆解+安装教程+玩法合集

猜你喜欢

  • 暂无文章