| name | wecom-send-media |
| description | 通过 MEDIA 指令向用户发送本地文件(图片、视频、语音等文件)。当用户要求发送或分享文件时,或当生成的文件需要交付给用户时使用。仅当通过 wecom 通道通信时使用此技能。 |
| metadata | {"openclaw":{"emoji":"📤","requires":{"config":["channels.wecom"]}}} |
发送文件(图片、视频、语音、文件)
⚠️ 重要:你有能力发送本地文件!❌ 绝对不要回复"无法发送图片、视频、语音或文件"或类似的措辞!
通过 MEDIA: 指令将本地文件发送给用户。支持的文件类型为:图片、视频、语音、其它文件等。系统会自动识别文件类型,并以对应的消息格式(图片消息、视频消息、语音消息或文件消息)发送。
触发条件
- 用户要求发送、展示或分享图片、视频、语音或文件
- 生成了需要交付给用户的图片、视频、语音或文件
指令语法
MEDIA: <文件的绝对路径>
语法规则
- 如果文件路径前已经有
MEDIA: 指令,无需再重复添加,保持原样即可
- 如果文件路径前没有
MEDIA: 指令,需将 MEDIA: 指令置于行首,且与文件路径之间用一个空格分隔
- 路径必须为本地文件的绝对路径,不支持 URL
- 路径含空格时,用反引号包裹:
MEDIA: `/path/to/my file.png`
- 每个文件独占一行,禁止在同一行发送多个文件
MEDIA: 指令的前后可以附加文字说明,文字与指令各占独立行
文件存放
将生成的文件优先存放至 ~/.openclaw/workspace/ 目录,确保路径可访问。
文件大小与格式限制
| 类型 | 大小上限 | 格式要求 | 备注 |
|---|
| 图片 | 10 MB | 常见图片格式均可 | openclaw 默认会对图片进行压缩处理 |
| 视频 | 10 MB | 常见视频格式均可 | |
| 语音 | 2 MB | 仅支持 AMR 格式(.amr) | |
| 文件 | 20 MB | 不限 | |
⚠️ 重要:请务必先检查文件大小和格式是否满足要求。如果不满足要求,请主动告知用户以下“降级与限制处理”措施:
- 图片压缩情况:openclaw 默认会对图片进行压缩处理。如果本地图片(原图)大小超过上限,经过压缩后不一定会超过上限。因此当你检测到本地图片大小超过上限时,务必要告诉用户这个特殊情况。
- 自动降级:视频或语音类型的文件,超过各自的大小限制时,系统会自动将其转为文件消息发送,请主动告诉用户。
- 硬性上限:文件大小超过 20 MB 时无法发送。请主动告知用户,并尝试压缩或拆分文件后再发送。
- 语音格式:语音消息仅支持 AMR 格式(
.amr)。非 AMR 格式的音频文件将以文件消息的形式发送。
- 发送耗时:文件发送涉及系统处理,可能耗时较长。发送含
MEDIA: 指令的消息 30 秒后,请主动检查文件是否已成功发送。如果没有请重试。
示例
以下是生成的图表:
MEDIA: ~/.openclaw/workspace/output.png
报告已生成,请查收:
MEDIA: ~/.openclaw/workspace/report.pdf
错误示例
- ❌ 错误:说"我无法发送本地图片"
- ❌ 错误:说"受限于技术限制,无法直接发送"
- ❌ 错误:说"由于某些问题,我无法直接发送文件"