corespeed-io/wechatbot

微信 iLink Bot SDK for OpenClaw/AI Agent

What it solves

WeChatBot 提供一套可投入生产的 SDK，让 AI 代理和机器人能够连接 WeChat iLink 协议。它简化了将 LLM 驱动的助理集成到 WeChat 的过程，处理认证、会话管理和消息轮询等复杂工作，开发者无需从头实现协议。

How it works

项目提供多语言支持（Node.js、Python、Go 与 Rust），让开发者可以使用自己熟悉的技术栈来构建机器人。它充当客户端，管理与协议 API 的连接，处理二维码登录、凭证持久化（用户在重启后不必再次扫描），以及长轮询接收消息。还包括会话持久化的 context token 系统和 AES-128-ECB 加密，以确保通信安全。

Who it’s for

适用于构建需要在 WeChat 生态系统内运行的 AI 代理或自动化助理的开发者，尤其是面向需要多租户支持（在同一进程中运行多个账号）的生产环境。

Highlights

  • Multi-language SDKs: Native support for Node.js, Python, Go, and Rust.
  • Multi-tenant Architecture: Isolated bot instances allowing a single backend process to manage multiple WeChat accounts.
  • Session Persistence: Automatic credential storage and session recovery to avoid frequent re‑logins.
  • Rich Media Support: Ability to send and receive images, files, audio, and video.
  • Developer Tooling: Includes a middleware pipeline (Node.js), a message builder API, and a pre‑compiled Echo Bot for quick testing.