OpenClaw QQ Plugin — seamlessly connect AI agents to QQ personal accounts via the OneBot v11 protocol and NapCat. Supports text, images, files, voice/video messages, proactive push, scheduled tasks, and server alerts.
Install
openclaw plugins install openclaw:qq The QQ plugin connects OpenClaw to QQ, China’s most widely-used personal messaging platform, via the OneBot v11 WebSocket protocol paired with NapCat.
Technical implementation
The plugin uses NapCat as the QQ client bridge, implementing the OneBot v11 WebSocket protocol to receive and send messages. Node.js 22+ and TypeScript, MIT licensed.
Message capabilities
Full message type support: text, images, files, voice recordings, and video. The plugin handles QQ group messages and private messages, with configurable routing rules for each.
Proactive messaging
Unlike reactive chatbots that only respond, this plugin supports proactive push — the agent can initiate messages for alerts, scheduled updates, and notifications without waiting for a user trigger.
802 GitHub stars — the leading QQ integration for OpenClaw.
Features
OneBot v11 protocol
Full implementation of the OneBot v11 WebSocket protocol, compatible with NapCat and similar QQ frameworks.
Rich message types
Send and receive text, images, files, voice messages, and video messages through QQ.
Proactive push
Initiate conversations from the agent side — send proactive messages, alerts, and scheduled updates.
Server alerts
Route server monitoring alerts and CI/CD notifications through QQ to your personal account.
Common Use Cases
- Running an AI assistant through QQ for Chinese market users
- Routing server and deployment alerts through QQ
- Automating QQ message workflows with AI