Guide
Hermes Agent + WeChat: Run Your Hermes Bot on WeChat
Hermes Agent has built-in WeChat support, making it one of the few AI agent platforms that can connect directly to China's dominant messaging app. Deploy a Hermes WeChat bot with QR pairing — no separate plugin install needed.
Why Run Hermes Agent on WeChat?
WeChat has over 1.3 billion monthly active users, primarily in China and among Chinese-speaking communities worldwide. For teams, creators, or businesses that communicate through WeChat, running an AI agent directly in the app eliminates the friction of switching to a separate tool.
Hermes Agent has built-in WeChat support as a native channel. This is different from OpenClaw, which requires installing a separate openclaw-weixin plugin at connect time. With Hermes, WeChat is available from first deploy.
Pair this with a Chinese-language model like Qwen 3.6 Plus or GLM-5.1 for the most natural experience with Chinese-language users.
How WeChat Pairing Works
Hermes connects to WeChat through a QR code pairing flow similar to WeChat Web:
- Deploy your Hermes instance with WeChat enabled (see below).
- Open the Hermes web dashboard (available at port 9119 or via the OpenClaw Launch dashboard link).
- Navigate to the WeChat section and click Connect.
- A QR code is displayed. Open WeChat on your phone and scan it (same process as WeChat Web login).
- After scanning, WeChat links to Hermes. The agent can now send and receive WeChat messages.
Option 1: WeChat on OpenClaw Launch
On OpenClaw Launch, WeChat is installed on-demand at connect time — you select it in the Connect Platforms interface after deploy, and the plugin is installed during the connection flow. This approach keeps the warm-pool deployment fast and avoids pre-installing channels that may not be needed.
- Go to openclawlaunch.com/hermes-hosting and start a Hermes deploy.
- Deploy with any model — WeChat connection is handled after deploy.
- After deploy, open the Connect Platforms section in your dashboard and select WeChat.
- Complete the QR pairing flow. Expect a brief installation step (~30–60s) on first connect.
Option 2: Self-Hosted Hermes + WeChat
For self-hosted Hermes, enable the WeChat channel in /opt/data/config.yaml. WeChat is a bundled channel in upstream Hermes and does not require a separate npm install. Refer to the upstream README for exact config field names:
# /opt/data/config.yaml
platforms:
weixin:
# Hermes uses platforms.weixin for personal WeChat and
# platforms.wecom for Enterprise WeChat. Pairing is QR-based.
# Refer to upstream README for current optional fields.After enabling and restarting, access the Hermes dashboard to complete QR pairing.
Recommended Models for WeChat Deployments
| Model | Chinese Language | Notes |
|---|---|---|
| Qwen 3.6 Plus | Excellent — native training | Best choice for Chinese-primary use |
| GLM-5.1 | Excellent — native training | Strong coding + Chinese; SWE-Bench 74.2 |
| Claude Sonnet 4.6 | Good | Better for mixed Chinese/English tasks |
| DeepSeek V4 Pro | Good | Cost-efficient; native Chinese training |
WeChat Limitations to Know
WeChat's unofficial Web API (which Hermes uses for personal account pairing) has some restrictions to be aware of:
- Message types — The Web API supports text messages reliably. Image, file, and voice message support depends on the API version and may vary.
- Session duration — WeChat Web sessions can expire, particularly after extended inactivity. If the session expires, repeat the QR pairing step.
- Account restrictions — Tencent may restrict or temporarily suspend accounts that exhibit automated bot-like behavior. Using a dedicated bot account rather than your personal account is strongly recommended.
What's Next?
- Hermes Agent + Qwen — Best model for Chinese-language WeChat deployments
- Hermes Agent + WhatsApp — Connect Hermes to WhatsApp for international users
- Hermes Agent + Telegram — Deploy Hermes on Telegram alongside WeChat
- Hermes Agent + GLM — GLM-5.1 for coding-heavy WeChat agent deployments