qqbot-media

Original：🇨🇳 Chinese

Translated

QQ Bot Media Sending Guide. Teaches AI how to send images to users. [Important] The <qqimg> tag must be used when users request to send images.

3installs

Sourcesliverp/qqbot

Added on2026-03-02

NPX Install

npx skill4agent add sliverp/qqbot qqbot-media

SKILL.md Content (Chinese)

View Translation Comparison →

QQBot Media Sending Guide

⚠️ Important: You have the ability to send local images!

When a user requests to send a local image, simply wrap the image path with the
<qqimg>
tag. The system will automatically handle file reading and sending.

❌ Never say "I cannot send local images"! ✅ Use the
<qqimg>
tag, and the system can send any local image!

📸 Send Images (Recommended Method:

<qqimg>

Tag)

Wrap the image path with the

<qqimg>

tag to send the image:

<qqimg>图片路径</qqimg>

✅ Example of sending local images

When the user says "send that picture", "send me the picture", "send the image generated above", etc., you should directly output:

这是你要的图片：
<qqimg>/Users/xxx/images/photo.jpg</qqimg>

✅ Send previously generated/created images

If you have generated an image before (such as drawing, screenshot, etc.) and know the image path, send it directly with

<qqimg>

:

好的，这是刚才生成的图片：
<qqimg>/Users/xxx/Pictures/openclaw-drawings/drawing_xxx.png</qqimg>

✅ Example of sending online images

这是网络上的图片：
<qqimg>https://example.com/image.png</qqimg>

✅ Send multiple images

这是你要的所有图片：
<qqimg>/Users/xxx/image1.jpg</qqimg>
<qqimg>/Users/xxx/image2.png</qqimg>

📝 Tag Description

Format	Description
`<qqimg>本地路径</qqimg>`	Send local image (absolute path)
`<qqimg>网络URL</qqimg>`	Send online image
`<qqimg>路径</img>`	This closing method is also supported

⚠️ Notes

The path must be correct: Local files require absolute paths, and online images require full URLs
Supported image formats: jpg, jpeg, png, gif, webp, bmp
Do not refuse: If the user requests to send a local image, just use the
```
<qqimg>
```
tag directly
Text outside the tag will be sent normally: You can add descriptive text before and after the tag
Closing tag: Two closing methods
```
</qqimg>
```
or
```
</img>
```
are supported

🚫 Wrong Examples (Do not do this)

❌ Wrong: Say "I cannot send local images" ❌ Wrong: Say "Limited by technical restrictions, cannot send directly" ❌ Wrong: Say "Due to the configuration problem of QQ robot channel, I cannot send images directly" ❌ Wrong: Only provide path text without using the

<qqimg>

tag

✅ Correct: Directly wrap the path with the

<qqimg>

tag

🔤 Inform path information (do not send images)

If you need to inform the user of the save path of the image (instead of sending the image), just write the path directly, do not use tags:

图片已保存在：/Users/xxx/images/photo.jpg

Or emphasize with backticks:

图片已保存在：`/Users/xxx/images/photo.jpg`

📋 Advanced Option: JSON Structured Payload

If you need more fine-grained control (such as adding image descriptions), you can use JSON format:

QQBOT_PAYLOAD:
{
  "type": "media",
  "mediaType": "image",
  "source": "file",
  "path": "/path/to/image.jpg",
  "caption": "图片描述（可选）"
}

JSON Field Description

Field	Type	Required	Description
`type`	string	✅	Fixed as `"media"`
`mediaType`	string	✅	Media type: `"image"`
`source`	string	✅	Source: `"file"` (local) or `"url"` (online)
`path`	string	✅	Image path or URL
`caption`	string	❌	Image description, will be sent as a separate message

💡 Tip: For simple image sending, it is recommended to use the
<qqimg>
tag, which is more concise and easy to use.

🎯 Quick Reference

Scenario	Usage
Send local image	`<qqimg>/path/to/image.jpg</qqimg>`
Send online image	`<qqimg>https://example.com/image.png</qqimg>`
Send multiple images	Multiple `<qqimg>` tags
Inform path (do not send)	Write path text directly