qqbot-media

Parse <qqmedia> tags and route media by file extension for QQBot.

7|12|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/borealBytes/my-farm-advisor --skill qqbot-media-borealbytes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qqbot-media
Source: https://github.com/borealBytes/my-farm-advisor/tree/main/extensions/qqbot/skills/qqbot-media
Command: npx skills add https://github.com/borealBytes/my-farm-advisor --skill qqbot-media-borealbytes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

QQBot users frequently need to send and receive images, audio, video, and files in chat, but require a simple, consistent mechanism to attach media and ensure correct routing.

Core Features & Use Cases

  • Rich media routing: detect media type from file extensions and route to the appropriate handling (image, audio, video, or file).
  • Tag-based sending: use <qqmedia> tags to wrap absolute paths or URLs before sending or receiving media.
  • Safe storage and access: media files are stored under ~/.openclaw/media/qqbot to comply with platform security constraints and ensure reliable access.
  • Use case: a user shares a photo in chat and the bot automatically formats it with the correct media tag for seamless viewing.

Quick Start

Wrap an absolute path in a <qqmedia> tag to send media, e.g., <qqmedia>/abs/path/image.jpg</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 rich media like images and audio in a QQBot chat?

To send rich media in a QQBot chat, wrap an absolute file path or URL in a <qqmedia> tag. The bot parses this tag to format the attachment for seamless viewing.

How does QQBot determine the media type for routing files?

QQBot determines the media type by detecting file extensions and routing the attachment to the appropriate handling for images, audio, video, or files. This ensures correct processing for chat interactions.

Where are received QQBot media files stored locally?

Received QQBot media files are stored securely under the ~/.openclaw/media/qqbot directory. This path validation complies with platform security constraints and ensures reliable access.

Can I use relative file paths when sending media with qqbot-media?

No, you must use absolute paths or URLs when wrapping file locations in <qqmedia> tags. Path validation requires absolute paths to ensure secure local storage and correct media routing.

Does qqbot-media support routing for video and file attachments?

Yes, qqbot-media supports rich media routing for images, audio, video, and files. It infers the media type from the file extension and applies the correct tag-based messaging semantics.