QQBot Connect for Openclaw

A powerful messaging skill for sending automated text, images, and files to QQ users and groups.

jcduann
v1.0.0
Apr 4, 2026
1
1.7k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install qq-bot-connect

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install qq-bot-connect 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 QQBot Connect?

QQBot Connect is a specialized communication tool designed for the Openclaw Skills ecosystem. It enables AI agents to actively push messages to QQ, supporting both private (C2C) and group interactions. This skill acts as a bridge between your automated workflows and the QQ messaging platform, allowing for the delivery of text notifications and rich media content.

By using this skill, developers can create sophisticated bots that not only reply to queries but also proactively update users with essential data. Whether you are building a notification system for a home lab or a professional alert tool, QQBot Connect provides the necessary infrastructure to interact with the QQ API through a simplified interface.

QQBot Connect Use Cases

  • Sending real-time automated alerts and status updates to a QQ private chat.
  • Distributing media files, such as generated reports or images, to specific QQ groups.
  • Creating proactive notification bots for system monitoring and log summaries.
  • Streamlining team communication by pushing AI-generated content directly into QQ workgroups.

How QQBot Connect Works

  1. The user provides a command such as "Push the latest report to QQ."
  2. The skill accesses the local config.json to retrieve the target OpenID or group ID.
  3. It formats the destination string using the qqbot:c2c: or qqbot:group: prefix.
  4. If media is involved, the skill wraps the file path in <qqmedia> tags for processing.
  5. The skill executes the message action via the Openclaw Skills messaging tool and confirms delivery status.

QQBot Connect Setup

To begin using QQBot Connect, you must configure your unique OpenID in the settings file. Locate your configuration at ~/.qclaw/skills/qqbot-connect/config.json.

# Navigate to your skill configuration directory
cd ~/.qclaw/skills/qqbot-connect/

# Edit the config.json with your specific credentials
# Update the 'openid' field with the ID found in your OpenClaw Control UI

Ensure the JSON structure matches the following:

{
  "default": {
    "openid": "YOUR_OPENID_HERE",
    "type": "c2c",
    "name": "Admin"
  }
}

QQBot Connect Data Schema & Taxonomy

The skill organizes communication targets and media handling using a strict schema to ensure compatibility with Openclaw Skills.

Component Format Description
Private Target qqbot:c2c:{openid} Identifier for private message delivery.
Group Target qqbot:group:{groupid} Identifier for group message delivery.
Media Wrapper <qqmedia>path/to/file</qqmedia> Tag used to identify local files for upload.
Config File config.json Stores default routing and user aliases.

Supported media extensions include .jpg, .png, .mp3, .silk, .mp4, and .pdf for general files.

QQBot Connect Advanced Features

  • Support for rich media types including high-quality SILK audio and MOV/MP4 video files.
  • Dynamic routing that allows users to specify different targets on-the-fly via natural language.
  • Seamless integration with the OpenClaw Control UI for easy discovery of OpenIDs.
  • Multi-agent compatibility for automated reporting across different bot instances.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*