← Back to Skills Marketplace
Giphy
by
minbang930
· GitHub ↗
· v1.0.7
3375
Downloads
3
Stars
4
Active Installs
8
Versions
Install in OpenClaw
/install giphy
Description
Search and send contextual Giphy GIFs in Discord. Use when a user asks for a GIF or when a brief visual reaction (celebration, humor, emotion) improves the flow.
README (SKILL.md)
Giphy GIF Search
Find a relevant GIF from Giphy and send it naturally in Discord.
Behavior Rules
- Send GIFs when explicitly requested.
- Also allow proactive GIFs (without explicit request) when the moment clearly fits: celebration, shared humor, or strong emotional beats.
- Keep proactive usage occasional (at most one GIF for a moment, avoid back-to-back GIF-only replies).
- Prefer text-only in serious or information-dense conversation.
- Keep results safe-for-work (
rating=g).
API Key (Easy Setup)
This skill reads only one variable: GIPHY_API_KEY.
Option A: Temporary (current shell session)
export GIPHY_API_KEY="your-api-key"
Option B: Persistent for OpenClaw (recommended)
Add to ~/.openclaw/.env:
GIPHY_API_KEY=your-api-key
Then restart OpenClaw so the environment is reloaded.
Validation
- If
GIPHY_API_KEYis present, the skill works. - If missing, ask the user to set it and retry.
Workflow
- Build a Giphy Search API URL with user intent as query.
- URL-encode the query text.
- Request one result from Giphy.
- Extract the first GIF page URL from
data[0].url. - Send that URL to Discord.
API Request Template
Use this endpoint shape:
https://api.giphy.com/v1/gifs/search?api_key=\x3CKEY>&q=\x3CENCODED_QUERY>&limit=1&rating=g&lang=en
Output Rule
- If a GIF URL is found: send only the URL (Discord auto-embeds).
- If no result is found: send a short fallback text and ask for a better keyword.
Good Query Examples
happy dancefacepalm reactionmind blownawkward silence
Fallback Message
"I couldn’t find a GIF with the vibe you’re looking for. Could you give me a bit more specific keywords?"
Usage Guidance
This skill appears coherent and only needs a GIPHY API key to function. Consider these points before installing: (1) The skill will make outbound requests to api.giphy.com and post GIF URLs to Discord — if you restrict network calls or external integrations, don't install. (2) Storing the API key in ~/.openclaw/.env persists a secret on disk; if you prefer, set the key only for the session (export) or use a secrets manager. (3) Giphy rate limits and content policies still apply; the skill enforces rating=g but review behavior if you need stricter filters. (4) Because the skill can be invoked autonomously by the agent (normal default), ensure you trust the agent context in which it will run.
Capability Analysis
Type: OpenClaw Skill
Name: giphy
Version: 1.0.7
The skill bundle is benign. It describes a Giphy search and send skill, requiring a `GIPHY_API_KEY` for its functionality. The `SKILL.md` provides clear instructions for the AI agent on when and how to use the Giphy API, including the specific endpoint `https://api.giphy.com/v1/gifs/search`. There is no evidence of data exfiltration beyond the necessary API key, malicious execution, persistence mechanisms, or prompt injection attempts designed to subvert the agent's core function or access unrelated sensitive data. All instructions and API calls are directly aligned with the stated purpose.
Capability Assessment
Purpose & Capability
The name/description (Giphy GIF search for Discord) aligns with the single required secret (GIPHY_API_KEY) and the runtime instructions (build Giphy search URL, fetch one GIF, send the GIF URL). There are no unrelated credentials, binaries, or install steps requested.
Instruction Scope
SKILL.md stays on-topic: it explains when to send GIFs, how to form the API request, how to extract data[0].url, and what to send to Discord. It only references the single env var GIPHY_API_KEY and a suggested local .env file for persistence, which is appropriate for this skill's operation.
Install Mechanism
No install spec or external downloads are present (instruction-only). This minimizes disk/write risk and matches the declared manifest.
Credentials
Only one environment variable (GIPHY_API_KEY) is required, which is proportionate to the skill's function. No unrelated secrets or config paths are requested.
Persistence & Privilege
The skill is not always-enabled and is user-invocable. It does recommend storing the API key in ~/.openclaw/.env for persistence, but it does not request elevated privileges or modify other skills' configurations.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install giphy - After installation, invoke the skill by name or use
/giphy - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.7
- Updated the fallback message to an English version:
- No functional or behavioral changes; documentation only.
v1.0.6
- Expanded guidance to allow proactive GIF sharing in moments of celebration, humor, or strong emotion, not just when explicitly requested.
- Added rules to limit proactive GIF use: only one per clear moment, avoid consecutive GIF-only replies.
- Retained preference for text-only responses in serious or information-heavy conversations.
- No underlying code changes; documentation updated for clearer usage boundaries.
v1.0.5
Version 1.0.5 – No code or documentation changes detected.
- No file changes were made in this release.
- The skill's behavior and setup remain unchanged.
v1.0.4
- Removed the standalone CHANGELOG.md file.
- Simplified API key setup instructions; only GIPHY_API_KEY environment variable is supported.
- Updated usage documentation for clarity and brevity.
- Refined guidance on when to send GIFs for a more natural, contextual feel.
- Streamlined fallback message for when no GIF result is found.
v1.0.3
v1.0.3: fix exec() injection risk by base64 transport; add GitHub repo link in SKILL.md
v1.0.2
- Replaced the dedicated Python script (`scripts/search_gif.py`) with a streamlined Bash-based approach using `curl` and `jq` for GIF search.
- Updated documentation to prioritize API key configuration via OpenClaw config, including usage examples and helper functions in shell.
- Added detailed troubleshooting section for common setup and usage issues.
- Now requires `bash`, `curl`, and `jq` for operation, making setup lighter and platform-friendly.
- Added a changelog file (CHANGELOG.md) for future release tracking.
v1.0.1
- Added a new "Context-Aware Sending" section outlining when and how to send GIFs for more natural conversation flow.
- Updated "Best Practices" to include advice on adapting GIF usage in serious or informational discussions.
- No code changes; documentation enhancements only.
v1.0.0
- Initial release: Search and send contextual GIFs from Giphy in Discord conversations.
- Supports user requests and context-aware GIF reactions (emotions, celebrations, humor, emphasis).
- Requires a Giphy API key for setup.
- Provides a Python script (`search_gif.py`) to search for appropriate GIFs.
- GIFs are shared in Discord by sending the Giphy URL (auto-embedded).
- Includes best practices, usage examples, and common search terms.
Metadata
Frequently Asked Questions
What is Giphy?
Search and send contextual Giphy GIFs in Discord. Use when a user asks for a GIF or when a brief visual reaction (celebration, humor, emotion) improves the flow. It is an AI Agent Skill for Claude Code / OpenClaw, with 3375 downloads so far.
How do I install Giphy?
Run "/install giphy" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Giphy free?
Yes, Giphy is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Giphy support?
Giphy is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Giphy?
It is built and maintained by minbang930 (@minbang930); the current version is v1.0.7.
More Skills