本页描述 WhatsApp 频道（Baileys Web）的媒体处理规则，涵盖发送、Gateway 处理和 Agent 回复。
CLI 发送接口
openclaw message send --media <path-or-url> [--message <caption>]
# --dry-run 打印解析后的 payload
# --json 输出 { channel, to, messageId, mediaUrl, caption }媒体类型处理规则
| 类型 | 处理方式 | 大小上限 |
|---|---|---|
| 图片 | 缩放重压缩为 JPEG（最大边 2048px） | channels.whatsapp.mediaMaxMb（默认 50MB） |
| 音频/语音/视频 | 直通，音频以语音消息发送（ptt: true） | 16MB |
| 文档 | 直通，保留文件名 | 100MB |
GIF 风格播放：发送 MP4 时加 --gif-playback（gifPlayback: true）。
入站媒体到命令（Pi）
入站媒体下载到临时文件后，暴露模板变量：
{{MediaUrl}}— 入站媒体的伪 URL{{MediaPath}}— 写入的本地临时路径
媒体理解（若配置）在模板化前运行，将 [Image]、[Audio]、[Video] 块插入 Body：
- 音频设置
{{Transcript}}，用于 slash 命令解析 - 若主模型原生支持视觉，跳过
[Image]摘要块，直接传原图
大小限制
出站发送上限（WhatsApp）
- 图片：50MB（重压缩后）
- 音频/语音/视频：16MB
- 文档：100MB
媒体理解上限
- 图片：10MB（
tools.media.image.maxBytes） - 音频：20MB（
tools.media.audio.maxBytes） - 视频：50MB（
tools.media.video.maxBytes）
超限媒体跳过理解，但回复仍正常发送。
相关页面
- nodes-camera — 摄像头捕获
- nodes-media-understanding — 媒体理解配置
- nodes-audio — 音频与语音笔记