wx-bot

What is wx-bot

wx-bot is an open-source project that connects WeChat to personal AI Agents (such as Grok, Muse, Claude, etc.) and enables message exchange between WeChat and AI via the official iLink.

Key features

• WeChat messages enter the local wx-bot via official iLink, are first saved to a SQLite inbox, then pushed to the Agent
• Supports both webhook push and pull-based message delivery
• Supports sending and receiving text, images, voice (with transcription), files and video
• Does not expose any ports externally, only listens on loopback for safer local operation
• By default only handles WeChat accounts logged in via QR code scan; whitelist configuration is supported

Who it is for

For developers or users who want to connect WeChat to personal AI Agents (such as Grok, Muse, Claude, etc.). Suitable for local or server environments.

How to get started

1. Visit https://github.com/lawrencewzen/wx-bot and send the repository link to your Grok Bot or Muse to help with installation
2. Log in using WeChat QR code scan (Grok requires a Webhook URL and key)
3. Run the command: wx-bot login xiaox to perform WeChat QR code login
4. Edit ~/.config/wx-bot/config.json to configure webhook or pull mode, then run wx-bot run to start

Compiled from public descriptions on the tool's official website / README / launch page. Pricing and user numbers have not been verified; please check the official website. Some sections were drafted with AI assistance. Written in Chinese and English; other languages are machine-translated.