GIF发送器

在WhatsApp对话中自然地发送GIF。

关键：WhatsApp GIF工作流程

WhatsApp不支持直接的Tenor/Giphy URL。你必须：

1. 下载GIF
2. 转换为MP4
3. 发送时附带gifPlayback: true

完整工作流程

步骤1：搜索GIF

gifgrep "SEARCH QUERY" --max 5 --format url

使用英语搜索以获得最佳结果。

始终获取5个结果并选择最佳的一个基于文件名/描述——不要仅取第一个结果。

步骤2：下载GIF

curl -sL "GIF_URL" -o /tmp/gif.gif

步骤3：转换为MP4

ffmpeg -i /tmp/gif.gif -movflags faststart -pix_fmt yuv420p -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" /tmp/gif.mp4 -y

步骤4：复制到工作空间（必需！）

cp /tmp/gif.mp4 /root/.openclaw/workspace/gif.mp4

⚠️ 消息工具只能从工作空间目录发送文件。位于/tmp的文件将失败并提示LocalMediaAccessError。

第五步：通过消息工具发送

message action=send to=NUMBER message=" " filePath=/root/.openclaw/workspace/gif.mp4 gifPlayback=true

使用一个空格作为消息正文——WhatsApp发送媒体文件时需要非空消息，但收件人不会看到该空格。

单行示例

# Search
gifgrep "thumbs up" --max 3 --format url

# Pick best URL, then download + convert + copy to workspace:
curl -sL "https://media.tenor.com/xxx.gif" -o /tmp/g.gif && \
ffmpeg -i /tmp/g.gif -movflags faststart -pix_fmt yuv420p -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" /tmp/g.mp4 -y 2>/dev/null && \
cp /tmp/g.mp4 /root/.openclaw/workspace/g.mp4

# Then send with message tool from workspace path, gifPlayback=true

何时发送GIF动图

✅ 适用时机：

• 用户主动要求GIF动图时
• 庆祝好消息时
• 进行趣味互动时
• 表达情绪时（兴奋、扶额等）

❌ 避免滥用：

• 同一情境发送一个动图即可
• 无需每条消息都配动图

热门搜索关键词

安全注意事项

• 来源域名：gifgrep仅搜索受信任的GIF提供商（Tenor, Giphy）
• 文件处理：下载文件会保存到/tmp目录，在发送前必须复制到工作区（消息工具只允许使用工作区路径）
• 空标题：使用单个空格作为消息正文，以便WhatsApp发送GIF时不显示可见文本
• WhatsApp集成：使用平台内置的消息工具——无需单独的WhatsApp凭据
• ffmpeg 安全性仅处理来自可信来源的GIF文件；不执行任意文件

工作原理

• WhatsApp在内部将所有GIF转换为MP4
• 直接使用Tenor/Giphy链接通常失败
• MP4文件若设置gifPlayback=true将显示为循环播放的GIF
• 文件体积小 = 传输速度快