@CycleDecoded: Unbelievable! I just stumbled upon a god-tier project on GitHub that completely obliterates all the automation pain points in the WeChat ecosystem. This is the recently open-sourced openilink-hub. Simply put, it's an open-source WeChat Bot management platform + App marketplace. Not only does it support self-hosting (Self-h…
Summary
OpeniLink Hub is an open-source WeChat Bot management platform and App marketplace based on the iLink protocol. It supports self-hosting, one-click Docker deployment, integration with 20+ tools and AI models, and multi-language SDKs, designed to simplify automation development and AI Agent construction within the WeChat ecosystem.
View Cached Full Text
Cached at: 07/11/26, 07:22 AM
Unbelievable — just stumbled upon a god-tier project on GitHub that absolutely demolishes all the automation pain points in the WeChat ecosystem. This is openilink-hub, released not long ago. In a nutshell, it’s an open-source WeChat Bot management platform + App Marketplace. It’s self-hostable and comes with a built-in app store that covers 20+ mainstream tools (Lark, Slack, Discord, DingTalk, GitHub, Notion, and more) plus AI models — all in one go. Written in Go, supports one-click Docker deployment, and is fully security and privacy focused.
Core highlights at a glance:
- Freeloaders rejoice: Completely open-source and free, supports local or private cloud deployment — you own all your data.
- Built-in App Marketplace: 20+ common office and AI tools are ready to use out of the box — no need to write complex API integrations yourself.
- Universal Connector: Sync WeChat messages to Discord, Slack, or Lark with one click — group management and notification automation are a breeze.
- 7 Language SDKs: Developers, take note — whether you use Python, Node, or Java, you can easily integrate and do secondary development.
- Perfect AI Agent Carrier: Hook it up with Coze, LangChain, or a local model — you’ll have a WeChat digital employee in minutes.
This is pretty savage. In the past, setting up this kind of WeChat automation would require stepping on countless pitfalls. Now, one project does it all. If you know, you know — anyone doing community automation or AI deployment should jump in without hesitation.
GitHub link: https://github.com/openilink/openilink-hub…
openilink/openilink-hub
Source: https://github.com/openilink/openilink-hub
免责声明:本项目基于公开的 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)
Scan to bind your WeChat account, extend capabilities with one click via the app marketplace — Lark / Slack / Discord / GitHub / Notion and 20+ apps. Install and use.
Multi-bot management · 20+ Apps · Platform interoperability · Productivity tools · Life assistants · AI Tools · 7 language SDKs · Passkey login
License Go (https://go.dev) React (https://react.dev) Docker (https://hub.docker.com/r/openilink/openilink-hub) GitHub Stars (https://github.com/openilink/openilink-hub/stargazers) Release (https://github.com/openilink/openilink-hub/releases)
Official site & docs (https://openilink.com) · Online demo (https://hub.openilink.com) · Quick Start · App Marketplace · SDK · English
快速开始 (Quick Start)
# One-click install (Linux / macOS)
curl -fsSL https://raw.githubusercontent.com/openilink/openilink-hub/main/install.sh | sh
# Start
oih
# Or use Docker (choose one)
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
Open http://localhost:9800, register an account (the first to register becomes admin automatically), scan the QR code to bind your WeChat account, and you’re done.
Default uses SQLite — no database needed, no configuration required. Want PostgreSQL? Just set
DATABASE_URL.Windows users: Native Windows is not supported. Please use one of the following:
- Docker (recommended):
docker run -d -p 9800:9800 openilink/openilink-hub:latest- WSL2: Run the Linux method above inside WSL’s Ubuntu/Debian
What Is This?
In March 2026, WeChat launched the ClawBot plugin, with the underlying protocol called iLink (Smart Link) — the first time the official platform allows programmatic sending and receiving of WeChat messages.
But iLink is just a raw channel: you can receive messages, send replies, and that’s it. You still have to handle context_token, CDN encryption, 24-hour expiry, multi-bot management…
OpeniLink Hub handles all of that, and via the App Marketplace lets you extend functionality with one click:
- Scan QR code to bind, manage multiple bots from a web dashboard
- Install features from the marketplace — integrate Lark / Slack / GitHub / Notion, check weather, track expenses, AI chat — no coding required
- Forward messages simultaneously via WebSocket / Webhook / AI channels to your service
- Get notified before the 24-hour window expires to avoid missing renewal
- Message trace — see exactly where a problem occurs
flowchart TD
subgraph WeChat
A[微信 ClawBot 插件]
end
A -->|iLink 协议| B[OpeniLink SDK]
subgraph OpeniLink["OpeniLink Hub"]
C[消息调度]
end
B --> C
C --> D[App: 平台互通飞书 / Slack / Discord / 钉钉 / 企业微信]
C --> E[App: 效率工具GitHub / Google / Notion / Linear]
C --> F[App: 生活工具天气 / 汇率 / 记账 / 地图 / RSS ...]
C --> G[App: OpenClaw]
C --> H[自定义 App]
C --> I[WebSocket 实时推送]
C --> J[Webhook 转发]
C --> K[AI 自动回复]
D --> L[第三方平台消息互通 + AI Tools]
E --> M[项目管理 / 文档协作 / 代码仓库]
F --> N[日常查询 / 自动化 / 个人助手]
G --> O[AI Agent Gateway]
H --> P[你的业务系统]
I --> Q[实时客户端]
J --> R[HTTP 回调服务]
K --> S[LLM]
Relationship with OpenClaw?
OpenClaw is an AI Agent framework; OpeniLink Hub is a message management platform — two different things.
In Hub, OpenClaw is a built-in App — just enable it from the marketplace. Of course you can completely ignore OpenClaw and choose other apps, or directly use WebSocket/Webhook to connect your own services.
Simply put: OpenClaw handles AI logic, Hub handles message sending/receiving and app distribution — each does its own thing, and you can connect them as you wish.
Why Use Hub?
Problems When Integrating iLink Yourself
| Problem you face | How Hub solves it |
|---|---|
| iLink has no official docs, only community reverse engineering | Complete Chinese docs + 7 language SDKs |
| context_token management is complex, messages often fail to send | SDK handles automatically — just receive and reply |
| 24-hour expiry disconnects, important messages lost | Pre-expiry notification + message persistence |
| Sending images requires CDN upload + AES encryption | One line of code to send images, videos, files |
| Command-line only, can’t manage multiple bots | Web console — QR binding, status monitoring, message trace |
| Adding features requires coding | Marketplace one-click install — extend without code |
Comparison with Other Open-Source Projects
There are several iLink-related open-source projects on GitHub, but most are low-level SDKs or Agent bridging tools. Hub is the only complete platform that includes a management dashboard + app marketplace + multi-channel distribution.
| OpeniLink Hub | Other solutions | |
|---|---|---|
| Positioning | Complete message management platform | SDK / Agent bridge |
| App Marketplace | Yes — one-click install, community apps supported | No |
| Web Dashboard | Full console + message trace | No / config panel only |
| Message Distribution | App + WebSocket + Webhook + AI in parallel | Single channel |
| SDK | 7 languages | 1–4 languages |
| Deployment | One command, built-in SQLite zero config | External database required |
| OpenClaw dependency | Completely independent (optional adapter) | Some are strongly dependent |
Core Features
App Marketplace · Extend your bot without writing code. 20+ official apps covering platform interoperability (Lark, Slack, Discord, DingTalk, WeCom), productivity (GitHub, Google Workspace, Notion, Linear), life tools (weather, currency, expense, maps, RSS), and more. Installed with PKCE OAuth for security. Supports third-party developers to publish apps.
Multi-Bot Management · Scan QR codes to bind multiple WeChat accounts, unified dashboard for status, pre-expiry notifications to prevent disconnection.
Note: The WeChat 24-hour window currently cannot be silently auto-renewed by Hub in the background. Hub supports “pre-expiry notification” — it reminds you before the window expires, and after you reply, the window restarts.
Multi-Channel Message Delivery
- App — installed apps automatically receive matched messages via WebSocket or Webhook delivery
- WebSocket — real-time push with millisecond latency
- Webhook — HTTP callback, connect to any service
- AI auto-reply — integrate OpenAI-compatible API for automatic bot conversation
Message Tracing · Complete chain from receipt to delivery — see at a glance how long each step took, quickly locate issues.
Passkey Login · Fingerprint, Face ID, hardware key — also supports GitHub / LinuxDo OAuth.
Management Dashboard · User management, role permissions, OAuth configuration, global AI settings, App management — all in one place.
App Marketplace
The core extension mechanism of Hub. Each App is an independent service that interacts with Hub via a standard protocol.
What Can You Install?
Platform Interoperability — Bidirectional message sync between WeChat and third-party platforms + AI Tools for natural language operations
| App | What it does |
|---|---|
| Lark (Feishu) 🔥 | Message sync + 34 AI Tools covering 11 business domains: calendar, cloud docs, tasks, contacts, multidimensional tables, email, knowledge base, video meetings, etc. |
| Slack | Message sync + 23 AI Tools: manage channels, messages, users, files, reminders, bookmarks |
| Discord | Message sync + 19 AI Tools: manage channels, members, embeds, servers |
| DingTalk | Message sync + 20 AI Tools: contacts, calendar, to-dos, approvals, attendance, DingDrive |
| WeCom (WeChat Work) | Message sync + 18 AI Tools: contacts, calendar, approvals, check-in, microdrive, customer contact |
Productivity Tools — Operate mainstream SaaS platforms from WeChat via natural language
| App | What it does |
|---|---|
| GitHub | 36 AI Tools: manage Issues, PRs, Repos, Actions, Releases, Gists |
| Google Workspace | 18 AI Tools: operate Gmail, Calendar, Drive, Docs, Sheets |
| Notion | 15 AI Tools: manage pages, databases, comments, search |
| Linear | 13 AI Tools: manage issues, projects, teams, cycles |
Life Tools — Lightweight and practical, zero-config or free API to run
| App | What it does |
|---|---|
| Amap (Gaode Maps) | 10 AI Tools: POI search, route planning, weather, geocoding |
| Weather | Global city weather + air quality query |
| Currency | Real-time exchange rate conversion for 30+ currencies |
| Expense | WeChat expense tracking + monthly reports + category stats |
| Reminder | One-time / recurring / Cron scheduled reminders |
| Cron | Cron scheduling + automatic message push |
| RSS | RSS subscription — new articles automatically pushed to WeChat |
| QRCode | QR code generation and decoding — local processing only |
Developer & Infrastructure
| App | What it does |
|---|---|
| Command Service | /s 600519 look up stock price, /gi cyberpunk city generate image, /a write an email for me AI chat — 20+ commands |
| OpenClaw | Let OpenClaw AI Agent interact directly via WeChat |
| Runner | Expose local CLI commands as App Tools callable from WeChat |
| Bridge | Auto-forward WeChat messages to your own server |
| Echo | Developer template — write your own App in 3 minutes |
App Types
| Type | Description | Example |
|---|---|---|
| Built-in App | Ships with Hub, no extra deployment | Bridge, OpenClaw |
| Market App | Installed from a remote Registry | Lark, GitHub, Weather, etc. 20+ |
| Custom App | Developed by you | Your own business system |
How to Install?
- Go to the “App Marketplace” in the Hub dashboard
- Find the App you want, click “Install”
- Complete authorization via PKCE OAuth
- The App starts receiving messages — done
How to Develop?
Apps interact with Hub via:
- Receiving events: WebSocket connection or Webhook callback
- Defining commands: Declare tools and commands — triggered via
/commandor@mention - Sending replies: Call Hub API to send messages
Refer to openilink-app-echo for a quick start.
Mock Server (Local Development & Debugging)
No need to run a real Hub + WeChat Bot — use the Mock Server for local development and testing:
# Start Mock Server, deliver events via Webhook to your App
go run ./cmd/appmock --webhook-url http://localhost:8080/webhook
# Inject a simulated message to trigger your App
curl -X POST http://localhost:9801/mock/event \
-d '{"sender":"alice","content":"@test-app hello"}'
# See what messages your App sent
curl http://localhost:9801/mock/messages
The Mock Server reuses the real Bot API handler — behavior is identical to production. See full docs at docs/mock-server.md.
Architecture Overview
flowchart TB
subgraph Client["客户端"]
direction TB
WX[微信号扫码绑定] --> Provider[ProvideriLink]
UI[Web UIReact] --> API[REST APIGo]
end
Provider --> Broker[Message Broker]
API --> Broker
Broker --> AppDispatch[App 调度]
Broker --> WS[WebSocket实时客户端]
Broker --> WH[Webhook回调]
Broker --> AI[AI Sink自动回复]
AppDispatch --> BuiltinApps[内置 AppBridge / OpenClaw]
AppDispatch --> MarketApps[市场 AppEcho / Command Service]
AppDispatch --> CustomApps[自定义 App]
subgraph Storage["存储"]
DB[(SQLite / PostgreSQL数据)]
MinIO[(MinIO媒体存储)]
PK[PasskeyWebAuthn]
end
Deployment Guide
Data Storage
Default SQLite, zero config. Data file locations:
- Linux:
~/.local/share/openilink-hub/openilink.db - macOS:
~/Library/Application Support/openilink-hub/openilink.db - root/service:
/var/lib/openilink-hub/openilink.db
Set DATABASE_URL=postgres://... to switch to PostgreSQL.
Register as System Service
oih install # Install systemd (Linux) / launchd (macOS) service
oih uninstall # Uninstall service
Docker Compose (Production)
Suitable for scenarios requiring PostgreSQL + MinIO:
services:
postgres:
image: postgres:17-alpine
environment:
POSTGRES_USER: openilink
POSTGRES_PASSWORD: <change to strong password>
POSTGRES_DB: openilink
volumes:
- pgdata:/var/lib/postgresql/data
hub:
image: openilink/openilink-hub:latest # or ghcr.io/openilink/openilink-hub:latest
ports:
- "9800:9800"
environment:
DATABASE_URL: postgres://openilink:<password>@postgres:5432/openilink?sslmode=disable
RP_ORIGIN: https://hub.example.com
RP_ID: hub.example.com
SECRET: <random string>
depends_on:
- postgres
volumes:
pgdata:
Just put an Nginx / Caddy in front as an HTTPS reverse proxy.
Build from Source
cd web && pnpm install && pnpm run build && cd ..
go build -o oih .
./oih
CLI Commands
| Command | Description |
|---|---|
oih | Run in foreground |
oih install | Install as system service |
oih uninstall | Uninstall system service |
oih version | Show version |
SDK Ecosystem
7 languages — pick the one you’re comfortable with:
| Language | Installation |
|---|---|
| Go | go get github.com/openilink/openilink-sdk-go |
| Node.js | npm install @openilink/openilink-sdk-node |
| Python | pip install openilink-sdk-python |
| PHP | composer require openilink/openilink-sdk-php |
| Java | openilink-sdk-java (build from source) |
| C# | openilink-sdk-csharp (in development) |
| Lua | openilink-sdk-lua (include from source) |
Related Projects
Apps (full list in App Marketplace)
| Project | Description |
|---|---|
| openilink-app-lark | Lark · 34 AI Tools 🔥 |
| openilink-app-slack | Slack · 23 AI Tools |
| openilink-app-discord | Discord · 19 AI Tools |
| openilink-app-dingtalk | DingTalk · 20 AI Tools |
| openilink-app-wecom | WeCom · 18 AI Tools |
| openilink-app-github | GitHub · 36 AI Tools |
| openilink-app-google | Google Workspace · 18 AI Tools |
| openilink-app-notion | Notion · 15 AI Tools |
| openilink-app-linear | Linear · 13 AI Tools |
| openilink-app-echo | App development template |
More apps: amap · weather · currency · expense · reminder · cron · rss · qrcode · command-service · runner
Other
| Project | Description |
|---|---|
| openclaw-channels | OpenClaw channel plugins |
| openilink-tg | Forward WeChat messages to other platforms |
| openilink-webhook-plugins | Official webhook plugin repository |
Environment Variables
| Variable | Default | Description |
|---|---|---|
LISTEN | :9800 | Listen address |
DATABASE_URL | SQLite | If not set, uses SQLite; set postgres://... to switch to PostgreSQL |
RP_ORIGIN | http://localhost:9800 | Site address — must match the browser-accessed URL |
RP_ID | localhost | WebAuthn RP ID — fill in your domain |
SECRET | change-me-in-production | Server secret — must change in production |
REGISTRY_URL | — | Remote App Registry URL |
REGISTRY_ENABLED | true | Enable remote Registry |
GITHUB_CLIENT_ID | — | GitHub OAuth |
GITHUB_CLIENT_SECRET | — | GitHub OAuth |
LINUXDO_CLIENT_ID | — | LinuxDo OAuth |
LINUXDO_CLIENT_SECRET | — | LinuxDo OAuth |
STORAGE_ENDPOINT | — | MinIO / S3 endpoint |
STORAGE_ACCESS_KEY | — | Storage access key |
STORAGE_SECRET_KEY | — | Storage secret key |
STORAGE_BUCKET | — | Storage bucket |
STORAGE_PUBLIC_URL | — | Storage public URL |
Configuring OAuth Login
GitHub OAuth
- Go to GitHub Developer Settings (https://github.com/settings/developers) → OAuth Apps → New OAuth App
- Homepage URL:
https://hub.example.com - Callback URL:
https://hub.example.com/api/auth/oauth/github/callback - Get Client ID and Secret, fill in environment variables
LinuxDo OAuth
- Create an app at connect.linux.do (https://connect.linux.do)
- Callback URL:
https://hub.example.com/api/auth/oauth/linuxdo/callback - Fill in environment variables
Callback URL format:
{RP_ORIGIN}/api/auth/oauth/{provider}/callback
Tech Stack
| Layer | Technology |
|---|---|
| Backend | Go 1.25, SQLite / PostgreSQL 17, gorilla/websocket |
| Frontend | React 19, Vite, TypeScript, Tailwind CSS |
| Auth | WebAuthn (Passkey), OAuth 2.0 (PKCE), password |
| App System | PKCE OAuth installation, WebSocket/Webhook event delivery |
| Storage | MinIO / S3 (optional) |
| Deployment | Single binary / Docker (Docker Hub / GHCR) / Docker Compose |
Contributing
Issues and PRs are welcome!
- For App development, refer to openilink-app-echo
- Submit plugins to openilink-webhook-plugins
- For SDK issues, go to the corresponding language repository
License
MIT — free to use, including commercial use.
OpeniLink (https://openilink.com) · Making WeChat Bot integration simpler
English
OpeniLink Hub is a self-hosted, open-source WeChat Bot management and message relay platform built on top of the iLink protocol — WeChat’s first official Bot API, launched in March 2026. It wraps WeChat’s raw messaging into a complete system: bind multiple accounts via QR code, install apps from the marketplace to add features like stock queries and image generation, forward messages through WebSocket / Webhook / AI auto-reply — all managed from a web dashboard.
Key Highlights
- App Marketplace (20+) — Platform integration (Lark, Slack, Discord, DingTalk, WeCom), productivity (GitHub, Google Workspace, Notion, Linear), utilities (weather, expense, RSS, maps…), all with AI Tools
- Multi-bot management — Bind and manage multiple WeChat accounts, auto session renewal
- Message tracing — Full delivery timeline for every message, pinpoint issues instantly
- Multi-channel delivery — Apps, WebSocket, Webhook, and AI auto-reply in parallel
- Passkey (WebAuthn) — Passwordless login with biometric / hardware key support
- Built-in SQLite — Zero-config database with optional PostgreSQL
- 7 language SDKs — Go, Node.js, Python, PHP, Java, C#, Lua
Quick Start
# One-line install
curl -fsSL https://raw.githubusercontent.com/openilink/openilink-hub/main/install.sh | sh
# Start
oih
# Or use Docker (either registry works)
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
Visit http://localhost:9800 — first user becomes admin. Zero config needed.
Website: openilink.com · Live Demo: hub.openilink.com
Similar Articles
@iluciddreaming: AI Agent can now read your WeChat. Two tools, 10 minutes to install: 1. Agent Reach: search official accounts and bypass anti-scraping to read full articles 2. wx-cli: read all WeChat messages locally, no internet required, no account ban. What can you do after installation? Auto-summarize group messages, collect official account materials, AI helps you keep producing content…
Introducing two tools (Agent Reach and wx-cli) that allow AI Agent to read WeChat messages and official account content, enabling automatic group message summarization, material collection, and more. Installation takes only 10 minutes.
@jakevin7: OpenCLI can now read WeChat, Telegram, and Discord content!!! wx-cli, tg-cli, and discord-cli are all integrated. Group messages, chat logs, Moments, and favorites can all be directly accessed via CLI. Previously, Agen…
OpenCLI has been updated to support reading content from WeChat, Telegram, and Discord via wx-cli, tg-cli, and discord-cli. This tool allows AI agents and developers to automate browser operations through a command-line interface and aggregate personal message feeds.
@ezshine: Sharing an open-source project that lets you run multiple official WeChat Linux clients on your own server using container technology, achieving multi-instance WeChat. In simple terms, it's like having several computers, each running an official WeChat client, and providing a remote desktop for you to log in and operate. This method of logging into WeChat is completely compliant.
Sharing an open-source project called WechatOnCloud, which uses container technology to run multiple independent official WeChat Linux clients on your own server and manage them via a browser-based remote desktop, enabling compliant multi-instance WeChat and multi-end sharing.
@jinchenma_ai: Whoa! Just discovered a tool that can read WeChat chat records – a must-have for private traffic operations! wx-cli enables AI to freely read WeChat messages. 1. Browse messages at will: No need to use WeChat’s clunky search bar; simply enter keywords to search through your entire chat history with lightning-fast speed. 2. Moments excavator: You can directly view friends’...
wx-cli is a local tool for extracting and analyzing WeChat chat history and moments, enabling AI integration without transmitting data to the cloud.
@laowangbabababa: Damn, I figured out how to redirect external links to add friends on WeChat. Used Codex throughout, from link to WeChat app scan code to add friend. Leads from various websites no longer get lost. I saw other sites offering this as a product for at least $99/month, but I only have certification and server costs. Check out this video...
The author implemented a feature using OpenAI Codex that redirects external links to add friends on WeChat, reducing lead acquisition costs. Compared to similar products costing $99/month, the author only pays for certification and server costs.