Connect WeChat
Connect personal WeChat with a ClawBot QR code, or contact Buda to activate a hosted account for direct messages and WeChat groups.
Chat with your agent right inside WeChat. By default, Buda uses ClawBot to connect by scanning a QR code — there's no app to register, no App ID, and no secret to copy. Just scan and start.

Scanning the QR code takes over the account. Connecting WeChat logs Buda in as that personal account — anyone who messages it gets an automatic reply, as if the owner sent it. Use a dedicated WeChat account, never your personal one.
Choose a connection method
In Channels, click Add Channel and select WeChat. Under Connection method, ClawBot is selected by default and keeps the direct QR-code connection. To use a hosted personal WeChat account instead, select Hosted Account and follow the hosted account guide to enter App Key, App Secret, and an account instance.
Connect with ClawBot
Add the channel in Buda
Open Settings → Channels, click Add Channel, and select WeChat. Keep the default ClawBot connection method. There are no credential fields to fill in — optionally set a label, then click Connect. A QR code appears on screen.
Scan the QR code
Scan the on-screen code using the dedicated WeChat account. Once you confirm the login in WeChat, the dialog shows Connected and the channel becomes active.
Test it
From a different WeChat account, message the connected account with Hi. Once Buda replies, you're set.
ClawBot capabilities
- Direct messages only. The connected account replies to 1:1 conversations; there's no group-chat support today.
- Text, images, files, audio, and video — inbound media is uploaded to the agent's Drive, and the agent can send files, images, and video back.
/new— send/new(optionally followed by a message) to start a fresh agent session in that conversation.
ClawBot troubleshooting
| Symptom | Fix |
|---|---|
| QR code expired | QR codes are time-limited (a few minutes). Return to channel settings and start the scan again |
| Session expired / channel went inactive | WeChat periodically invalidates the login session. Reconnect the channel and scan again |
| Used your personal account | Delete the channel, then reconnect and scan with a dedicated account instead |
Connect a hosted account
Use a dedicated personal WeChat account to reply to direct messages and participate in WeChat groups when @mentioned. You or an authorized group member must invite the account first.
Contact us
Contact Buda to arrange your hosted account purchase and activation. Contact us to obtain an App Key, App Secret, and an available account instance.
Email hi@buda.im with your WeChat account and how you plan to use direct messages or groups.
Set up the hosted account
- Open your space's Channels settings and click Add Channel.
- Select WeChat, then switch from the default ClawBot to Hosted Account under Connection method.
- Enter the App Key and App Secret provided by Buda. Click Verify and list accounts, then choose an Account instance and the target Agent.
- Click Connect and open Manage account connection to check the status. For an offline account, generate a login QR code, scan it with the matching account, and confirm login.
- Once Account connected appears, send a direct text message from another account and confirm you receive an Agent reply. To test a group, explicitly @mention the connected account.
Hosted account group conversations
Select the connected account from WeChat’s @mention picker and send text. Buda keeps the sender identity and returns the Agent's reply to the original group, without automatically @mentioning the sender.
Mentioning everyone, mentioning another member, or typing a nickname as plain text does not trigger a reply. Group messages without the account's mention are ignored and do not appear in the Buda session. Different groups and direct conversations have separate sessions.
Direct text and group text mentions are supported. Images, files, voice, contact management, and bulk messaging are currently unsupported.
Hosted account status and recovery
- Expired QR code or offline account: generate a new QR code in Manage account connection and confirm login.
- Missing account instances, invalid credentials, or a connection needing attention: contact us with the error shown in Buda.
- Connected but no reply: check that the message is direct text or explicitly mentions the account in a group, then check the Buda conversation.
- Unlinking removes the Buda connection and does not automatically log out the account. Contact us if you need to restore its other message receiver settings.
Related
- Channels overview — how channels route messages to agents
- Connect WhatsApp — the same QR scan-and-go pattern, for WhatsApp