openilink-hub
基于微信 iLink 协议的开源 Bot 管理平台,一键扩展微信能力到飞书、GitHub、Notio
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
基于微信 iLink 协议的开源 Bot 管理平台,一键扩展微信能力到飞书、GitHub、Notio
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
2026 年 3 月,微信推出 ClawBot 插件,底层采用名为 iLink(智联) 的协议。这是微信历史上第一次官方允许第三方程序收发消息。对于开发者来说,这就像打开了一扇封印多年的门——终于可以告别逆向 Hook、模拟登录等灰色手段,用正规渠道接入微信生态。
但问题随之而来:iLink 只是一个原始通道,能收消息、能发回复,但 context_token 管理、CDN 加密传输、24 小时消息窗口过期、多 Bot 管理……这些全得开发者自己搞定。文档缺乏,不同语言 SDK 分散,真正想用起来,门槛不低。
OpeniLink Hub 就是在这一背景下诞生的。它把 iLink 的「毛坯房」装修成「精装公寓」——扫码绑定微信号、Web 后台统一管理、应用市场一键扩展功能、消息多通道分发。对于普通用户,它让微信 Bot 的使用变得像装 App 一样简单;对于开发者,它提供了 7 种语言的 SDK 和完整的 App 开发框架,大幅降低了接入成本。
通过微信扫描 Web 界面的二维码,即可将微信号绑定到 Hub。之后在 Web 控制台可以同时管理多个微信号,查看每个 Bot 的在线状态、消息收发统计。更重要的是,系统会在消息窗口即将 24 小时过期前主动提醒用户,确保 Bot 不「掉线」。
Hub 的核心扩展机制是应用市场(App Marketplace)。每个 App 是一个独立服务,通过 WebSocket 或 Webhook 与 Hub 交互,用户在后台一键安装授权即可使用,无需写任何代码。
平台互通是最大的亮点:微信可以与飞书、Slack、Discord、钉钉、企业微信双向消息互通。飞书 App 支持 34 个 AI Tools,覆盖日历、云文档、任务、多维表格等 11 个业务域;GitHub App 提供 36 个 AI Tools,直接在微信里用自然语言管理 Issue 和 PR;Notion App 支持 15 个 AI Tools,微信里查数据库、写笔记。
效率工具覆盖了主流 SaaS 平台:Google Workspace(18 Tools)、Linear(13 Tools)。生活工具包括天气查询、汇率换算、微信记账、RSS 订阅推送、二维码生成等,零配置或免费 API 即可运行。
App 的安装通过 PKCE OAuth 完成,安全可靠。开发者参考 Echo 模板,3 分钟即可上手开发自己的 App。
一条微信消息可以同时走四条通道:
这种并行分发机制意味着,同一条消息可以同时触发 AI 回复、写入 Notion、推送 Discord,微信真正成为了各种服务的中转枢纽。
每条消息从微信端收到,到经过 App 处理、WebSocket 推送,最终送达目标服务,都有完整的时间线和状态记录。出问题时,一眼就能看到卡在哪一步,大幅缩短排查时间。
支持 Passkey(WebAuthn) 登录,指纹、Face ID、硬件密钥直接认证,无需密码。同时支持 GitHub 和 LinuxDo 的 OAuth 2.0 PKCE 登录方式。数据存储默认使用 SQLite,零配置开箱即用;生产环境设置 DATABASE_URL 即可切换 PostgreSQL。
项目采用 Go 编写,internal/ 目录下模块职责清晰:
| 目录 | 职责 |
|---|---|
api/ | REST API 路由与 handlers |
auth/ | Passkey + OAuth 认证逻辑 |
bot/ | Bot 实例生命周期管理 |
app/ | App 注册、调度、命令路由 |
ai/ | AI Sink,OpenAI 兼容接口调用 |
provider/ | iLink 协议 Provider,与微信交互 |
relay/ | 消息中继与分发引擎 |
sink/ | 消息 Sink(WebSocket/Webhook/App) |
storage/ | MinIO/S3 媒体文件存储 |
store/ | 数据库 ORM(pgx/v5 + SQLite) |
builtin/ | 内置 App(Bridge、OpenClaw) |
web/ | 前端静态资源(构建产物) |
config/ | 配置加载与环境变量解析 |
daemon/ | 系统服务安装(systemd/launchd) |
push/ | 推送通知服务 |
registry/ | 远程 App Registry 客户端 |
关键依赖包括:gorilla/websocket(实时通信)、jackc/pgx/v5(PostgreSQL ORM)、modernc.org/sqlite(嵌入式数据库)、go-webauthn/webauthn(Passkey)、coreos/go-oidc/v3(OpenID Connect)、minio/minio-go(对象存储)、mark3labs/mcp-go(MCP 协议支持)、rs/xid(分布式 ID 生成)。
web/ 目录是完整的 React 应用:TypeScript 类型安全、Vite 快速构建、Tailwind CSS 样式系统。目录结构包括 pages/(页面组件)、components/(可复用组件)、hooks/(自定义 Hook)、stores/(状态管理)、lib/(工具函数)。
Dockerfile 分为三个阶段:
pnpm build,产出 React 静态文件docker-compose.yml 完整定义了 postgres(17-alpine)+ minio + hub 三个服务,hub 依赖 postgres 健康检查,生产环境零配置即可启动。
项目包含 .goreleaser.yml(跨平台构建配置)和 integration_test.go(集成测试套件),.github/ 目录提供 GitHub Actions 工作流。Go Module 依赖管理规范,版本锁定在 go.sum。但目前仓库中尚未发现独立的单元测试文件,主要测试覆盖来自集成测试。
总体评分:80/100(Go 项目平均水平,模块化好但测试覆盖偏少)。
必须正视的问题:
OpeniLink Hub 填补了一个重要空白:微信 Bot 领域长期缺乏一个完整、好用、社区活跃的开源管理平台。它的 App 市场模式将微信从一个聊天工具,转变为真正的超级入口——用户可以在微信里用自然语言管理 GitHub Issue、查询飞书文档、控制 RSS 订阅。
7 种语言的 SDK 也值得关注:不熟悉 Go 的开发者可以用 Python、Node.js、PHP 等自己熟悉的语言开发微信 Bot 应用,大大降低了参与门槛。结合 MCP(Model Context Protocol)支持,项目已经为 AI Agent 时代做好了准备——OpenClaw 内置 App 就是 AI Agent 通过微信对话的示例。
最简单的方式(Linux/macOS):
curl -fsSL https://raw.githubusercontent.com/openilink/openilink-hub/main/install.sh | sh
oih
Docker 一键启动:
docker run -d -p 9800:9800 openilink/openilink-hub:latest
打开 http://localhost:9800,第一个注册的账号自动成为管理员,扫码绑定微信号,从应用市场安装想要的 App,立即开始使用。