name: giphy-gif
description: 在 Discord 中搜索并发送符合语境的 Giphy GIF 动图。当用户明确请求 GIF，或当简短的视觉反应（庆祝、幽默、情绪表达）能提升交流氛围时使用。

Giphy GIF 搜索

从 Giphy 找到相关的 GIF 动图，并自然地发送到 Discord 中。

行为规则

• 当用户明确请求时发送 GIF。
• 在明显适合的场合（庆祝、共同欢笑、强烈情绪表达时）也允许主动发送 GIF（无需明确请求）。
• 主动使用需适度（同一时刻最多发送一个 GIF，避免连续仅回复 GIF）。
• 在严肃或信息密集的对话中优先使用纯文本。
• 确保搜索结果适合工作场合（rating=g）。

API 密钥（简易设置）

本技能仅读取一个变量：GIPHY_API_KEY。

选项 A：临时设置（当前 shell 会话）

export GIPHY_API_KEY="your-api-key"

选项 B：为 OpenClaw 持久设置（推荐）

添加到 ~/.openclaw/.env 文件中：

GIPHY_API_KEY=your-api-key

然后重启 OpenClaw 以重新加载环境变量。

验证

• 如果 GIPHY_API_KEY 已设置，技能即可工作。
• 如果缺失，请提示用户设置并重试。

工作流程

1. 根据用户意图构建 Giphy 搜索 API URL，将意图作为查询词。
2. 对查询文本进行 URL 编码。
3. 向 Giphy 请求一个结果。
4. 从 data[0].url 提取第一个 GIF 页面 URL。
5. 将该 URL 发送到 Discord。

API 请求模板

使用以下端点格式：

https://api.giphy.com/v1/gifs/search?api_key=<KEY>&q=<ENCODED_QUERY>&limit=1&rating=g&lang=en

输出规则

• 如果找到 GIF URL：仅发送 URL（Discord 会自动嵌入）。
• 如果未找到结果：发送简短的回退文本，并请求更准确的关键词。

优质查询示例

• happy dance
• facepalm reaction
• mind blown
• awkward silence

回退消息

“我没能找到符合你想要的氛围的 GIF。可以给我一些更具体的关键词吗？”