Qqbot

What This Skill Does

Qqbot is a specialized OpenClaw AI agent skill that enables seamless integration between your OpenClaw environment and the official QQ Robot platform. This skill acts as a bridge, allowing the AI to listen to incoming events from QQ channels and groups, process natural language queries, and send automated responses back to users. By automating the message handling process, it transforms a standard QQ bot into a highly intelligent assistant capable of participating in complex, multi-turn conversations directly within the QQ ecosystem.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/byzgpc/qqbot. After installation, navigate to the ~/.openclaw/workspace/ directory to configure the provided qq_official_bot.py script with your AppID and AppSecret. Ensure that you have properly configured the IP whitelist in the QQ Developer Console and set up the necessary Intents (GUILDS, GROUP_AND_C2C_EVENT, and AT_MESSAGES) to ensure the agent receives the correct event streams. Finally, trigger the daemon script ~/.openclaw/workspace/qq_bot_daemon.sh start to activate the connection.

Use Cases

This skill is perfect for developers and power users looking to provide AI-driven customer support on QQ, manage automated community groups, or create personalized AI personas for private chat. It can be used to handle frequently asked questions, summarize group discussions, or act as an automated moderation layer that filters content based on customizable AI rules.

Example Prompts

1. "@MyBot, summarize the last 10 messages from this group and highlight the key action items."
2. "@MyBot, please draft a professional reply to the user requesting technical support regarding the 11298 error code."
3. "@MyBot, create a reminder for tomorrow at 10 AM to follow up with the team regarding the server migration status."

Tips & Limitations

• IP Persistence: Since QQ requires a static IP for the whitelist, use a cloud VPS or a static IP tunnel to avoid frequent 11298 errors.
• Intents: If the bot is not responding to messages, double-check that you have enabled all required permissions (GUILDS, GROUP_AND_C2C_EVENT, AT_MESSAGES) in the official QQ console.
• Performance: While the bot can handle high traffic, ensure your OpenClaw AI processor is configured to handle the specific load to prevent response timeouts.
• Security: Always keep your AppSecret secure; never push your configuration file to public repositories.