WeChat Bot · Dedicated Cloud Host + Claude Code Integration

Turn WeChat into a programmable AI Assistant
One-click deployment, ready to use after scanning

Provision a dedicated cloud host for each user, automatically running a real WeChat desktop client and providing complete HTTP / WebSocket interfaces externally. You can call APIs directly to send and receive messages, or integrate Claude Code to let AI automatically read and reply to your WeChat conversations.

1:1
One dedicated cloud host per user, with no interference
HTTP+WS
Message send/receive API + real-time event WebSocket
Scan
Go online simply by scanning the login QR code with WeChat
Claude
Integrate Claude Code to automatically reply to messages

Core Capabilities

Drives the real WeChat desktop client with behavior close to human operation; exposes a unified interface covering the complete workflow from login and sending/receiving to event listening and conversation history.

📨

Message Sending

Send text, images, files, and videos through /api/messages/send; use /api/share to share web link cards with contacts or group chats via WeChat's built-in browser. Write operations return queryable task results.

⚡

Real-Time Message Listening

Subscribe to incoming message events through WebSocket /ws and push new messages to your ticketing, CRM, or alerting system immediately.

🗂️

Message History and Search

Supports retrieving and refreshing conversation history and searching by keyword, making it easy to retain messages, perform quality checks, and analyze data.

👥

Contact and Conversation Synchronization

Synchronize contact and conversation lists, retrieve the latest status as needed, and reduce maintenance costs on the business side.

🩺

Status and Health Checks

/api/status and /ping expose online status and availability, making it easy to integrate monitoring and configure automatic recovery.

🔐

Independent Authentication and Operations

Each instance is equipped with an independent API_TOKEN and provides QR code login and a VNC interface for troubleshooting.

★ Featured Capability · WisdomChannel

Let Claude Code take over your WeChat

WisdomChannel is a Claude Code channel plugin that connects your WeChat instance with Claude Code: incoming WeChat messages are handled by Claude, and replies are sent back to the sender—turning your WeChat into an AI assistant that works on its own.

  • Private chats are forwarded automatically; group chats are triggered only when @you are mentioned, avoiding interruptions
  • Built-in allowlist access control, responding only to contacts you approve
  • Two modes: an interactive MCP channel, or the unattended wisdom-channel bridge auto-reply loop
  • Install with one command: pip install wisdom-channel (requires Claude Code CLI v2.1.80+)
Unattended Auto-Reply
pip install wisdom-channel
# Configure the instance address and token
setx WISDOM_API_URL "http://<your-instance-ip>:8000"
setx WISDOM_API_TOKEN "<API_TOKEN>"
# Start bridging: new message → Claude → automatic reply
wisdom-channel bridge --model sonnet

Quick Integration Example

Each instance has its own API address and token (API_TOKEN). Simply call the instance's own :8000 endpoint to send messages.

cURL · Send a Message
curl -X POST "http://<your-instance-ip>:8000/api/messages/send" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "Alice",
    "type": "text",
    "text": "Hello from WeChat Bot"
  }'

Go Live in Four Steps

A standardized deployment process that reduces integration barriers and operational complexity.

STEP 01

Create an Application

Create a WeChat Bot application on the platform, and the system will automatically deploy a dedicated cloud server for you.

STEP 02

Scan to Log In

Use WeChat on your phone to scan the code and log in from the console, then obtain the instance's API address, API_TOKEN, and VNC interface entry. The Viewer uses independent credentials and is visible only to the application owner and platform administrators.

STEP 03

Call the API or Integrate Claude

Directly call the :8000 interface to send and receive messages, or install wisdom-channel to let Claude Code reply automatically.

STEP 04

Connect Business Systems

Connect message events with internal processes to build maintainable, observable automated workflows.

Typical Scenarios

Suitable for teams and individuals who need reliable WeChat capabilities while adding AI automation.

  • AI customer service auto-replies and 24/7 coverage (Claude Code)
  • Private-domain operations automation and scheduled outreach
  • Enterprise notification bots and alert delivery
  • Customer service message forwarding and ticket integration
  • Conversation history retention, retrieval, and quality analysis
  • Personal WeChat assistant: automatic organization, reminders, and replies

Frequently Asked Questions

How does it connect to WeChat?

Each instance runs the real WeChat desktop client, with Wisdom using desktop automation to send and receive messages. Its behavior closely resembles human operation rather than relying on third-party web protocols.

How do I enable AI auto-replies?

Simply install wisdom-channel and connect it to Claude Code. Private chats are forwarded automatically, while group chats are triggered only when you @mention it, with whitelist controls for response scope.

Does it support real-time event processing?

Yes. Subscribe to incoming message events through WebSocket /ws to enable real-time business processing and system integration.

How do I troubleshoot operations?

Application owners can log in to instances through the VNC interface for troubleshooting, and use the /api/status status check to identify login, data preparation, and enabled API capabilities.

What should I keep in mind when using it?

Please follow WeChat platform usage guidelines, reasonably control sending frequency and content, and avoid affecting normal accounts.

Get Started with WeChat Bot

A unified deployment, authentication, and operations model, combined with Claude Code integration, gets your WeChat automation business online quickly.