corespeed-io/wechatbot

微信 iLink Bot SDK for OpenClaw/AI Agent

What it solves

WeChatBot 은 AI 에이전트와 봇을 WeChat iLink 프로토콜에 연결하기 위한 프로덕션 레디 SDK 를 제공합니다. LLM 기반 어시스턴트를 WeChat에 통합하는 과정을 단순화하고, 인증, 세션 관리, 메시지 폴링의 복잡성을 처리하여 개발자가 프로토콜을 처음부터 구현할 필요가 없습니다.

How it works

이 프로젝트는 Node.js, Python, Go, Rust 의 멀티랭귀지 지원을 제공하여 개발자가 선호하는 스택으로 봇을 구축할 수 있게 합니다. 클라이언트 역할을 하며 프로토콜 API와의 연결을 관리하고, QR 코드 로그인, 자격 증명 영구 저장(재시작 후 재스캔 불필요), 수신 메시지에 대한 롱 폴링을 처리합니다. 또한 세션 영구성을 위한 컨텍스트 토큰 시스템과 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.