QQ Platform Overview

QQ is the only currently implemented platform profile. The plugin selects one QQ adapter at startup via LINGCHUAdapter (default: ~onebot.v11).

Protocol priority

Priority	Protocol	Adapter ID	NoneBot package	Status
1 (default)	OneBot V11	`~onebot.v11`	`nonebot-adapter-onebot`	Active
2	QQ Official	`~qq`	`nonebot-adapter-qq`	Deprecated
3	OneBot V12	`~onebot.v12`	`nonebot-adapter-onebot`	Deprecated

Only one QQ adapter is considered enabled at a time. Other adapters that NoneBot loads are treated as disabled and excluded from platform resolution, message storage, and API call recording. QQ Official and OneBot V12 have been deprecated and removed from the project, including their source code.

Switching protocols

Set LINGCHUAdapter in .env. Only OneBot V11 is active in the startup flow:

DRIVER=~fastapi+~httpx+~websockets
ONEBOT_ACCESS_TOKEN=your-token

Deprecated adapters

QQ Official (~qq) and OneBot V12 (~onebot.v12) have been deprecated and removed from the project, including their source code. Setting LINGCHUAdapter to a deprecated adapter ID is no longer supported.

Implementation matrix

Each protocol has a default handler set and optional implementation-specific extensions:

Protocol	Implementation	Extension highlights
OneBot V11	`default`	Core group management commands
OneBot V11	NapCat	Group announcement + group avatar

Source layout

handle/qq/
├── commands/              # Shared QQ command definitions (Alconna matchers)
│   ├── triggers.py        # Command trigger words (zh/en)
│   ├── mute.py
│   ├── member.py
│   ├── block.py
│   ├── announcement.py
│   ├── remote.py          # Remote management commands
│   └── ...
└── adapters/
    └── onebot11/
        ├── default/       # OneBot V11 default handlers
        └── napcat/        # NapCat extensions

Next steps

Framework Integrations — Protocol-side runtime setup (NapCat Docker, SnowLuma Docker)
QQ Commands — Full command reference including remote management
OneBot V11 Protocol — Protocol overview and implementation-specific docs

QQ Platform Overview