This project provides a WeChat bot that integrates with various AI services like DeepSeek, ChatGPT, Kimi, and iFlytek for automated message replies and group management. It targets users looking for a customizable and easy-to-set-up solution for enhancing their WeChat experience with AI capabilities.

How It Works

The bot leverages the Wechaty framework to interact with WeChat. It supports multiple AI service integrations, allowing users to choose their preferred LLM provider by configuring API keys in a .env file. The core logic for message handling and AI interaction is designed to be extensible, enabling contributions for new AI services or features.

Quick Start & Requirements

• Install dependencies: npm install or yarn install.
• Run the bot: npm run dev or yarn dev.
• Prerequisites: Node.js >= v18.0 (LTS recommended).
• Configuration: Requires setting up API keys for chosen AI services in a .env file, which is a copy of .env.example.
• Proxy: A proxy is often required for AI service requests.
• Docker: Supported via docker build . -t wechat-bot and docker run -d --rm --name wechat-bot -v $(pwd)/.env:/app/.env wechat-bot.
• Official Docs: https://github.com/wangrongding/wechat-bot

Highlighted Details

• Supports 9+ AI services including DeepSeek, ChatGPT, Kimi, Tongyi Qianwen, iFlytek, Dify, and Ollama.
• Features configurable whitelists for contacts and groups to control automatic replies.
• Offers a BOT_NAME setting to manage mentions in group chats.
• Includes a test command (npm run test) to verify AI service connectivity.

Maintenance & Community

• Project has achieved significant traction, hitting #1 on GitHub Trending multiple times.
• Open to PRs for new AI service integrations and features.
• Community discussion is available via WeChat groups (contact provided).
• Sponsorship opportunities are mentioned.

Licensing & Compatibility

• License: MIT.
• Compatibility: Generally compatible with commercial use due to MIT license, but users must be aware of WeChat's terms of service regarding third-party clients.

Limitations & Caveats

WeChat's recent strictness on third-party clients poses a risk of account warnings or bans, especially with the default web protocol. The underlying Wechaty library's maintenance status is uncertain due to potential legal issues with Tencent. Users are advised to consider alternative protocols like pad (with caution) or enterprise solutions.