Key Takeaways
- WeChatFerry + Ollama: the recommended local WeChat bot stack for 2026
- Qwen2.5 7B: best local model for Chinese-language WeChat responses
- Windows required: WeChatFerry hooks into the WeChat PC client (Windows only)
- Setup time: 30β60 minutes for someone comfortable with Python
- No cloud API: all inference runs locally, no message data sent externally
- Risk: WeChat ToS prohibits automated bots β use for personal assistants only
- 1Install Ollama and pull Qwen2.5 7B
Why it matters: Download Ollama from ollama.com and run: `ollama pull qwen2.5:7b` - 2Log in to WeChat PC
Why it matters: Open WeChat on Windows and scan the QR code to log in. Keep it logged in and running in the background. - 3Install WeChatFerry
Why it matters: Install via pip: `pip install wcferry`. WeChatFerry injects into the WeChat process to expose a message API. - 4Create the Python message handler
Why it matters: Create `wechat_bot.py` with WeChatFerry client, Ollama HTTP API calls, and message routing logic. - 5Test with a self-message
Why it matters: Send a WeChat message to yourself starting with "@ai" and verify the bot responds within 10 seconds. - 6Add conversation history
Why it matters: Store the last 10 messages per contact in a dict to enable multi-turn conversation context. - 7Run as a background service
Why it matters: Use NSSM (Non-Sucking Service Manager) to run the Python script as a Windows service that starts automatically.
Does this WeChat bot work on Mac?
No. WeChatFerry requires Windows and hooks into the WeChat Windows PC client via DLL injection. macOS users can run Windows in a virtual machine (Parallels or VMware Fusion) to use this setup.
Will my WeChat account get banned for using a bot?
WeChat prohibits automated bots in its Terms of Service. Accounts detected using automation tools risk temporary suspension or permanent ban. Use only for personal productivity at low message volumes.
What is the best Ollama model for Chinese WeChat messages?
Qwen2.5 7B is the best balance of quality and speed for Chinese-language WeChat responses β excellent Chinese comprehension, fast enough on most hardware, and the 4.7GB model fits in 8GB VRAM.
Can the bot handle group chats?
Yes. WeChatFerry exposes group messages with the room ID. Modify the on_message handler to check msg.roomid and filter which groups the bot should respond in. Add a trigger keyword to avoid responding to every group message.