QQBot Media Sender
一键发送图片、视频、文件到 QQ 聊天窗口，支持批量发送和自动压缩。
功能特性
- ✅ 图片发送：支持 jpg, png, gif, webp 等格式
- ✅ 视频发送：支持 mp4, avi, mov 等格式
- ✅ 文件发送：支持 pdf, docx, xlsx, zip 等格式
- ✅ 批量发送：一次发送多个文件
- ✅ 自动压缩：大文件自动压缩（可选）
- ✅ 进度显示：实时显示发送进度
使用方法
发送单张图片
# 使用标签直接发送
<qqimg>/path/to/image.jpg</qqimg>
发送单个文件
# 使用标签直接发送
<qqfile>/path/to/document.pdf</qqfile>
批量发送
# 发送目录下所有图片
qqbot-send-media /path/to/images/ --type image
# 发送指定文件列表
qqbot-send-media file1.pdf file2.pdf file3.pdf
# 发送到指定 QQ 群
qqbot-send-media /path/to/file.jpg --group 843812FF4BA524086B77B60886C38AB3
命令行参数
| 参数 | 说明 | 默认值 |
|---|---|---|
--type |
文件类型：image, video, file, auto | auto |
--group |
目标 QQ 群号 | 私聊 |
--compress |
是否压缩大文件 | false |
--max-size |
最大文件大小 (MB) | 20 |
--delay |
发送间隔 (ms) | 1000 |
示例
示例 1: 发送工作区所有 PDF
qqbot-send-media ~/.openclaw/workspace/*.pdf --type file
示例 2: 发送图片到指定群组
qqbot-send-media /tmp/screenshot.png --group 843812FF4BA524086B77B60886C38AB3
示例 3: 批量发送并压缩
qqbot-send-media /photos/ --type image --compress --max-size 10
自动压缩规则
- 图片 > 5MB: 自动压缩到 80% 质量
- 视频 > 10MB: 提示并建议压缩
- 文件 > 20MB: 自动分割或拒绝
支持的文件格式
图片
- ✅ JPG/JPEG
- ✅ PNG
- ✅ GIF
- ✅ WebP
- ✅ BMP
视频
- ✅ MP4
- ✅ AVI
- ✅ MOV
- ✅ WMV
文档
- ✅ DOC/DOCX
- ✅ XLS/XLSX
- ✅ PPT/PPTX
- ✅ TXT
- ✅ ZIP
故障排除
问题：发送失败
解决方案：
- 检查文件路径是否正确
- 检查文件大小是否超过 20MB
- 检查 QQBot 服务是否运行
问题：图片无法显示
解决方案：
- 确保使用
<qqimg>标签 - 检查文件扩展名是否正确
- 尝试转换为 JPG 格式
技术细节
标签格式
<qqimg>路径</qqimg> - 图片
<qqvideo>路径</qqvideo> - 视频
<qqfile>路径</qqfile> - 文件
<qqvoice>路径</qqvoice> - 语音
API 调用
// 内部调用示例
const payload = {
type: 'media',
mediaType: 'image',
source: 'file',
path: '/absolute/path/to/file.jpg'
};
许可证
MIT