GIF Picker lets Openclaw agents choose a local reaction GIF by tag and return a reliable `MEDIA:` path for chat replies.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gif-picker
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install gif-picker using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is GIF Picker?
GIF Picker is a lightweight Openclaw Skills tool for selecting reaction GIFs from a local library using emotional or situational tags like praise, celebration, or facepalm.
It replaces fragile third-party GIF URLs and API-dependent services with a stable, offline-friendly workflow: the agent matches tags against index.json, the Python picker resolves the best file, and the response can include a MEDIA:<path> line that messaging systems can deliver consistently.
GIF Picker Use Cases
- Replying with praise, celebration, acknowledgment, apology, or humor.
- Avoiding Tenor/GIPHY URL rot and silent message failures caused by dead links.
- Sending reaction media in offline, restricted, or API-free environments.
- Curating team-specific or brand-safe GIF reactions from a local collection.
- Verifying a library before using it in an Openclaw Skills workspace.
- Picking the best matching GIF from one or more intent tags in real time.
How GIF Picker Works
- Create a local GIF library directory and ensure Python 3 is available.
- Add sample GIFs with
populate.shor copy in your own stable GIF files. - Register each GIF in
index.jsonwith its filename, tags, mood, and description. - Run
pick_gif.pywith one or more tags to find the best match, or use--list,--list-tags, and--verifyto inspect the library. - The script prints a
MEDIA:<path>line so the agent can attach the GIF directly in its reply.
GIF Picker Setup
- Create the library root
mkdir -p ~/.openclaw/workspace/gif-library
- Copy the skill files into the directory
# Copy pick_gif.py, index.json, and populate.sh into ~/.openclaw/workspace/gif-library
- Populate sample GIFs and verify the install
cd ~/.openclaw/workspace/gif-library && bash populate.sh
python3 pick_gif.py --verify
python3 pick_gif.py --list
- Optional: point Openclaw Skills to a custom library path
export GIF_LIBRARY_DIR=~/.openclaw/workspace/gif-library
GIF Picker Data Schema & Taxonomy
Directory layout
| Path | Type | Purpose |
|---|---|---|
{GIF_LIBRARY_DIR}/gifs/ |
directory | Stores local reaction GIF binaries used by the picker |
{GIF_LIBRARY_DIR}/index.json |
JSON catalog | Maps each GIF name to file, tags, mood, and description |
{GIF_LIBRARY_DIR}/pick_gif.py |
Python CLI | Performs tag matching, listing, and verification |
{GIF_LIBRARY_DIR}/populate.sh |
shell script | Downloads starter GIFs into the library |
Metadata taxonomy
tags: Search tokens used to match the user's intent; examples includepraise,good-job,celebration,salute, andfacepalm.mood: A short classifier for tone, such aspositive,sarcastic,acknowledgment, orapology.description: A human-readable explanation of what the GIF communicates.file: The filename insidegifs/; only local files are used, so no CDN URLs are stored.
Runtime behavior
- Default root:
~/.openclaw/workspace/gif-library - Optional override:
GIF_LIBRARY_DIR - Output contract:
MEDIA:<path>
GIF Picker Advanced Features
- Offline-first media selection with no third-party CDN dependency.
- No API keys, no rate limits, and no brittle external GIF URLs.
--list,--list-tags, and--verifysupport for library discovery and maintenance.- Tag-based matching that works with multiple intent words to improve relevance.
- Custom-curated GIFs for team culture, product tone, or community rituals.
GIF_LIBRARY_DIRoverride for multi-workspace or self-hosted deployments.- Compatible with Openclaw message replies via a plain
MEDIA:<path>output. - Ideal for Openclaw Skills workflows that need expressive, low-friction reaction media.
SKILL.md
Loading
Related Openclaw Skills
Save — Conversation Memory Index
Save is an Openclaw Skills memory system that turns live conversations into durable, searchable local knowledge.
savemaintenance
savemaintenance is an Openclaw Skills maintenance pipeline that backs up, reconciles, rebuilds, and audits the three-tier memory system in one deterministic run.
Dali Creative Intelligence
Dali scores and upgrades image and video prompts before generation, preventing wasted credits and improving output quality.
OpenClaw VPS Security Preflight
A read-only VPS security preflight that validates OpenClaw exposure, SSH/firewall posture, and deployment readiness on authorized Linux hosts.
UI Master Static
Openclaw Skills guidance for building production-grade interfaces with native CSS, BEM, modern layouts, and polished motion.
Tristan RFQ Overseer
Tristan RFQ Overseer turns inbound RFQs into priced, compared, and approval-gated quotation drafts with vault-backed state.