A high-performance QQ bot integration for OpenClaw that enables AI-driven automated replies in private and group conversations.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openqq
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 openqq 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 OpenQQ Bot?
OpenQQ is a specialized integration designed to bridge OpenClaw with the QQ messaging ecosystem. It allows developers to deploy AI agents that can respond to private messages and group @mentions with high reliability and session-specific context. By leveraging the Openclaw Skills framework, this tool provides a robust foundation for building automated communication workflows on one of the world's most popular messaging platforms.
The integration handles the complexities of the QQ Open Platform API, including WebSocket connections and message formatting, allowing users to focus on the intelligence of their agents rather than the underlying transport layer. It ensures that every interaction is captured, logged, and processed with session isolation to maintain privacy and context accuracy.
OpenQQ Bot Use Cases
- Automated customer support within QQ private chats to answer frequently asked questions.
- AI-powered group moderators and assistants for QQ communities to manage discussions.
- Integrating Openclaw Skills into mobile messaging workflows for real-time task management and notifications.
- Building secure, logged AI interactions with external users on the QQ Open Platform.
How OpenQQ Bot Works
- The bot establishes a secure WebSocket connection to the QQ Open Platform using the provided AppID and Token.
- Incoming messages from private chats or group @mentions are captured in real-time by the bot engine.
- The system maps each interaction to a unique session ID (e.g., qq-private-openid) to maintain conversation history isolation.
- The message content is forwarded to the OpenClaw agent, which processes the input and generates an intelligent AI response.
- The generated response is sent back to the QQ platform with a built-in retry mechanism to ensure delivery success.
OpenQQ Bot Setup
# Initialize the configuration file and directory structure
npm run setup
# Install the required Node.js dependencies
npm install
# Configure your credentials (appId, token, appSecret) from the QQ Open Platform
vim ~/.openclaw/workspace/open-qq-config.json
# Start the bot integration
npm start
OpenQQ Bot Data Schema & Taxonomy
| Component | Details |
|---|---|
| Session ID Logic | Private: qq-private-{user_openid} |
| Logging System | Daily rotation, China timezone support, and sensitive data filtering |
| Configuration | JSON-based storage at ~/.openclaw/workspace/open-qq-config.json |
| Security | Whitelisted alphanumeric session IDs and spawn-based command execution |
OpenQQ Bot Advanced Features
- Automated WebSocket heartbeat monitoring and auto-reconnect logic for maximum uptime.
- Graceful shutdown handling for SIGTERM and SIGINT signals to prevent data loss.
- Comprehensive health check and status monitoring scripts specifically optimized for Openclaw Skills deployments.
- Advanced message delivery retry mechanism that automatically attempts to resend failed messages up to 2 times.
- Isolated logging per day with automatic rotation to manage storage efficiently.
SKILL.md
Loading
Related Openclaw Skills
DingTalk API Skill
A comprehensive integration for the DingTalk Open Platform that enables automated messaging, organizational management, and real-time event processing.
Cord Sentinel
A robust constitutional enforcement engine designed to govern AI agent tool calls through a strict 11-article security framework.
Labradoc CLI Skill
A powerful interface for managing Labradoc document intelligence, tasks, and file operations directly via the CLI.
Bring! Shopping List
A high-performance AI agent skill for managing Bring! shopping lists through natural language commands and automated synchronization.
WA-Relay
A secure WhatsApp relay and firewall that prevents AI agents from directly interacting with third parties without owner consent.
Brave Image Search
A streamlined tool for AI agents to search, filter, and display images, photos, and thumbnails using the privacy-focused Brave Search API.
Featured*
