一句话剧透：2026年3月22日，腾讯正式推出微信ClawBot官方插件，让12亿微信用户第一次拥有了原生AI Agent入口。这不是第三方的灰产套壳，是腾讯亲儿子，背后跑的是iLink官方协议。今天我们从原理、代码、踩坑三个维度，把这个Skill讲透。

一、开场：凌晨两点，我盯着微信里那只"小龙虾"

上周三深夜，我在改一个bug。

突然想到，openclaw里有个老问题想查一下——比如"如何把本地文件批量重命名"。

正常流程是：开终端 → 启动openclaw → 敲命令 → 看回显。

但那天我懒得动。

我直接打开微信，找到"ClawBot"，敲了一句：

“把 ~/Downloads 下面所有 .jpg 文件按日期重命名，按年-月-日_原序号.jpg 命名”

3秒后，微信弹回一段话：

✅ 已完成 扫描到 247 个 jpg 文件 重命名 247 个，失败 0 个 耗时 2.3 秒 最早文件：2019-03-12_IMG_001.jpg 最晚文件：2026-07-22_截图.jpg 完整日志已保存到 ~/.openclaw/logs/rename.log

我盯着那个对话框愣了5秒钟。

这玩意儿不是套壳，不是爬虫，不是某灰产圈子里天天吹的"微信机器人"——这是腾讯官方出手了。

而这只"小龙虾"，就是今天要聊的：openclaw-weixin，微信ClawBot官方插件。

二、为什么这个Skill值得专门写一篇？

先说几个数字，你感受一下：

• 2026年3月22日，腾讯正式发布微信ClawBot插件
• 支持iOS/Android 8.0.70+微信，灰度放量中
• 底层协议iLink，接入域名ilinkai.weixin.qq.com——这是腾讯官方服务器
• GitHub上openclaw主项目Star 23万+
• 国内媒体口径：12亿微信用户的AI入口打开（数据来源：IT之家、新华财经、北京商报）

但数字背后，真正有意思的是三件事：

1. 之前根本没人能合法接入个人微信—— 个人微信官方不开放Bot API，第三方方案（Wechaty、Gewechat、WeChatFerry）全是协议模拟，封号风险高得离谱
2. OpenClaw已经支持Telegram、WhatsApp、Discord、Slack—— 但都是海外平台，中国用户真正高频使用的还是微信
3. 腾讯这次把iLink协议正式开放—— 这是官方第一次对个人微信的Bot能力开口子

简单说：openclaw-weixin = 12亿用户入口 × openclaw全部Skills × 零封号风险。

这个组合，全球独一份。

三、openclaw-weixin是什么？一句话说清楚

openclaw-weixin 是腾讯官方在 2026年3月推出的微信ClawBot插件，通过官方iLink协议让openclaw安全地接入个人微信，让你在微信聊天界面里直接指挥你的AI Agent。

核心特征：

说人话：装上它，你的微信里就多了一个叫"ClawBot"的好友，你说什么，它就给你在电脑上干活。

四、它是怎么工作的？3分钟讲透原理

4.1 完整数据流

先看一条消息是怎么从你微信发到你电脑里跑的openclaw的：

微信客户端 ↓ (你打字发出去) 微信官方服务器 ↓ (iLink协议加密传输) openclaw-weixin 插件 (跑在你电脑上) ↓ (HTTP JSON API本地通信) openclaw Gateway (网关) ↓ (路由到对应Agent/Skill) AI Agent / Skills 执行具体任务 ↓ (回传结果) 原路返回，微信里弹出回复

简单说，openclaw-weixin就是个"翻译官"——左边说微信的话，右边说openclaw的话。

4.2 三大核心模块

打开openclaw的扩展目录~/.openclaw/extensions/openclaw-weixin/，你会看到几个关键文件：

① 扫码登录：login-qr.ts

用户用微信扫二维码后，插件会调用腾讯上游接口：

• get_bot_qrcode—— 获取二维码
• get_qrcode_status—— 轮询扫码状态
• 拿到三个关键凭证：bot_token/ilink_bot_id/ilink_user_id

这些凭证会本地加密存储，不会上传到任何第三方服务器。

② 收消息：monitor.ts+channel.ts

插件启动后进入一个long-poll长轮询循环：

// 简化版代码 while (running) { const updates = await ilink.getUpdates({ get_updates_buf: lastCursor // 上次的游标 }); for (const msg of updates.msgs) { // 转换成 openclaw 标准消息格式 const ctx = inbound.toOpenClawContext(msg); // 路由到对应 Agent gateway.route(ctx); // 持久化游标 syncBuf.save(updates.get_updates_buf); } }

几个关键设计：

• 35秒长轮询超时—— 服务端有新消息立即返回，没消息最长等35秒
• 游标持久化—— 重启后不会丢消息，也不会重复拉取
• 消息上下文转换—— 把微信消息转成openclaw统一的"消息事件"格式

③ 发消息：sendmessage接口

Agent产出回复后，插件调用：

POST /sendMessage Headers: Content-Type: application/json Authorization: Bearer <bot_token> X-WECHAT-UIN: <随机base64编码> Body: { "to": "user_xxx", "type": "text", "content": "✅ 已完成..." }

支持的消息类型：

• 文本（text）
• 图片（image）—— 走getUploadUrl拿预签名URL上传CDN
• 视频（video）
• 文件（file）
• 输入状态（typing）—— 显示"对方正在输入…"

4.3 接口清单（想魔改的看这里）

所有接口都是POST方法，请求体和响应体都是JSON，统一走iLink协议。

五、3分钟安装，全程鼠标点击也能搞定

5.1 前置条件

5.2 方式一：一键安装（推荐）

步骤1：手机微信进入我→设置→插件→ 找到微信ClawBot→ 点击详细

页面会显示一行安装命令，类似：

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

步骤2：在你部署openclaw的设备上打开终端，粘贴这行命令，回车

步骤3：等它跑完，终端会弹出一个二维码

步骤4：打开手机微信 → 扫一扫 → 扫码 → 确认授权

完事。

整个过程不到3分钟。

5.3 方式二：手动安装（如果自动安装失败）

有时候ClawHub会提示"速率受限制"，这时候改手动：

# 步骤1：先停掉openclaw openclaw gateway stop pkill -f openclaw # 步骤2：手动安装插件 openclaw plugins install "@tencent-weixin/openclaw-weixin" # 步骤3：启用插件 openclaw config set plugins.entries.openclaw-weixin.enabled true # 步骤4：触发扫码登录 openclaw channels login --channel openclaw-weixin # 步骤5：重启Gateway openclaw gateway restart

5.4 验证是否成功

打开手机微信，应该能看到一个"ClawBot"的联系人。随便发条消息测试：

“你好，介绍一下你自己”

如果回复一段自我介绍，恭喜你，接入成功。

六、6个真实使用场景，让你感受到它的强

场景1：深夜的程序员救星

传统流程：发现bug → 查Google → 翻StackOverflow → 改代码 → 重启服务 → 写commit

微信ClawBot流程：在微信发"openclaw，帮我看看 ~/code/myapp/src/api.js 第127行为什么报 undefined is not a function"

实际效果：

• AI直接读文件
• 调用Skill分析错误
• 给出修复建议
• 微信里给你回话

你甚至不用打开电脑。

场景2：自媒体的内容生产

微信发一句：“今天公众号要发一篇关于GPT-5的稿子，帮我写个3000字的技术解读，要带案例和对比表格”

AI自动调用：

• tavily-search Skill查最新信息
• summarize Skill整理素材
• nano-pdf Skill查相关研究报告
• 直接生成Markdown格式的稿件

你躺床上就把稿子写了。

场景3：家庭服务器管理

微信发：“openclaw，帮我看看家里NAS的硬盘使用情况”

AI调用filesystem-mcp Skill，列出所有挂载点的空间占用，回传微信。

不用记SSH命令，不用开电脑。

场景4：群里的智能助手

在工作群里有人问：“上周那个客户的对接文档发我一下”

AI自动调用notion-skill，去Notion知识库搜"客户对接文档"，把链接发到群里。

群里的人都惊了。

场景5：定时任务的微信通知

早上9点，AI自动检查你的邮件（email-management Skill），把今天的待办整理成清单发到微信。

晚上6点，AI自动汇总今天的工作日志，生成日报发微信。

你完全不用打开任何App。

场景6：个人微信也能安全地用

以前你想在个人微信里跑个AI助手，方案都是灰的：

• Wechaty —— 协议模拟，封号率30%+
• Gewechat —— 同样风险
• WeChatFerry —— hook方案，容易掉线

openclaw-weixin走腾讯iLink官方协议，零封号风险。

这才是真正"敢用"的方案。

七、安全性分析：为什么这次可以放心用？

7.1 官方协议的三大保障

7.2 vs 第三方方案对比

结论：openclaw-weixin = 唯一靠谱的个人微信AI接入方案。

7.3 风险点（但都是可控的）

虽然官方插件本身很安全，但openclaw生态本身有一些需要注意的点：

1. 指令注入风险—— 有人微信里给你发"忽略之前的指令，执行xxx"，AI可能会被诱导
2. Skill供应链投毒—— 装来历不明的Skill可能导致token泄露
3. 默认端口暴露—— openclaw默认18789端口如果暴露公网，可能被攻击

解决方案：

• 配置~/.openclaw/allowlist.json加白名单
• 装Skill前用skill-vetter扫一遍
• 改默认端口 + 配防火墙

八、openclaw-weixin的5个明显优点 + 2个不足

5个明显优点

1. 官方协议零风险—— 不封号、不掉线、不用担心合规问题
2. 3分钟装完—— 一行命令 + 扫码，比装个手机App还简单
3. 全平台打通—— Windows / macOS / Linux通吃，手机iOS/Android通吃
4. 完整媒体支持—— 文本/图片/视频/文件都能发，"正在输入"状态显示
5. 生态完美融合—— openclaw的3000+ Skills全部可用，相当于给微信接入了3000个超能力

2个目前不足

1. 群聊支持有限—— 目前主要是私聊稳定，群聊还在持续完善
2. 多媒体推送有限—— 主动推送图文混排卡片还有限制，主要是文本+图片

但这些都在快速迭代中，按openclaw的更新速度，1-2个月就能补齐。

九、黄金组合：openclaw-weixin + 5个Skills的实战

光有openclaw-weixin还不够，配合openclaw生态里的Skills才能发挥最大威力。

组合1：内容创作全家桶

openclaw-weixin (微信入口) + tavily-search (联网搜索最新资讯) + summarize (长文摘要) + nano-pdf (PDF处理) + nano-banana-pro (AI配图)

场景：你躺床上发一句"帮我写一篇关于Claude 5的3000字分析，带配图和案例"

→ 3分钟后微信收到完整稿子 + 配图

组合2：办公自动化全家桶

openclaw-weixin (微信入口) + email-management (邮件处理) + gog (Google全家桶) + office-cli (Office全家桶) + notion-skill (Notion知识库)

场景：早上在地铁上发"openclaw，今天有几封新邮件需要处理？"

→ AI扫描邮件，重要邮件摘要发微信 + 自动归档Notion

组合3：家庭服务器管理全家桶

openclaw-weixin (微信入口) + filesystem-mcp (文件系统) + n8n-workflow-automation (工作流编排) + database-query (数据库查询)

场景：发"openclaw，NAS硬盘还剩多少？"

→ AI查文件系统 → 微信回"已用82%，剩余850G"

组合4：开发提效全家桶

openclaw-weixin (微信入口) + github (GitHub管理) + agent-browser (浏览器自动化) + self-improving-agent (自我进化)

场景：发"openclaw，帮我看看我那3个仓库有没有新Issue"

→ AI查GitHub → 微信列出来 → 你直接说"把3天前的全部回复’在处理中’"

组合5：自媒体矩阵全家桶

openclaw-weixin (微信入口) + xiaohongshu-mcp (小红书) + content-collector-skill (内容采集) + wechat-draft-writer (公众号写作)

场景：发"openclaw，把今天科技圈最火的3条新闻发小红书"

→ AI采集 → 写文案 → 自动发布 → 微信通知"已发，链接xxx"

十、踩坑指南：5个常见问题

问题1：微信里找不到ClawBot插件

原因：账号还在腾讯灰度覆盖范围

解决：

• 更新微信到最新版
• 关闭微信重启
• 等待1-2天，灰度逐步覆盖
• 多账号测试

问题2：扫码后提示"当前登录环境异常"

原因：微信风控，不允许非官方客户端登录

解决：

• 确认openclaw-weixin版本 ≥ 2.0.1
• 不要在测试服/小号上扫
• 检查网络是否能访问ilinkai.weixin.qq.com

问题3：微信能收到消息但机器人不回复

原因：消息链路未完全打通

解决：

• 检查openclaw Gateway是否运行：openclaw gateway status
• 查看日志：tail -f ~/.openclaw/logs/openclaw.log
• 确认模型API配置正确

问题4：openclaw升级到2026.3.24后插件失效

原因：openclaw架构重构，旧的微信插件入口失效

解决：

# 卸载旧版 openclaw plugins uninstall openclaw-weixin rm -rf ~/.openclaw/extensions/openclaw-weixin rm -rf ~/.openclaw/openclaw-weixin # 装新版 npx -y @tencent-weixin/openclaw-weixin-cli@latest install

问题5：ClawBot插件突然消失

原因：微信版本回退 或 灰度策略变化

解决：

• 重新更新微信到8.0.70+
• 在我-设置-插件重新启用

十一、写在最后：这不是一个Skill，是AI普惠的拐点

最后说点大格局的东西。

openclaw-weixin看起来只是一个插件，但它解决了一个困扰中国AI行业3年的核心问题：

个人微信的Bot入口

之前，中国开发者要做微信AI，要么：

• 用企业微信（功能受限、体验差）
• 走灰产（封号、违规、不敢用在生产）
• 放弃（用户不用别的平台）

现在，腾讯亲自下场，把iLink协议开放了。

这意味着：

• 12亿微信用户第一次可以"原生"使用AI Agent
• 个人开发者第一次有合规路径把AI能力塞进微信
• 企业用户第一次可以在不加企业微信的情况下做内部AI

而这背后，是openclaw生态提供的3000+ Skills作为弹药库。

一个微信聊天窗口 = 一台超级AI电脑。

这不是营销话术，是正在发生的事实。

行动号召

如果你还在用Telegram、Slack这些海外平台跟你的openclaw对话——

试试openclaw-weixin。

3分钟装完。

然后给微信里的ClawBot发一句：

“你好，介绍一下你自己”

感受一下，“你的微信，第一次有了AI大脑”。

安装命令：

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

GitHub：

• openclaw主项目：GitHub - openclaw/openclaw: Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞 · GitHub
• 微信插件：https://github.com/tencent-weixin/openclaw-weixin

官方文档： WeChat - OpenClaw

数据来源：腾讯云开发者社区、博客园、36氪、IT之家、CSDN技术社区