ChatGPT on WeChat

WeChat bot powered by LLM-driven super AI assistant. CowAgent framework enabling ChatGPT, Claude, and other models integration with WeChat for intelligent conversations and automation.

WeChat LLM Bot - CowAgent Super AI Assistant

ChatGPT on WeChat is a popular WeChat bot framework powered by large language models. Using the CowAgent framework, it integrates ChatGPT, Claude, and other AI models with WeChat, enabling intelligent conversations, group chat management, and automation on China's most popular messaging platform. GitHub: https://github.com/zhayujie/chatgpt-on-wechat Developer: zhayujie (Community Open Source) License: MIT Platform: WeChat (Personal/Enterprise) Key Innovation: ChatGPT on WeChat brings the power of modern LLMs to WeChat's billion-user ecosystem, enabling intelligent AI conversations within the app everyone uses.

Core Philosophy: "Bring AI intelligence to your WeChat conversations"

Why ChatGPT on WeChat?

WeChat Integration: Native integration with China's super app.

Multiple LLMs: Support for ChatGPT, Claude, Gemini, and more.

Group Chat Ready: Full support for group conversations.

Proven Track Record: 18,500+ GitHub stars, widely deployed.

Key Features

$#1.
WeChat Integration

Personal WeChat support
Enterprise WeChat support
Group chat handling
Private chat support
Message type detection

$#2.
LLM Support

OpenAI (ChatGPT)
Anthropic (Claude)
Google (Gemini)
Chinese models (文心，通义，etc.)
Local models (Ollama)

$#3.
Message Handling

Text messages
Voice messages (STT/TTS)
Image messages (recognition)
File messages
Link sharing

$#4.
Session Management

Conversation context
Multi-user sessions
Session timeout
Memory persistence
Clear commands

$#5.
Administration

Rate limiting
User whitelist/blacklist
Command system
Logging and monitoring
Web dashboard (optional)

Installation

Docker (Recommended)

# Clone repository
git clone https://github.com/zhayujie/chatgpt-on-wechat.git
cd chatgpt-on-wechat

# Configure
cp config-template.json config.json
# Edit config.json with your settings

# Run with Docker
docker-compose up -d

Manual Installation

# Clone repository
git clone https://github.com/zhayujie/chatgpt-on-wechat.git
cd chatgpt-on-wechat

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows

# Install dependencies
pip install -r requirements.txt

# Configure
cp config-template.json config.json
# Edit config.json

# Run
python app.py

One-Click Install

# Linux
curl -fsSL https://github.com/zhayujie/chatgpt-on-wechat/raw/main/install.sh | bash

# Windows
# Download installer from releases

Configuration

config.json

{
  "channel_type": "wechatmp",
  "wechatmp_app_id": "YOUR_APP_ID",
  "wechatmp_app_secret": "YOUR_APP_SECRET",
  "wechatmp_token": "YOUR_TOKEN",
  
  "model": "gpt-4o-mini",
  "open_ai_api_key": "YOUR_API_KEY",
  
  "single_chat_prefix": ["bot", "@bot"],
  "single_chat_reply_prefix": "[bot] ",
  "group_chat_prefix": ["@bot"],
  "group_name_white_list": ["All"],
  
  "image_recognition": true,
  "voice_reply_voice": true,
  
  "rate_limit_chatgpt": 10
}

Environment Variables

export OPENAI_API_KEY=sk-...
export WECHAT_TOKEN=your-token

Usage

Personal Chat

Send: bot 你好
Reply: [bot] 你好！有什么我可以帮助你的吗？

Send: @bot 今天天气怎么样
Reply: [bot] 我无法获取实时天气信息，但你可以...

Group Chat

@bot 帮我总结一下今天的讨论
@bot 翻译这句话：Hello World
@bot 写一首关于春天的诗

Voice Messages

Send voice: "今天有什么新闻？"
Bot processes speech-to-text
Bot responds with text or voice

Commands

#help - Show help
#reset - Reset conversation
#token - Show token usage
#image - Generate image

Pricing

Free: ChatGPT on WeChat is completely free and open source under MIT license. You only pay for:

AI model API usage
WeChat enterprise account (if using)
Server hosting

System Requirements

Component	Minimum	Recommended
OS	Linux, macOS, Windows	Linux (Ubuntu 20.04+)
Runtime	Python 3.8+	Python 3.10+
Memory	512MB RAM	1GB+ RAM
Storage	200MB	500MB
Network	Required	Stable internet

Use Cases

WeChat AI Assistant

Add intelligent AI conversations to your WeChat experience.

Personal Chat Automation

Automate responses and tasks in personal WeChat chats.

Group Chat Management

Moderate and assist in WeChat group conversations.

Customer Service on WeChat

Provide automated customer support through WeChat.

LLM-Powered Conversations

Enable natural AI conversations within WeChat.

WeChat Bot Development

Build custom WeChat bots with LLM capabilities.

Community and Support

GitHub: https://github.com/zhayujie/chatgpt-on-wechat
Documentation: https://github.com/zhayujie/chatgpt-on-wechat#readme
Issues: GitHub Issues tab
Discussions: GitHub Discussions tab
WeChat Group: Available on documentation

Quick Start Guide

Get ChatGPT on WeChat up and running quickly.

Step 1: Install

cd chatgpt-on-wechat
npm install
npx chatgpt-on-wechat setup

Step 2: Configure

Set your AI model and API key in the configuration.

Step 3: Connect and Go

Link your messaging platform and start using your AI agent.

Full documentation: https://github.com/zhayujie/chatgpt-on-wechat#readme

FAQ

Is ChatGPT on WeChat free to use?

Yes, ChatGPT on WeChat is free and open source (MIT license). You only pay for AI model API costs if using external models.

What are the system requirements for ChatGPT on WeChat?

ChatGPT on WeChat requires 512MB RAM of RAM minimum. Runtime: Python. It runs on Windows, macOS, and Linux.

Can I self-host ChatGPT on WeChat?

Yes. ChatGPT on WeChat is open source (MIT) and can be self-hosted on your own hardware. Clone the repository from GitHub and follow the installation guide.

What platforms does ChatGPT on WeChat support?

ChatGPT on WeChat supports: Wechat. Check the official documentation for the most up-to-date list of supported platforms.

How does ChatGPT on WeChat compare to OpenClaw?

ChatGPT on WeChat offers a different approach compared to OpenClaw. While OpenClaw provides the largest ecosystem with 13,729+ skills and maximum flexibility, ChatGPT on WeChat focuses on personal assistant. Choose ChatGPT on WeChat if you prioritize its specific features; choose OpenClaw for the broadest compatibility and community support.

Is ChatGPT on WeChat suitable for beginners?

ChatGPT on WeChat requires some technical knowledge to set up (Python). If you are a beginner, consider starting with QClaw (one-click install) or MaxClaw (cloud-based, no setup) first, then graduate to ChatGPT on WeChat as you gain experience.

License

MIT License - Free for personal and commercial use.