WeChat Personal

OpenClaw WeChat personal account channel plugin via WeChatPadPro (iPad protocol). Supports text, image, and file exchange.

The WeChat Personal plugin bridges OpenClaw to WeChat personal accounts using the WeChatPadPro iPad protocol — the only reliable way to automate personal WeChat without Enterprise WeChat restrictions. Unlike the official WeCom (Enterprise WeChat) integration, this plugin targets the 1.3 billion users on regular WeChat, making it essential for anyone whose contacts are only reachable through the personal app. The plugin works by connecting to a WeChatPadPro server that emulates the iPad WeChat client. Messages are relayed via HTTP polling: inbound messages arrive through a sync endpoint, and outbound replies are sent through dedicated text, image, and file APIs. It supports both direct messages and group chats, with a configurable keyword trigger prefix (e.g., @ai) so the bot coexists with normal personal use without responding to every message. File exchange is fully bidirectional — images sent by contacts are injected into the AI's visual context for multimodal models, while the AI can send images, PDFs, Excel files, and other documents back through WeChat's CDN. The plugin includes QR code login flow displayed in the terminal, per-peer session routing for independent conversations, quote reply extraction, and configurable DM access policies (pairing, allowlist, or open access). This is a community plugin primarily used by users in China and the Chinese diaspora who need their AI assistant accessible through WeChat. It requires a self-hosted WeChatPadPro instance, which itself requires a valid WeChat account and token key. Setup is more involved than official channel plugins, but it unlocks an entire messaging ecosystem that OpenClaw can't reach otherwise.

Tags: channel, messaging, china, community

Use Cases

Personal AI assistant accessible through WeChat for Chinese-speaking family and friends
Customer service bot for small businesses that operate primarily through WeChat
Translation assistant for cross-language WeChat conversations
AI-powered group chat moderator with keyword-triggered responses
Document analysis bot — send images and files through WeChat for AI processing

Tips

Set a distinctive triggerPrefix like '@ai' to prevent the bot from responding to every personal message
Use replyPrefix '🤖 ' so friends can distinguish AI responses from your personal messages
Set dmPolicy to 'pairing' initially — it requires explicit approval before the bot responds to new contacts
Run WeChatPadPro in Docker for easier management and auto-restart
Use per-peer session routing for independent conversation context per user
Enable debugMessages temporarily when troubleshooting message delivery issues
Keep a dedicated WeChat account for the bot rather than using your personal one

Known Issues & Gotchas

WeChatPadPro uses an unofficial iPad protocol — Tencent may restrict or ban accounts using it
You need to generate a TOKEN_KEY from the WeChatPadPro admin API before configuring the plugin
QR code login is required on first setup and after session expiry — keep terminal accessible
The plugin uses HTTP polling, not WebSocket — there may be slight message delivery delays
Group chat messages are only processed when they match the triggerPrefix
If WeChatPadPro server goes down, the plugin silently stops receiving messages

Alternatives

WeCom (Enterprise WeChat)
OpenClawWeChat (Mini Program)

Community Feedback

WeChat is used daily, but OpenClaw only supports Enterprise WeChat, not personal WeChat. This plugin finally bridges that gap.
— Reddit r/openclaw

Week 1: WeChat plugin for OpenClaw. The goal: let your AI assistant talk to family and friends who are only on WeChat.
— LinkedIn

OpenClaw WeChat personal account channel plugin via WeChatPadPro iPad protocol — supports text, image, file exchange, group chats, and keyword triggers.
— npm

Frequently Asked Questions

Is this the same as the WeCom (Enterprise WeChat) plugin?

No. This plugin targets personal WeChat accounts via the WeChatPadPro iPad protocol. WeCom is a separate enterprise product. Most personal contacts use regular WeChat, not WeCom, which is why this plugin exists.

Will my WeChat account get banned for using this?

There is a risk. WeChatPadPro uses an unofficial iPad protocol that Tencent does not sanction. While many users run it without issues, Tencent can and does restrict accounts using unofficial clients. Use a dedicated account rather than your primary one.

Do I need to run WeChatPadPro myself?

Yes. WeChatPadPro is a separate self-hosted server that emulates the iPad WeChat client. You need it running and accessible before configuring this plugin. See the WeChatPadPro GitHub repo for setup instructions.

Can the bot send files and images through WeChat?

Yes. The plugin supports bidirectional file exchange. The AI uses MEDIA:/path/to/file syntax in replies. Images are sent as WeChat image messages, and other files (PDF, Excel, etc.) are uploaded to WeChat CDN and sent as file attachments.

Does this work in WeChat group chats?

Yes. Group chats are supported. Use the triggerPrefix setting (e.g., '@ai') so the bot only responds when explicitly called, rather than reacting to every group message.

How do I approve new contacts to chat with the bot?

With dmPolicy set to 'pairing' (the default), new contacts receive a pairing code. Run 'openclaw pairing approve wechat <CODE>' to grant access. You can also use 'allowlist' or 'open' modes for different access controls.

Configuration Examples

Basic setup with pairing

{
  "channels": {
    "wechat": {
      "enabled": true,
      "serverUrl": "http://localhost:8849",
      "token": "YOUR_TOKEN_KEY",
      "triggerPrefix": "@ai",
      "replyPrefix": "🤖 ",
      "dmPolicy": "pairing"
    }
  }
}

Open access for group use

{
  "channels": {
    "wechat": {
      "enabled": true,
      "serverUrl": "http://192.168.1.100:8849",
      "token": "YOUR_TOKEN_KEY",
      "triggerPrefix": "",
      "dmPolicy": "open",
      "debugMessages": false
    }
  },
  "session": {
    "dmScope": "per-peer"
  }
}

Installation

openclaw plugins install @icesword760/openclaw-wechat