photon-hq

photon-hq / wechat-ilink-client

Public

Standalone TypeScript client for the WeChat iLink bot protocol, reverse-engineered from Tencent's openclaw-weixin.

photon.codes
17
2
69% credibility
Found Mar 25, 2026 at 17 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

A lightweight library for building custom WeChat chatbots that connect via QR scan, receive and reply to messages, and handle media sharing.

How It Works

1
🔍 Discover the WeChat bot tool

You find a simple kit online to build your own friendly chat companion for WeChat.

2
📦 Grab the ready example

You pick up the echo buddy example that repeats back what friends say.

3
📱 Scan the special code to connect

A picture code appears on screen, you scan it with your WeChat phone app, and it links right up.

4
💬 Watch for incoming chats

Your buddy starts listening quietly for new messages from friends.

5
↩️ Send fun replies

It automatically echoes texts, shares pictures or files just like a real conversation.

6
💾 Save its memory spot

You note down a few details so next time it picks up exactly where it left off.

🎉 Your buddy is chatting away!

Friends message you, and your smart companion replies instantly, keeping talks lively and fun.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 17 to 17 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is wechat-ilink-client?

This standalone TypeScript client lets you build WeChat bots using the iLink protocol, reverse-engineered from Tencent's tools without relying on their OpenClaw framework. It handles QR code login (you render the URL), long-polling for messages with optional cursor persistence, sending text/image/video/file messages via encrypted CDN uploads, and typing indicators—all with zero runtime dependencies and full TypeScript types. Drop it into a Node.js 20+ app for a pure, stateless bot library like a typescript standalone script or app.

Why is it gaining traction?

Unlike bloated WeChat bot frameworks, this offers a minimal EventEmitter API with no file I/O or external deps, making it dead simple to integrate into any typescript standalone component or function. Developers dig the stateless design—you control persistence—and built-in AES-ECB media handling, plus examples like an echo bot that resumes sessions. It's a lightweight bot client akin to whisper standalone github or selenium standalone github projects.

Who should use this?

Node.js backend devs scripting WeChat automations, like customer support bots echoing replies or sending files. Ideal for solo hackers building notification bots or media-sharing tools without framework lock-in. Skip if you need group chats or advanced UI—it's pure 1:1 messaging.

Verdict

Solid pick for quick WeChat bot prototypes with excellent docs and MIT license, but at 17 stars and 0.7% credibility score, it's early-stage—test thoroughly for production. Pair with qrcode-terminal for terminal QR scans and go.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.