QQ Platform Overview

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

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.

Switching protocols

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

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

Unsupported adapters

Only OneBot V11 is implemented. Setting LINGCHUAdapter to any other adapter ID (such as ~qq, ~onebot.v12, or ~milky) raises PlatformAdapterUnknownError at startup.

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

• Connect QQ via NapCat — NapCat Docker setup and NapCat-specific commands
• Connect QQ via SnowLuma — SnowLuma Docker setup
• QQ Commands — Full command reference including remote management
• OneBot V11 default implementation — Default handler reference