qqbot-media

Sends and receives images, voice, video, and files through QQBot using qqmedia tags.

1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill qqbot-media-jerome-prakash-l
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qqbot-media
Source: https://github.com/JEROME-PRAKASH-L/openclaw/tree/main/extensions/qqbot/skills/qqbot-media
Command: npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill qqbot-media-jerome-prakash-l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Handling rich media in QQBot conversations requires knowing which attachment types are supported, how to route files by extension, and where files must be stored to pass platform security policies. This Skill provides the exact tag syntax and rules for sending and receiving media without trial and error. ## Core Features & Use Cases - Media Sending: Wrap an absolute path or URL in <qqmedia> tags and the system routes it as image, voice, video, or file based on the file extension. - Media Receiving: Incoming images are downloaded locally with paths exposed in the conversation context, and voice messages can be transcribed when STT is available. - Use Case: After generating a chart image, save it to ~/.openclaw/media/qqbot/ and send it to a QQ contact by writing <qqmedia>/path/to/chart.png</qqmedia> in your reply. ## Quick Start Send the image at ~/.openclaw/media/qqbot/chart.png to the current QQ conversation using the qqmedia tag.

Frequently Asked Questions about qqbot-media

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

FAQPage Schema
How do I send an image or file in a QQBot message?

Wrap the absolute path or URL in opening and closing qqmedia tags, such as <qqmedia>/path/to/image.png</qqmedia>. The system infers the media type from the file extension and routes it as image, voice, video, or file automatically.

How does QQBot media type detection work by file extension?

Extensions like .jpg, .png, .gif, .webp, and .bmp map to images; .silk, .wav, .mp3, .ogg, .aac, and .flac map to voice; .mp4, .mov, .avi, .mkv, and .webm map to video. Other extensions are sent as files, and URLs without extensions default to images.

Why is my QQBot media file blocked from sending?

Files must be stored under a trusted root such as ~/.openclaw/media/qqbot/ before sending. Files placed only in the workspace directory are rejected by the platform security policy, so copy or generate files into the media directory first.

What are the QQBot media file size limits?

Images are limited to 30MB, videos to 100MB, generic files to 100MB, and voice messages to 20MB. Files exceeding these limits cannot be sent through the qqmedia tag.

Can I reply with a received QQ image or voice message?

Yes. Received images are downloaded locally and their paths appear in the conversation context attachments, so you can resend them directly with <qqmedia>path</qqmedia>. Voice paths are also provided and can be transcribed first if STT is enabled.