qqbot-media

Route QQBot media files by extension using the <qqmedia> tag.

Updated Apr 7, 2026

Search Tags:#automation #communication #media #chatbot #tag #qqbot #rich-media

Ready to run

npx skills add https://github.com/Luzzer/Kraken --skill qqbot-media-luzzer

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: qqbot-media
Source: https://github.com/Luzzer/Kraken/tree/main/extensions/qqbot/skills/qqbot-media
Command: npx skills add https://github.com/Luzzer/Kraken --skill qqbot-media-luzzer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

QQBot 的富媒体收发在没有统一标签和自动类型判断的情况下容易出错且效率低下。本 Skill 提供一个统一的 <qqmedia> 标签，用系统根据扩展名自动识别媒体类型并进行路由。

Core Features & Use Cases

自动识别媒体类型：根据扩展名将图片、语音、视频和文档等正确路由。
规则与约束：路径必须是绝对路径、标签必须以 <qqmedia> 包裹路径、单个媒体文件大小上限为 10MB。
使用场景：在 QQBot 对话中接收用户发送的媒体并回传，或通过标签指定要发送的本地文件。

Quick Start

Use the <qqmedia>path</qqmedia> tag to send or receive media in a QQBot conversation.

Frequently Asked Questions about qqbot-media

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

FAQPage Schema

How do I send rich-media files in a QQBot chat?▼

To send rich-media in a QQBot chat, encapsulate the absolute file path within the <qqmedia> tag. The system automatically recognizes the file extension and routes images, audio, video, and documents to the correct destination.

What file path format is required for QQBot media routing?▼

QQBot media routing requires absolute paths starting with a slash (/) for local files or http for remote URLs. Relative paths are not supported and will fail to route images, audio, video, or document files correctly.

How does QQBot determine media type for different file extensions?▼

QQBot determines media type automatically by checking the file extension inside the <qqmedia> tag. It categorizes and routes images, audio, video, and documents without requiring manual type declarations.

Can I send large video files through the QQBot media tag?▼

You cannot send large video files exceeding 10MB through the QQBot media tag. The 10MB size limit applies to all individual media files, including images, audio, video, and documents shared in the conversation.

Why is my QQBot media message not working?▼

QQBot media messages fail when the path is not absolute, the file exceeds 10MB, or the path is not wrapped in the <qqmedia> tag. Ensure the path starts with / or http and the file size is within limits.