A comprehensive integration guide for connecting official QQ bots to the OpenClaw AI ecosystem for intelligent chat automation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install qqbot
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install qqbot using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is QQ Official Bot Integration?
This skill enables developers to bridge the official QQ Bot platform with OpenClaw, transforming a standard chat account into a sophisticated AI agent. By utilizing Openclaw Skills, you can automate interactions across private chats, group messages, and QQ Channels. The integration relies on an official API architecture, ensuring stability and compliance with Tencent's developer standards while providing a local workspace for AI processing.
Built for developers who need reliable real-time communication, the skill manages WebSocket connections, maintains heartbeats, and handles complex authentication flows. It serves as a robust foundation for building community management tools, personal assistants, or automated support agents within the QQ ecosystem.
QQ Official Bot Integration Use Cases
- Automating customer service responses in QQ groups using Openclaw Skills.
- Developing interactive AI assistants for private one-on-one QQ conversations.
- Managing community engagement in QQ Channels via automated @mention replies.
- Building custom notification systems that push AI-generated insights directly to QQ users.
How QQ Official Bot Integration Works
- The bot authenticates with the QQ Open Platform using an AppID and AppSecret to obtain a secure access token.
- A persistent WebSocket connection is established to listen for specific events such as C2C messages or group @mentions.
- Incoming messages are filtered based on configured Intents and passed to the OpenClaw workspace.
- Openclaw Skills process the message through a file-based queue system (ai_request_*.json).
- The AI generates a response which is written to a response file (ai_response_*.txt).
- The bot script monitors the queue, retrieves the AI output, and sends the final message back to the QQ user or group.
QQ Official Bot Integration Setup
To get started, register your bot on the QQ Bot platform and then configure your environment:
- Update your
openclaw.jsonto enable the channel:
{
"channels": {
"qq": {
"enabled": true,
"appId": "YOUR_APP_ID",
"appSecret": "YOUR_APP_SECRET"
}
}
}
- Deploy the bot scripts to your workspace:
cp qq_official_bot.py ~/.openclaw/workspace/
- Install necessary dependencies:
pip3 install requests aiohttp websockets --user
- Start the bot daemon:
~/.openclaw/workspace/qq_bot_daemon.sh start
QQ Official Bot Integration Data Schema & Taxonomy
The skill organizes its operations within the ~/.openclaw/workspace/ directory using the following structure:
| File/Directory | Purpose |
|---|---|
qq_official_bot.py |
Main execution logic and WebSocket handler |
qq_queue/ |
Directory for asynchronous message processing |
ai_request_*.json |
Metadata for incoming AI processing requests |
ai_response_*.txt |
Output text generated by the AI model |
qq_bot.log |
Real-time logs for debugging connection and message events |
QQ Official Bot Integration Advanced Features
- Intent Management: Customizable bitmask settings for GUILDS, GROUP_AND_C2C, and AT_MESSAGES.
- IP Whitelist Resilience: Documentation for handling dynamic IP changes common in home broadband setups.
- Daemonized Lifecycle: Background process management via shell scripts for start, stop, and restart operations.
- Decoupled Processing: File-based queueing system allows the AI to process tasks without blocking the main WebSocket heartbeat in Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Kubera Portfolio Manager
A professional-grade tool to query and manage Kubera portfolio data, including net worth, asset allocation, and holdings.
shop-culture
An Agentic Commerce skill for the For the Cult store that enables AI agents to browse products, execute multi-chain payments, and track orders autonomously.
ByteRover Headless Knowledge Management
A powerful CLI-driven knowledge management system designed for headless automation and AI agent context retrieval.
Hugo Blog Agent
A specialized Hugo toolkit designed to build minimalist, high-performance static blogs optimized for seamless consumption by AI agents and crawlers.
Speech to Text (Yandex SpeechKit)
An extensible speech-to-text integration for Openclaw that converts voice messages into accurate text using Yandex SpeechKit and FFmpeg.
Telegram Usage Stats
A utility for tracking and displaying API usage statistics and session quotas directly within Telegram.
Featured*
