WeChat Channel Integration Guide
1. Introduction to the WeChat Channel
The WeChat channel allows users to converse with Agents in 3ChatClaw directly via WeChat.
After integrating the personal WeChat channel, users can send messages to an Agent via their personal WeChat account, and the Agent will reply within WeChat. Once configured, messages from WeChat friends or WeChat groups can be forwarded to an Agent in 3ChatClaw for processing, with the Agent automatically generating replies.
The WeChat channel itself is responsible for connecting WeChat and 3ChatClaw. It is the Agent within 3ChatClaw that truly understands the messages, invokes skills, and generates responses.
Note: After integrating the WeChat channel, you must keep 3ChatClaw and the corresponding Agent open and online.
If 3ChatClaw exits, the computer goes into sleep mode, the network disconnects, or the Agent is not in a responsive state, messages in WeChat may not be processed in a timely manner.
2. Prerequisites
Before integrating the WeChat channel, please confirm the following:
-
3ChatClaw is running normally
The WeChat channel relies on 3ChatClaw to receive and process messages. -
The Agent is online
Messages sent via WeChat are handed over to the Agent for processing. Please ensure the Agent can converse normally. -
A personal WeChat account ready for QR code authorization is prepared
The personal WeChat channel requires scanning a QR code with the mobile WeChat app and confirming authorization. -
The computer and network are stable
If the computer sleeps, loses network connectivity, or 3ChatClaw is closed, the WeChat channel may be unable to send or receive messages.
3. Logging into the WeChat Channel via QR Code
It is recommended to complete the WeChat channel login via the 3ChatClaw console using a QR code.
Steps
- Open 3ChatClaw Web.
- Click
Channelsin the left-hand list. - Select
WeChat. - Enable
Enabled. - Click
Get Login QR Code. - Wait for the QR code to appear.
- Scan the QR code using your mobile WeChat app.
- Confirm authorization on your phone.
- Upon successful authorization, the
Bot Tokenwill automatically populate the form. - Click
Save.
Once saved, the personal WeChat channel is successfully configured. As long as 3ChatClaw and the Agent remain online, users can send messages to the Agent via WeChat and receive replies.
It is recommended to disable
Show Thinking ProcessandShow Tool Messages, keeping only the final reply content.
4. Common WeChat Channel Configuration Explanations
| Configuration Item | Description |
|---|---|
| Enabled | The WeChat channel will only start receiving and processing messages after this is enabled. |
| Bot Prefix | The prefix that triggers the Bot. Once filled, only messages containing the specified prefix will be sent to the Agent for processing. |
| Show Tool Messages | When enabled, the process messages of the Agent invoking tools will be visible in the conversation. |
| Show Thinking Process | When enabled, the Agent’s thinking process will be visible in the conversation. |
| Get Login QR Code | Click to generate a WeChat login QR code when logging in for the first time or if the Token has expired. |
| Bot Token | The Token generated after successful WeChat iLink authorization. It is automatically populated when scanning the code via the console. |
| Token File Path | The local save path for the Bot Token. The default is ~/.qwenpaw/wechat_bot_token. |
| Media File Directory | The local save directory for media content such as images, voice messages, and files. |
| Message Merging | When enabled, multiple messages received within a short period will be merged before being sent to the Agent for processing. |
| Private Chat Policy | Controls whether private chat messages are sent directly to the Agent for processing. |
| Group Chat Policy | Controls whether group chat messages are sent directly to the Agent for processing. |
| Requires @Mention | When enabled, only messages mentioning @Bot in a group chat will be processed. |
5. Usage Recommendations
1. Keep the Agent Online
The WeChat channel only integrates WeChat messages into 3ChatClaw; the Agent is responsible for generating the actual replies. Please ensure 3ChatClaw is running and confirm that the corresponding Agent can respond normally.
2. Test with Private Chat First
After saving the WeChat channel configuration, it is recommended to first send a simple message from another WeChat account to the current account to confirm that the Agent can receive and reply normally.
3. Enable @Mention for Group Chats
If integrating with a WeChat group, it is recommended to enable Requires @Mention to prevent ordinary group chats from being frequently sent to the Agent for processing.
4. Use Caution When Enabling “Show Thinking Process”
To prevent replies from becoming too long, it is recommended to disable Show Thinking Process and keep only the final reply content.
5. Re-scan the QR Code if the Token Expires
If the WeChat channel suddenly stops receiving or sending messages, return to Channels -> WeChat, click Get Login QR Code again, and scan to re-authorize.