qqbot-media

Route absolute paths or HTTP URLs into QQBot image, voice, video, or file messages.

Updated May 4, 2026
One-click install
npx skills add https://github.com/234194027-cpu/xianclaw --skill qqbot-media-234194027-cpu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qqbot-media
Source: https://github.com/234194027-cpu/xianclaw/tree/main/resources/openclaw/config/extensions/openclaw-qqbot/skills/qqbot-media
Command: npx skills add https://github.com/234194027-cpu/xianclaw --skill qqbot-media-234194027-cpu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of chatting with QQBot while needing reliable rich media transfer for images, audio, video, and other files without manually figuring out how to package or route attachments.

Core Features & Use Cases

  • Media type auto-routing: Uses the file extension to automatically decide whether a URL/path is an image, voice, video, or a generic file.
  • Flexible input sources: Supports both absolute local paths and remote URLs; URLs without extensions default to image handling.
  • Context-aware reception: Received image paths are placed into context as attachments for easy reuse in replies, and received voice paths can be transcribed when STT is available.
  • Size guardrails: Enforces QQBot sending limits (Image 30MB, Voice 20MB, Video 100MB, File 100MB) and instructs the assistant to notify the user when oversized.

Quick Start

Use the tag <qqmedia> with an absolute local path or an HTTP URL to send a photo, such as <qqmedia>/Users/xxx/photo.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 images or videos through QQBot using a file path?

To send rich media through QQBot, use the <qqmedia> tag containing an absolute local file path or an HTTP URL, and the system auto-routes the file to the correct media type based on its extension.

How does QQBot handle incoming voice messages and attachments?

QQBot handles incoming voice messages by placing received file paths into context as attachments for reuse, and it can optionally transcribe voice audio to text when speech-to-text capabilities are available.

Can I use an HTTP URL without a file extension to send media in QQBot?

Yes, you can use an HTTP URL without a file extension to send media in QQBot; the system defaults to handling extensionless URLs as image outputs during the routing process.

What are the file size limits for sending video and image files via QQBot?

QQBot enforces specific file size limits for sending media: images up to 30MB, voice files up to 20MB, and video or generic files up to 100MB, notifying users when inputs exceed these limits.

Why does my large file fail to send when chatting with QQBot?

Large files fail to send in QQBot when they exceed the enforced size guardrails, which restrict images to 30MB, voice to 20MB, and video or generic files to 100MB before dispatch.