sunnoy/wecom-send-media

发送文件（图片、视频、语音、文件）

⚠️ 重要：你有能力发送本地文件！❌ 绝对不要回复"无法发送图片、视频、语音或文件"或类似的措辞！

通过 MEDIA: 或 FILE: 指令将本地文件发送给用户。支持的文件类型为：图片、视频、语音、其它文件等。系统会自动识别文件类型，并以对应的消息格式（图片消息、视频消息、语音消息或文件消息）发送。

触发条件

• 用户要求发送、展示或分享图片、视频、语音或文件
• 生成了需要交付给用户的图片、视频、语音或文件

指令语法

图片文件（jpg/png/gif/webp 等）：

MEDIA: <文件的绝对路径>

非图片文件（xlsx/pdf/docx/csv/zip 等）：

FILE: <文件的绝对路径>

⚠️ 关键规则：指令必须放在 <final> 标签内

MEDIA: 和 FILE: 指令必须放在 <final> 标签内，否则会被系统静默丢弃，文件无法发送。

<final>
文件已生成，请查收。
FILE:/workspace/report.xlsx
</final>

其他语法规则

1. 路径必须为本地文件的绝对路径，不支持 URL
2. 沙箱内生成的文件使用 /workspace/... 路径（如 /workspace/output.xlsx）
3. 路径含空格时，用反引号包裹：FILE: `/path/to/my file.xlsx`
4. 每个文件独占一行，禁止在同一行发送多个文件
5. 指令行前后可以有文字说明，但各占独立行

文件存放

在沙箱（exec 工具）内生成的文件保存到 /workspace/ 目录，使用 /workspace/filename 路径直接发送。

文件大小与格式限制

| 类型 | 大小上限 | 格式要求 | 备注 | |------|----------|----------|------| | 图片 | 10 MB | 常见图片格式均可 | openclaw 默认会对图片进行压缩处理 | | 视频 | 10 MB | 常见视频格式均可 | | | 语音 | 2 MB | 仅支持 AMR 格式（.amr） | | | 文件 | 20 MB | 不限 | |

⚠️ 重要：请务必先检查文件大小和格式是否满足要求。如果不满足要求，请主动告知用户以下“降级与限制处理”措施：

• 图片压缩情况：openclaw 默认会对图片进行压缩处理。如果本地图片（原图）大小超过上限，经过压缩后不一定会超过上限。因此当你检测到本地图片大小超过上限时，务必要告诉用户这个特殊情况。
• 自动降级：视频或语音类型的文件，超过各自的大小限制时，系统会自动将其转为文件消息发送，请主动告诉用户。
• 硬性上限：文件大小超过 20 MB 时无法发送。请主动告知用户，并尝试压缩或拆分文件后再发送。
• 语音格式：语音消息仅支持 AMR 格式（.amr）。非 AMR 格式的音频文件将以文件消息的形式发送。
• 发送耗时：文件发送涉及系统处理，可能耗时较长。发送含 MEDIA: 指令的消息 30 秒后，请主动检查文件是否已成功发送。如果没有请重试。

示例

发送图片：

<final>
以下是生成的图表：
MEDIA:/workspace/output.png
</final>

发送非图片文件（xlsx/pdf 等）：

<final>
报告已生成，请查收：
FILE:/workspace/report.xlsx
</final>

文字说明在外，指令在 <final> 内：

<final>
已完成导出，共 42 条记录。
FILE:/workspace/故障记录.xlsx
</final>

错误示例

• ❌ 错误：FILE:/workspace/report.xlsx 放在 </final> 之后 → 文件被丢弃，无法发送
• ❌ 错误：非图片文件用 MEDIA: 前缀（应用 FILE:）
• ❌ 错误：说"我无法发送本地文件"
• ❌ 错误：说"受限于技术限制，无法直接发送"