qqbot-media

Route and send QQ media by recognizing file extensions from <qqmedia> tags.

Updated Jan 31, 2026
One-click install
npx skills add https://github.com/zyj18860969891-byte/openclaw-railway --skill qqbot-media-zyj18860969891-byte
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qqbot-media
Source: https://github.com/zyj18860969891-byte/openclaw-railway/tree/main/extensions/qqbot/skills/qqbot-media
Command: npx skills add https://github.com/zyj18860969891-byte/openclaw-railway --skill qqbot-media-zyj18860969891-byte

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

QQBot needs to efficiently exchange rich media in chats by automatically classifying and routing content based on file extensions.

Core Features & Use Cases

  • Automatic media type routing from extensions: .jpg/.png/.gif/.webp/.bmp -> images; .silk/.wav/.mp3/.ogg/.aac/.flac -> audio; .mp4/.mov/.avi/.mkv/.webm -> video; others -> files; no-extension URLs default to image.
  • Tag-based workflow using <qqmedia> to reference a local path or URL.
  • Receives media from users and can echo or forward media with appropriate handling; if STT is available, can transcribe audio.

Quick Start

Use the <qqmedia>path</qqmedia> tag with an absolute URL or file path to route and send media.

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 and audio through a QQ chatbot using file extensions?

To send images and audio through a QQ chatbot, use the <qqmedia> tag with an absolute local path or URL, and the system automatically routes the media based on its file extension. It classifies formats like .jpg, .mp3, and .mp4 into images, audio, and video respectively.

What file types are supported for automatic media routing in QQBot?

Automatic media routing in QQBot supports common image formats like .jpg, .png, and .gif, audio formats like .silk, .wav, and .mp3, and video formats like .mp4, .mov, and .mkv. Any unrecognized extension is treated as a standard file.

How do I use the qqmedia tag to send local files in a QQ chat?

To send local files in a QQ chat, wrap the absolute file path or URL inside the <qqmedia> tag. The chatbot processes this tag to automatically classify and send the referenced media content.

Are there file size limits or path requirements for sending QQ media?

Yes, sending QQ media requires using absolute paths for local files and enforces a strict 10MB size limit. These constraints ensure the media routing remains self-contained and safe during chat interactions.

What happens if I send a URL with no file extension to the QQ chatbot?

When you send a URL with no file extension to the QQ chatbot, the system defaults to treating it as an image. This allows seamless image sharing even when the URL lacks a specific extension like .jpg or .png.

Can the QQ chatbot transcribe audio files received from users?

Yes, the QQ chatbot can transcribe received audio files if Speech-to-Text (STT) capabilities are available. It handles incoming media and applies appropriate processing like transcription for audio content.