๐ฌ QQ Integration
๐ค Who it's for: Users who want an AI assistant in QQ
โฑ๏ธ Read time: ~5 minutes
๐ก In one line: Make YingClaw your intelligent QQ assistant โ always responsive, speaks only when needed.
Connect YingClaw to QQ and turn it into an always-available AI assistant for both private and group chats.
Overviewโ
YingClaw connects to QQ via the QQ Open Platform's WebSocket connection, supporting text, images, and @ mentions.
| Scenario | Description |
|---|---|
| ๐ค Private Assistant | One-on-one conversations, ask anything anytime |
| ๐ฅ Group Response | Responds when @ mentioned in group chats |
| ๐ข Notifications | Scheduled task results pushed to QQ |
Setupโ
1. Get QQ Open Platform Credentialsโ
Go to QQ Open Platform and register an app to get:
- App ID: Your application's unique identifier
- App Secret: Your application's secret key
2. Configure in YingClawโ
Log into the YingClaw Web Console, go to "Channels", enable QQ, and fill in:
| Parameter | Description |
|---|---|
app_id | App ID from QQ Open Platform |
app_secret | App Secret from QQ Open Platform |
allowed_users | User allowlist, * means all users |
3. Start the Channelโ
After saving, YingClaw automatically connects to QQ WebSocket and starts receiving messages.
Message Interactionโ
Private Chatโ
Users send messages directly to the Bot. YingClaw responds in real time, supporting:
- ๐ฌ Natural language conversation
- ๐ File reading, writing, and editing
- ๐ Information lookup and web search
- โฐ Task scheduling and reminders
Group Chatโ
In group chats, YingClaw is best configured to respond only when @ mentioned to avoid disrupting conversations.
User Allowlistโ
Control which QQ users can trigger the Bot:
channels:
qq:
allowed_users:
- "123456789" # Only specific QQ accounts
# - "*" # Allow all users
Notesโ
- Use a dedicated QQ account for the Bot
- In groups, configure @-mention-only responses to protect the chat experience
- Regularly review message logs for unusual activity
Next Stepsโ
- ๐ฌ Learn about ๐ฌ WeChat Integration
- ๐ Set up ๐ Feishu Integration
- ๐ Back to Documentation