openqqQQ bot integration for OpenClaw with session isolation, logging, and AI auto-reply. Supports private chat and group @messages.
Install via ClawdBot CLI:
clawdbot install Zaohon/openqqQQ bot integration for OpenClaw. Enables AI auto-reply for QQ private chats and group @mentions with session isolation and comprehensive logging.
# Initialize config
npm run setup
# Install dependencies
npm install
# Edit config
vim ~/.openclaw/workspace/open-qq-config.json
# Start bot
npm startEdit ~/.openclaw/workspace/open-qq-config.json:
{
"qq": {
"appId": "YOUR_APP_ID",
"token": "YOUR_TOKEN",
"appSecret": "YOUR_APP_SECRET"
}
}Get credentials from QQ Open Platform.
npm start # Start bot
npm run health # Health check
npm run logs # View today's logs
npm run status # Check running statusqq-private-{user_openid}qq-group-{group_openid}| File | Description |
|------|-------------|
| qq-bot.js | Main program (WebSocket + OpenClaw integration) |
| logger.js | Logging system (China timezone + rotation) |
| scripts/health-check.sh | Health check script |
| package.json | Dependencies (axios, ws) |
| Command | Description |
|---------|-------------|
| npm start | Start bot |
| npm run health | Health check |
| npm run logs | View logs |
| npm run setup | Initialize config |
| npm run status | Check status |
| npm run clean | Clean node_modules |
open-qq-config.json to version controlchmod 600 ~/.openclaw/workspace/open-qq-config.jsonspawn instead of exec to prevent command injection| Issue | Solution |
|-------|----------|
| Config not found | Run npm run setup |
| Missing credentials | Edit config file with appId/token/appSecret |
| WebSocket failed | Check Token and network |
| No reply | Test with openclaw agent --message "test" |
See CHANGELOG.md
MIT License
Generated Feb 26, 2026
This skill enables businesses to automate responses to customer inquiries on QQ, a popular messaging platform in China. It can handle private chats and group mentions, providing 24/7 support with session isolation to maintain context for each user. This reduces response times and frees up human agents for complex issues.
Gaming companies can use this bot to engage with players in QQ groups, answering FAQs about game updates, events, or technical issues. The auto-reply feature ensures timely interactions, while logging helps monitor community sentiment and common questions for future improvements.
Educational institutions or online learning platforms can deploy this bot to answer student questions in QQ study groups. It provides instant responses to common queries about schedules, assignments, or resources, with session isolation ensuring personalized help for different groups or courses.
Organizations can integrate this bot into internal QQ groups for team communication, automating reminders for meetings, deadlines, or policy updates. The logging feature tracks interactions for accountability, and session isolation allows separate conversations for different departments or projects.
Event organizers can use the bot to promote events and handle registrations via QQ, sending automated replies with details, schedules, and links. It manages inquiries in private chats and group discussions, with retry mechanisms ensuring reliable message delivery to participants.
Offer this bot as a SaaS solution where businesses pay a monthly or annual fee for access to the QQ integration, including features like auto-reply, logging, and support. Revenue is generated through tiered pricing based on usage volume, such as number of messages or active users.
Provide a free basic version with limited functionality, such as basic auto-reply and logging, to attract small businesses or individual users. Charge for premium features like advanced analytics, custom session management, or priority support to upsell to larger enterprises.
Generate revenue by offering custom development services to tailor the bot for specific client needs, such as integrating with existing CRM systems or adding specialized AI models. This includes one-time setup fees and ongoing maintenance contracts for technical support and updates.
💬 Integration Tip
Ensure proper configuration of QQ credentials from the Open Platform and test with the health check command before deployment to avoid connectivity issues.
Transform AI agents from task-followers into proactive partners that anticipate needs and continuously improve. Now with WAL Protocol, Working Buffer, Autonomous Crons, and battle-tested patterns. Part of the Hal Stack 🦞
Use the ClawdHub CLI to search, install, update, and publish agent skills from clawdhub.com. Use when you need to fetch new skills on the fly, sync installed skills to latest or a specific version, or publish new/updated skill folders with the npm-installed clawdhub CLI.
Clawdbot documentation expert with decision tree navigation, search scripts, doc fetching, version tracking, and config snippets for all Clawdbot features
Interact with Moltbook social network for AI agents. Post, reply, browse, and analyze engagement. Use when the user wants to engage with Moltbook, check their feed, reply to posts, or track their activity on the agent social network.
OpenClaw CLI wrapper — gateway, channels, models, agents, nodes, browser, memory, security, automation.
MoltGuard — runtime security plugin for OpenClaw agents by OpenGuardrails. Helps users install, register, activate, and check the status of MoltGuard. Use wh...