qqbot-media

Detect media type by file extension and route QQBot media via <qqmedia> tags.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

QQBot 的富媒体收发能力在跨对话场景中容易变得繁琐。本 Skill 提供一个统一处理方式,通过 <qqmedia> 标签自动识别媒体类型并将媒体按类型路由到相应的处理流程。

Core Features & Use Cases

  • 自动媒体识别与路由:基于扩展名将图片、语音、视频和其他文件分发到对应的处理逻辑。
  • 接收与发送支持:接收用户发送的媒体并在需要时复用路径回发,保持对话上下文。
  • 使用场景:在 QQBot 对话中,用户发送多媒体内容,Skill 自动识别并按类型处理、转发或存储,确保多媒体通信畅通。

Quick Start

在消息处理中使用 <qqmedia>路径</qqmedia> 包裹媒体路径,系统将自动识别类型并路由。

Frequently Asked Questions about qqbot-media

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

FAQPage Schema
How do I handle QQBot media routing for images, audio, and video in conversations?

QQBot media routing is handled by wrapping absolute file paths in <qqmedia> tags, which auto-detects the media type from the file extension and routes it to the correct processing flow.

Can I use relative paths when sending files through QQBot media messages?

No, sending files through QQBot media messages requires absolute paths. You must provide the full absolute path inside the <qqmedia> tag to ensure the system correctly locates and processes the media.

What is the file size limit for sending images and videos in a QQBot chat?

The file size limit for sending images, videos, audio, or other files in a QQBot chat is 10MB. Media exceeding this limit will not be processed by the routing system.

How to reuse received user-uploaded media to send it back in a QQBot response?

To reuse received user-uploaded media in a QQBot response, retain the original absolute file path and wrap it again in the <qqmedia> tag, maintaining the conversation context while re-sending the media across channels.

Does QQBot media routing support receiving and forwarding all file types?

Yes, QQBot media routing supports receiving and forwarding all file types. It automatically categorizes media into image, audio, video, or general file routes based on the file extension.

Why does my QQBot media message fail to route correctly during cross-channel forwarding?

QQBot media message routing fails if the <qqmedia> tag is missing, the path is not absolute, or the file exceeds the 10MB limit. Ensure correct tag usage and absolute paths for predictable cross-channel behavior.