💬 WeChat Integration

👤 Who it's for: Anyone who wants AI in their WeChat
⏱️ Read time: ~6 minutes
💡 In one line: YingClaw lives in your WeChat — ask anytime, responds when needed.

Connect YingClaw to WeChat and turn it into an always-available personal assistant.

---

Overview

YingClaw supports WeChat messaging channels for receiving and sending messages, enabling seamless AI interaction directly within WeChat.

Scenario	Description
🤖 Personal Assistant	Ask questions and execute tasks in private chat anytime
👥 Group Collaboration	Respond on demand in group chats without being intrusive
📢 Notifications	Auto-push scheduled task results to WeChat

---

Connection Methods

Method 1: Personal WeChat Account (Recommended)

Connect via WeChaty-compatible protocols (WeChat4U, PadLocal, etc.).

Advantages:

• Uses your personal WeChat account, no verification required
• Supports private and group chats
• Rich message formats (text, files, images)

Limitations:

• Must comply with WeChat usage policies
• Dedicated account recommended to avoid disrupting daily use

Method 2: WeCom (Enterprise WeChat)

Connect via WeCom app integration — higher barrier but better stability.

Advantages:

• Official API support, reliable
• Can bind multiple members
• Webhook message push support

---

Configuration Steps

1. Prepare a WeChat Account

Use a separate WeChat account (not your primary one) to avoid disrupting daily use.

2. Install the Integration Plugin

yingclaw plugin install wechat

3. Configure Channel Parameters

Set up the WeChat channel in YingClaw's config:

channels:
  wechat:
    enabled: true
    puppet: 'wechat4u'       # or 'padlocal'
    auto_reply: true
    groups:
      - name: 'Work Group'
        auto_join: false
        respond_only_mentioned: true

Parameter	Description
puppet	Protocol type
auto_reply	Auto-reply to private messages
groups	Group chat config list
respond_only_mentioned	Only respond when @mentioned in groups

4. Scan to Log In

After configuration, start the channel. A QR code will appear — scan it with WeChat to log in.

yingclaw channel start wechat

---

Message Interaction

Private Chat

Users send messages directly in WeChat; YingClaw responds in real time, supporting:

• 💬 Natural language conversation
• 📄 File read/write and editing
• 🔍 Web search and info query
• ⏰ Task scheduling and reminders

Group Chat

YingClaw follows the principle of observe quietly, speak when needed in groups:

• Responds when @mentioned
• Offers help for clear questions
• Stays silent during casual conversation

File Sharing

Through the WeChat channel, YingClaw can send generated files (documents, spreadsheets, images, etc.) directly to users.

---

Push Notifications

Push scheduled task results to WeChat:

# Scheduled task example
jobs:
  - name: 'Daily standup reminder'
    schedule: '0 9 * * 1-5'
    type: agent
    delivery:
      channel: weixin
      to: 'Personal WeChat'

---

Security Reminders

• Use a dedicated WeChat account
• Never expose private memories in group chats
• Regularly check connection status and message logs
• Sensitive operations (file deletion, external requests) require confirmation

---

Next Steps

• 💻 Explore Shell Command Execution
• 🤖 Learn about Multi-Agent Orchestration
• 📖 Return to Documentation Center