# Wecom Send Media

> 通过 MEDIA 指令向用户发送本地文件（图片、视频、语音等文件）。当用户要求发送或分享文件时，或当生成的文件需要交付给用户时使用。仅当通过 wecom 通道通信时使用此技能。

- Skill: `wecomteam/wecom-send-media` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wecomteam/wecom-send-media`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wecomteam/wecom-send-media/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wecomteam (https://skillmd.com/u/wecomteam)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wecomteam/wecom-send-media

---


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

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

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

> **职责边界**：这是企业微信 Channel 的**当前会话文件投递能力**。需要把本轮生成或已有的本地文件交付给当前用户时使用 `MEDIA:`；不要调用 `wecom-cli message` 代替本轮回复的文件投递。`wecom-cli message` 适用于向另一个已选定的企微会话主动发送消息，不属于本技能。

## 触发条件

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

## 指令语法

```
MEDIA: <文件的绝对路径>
```

### 语法规则

1. 如果文件路径前已经有 `MEDIA:` 指令，无需再重复添加，保持原样即可
2. 如果文件路径前没有 `MEDIA:` 指令，需将 `MEDIA:` 指令置于行首，且与文件路径之间用一个空格分隔
3. 路径必须为本地文件的**绝对路径**，不支持 URL
4. 路径含空格时，用反引号包裹：`` MEDIA: `/path/to/my file.png` ``
5. 每个文件独占一行，禁止在同一行发送多个文件
6. `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
```

## 错误示例

- ❌ 错误：说"我无法发送本地图片" 
- ❌ 错误：说"受限于技术限制，无法直接发送" 
- ❌ 错误：说"由于某些问题，我无法直接发送文件"