QQ Bot
The QQ Bot Channel receives events from the official WebSocket Gateway and sends replies through the platform API. The resident Gateway keeps the protocol session available.
What You Need
- a QQ Bot application;
- the App ID;
- the App Secret (entered in Anyy as
client_secret); - optional Bot User ID; and
- the Gateway intent for C2C and group
@messages.
See the current QQ Bot event subscription documentation.
Connect in Dashboard
- Open Dashboard → Channel → Add account.
- Choose QQ Bot and WebSocket Gateway.
- Enter the App ID and App Secret.
- Add the Bot User ID only when you have the matching platform identity.
- Review DM and group policies, then save.
- Enable the required C2C/group
@message intent in the QQ Bot console.
The default account ID is bot. No public inbound webhook is required for this profile.
Access Policies
Direct messages default to pairing; groups default to mention. Supported policies are:
- DM:
pairing,open,allowlist,disabled; - group:
mention,open,allowlist,disabled.
anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
Verify the Connection
anyy channel doctor qqbot
anyy channel reload
Test one C2C message and one group mention. Keep these as separate checks because they depend on different event paths and policies.
Diagnose intent problems before credentials
If identity probes succeed but no messages arrive, verify the Gateway intent and event subscription before rotating the App Secret.
Troubleshooting
| Problem | Check |
|---|---|
| Gateway authentication fails | App ID and App Secret |
| Connected but no events arrive | C2C/group @ message intent and app availability |
| Direct message ignored | DM policy and pairing/allowlist |
| Group message ignored | Group policy and explicit bot mention |
| Receive works but send fails | Bot identity and platform send authorization |