介绍
# Giphy GIF Search
从 Giphy 找到相关的 GIF，并在 Discord 中自然地发送。
## 行为规则
- 在明确被要求时发送 GIF。 - 当情境明显合适时（例如庆祝、共享幽默或强烈的情感时刻），也允许主动发送 GIF（无需明确请求）。 - 保持主动发送的频率适度（一个时刻最多一张 GIF，避免连续仅发送 GIF 的回复）。 - 在严肃或信息密集的对话中，优先使用纯文本。 - 保持结果适合工作场所 (`rating=g`)。
## API 密钥（简易设置）
此技能仅读取一个变量：`GIPHY_API_KEY`。
### 选项 A：临时（当前 Shell 会话）
```bash export GIPHY_API_KEY="your-api-key" ```
### 选项 B：为 OpenClaw 持久化（推荐）
添加到 `~/.openclaw/.env`：
```bash 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。你能给我更具体一点的关键词吗？"