免责声明：本项目基于公开的 iLink 协议进行独立开发，仅供学习交流与技术研究使用。项目与 iLink 协议的官方团队无任何关联或授权关系。若相关权利方认为本项目存在侵权，请通过 Issue 联系我们，我们将在确认后第一时间予以下架处理。

Disclaimer: This project is independently developed based on the publicly available iLink protocol for learning and research purposes only. It is not affiliated with or endorsed by the official iLink team. If any rights holder believes this project infringes upon their rights, please contact us via an Issue and we will take it down promptly upon confirmation.

微信 ClawBot iLink 协议的开源消息管理平台 + App 应用市场
Open-source message management platform + App Marketplace for WeChat ClawBot (iLink protocol)

扫码绑定微信号，通过应用市场一键扩展能力 —— 飞书 / Slack / Discord / GitHub / Notion 等 20+ App，装上就用
多 Bot 管理 · 20+ App · 平台互通 · 效率工具 · 生活助手 · AI Tools · 7 种语言 SDK · Passkey 登录

官网 & 文档 · 在线体验 · 快速开始 · 应用市场 · SDK · English

快速开始

# 一键安装（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              # Docker Hub
# 或者 / or:
docker run -d -p 9800:9800 ghcr.io/openilink/openilink-hub:latest     # GHCR

打开 http://localhost:9800，注册账号（第一个注册的自动当管理员），扫码绑定微信号，完事。

默认用 SQLite，不用装数据库，不用配任何东西。想用 PostgreSQL？设个 DATABASE_URL 就行。

Windows 用户：原生 Windows 不支持，请用以下任一方式：

• Docker（推荐）：docker run -d -p 9800:9800 openilink/openilink-hub:latest
• WSL2：在 WSL 的 Ubuntu/Debian 里按上面的 Linux 方式跑

这是什么？

2026 年 3 月微信推出了 ClawBot 插件，底层叫 iLink（智联） 协议 —— 第一次官方允许你用程序收发微信消息。

但 iLink 只是个原始通道：能收消息、能发回复，没了。你还得自己处理 context_token、CDN 加密、24 小时过期、多 Bot 管理……

OpeniLink Hub 把这些全包了，并且通过 App 应用市场 让你一键扩展功能：

• 扫码绑定，Web 后台管理多个 Bot
• 应用市场一键装功能 —— 对接飞书 / Slack / GitHub / Notion，查天气、记账、AI 对话，不用写代码
• WebSocket / Webhook / AI 三个通道同时转发消息到你的服务
• 24 小时窗口到期前提醒，避免错过续期
• 消息链路追踪，出问题一眼看到卡在哪

flowchart TD
    subgraph WeChat
        A[微信 ClawBot 插件]
    end

    A -->|iLink 协议| B[OpeniLink SDK]
    subgraph OpeniLink["OpeniLink Hub"]
      C[消息调度]
    end
    B --> C

    C --> D[App: 平台互通<br/>飞书 / Slack / Discord / 钉钉 / 企业微信]
    C --> E[App: 效率工具<br/>GitHub / Google / Notion / Linear]
    C --> F[App: 生活工具<br/>天气 / 汇率 / 记账 / 地图 / RSS ...]
    C --> G[App: OpenClaw]
    C --> H[自定义 App]
    C --> I[WebSocket 实时推送]
    C --> J[Webhook 转发]
    C --> K[AI 自动回复]

    D --> L[第三方平台<br/>消息互通 + AI Tools]
    E --> M[项目管理 / 文档协作 / 代码仓库]
    F --> N[日常查询 / 自动化 / 个人助手]
    G --> O[AI Agent Gateway]
    H --> P[你的业务系统]
    I --> Q[实时客户端]
    J --> R[HTTP 回调服务]
    K --> S[LLM]

为什么用 Hub？

自己对接 iLink 会遇到这些问题

和其他开源项目比

GitHub 上有不少 iLink 相关的开源项目，但大多是底层 SDK 或 Agent 桥接工具。Hub 是目前唯一带管理后台 + 应用市场 + 多通道分发的完整平台。

核心特性

App 应用市场 · 不写代码也能扩展 Bot。20+ 官方 App 覆盖平台互通（飞书、Slack、Discord、钉钉、企业微信）、效率工具（GitHub、Google Workspace、Notion、Linear）、生活工具（天气、汇率、记账、地图、RSS）等场景。通过 PKCE OAuth 安全安装，支持第三方开发者上架。

多 Bot 管理 · 扫码绑定多个微信号，统一面板看状态，到期前提醒防掉线。

说明：微信 24 小时窗口目前不能由 Hub 在后台静默自动续期。Hub 现在支持的是“到期前提醒”，会在窗口快到期时提醒你回一条消息，收到回复后窗口会重新开始计时。

多通道消息下发

• App — 已安装的 App 自动接收匹配的消息，通过 WebSocket 或 Webhook 投递
• WebSocket — 毫秒级实时推送
• Webhook — HTTP 回调，对接任意服务
• AI 自动回复 — 接入 OpenAI 兼容 API，Bot 自动对话

消息追踪 · 每条消息从收到到投递的完整链路，哪一步耗时多少一目了然，出问题快速定位。

Passkey 登录 · 指纹、Face ID、硬件密钥直接登录，也支持 GitHub / LinuxDo OAuth。

管理后台 · 用户管理、角色权限、OAuth 配置、AI 全局设置、App 管理，一站式掌控。

App 应用市场

Hub 的核心扩展机制。每个 App 是一个独立服务，通过标准协议与 Hub 交互。

能装什么？

平台互通 — 微信与第三方平台双向消息互通 + AI Tools 自然语言操作

效率工具 — 在微信里用自然语言操作主流 SaaS 平台

生活工具 — 轻量实用，零配置或免费 API 即可运行

开发者 & 基础设施

App 类型

怎么装？

1. 在 Hub 后台进入「应用市场」
2. 看到想要的 App，点「安装」
3. 通过 PKCE OAuth 完成授权
4. App 开始接收消息，完事

怎么开发？

App 通过以下方式与 Hub 交互：

• 接收事件：WebSocket 连接或 Webhook 回调
• 定义命令：声明 tools 和 commands，用户通过 /命令 或 @提及 触发
• 发送回复：调用 Hub API 发消息

参考 openilink-app-echo 快速上手。

Mock Server（本地开发调试）

不用跑真实 Hub + 微信 Bot，用 Mock Server 在本地开发和测试 App：

# 启动 Mock Server，将事件通过 Webhook 投递到你的 App
go run ./cmd/appmock --webhook-url http://localhost:8080/webhook

# 注入一条模拟消息，触发你的 App
curl -X POST http://localhost:9801/mock/event \
  -d '{"sender":"alice","content":"@test-app hello"}'

# 查看你的 App 发了什么消息
curl http://localhost:9801/mock/messages

Mock Server 复用真实的 Bot API handler，行为与生产环境完全一致。完整文档见 docs/mock-server.md。

架构总览

flowchart TB
    subgraph Client["客户端"]
        direction TB
        WX[微信号<br/>扫码绑定] --> Provider[Provider<br/>iLink]
        UI[Web UI<br/>React] --> API[REST API<br/>Go]
    end

    Provider --> Broker[Message Broker]
    API --> Broker

    Broker --> AppDispatch[App 调度]
    Broker --> WS[WebSocket<br/>实时客户端]
    Broker --> WH[Webhook<br/>回调]
    Broker --> AI[AI Sink<br/>自动回复]

    AppDispatch --> BuiltinApps[内置 App<br/>Bridge / OpenClaw]
    AppDispatch --> MarketApps[市场 App<br/>Echo / Command Service]
    AppDispatch --> CustomApps[自定义 App]

    subgraph Storage["存储"]
        DB[(SQLite / PostgreSQL<br/>数据)]
        MinIO[(MinIO<br/>媒体存储)]
        PK[Passkey<br/>WebAuthn]
    end

部署指南

数据存储

默认 SQLite，零配置。数据文件位置：

• Linux: ~/.local/share/openilink-hub/openilink.db
• macOS: `~/Library