Gif Whatsapp

功能概述

gif-whatsapp 是专为 WhatsApp 场景设计的 GIF 发送技能，解决 WhatsApp 不支持直接 Tenor/Giphy URL 的核心痛点。通过 gifgrep 搜索受信任的 GIF 源（Tenor、Giphy），再经 ffmpeg 转换为 MP4 格式，最终通过平台内置的 message 工具发送。

核心用法

1. 搜索：gifgrep "QUERY" --max 5 --format url 获取 5 个候选结果
2. 人工精选：根据文件名/描述挑选最佳 GIF，而非盲目取第一个
3. 下载转换：curl 下载 → ffmpeg 转 MP4（yuv420p 编码、尺寸对齐）
4. 强制拷贝：必须复制到 /root/.openclaw/workspace/（message 工具仅允许工作区路径）
5. 发送：message 工具配合 gifPlayback=true，消息体留单空格

显著优点

• 零配置集成：复用平台已配置的 message 工具，无需单独 WhatsApp 认证
• 格式自适应：自动处理 WhatsApp 内部 GIF→MP4 的转换要求
• 源可信：仅搜索 Tenor/Giphy 两大主流平台，降低恶意文件风险
• 轻量化：/tmp 临时存储，发送后自动清理

潜在局限

• 英文搜索优先：非英文查询可能返回结果质量下降
• 单 GIF 限制：文档明确建议同一场景仅发一张，避免过度使用
• 路径硬编码：依赖 /root/.openclaw/workspace 固定路径，可移植性受限
• 人工介入：需人工从 5 个结果中挑选，非全自动

适合人群

• 频繁在 WhatsApp 进行非正式沟通的用户
• 需要快速情绪表达（庆祝、惊讶、尴尬等场景）的社交场景
• 已通过 clawhub 平台配置好 message 工具的用户

常规风险

• 临时文件残留：虽文档称清理，但 ffmpeg/curl 失败时可能残留 /tmp 文件
• 版权模糊：Tenor/Giphy 内容版权归属复杂，商业场景需谨慎
• 路径遍历：若 gifgrep 返回恶意 URL，curl 可能下载非 GIF 文件（但 ffmpeg 仅处理有效 GIF）
• 平台锁定：深度绑定 clawhub 工作区路径，脱离平台即失效

核心功能与用法

gif-whatsapp 是一个专为WhatsApp设计的GIF发送工具，解决了WhatsApp不直接支持Tenor/Giphy链接的技术限制。其核心工作流程为：

1. 搜索GIF：使用 gifgrep 工具从Tenor/Giphy搜索GIF，支持英文关键词，建议获取5个结果后择优选择
2. 下载处理：通过 curl 下载GIF文件至 /tmp 目录
3. 格式转换：使用 ffmpeg 将GIF转换为MP4格式（WhatsApp内部标准格式），包含尺寸对齐、色彩空间优化
4. 工作区复制：必须将文件从 /tmp 复制到 /root/.openclaw/workspace/（message工具仅允许此路径）
5. 消息发送：通过 message 工具发送，设置 gifPlayback: true 实现循环播放效果，消息体使用单个空格避免显示文字

显著优点

• 技术方案成熟：精准解决WhatsApp GIF兼容性问题，MP4+gifPlayback组合确保最佳显示效果
• 依赖可信来源：仅使用Tenor（Google）和Giphy（Meta）两大主流GIF平台，HTTPS加密传输
• 权限最小化：仅申请 exec（系统工具调用）和 message（消息发送）两个必要权限
• 流程文档详尽：提供完整命令示例、常见搜索词对照表、使用场景建议
• 安全设计：临时文件自动清理、工作区隔离、无敏感信息硬编码

潜在局限与风险

| 局限 | 说明 |

|------|------|

| 平台绑定 | 专为WhatsApp设计，其他平台可能需调整 |

| 英文搜索优化 | Tenor/Giphy英文内容更丰富，中文搜索效果可能受限 |

| 多步骤依赖 | 任一环节失败（下载/转换/复制）都会导致整体失败 |

| 版本不一致 | SKILL.md(1.2.0)与_meta.json(1.3.0)版本号未同步 |

| T3来源 | 个人开发者维护，缺乏开源社区背书 |

适合人群

• 频繁在WhatsApp中使用表情包回复的用户
• 客服/社区运营人员需要标准化GIF回复流程
• 希望自动化GIF搜索-发送的技术用户

常规风险

• 外部服务依赖：Tenor/Giphy服务可用性影响功能
• 内容合规：GIF内容由第三方平台提供，需遵守平台内容政策
• 输入验证：建议对用户搜索词进行基础过滤，避免特殊字符注入

安全认证结论

CLS-Certify扫描结果：Grade A（85分），静态/动态/依赖/隐私维度均表现良好，唯一警告项为T3来源可信度。无可执行代码、无敏感数据收集、无隐蔽指令。