OpeniLinkOpeniLink
指南

背景知识

了解微信 ClawBot 插件、OpenClaw 和 iLink 协议的来龙去脉。

在了解 OpeniLink 之前,有必要先弄清楚它所依赖的几个核心背景:微信 ClawBot 插件、OpenClaw 以及 iLink 协议。这一页将逐一介绍它们的来龙去脉。

微信 ClawBot 插件是什么

2026 年 3 月 22–23 日,腾讯正式上线了微信 ClawBot 插件(中文昵称"龙虾插件"),让微信的 14 亿月活用户可以直接在微信内与 OpenClaw AI Agent 进行交互(IT之家报道TechNode 报道南华早报报道Yahoo Finance 报道)。

使用条件

  • 微信版本 v8.0.70 或更高
  • 设备上已安装 OpenClaw

安装方式

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

安装完成后,进入微信:我 → 设置 → 插件,即可找到 ClawBot 入口。

能力与限制

ClawBot 支持多模态交互,包括文本、图片、视频和文件。但也存在一些限制:

  • 24 小时消息窗口:Bot 必须在收到用户消息后 24 小时内回复,超时后需等待用户再次发起对话。
  • 不支持斜杠命令:无法使用类似 /command 的交互方式。

24 小时窗口机制与 iLink 协议的 Context Token 直接相关——Token 有效期为 24 小时,过期后 Bot 无法主动触达用户。

OpenClaw 是什么

OpenClaw 是一个开源的自主 AI Agent 工具,由奥地利开发者 Peter Steinberger 创建,使用 TypeScript 和 Swift 编写,采用 MIT 开源协议(WikipediaTechCrunch 报道CNBC 报道)。

发展时间线

时间事件
2025 年 11 月项目以 Clawdbot 名称启动
2026 年 1 月更名为 Moltbot,随后再次更名为 OpenClaw
2026 年 2 月Steinberger 加入 OpenAI,项目移交给开源基金会运营
2026 年 3 月GitHub 星标数达到 247,000,成为最受关注的 AI Agent 项目之一

OpenClaw 是微信 ClawBot 插件的运行前提——用户设备上必须安装 OpenClaw,ClawBot 才能正常工作。

iLink(智联)是微信官方提供的 Bot 通信协议,官方域名为 ilinkai.weixin.qq.comGitHub 技术文档allclaw.org)。它是一套标准的 HTTP/JSON 协议,为开发者提供了与微信 Bot 交互的合法接口。

核心端点

端点用途
get_bot_qrcode获取 Bot 登录二维码
get_qrcode_status查询二维码扫码状态
getupdates长轮询方式接收新消息
sendmessage发送消息
getuploadurl获取媒体上传地址
getconfig获取 Bot 配置信息
sendtyping发送输入状态提示

认证方式

所有 API 请求通过 Authorization 请求头携带 ilink_bot_token 进行身份验证。

消息类型

类型编号说明
文本1纯文本消息
图片2图片消息
语音3语音消息(Silk 格式)
文件4文件消息
视频5视频消息

媒体加密

媒体文件存储在腾讯 CDN 上,使用 AES-128-ECB 加密。开发者在下载媒体后需要使用对应密钥进行解密。

iLink 协议本身只是一个原始通道,不提供消息路由、过滤、分发等高级能力。这正是 OpeniLink Hub 要解决的问题。

在 iLink 协议出现之前,想要通过编程方式操作微信,唯一的途径是逆向工程——注入微信客户端、拦截通信协议、模拟用户操作。这种做法存在严重问题:

  • 违反微信服务条款,随时可能被封号
  • 法律风险高,涉及破坏计算机信息系统等法律问题
  • 稳定性差,每次微信更新都可能导致方案失效

iLink 是首个官方的、合法的微信个人账号 Bot API。它意味着开发者终于可以在不违反规则的前提下,合法地构建微信 Bot 应用。

iLink 提供的是一个原始通道——它解决了"能不能连上"的问题,但没有解决"连上之后怎么管"的问题:

  • 没有多渠道分发能力
  • 没有消息过滤和路由机制
  • 没有消息日志和追踪
  • 没有 AI 自动回复集成
  • 没有 Webhook 回调支持
  • 没有统一的多语言 SDK

OpeniLink Hub 的定位就是将 iLink 的原始能力包装成一个完整的消息管理平台,提供 Bot 管理、Channel 配置、消息路由、AI 回复、Webhook、多语言 SDK 等上层能力。

参考资料

以下是本页引用的信息来源:

微信 ClawBot 插件

OpenClaw

下一步

On this page