WeChat Tool

WinClaw supports WeChat automation. Once configured, you can use natural language to have your AI assistant send WeChat messages to friends or group chats.

Features

The WeChat tool supports the following features:

• Send Messages: Send text messages to friends or group chats
• Get Contacts: View your WeChat friends and group chat list

Step 1: Install the WeChat Tool

1. Click the Tools icon in the left navigation bar to enter the Tool Management page
2. Find the wechat_agent tool in the Tool Store
3. Click the Install button to install the tool

Tool information:

• Name: wechat_agent
• Type: Command line tool
• Size: About 7.5 MB
• Platform: windows/x64

Step 2: Start the WeChat Agent Service

After installation, you need to start the WeChat agent service.

1. Go back to the Home chat interface
2. Enter the following command:

start wechat_agent daemon

3. The AI assistant will start the WeChat agent service and display the running status

After successful startup, the AI will return information like:

Wechat_agent daemon has been successfully started and is running in the background. The status confirms that the daemon is running on port 19860, the WeChat session is online, and the logged-in user is "xxx". The daemon is now ready to accept commands such as wechat_agent contacts and wechat_agent send for messaging operations.

Manual Start (Optional)

If you prefer using the command line, you can also manually start the WeChat agent service:

1. Open a terminal (Command Prompt) and navigate to the tools directory:

cd C:\Users\YourUsername\.auto-coder\.autocodertools\

2. Run the start command:

wechat_agent.exe start

3. A QR code will automatically appear after startup — scan it with your phone's WeChat to log in

Step 3: Scan QR Code to Log In

After starting the service, a browser will automatically open showing the WeChat login QR code.

1. Open WeChat on your phone
2. Tap the + icon in the top right corner and select Scan
3. Scan the QR code on the screen
4. Confirm login on your phone

After successful login, the WeChat agent service will display the currently logged-in username.

Verify Login Status

After scanning the QR code and logging in, you can verify the service is running properly with the following command:

.\wechat_agent.exe status

If the output looks like this, everything is working correctly:

守护进程状态:
  运行中: 是（端口: 19860）
  微信在线: true
  用户昵称: YourWeChatNickname

When you see 运行中: 是 (Running: Yes) and 微信在线: true (WeChat Online: true), the WeChat agent service is ready to use.

Step 4: Use WeChat Features

After logging in, you can use natural language to have the AI operate WeChat for you.

Send Messages

Simply tell the AI what message you want to send and to whom:

Send "This is a test message" to the ac-aicoder group via WeChat

The AI will call the WeChat tool to send the message and confirm the result:

More Examples

Important Notes

1. Keep Service Running: The WeChat agent service needs to run continuously in the background. You'll need to restart the service after closing WinClaw
2. Login Status: If your WeChat login expires, you'll need to scan the QR code again to log in
3. Message Frequency: Use responsibly and avoid sending messages too frequently to prevent account issues
4. Privacy & Security: The WeChat tool runs locally only and does not upload any message content

FAQ

What if there's an error when starting the service?

1. Confirm the wechat_agent tool is properly installed
2. Check if port 19860 is already in use
3. Restart WinClaw and try again

Can't log in after scanning the QR code?

1. Make sure your phone and computer are on the same network
2. Check if the QR code has expired; if so, restart the service
3. Confirm your phone's WeChat app is up to date

Message sending failed?

1. Check if the WeChat login status is normal
2. Confirm the recipient name or group name is correct
3. Check the error message returned by the AI