Connect xbot via the QQ official bot protocol. Supports private chats, group chats, and channel messages.
Requires Server mode.
- xbot installed and running in Server mode
- A bot app registered on the QQ Open Platform
- App ID and Client Secret obtained
- WebSocket connection mode enabled
{
"qq": {
"enabled": true,
"app_id": "your-app-id",
"client_secret": "your-client-secret",
"allow_from": []
}
}
| Field | Required | Default | Description |
|---|---|---|---|
enabled | ✅ | false | Enable the QQ channel |
app_id | ✅ | — | QQ Bot App ID |
client_secret | ✅ | — | QQ Bot Client Secret |
allow_from | ❌ | [] | Whitelist of user openid values; empty = allow all |
- Private chat: send a message directly to the bot
- Group chat: @mention the bot + your question
- QQ Channel: @mention the bot in a channel
- QQ channel does not support message updates (patching), so agent streaming rendering and progress notifications are not visible
- Markdown messages automatically degrade to plain text if sending fails
- Supports automatic reconnection with exponential backoff
- NapCat Channel — OneBot 11 protocol
- Feishu Channel — team collaboration
- Configuration — QQ channel settings