OpenClaw WeChat Setup
v1.0.0Install and connect the WeChat (微信) channel plugin for OpenClaw. Use when the user asks to set up WeChat, connect WeChat, install the WeChat plugin, scan WeC...
Like a lobster shell, security has layers — review code before you run it.
License
SKILL.md
OpenClaw WeChat (微信) Plugin Setup
Install and connect WeChat as a messaging channel for OpenClaw.
Prerequisites
- OpenClaw installed and running (
openclawCLI 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:
- Detect the local OpenClaw installation
- Download and install the
@tencent-weixin/openclaw-weixinplugin - Enable the plugin in OpenClaw config
- Start the WeChat QR code login flow
- 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-weixinafter 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
| Issue | Solution |
|---|---|
| QR code garbled in chat | Run the command in a real terminal |
| QR code expired | Re-run openclaw channels login --channel openclaw-weixin |
| Plugin not loading | Check openclaw status, ensure plugins.entries.openclaw-weixin.enabled is true |
| "No install record" warning | Non-critical; plugin still functions if files exist locally |
| Connection dropped | Re-run login command to re-authenticate |
Files
1 totalComments
Loading comments…
