Want your AI assistant on WeChat? Here’s how to hook OpenClaw up to WeChat (Weixin) in a few minutes.

Prerequisites

  • OpenClaw installed (openclaw --version)
  • A WeChat account that can scan QR codes

Step 1: Install the Plugin

Quick install (recommended):

npx -y @tencent-weixin/openclaw-weixin-cli install

Or manual:

openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true

Step 2: QR Login

openclaw channels login --channel openclaw-weixin

A QR code appears in your terminal. Scan it with WeChat on your phone, confirm — done. The token is saved locally.

Need multiple accounts? Run the same command again for each one, then isolate sessions:

openclaw config set session.dmScope per-account-channel-peer

Step 3: Restart

openclaw gateway restart

That’s it. Your AI assistant is now on WeChat.

Step 4: Approve Contacts (Pairing)

By default, new senders need approval before the bot responds:

openclaw pairing list openclaw-weixin
openclaw pairing approve openclaw-weixin <CODE>

Pairing codes expire after 1 hour. For fully open access, see the pairing docs.

Quick Troubleshoot

SymptomFix
Plugin won’t loadopenclaw --version — need ≥2026.3.22 for v2.x
Gateway restarts in a loopUpdate both: npm view @tencent-weixin/openclaw-weixin version && openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
TypeScript entry errorPlugin package missing compiled JS — reinstall or wait for publisher fix
Not receiving messagesCheck pairing: openclaw pairing list openclaw-weixin

Optional: Custom Bot Agent

For easier log tracing, add a custom botAgent in openclaw.json:

{
  "channels": {
    "openclaw-weixin": {
      "botAgent": "MyBot/1.0"
    }
  }
}

That’s all. Now reply to WeChat messages right from your terminal — your AI assistant rides in your pocket.