qqbot-media

Route QQ media messages by file extension with <qqmedia> tagged paths.

1|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/karaabd23-crypto/openclaw --skill qqbot-media-karaabd23-crypto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qqbot-media
Source: https://github.com/karaabd23-crypto/openclaw/tree/main/extensions/qqbot/skills/qqbot-media
Command: npx skills add https://github.com/karaabd23-crypto/openclaw --skill qqbot-media-karaabd23-crypto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

QQBot users often need to share and receive rich-media content (images, audio, video, files). This Skill enables seamless handling by routing media based on file extensions and enabling tagged paths to trigger appropriate delivery and storage.

Core Features & Use Cases

  • Auto-detect media type by extension (images, audio, video, files) and route accordingly.
  • Receive media uploads to local context with path references in messages (e.g., using <qqmedia>path</qqmedia>).
  • Enforce media rules: absolute paths, mandatory <qqmedia> tag wrapper, 10MB size limit, and optional speech-to-text for audio when available.

Quick Start

Seamlessly send a media file by wrapping its absolute path in <qqmedia>path</qqmedia>.

Frequently Asked Questions about qqbot-media

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send images or files through a QQ chatbot?

To send images or files through a QQ chatbot, wrap the absolute path of your media file in a <qqmedia> tag. The system automatically detects the media type by file extension and routes the image, audio, video, or file accordingly.

What are the requirements for routing rich-media attachments in QQ messages?

Routing rich-media attachments in QQ messages requires using absolute file paths, wrapping paths in a mandatory <qqmedia> tag, and keeping file sizes under a 10MB cap. The system uses file extensions to identify and route images, audio, video, and files.

Can I use speech-to-text for audio messages received in QQ groups?

Yes, you can apply optional speech-to-text integration for audio messages received in QQ groups and DMs. When supported, the system processes received audio uploads and can convert speech to text alongside routing the media.

How do I handle media uploads downloaded from QQ chat contexts?

Received media uploads are automatically downloaded to your local context with path references in messages. These local paths are then wrapped in <qqmedia> tags to trigger appropriate delivery, storage, and routing for images, audio, video, and files.

Why does my QQ media message fail to deliver when using relative paths?

QQ media message delivery fails with relative paths because the system enforces absolute paths as a mandatory constraint. You must provide the complete absolute file path within the <qqmedia> tag wrapper and ensure the file size does not exceed the 10MB limit.