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#

bash

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:

bash

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:

bash

openclaw gateway restart

Adding More WeChat Accounts#

bash

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:

bash

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

Troubleshooting#

IssueSolutionQR code garbled in chatRun the command in a real terminalQR code expiredRe-run openclaw channels login --channel openclaw-weixinPlugin not loadingCheck openclaw status, ensure plugins.entries.openclaw-weixin.enabled is true"No install record" warningNon-critical; plugin still functions if files exist locallyConnection droppedRe-run login command to re-authenticate