扫码即连：我把 OMP 和微信 ClawBot 撮合在一起了
🦞 扫码即连：我把 OMP 和微信 ClawBot 撮合在一起了
一个 Python 项目，跑起来扫个二维码，你的 OMP 就能在微信里跟你对话。
为什么要做这个项目
2026 年 3 月，微信官方开放了ClawBot 插件（底层协议 iLink，接入域名为ilinkai.weixin.qq.com），第一次让个人微信号合规地接入外部 AI 智能体成为可能。与此同时，OMP（OpenClaw Meta Platform / 你的智能体运行平台）作为 AI 智能体的载体，欠缺一个轻量、官方的消息通道。
两边都是好东西，但原生的对接流程对很多开发者来说还是有点折腾：
- 要自己处理 iLink 的扫码登录、长轮询、消息收发
- 要把 OMP 的智能体能力"搬"到微信这条通道上
- 配置零散，新手容易在第一步就劝退
于是我写了omp-wechat-clawbot：一个基于 Python iLink 接口的项目，克隆下来、跑一句、扫个码，OMP 和微信 ClawBot 就联通了。
📦 仓库地址：https://gitee.com/futurelei/omp-wechat-clawbot
项目做了什么
omp-wechat-clawbot的核心定位非常单纯——它是 OMP 与微信 ClawBot 之间的桥梁。
┌─────────────┐ iLink ┌──────────────────┐ HTTP/内部协议 ┌─────────────┐ │ 微信客户端 │ ◄──────────────► │ omp-wechat-clawbot│ ◄──────────────────► │ OMP │ │ (ClawBot) │ ilinkai.weixin │ (本项目 bridge) │ │ (你的智能体) │ └─────────────┘ └──────────────────┘ └─────────────┘- 微信侧：通过 iLink 官方接口，扫码登录、长轮询收消息、调用发送接口，全程走
ilinkai.weixin.qq.com - OMP 侧：把微信收到的消息转发给 OMP 的智能体，拿到回复后再通过 iLink 推回微信
- 你：像给朋友发消息一样，在微信里直接和你的 OMP 智能体对话
核心特性
- 🔑扫码即连：首次运行生成二维码，微信扫一扫确认即可，无需复杂配置
- 🐍纯 Python 实现：基于 iLink Bot API，核心依赖
requests/aiohttp等常用库 - 🔄长轮询收消息：基于 iLink 的
/ilink/bot/getupdates接口，实时接收微信私聊消息 - 📨Markdown 文本回复：支持文本消息收发，满足日常对话需求
- 🧩松耦合桥接：OMP 与微信通道解耦，方便替换任一侧的实现
- 📦开箱即用：简单运行扫描二维码即可链接 OMP 和微信的 ClawBot
快速开始
# 1. 克隆仓库gitclone https://gitee.com/futurelei/omp-wechat-clawbot.gitcdomp-wechat-clawbot# 2. 安装依赖pipinstall-rrequirements.txt# 3. 运行python main.py# 或项目指定的入口文件终端会打印出一张 ASCII 二维码，拿出手机微信扫一扫并确认，桥接服务就起来了。之后你在微信的 ClawBot 会话里发的每句话，都会被转发到 OMP，OMP 的回复也会实时推回微信。
💡 具体入口文件、配置项、环境变量请以仓库最新 README 为准。
适用场景
- 把本地/云端运行的 OMP 智能体，"搬"到微信里随时调用
- 不想暴露 OMP 的 Web 端口，通过微信私聊作为唯一交互入口
- 做智能体分发：让你的用户/朋友通过微信就能用上你的 OMP 智能体
- 二次开发的基础骨架：基于本项目的桥接逻辑，扩展群聊、插件、定时任务等
一些技术细节（给想深入的同学）
微信 ClawBot 的 iLink 接口本质上是一组 HTTPS 端点，基地址https://ilinkai.weixin.qq.com，关键的有：
| 接口 | 用途 |
|---|---|
/ilink/bot/get_bot_qrcode | 获取登录二维码 |
/ilink/bot/get_qrcode_status | 轮询扫码状态 |
/ilink/bot/getupdates | 长轮询收消息 |
/ilink/bot/sendmessage | 发送消息 |
/ilink/bot/sendtyping | 发送"正在输入"状态 |
本项目就是对这些接口的封装 + 与 OMP 的对接逻辑。当前 iLink bot 账号仅支持 1v1 私聊，不支持群聊，这是微信侧的限制，不是 bug。
写在最后
这个项目诞生的初衷很简单：让 OMP 的用户能少装一个 App，直接在微信里就把事儿办了。它不复杂，但希望它能成为你探索"微信 + 智能体"组合的一个轻量起点。
📌目前项目已在 Gitee 开源：https://gitee.com/futurelei/omp-wechat-clawbot
欢迎 Star ⭐、Fork 🍴、提 Issue 和 PR。如果你基于它做了好玩的扩展，也欢迎回来告诉我，我会把优秀用例汇总到 README 里。
⚠️ 微信 ClawBot 目前仍处于逐步放量阶段，部分账号可能需要在微信「设置 → 插件」中等待灰度开放。使用前请确保微信已更新到支持 ClawBot 的版本。