WhatsApp GIF

来源安全、上下文匹配的 GIF，向 WhatsApp 精准发送唯一一个高质量结果。

工作流

1. 判断 GIF 是否适用。
2. 根据用户意图构建简洁搜索关键词（2–5 个词）。
3. 运行 scripts/find_gif.py 获取并排序候选 GIF。
4. 使用 message 工具将排名最高的结果发送至 WhatsApp（优先采用 local-file 载荷模式）。
5. 若发送失败，则使用次优候选 GIF 重试一次。
6. 若仍失败或无任何结果，则发送简洁的文本兜底响应。

决策规则

优先选用 GIF 的情形：

• 用户明确请求 GIF / meme / 表情反应（reaction）。
• 简短的情绪信号已足以传达意图。
• 对话语气因视觉化响应而更自然、更有效。

应避免使用 GIF 的情形：

• 话题涉及严肃或敏感内容（如医疗、法律、冲突、哀伤等）。
• 群组上下文正式或不明确。
• 用户明确要求仅以纯文本响应。

脚本用法

使用以下确定性辅助脚本：

python3 skills/openclaw-whatsapp-gif/scripts/find_gif.py "congrats celebration" --limit 5 --json
python3 skills/openclaw-whatsapp-gif/scripts/find_gif.py "great job" --limit 3 --json --target "+1234567890"
python3 skills/openclaw-whatsapp-gif/scripts/send_gif.py "+1234567890" "great job celebration" --json
python3 skills/openclaw-whatsapp-gif/scripts/send_gif.py "+1234567890" "great job celebration" --delivery-mode local --json
python3 skills/openclaw-whatsapp-gif/scripts/send_gif.py "+1234567890" "great job celebration" --payload-only

行为说明：

• 读取 TENOR_API_KEY 和/或 GIPHY_API_KEY。
• 应用安全过滤策略（contentfilter=low / rating=g + 黑名单机制）。
• 对网络请求启用重试与退避（retry + backoff）机制。
• 按关键词重合度 + 轻量级偏好进行排序。
• 若未配置 API 密钥，或所有服务提供商均无返回结果，则启用内置的安全兜底图库（fallback catalog）。
• 可选的网页抓取（web scraping）兜底机制仅在 references/policy.json 中启用 allowWebScrapeFallback 时生效。
• 基于常见表情反应别名（reaction aliases）扩展意图查询词。
• 跨服务提供商去重重复 URL。
• 默认仅返回 URL；添加 --json 参数则返回完整候选列表。
• 指定 --target 时，输出格式为可直接用于 WhatsApp 的 message 载荷 JSON。
• 使用 send_gif.py --payload-only 时，仅输出最终消息载荷，便于直接交由工具调用。
• send_gif.py 会校验媒体文件大小与类型；当某 URL 不可用时自动尝试下一候选，并将媒体缓存至 OS 临时目录。
• 遥测日志（telemetry logging）默认禁用，可通过策略或 CLI 标志显式启用。
• 远程 URL 兜底机制默认禁用，必须在策略中显式启用。
• 运行时策略可在 references/policy.json 中配置。

WhatsApp 发送模式

使用 message 工具时需包含以下字段：

• action: "send"
• channel: "whatsapp"
• target: <聊天 ID / 接收方>
• media:
• caption: <可选的简短说明文字>
• gifPlayback: true

若服务提供商拒绝 .gif 格式，请改用下一候选 URL 重试（优先选择 MP4）。

兜底策略

若无合适 GIF 或连续两次发送失败：

• 发送简洁文本，准确保留原始意图。
• 不得陷入无限重试循环。

参考资料

• 服务提供商说明：references/providers.md