← Back to Skills Marketplace
5318
Downloads
10
Stars
51
Active Installs
1
Versions
Install in OpenClaw
/install qqbot
Description
配置并管理QQ官方机器人，支持身份认证、IP白名单设置、Webhook/WebSocket连接及OpenClaw AI集成。
Usage Guidance
Review before installing. Replace and rotate any QQ credentials, treat config.example.json as exposed if that secret is real, protect ~/.openclaw/workspace with restrictive permissions, avoid using this in sensitive chats until logging and queue retention are understood, and remove or ignore the ClawHub publishing scripts if you only need the bot.
Capability Analysis
Type: OpenClaw Skill
Name: qqbot
Version: 1.0.0
The skill bundle provides a QQ bot integration for OpenClaw AI. All scripts and documentation are aligned with the stated purpose of setting up, managing, and publishing a QQ bot. The `qq_official_bot.py` interacts with official QQ API endpoints and uses a file-based queue (`~/.openclaw/workspace/qq_queue/`) for inter-process communication with an AI handler (`qq_ai_handler.sh`). The `install.sh` and daemon scripts perform standard system operations within the OpenClaw workspace. Publishing scripts (e.g., `auto-publish.js`, `publish-helper.sh`) use browser automation to interact with `clawhub.com` for skill publication, accessing only the skill package itself. There is no evidence of data exfiltration, unauthorized remote execution, persistence mechanisms beyond the daemon, or malicious prompt injection attempts against the OpenClaw agent in any of the files, including `SKILL.md`.
Capability Assessment
Purpose & Capability
The core QQ bot, daemon, and AI queue are coherent with the advertised QQ/OpenClaw integration, but the package also includes non-core ClawHub publishing automation and a config.example.json with a concrete-looking appId/clientSecret despite documentation claiming secrets were sanitized.
Instruction Scope
Setup instructions tell users to place AppSecret values in JSON and Python files and to inspect logs, but they do not provide strong guidance for secret storage, file permissions, avoiding commits, log redaction, or chat-data retention.
Install Mechanism
install.sh installs expected Python dependencies with pip --user, copies bot scripts into ~/.openclaw/workspace, creates qq_queue, and marks scripts executable; it does not automatically start the daemon.
Credentials
QQ credentials and message access are expected for this bot, but the implementation prints chat content to logs and writes user IDs, usernames, message text, and timestamps into local queue files without explicit access controls or minimization.
Persistence & Privilege
The daemon runs the bot in the background with PID and log files and has stop/status commands; this is expected for a bot, but users should understand it will keep reconnecting and replying until stopped.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install qqbot - After installation, invoke the skill by name or use
/qqbot - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release with comprehensive setup guide for integrating QQ Official Bot with OpenClaw AI.
- Step-by-step instructions for bot creation, IP whitelist configuration, bot deployment, and OpenClaw integration.
- Detailed troubleshooting section covering common errors and their solutions.
- Includes file structure overview, management commands, and debugging tips.
- References to official documentation provided for further guidance.
Metadata
Frequently Asked Questions
What is qqbot?
配置并管理QQ官方机器人，支持身份认证、IP白名单设置、Webhook/WebSocket连接及OpenClaw AI集成。 It is an AI Agent Skill for Claude Code / OpenClaw, with 5318 downloads so far.
How do I install qqbot?
Run "/install qqbot" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is qqbot free?
Yes, qqbot is completely free (open-source). You can download, install and use it at no cost.
Which platforms does qqbot support?
qqbot is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created qqbot?
It is built and maintained by byzgpc (@byzgpc); the current version is v1.0.0.
More Skills