OpenClaw WeChat (微信) Plugin Setup

Install and connect WeChat as a messaging channel for OpenClaw.

Prerequisites

• OpenClaw installed and running (openclaw CLI available)
• A WeChat account on a mobile device for QR code scanning

Setup Workflow

Step 1: Install the plugin

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

This command will:

1. Detect the local OpenClaw installation
2. Download and install the @tencent-weixin/openclaw-weixin plugin
3. Enable the plugin in OpenClaw config
4. Start the WeChat QR code login flow
5. Display a terminal QR code for scanning

Step 2: Scan the QR code

The CLI prints an ASCII QR code in the terminal. The user must scan it with their WeChat mobile app to authorize the connection.

Important: The QR code renders correctly only in a monospace terminal. It will appear garbled in chat interfaces (webchat, Feishu, etc.) due to proportional fonts. If the user cannot see the QR code clearly:

• Instruct them to run the command directly in their terminal (Terminal.app, iTerm2, etc.)
• Or use openclaw channels login --channel openclaw-weixin after plugin is installed

Step 3: Verify connection

After scanning, verify the connection:

openclaw status 2>/dev/null | grep -i "openclaw-weixin"

Expected output should show openclaw-weixin │ ON │ OK.

Step 4: Restart gateway (if needed)

If the plugin was installed but the gateway wasn't restarted:

openclaw gateway restart

Adding More WeChat Accounts

openclaw channels login --channel openclaw-weixin

Each scan creates a new account entry. Multiple WeChat accounts can be online simultaneously.

Context Isolation (Optional)

To isolate conversation context per WeChat account:

openclaw config set agents.mode per-channel-per-peer

Troubleshooting