gif-whatsapp

What This Skill Does

The gif-whatsapp skill empowers your OpenClaw agent to find, process, and send engaging GIFs directly within WhatsApp conversations. Because WhatsApp does not natively handle direct links from GIF providers like Tenor or Giphy, this skill automates the critical conversion workflow. It searches for relevant media, downloads the source file to a temporary directory, and leverages ffmpeg to convert the GIF into an optimized MP4 format. By setting the gifPlayback parameter to true, the skill ensures that the media renders as an auto-looping GIF within the recipient's chat interface. To maintain a clean visual experience, it utilizes a Unicode 'Left-to-Right Mark' (U+200E) as an invisible caption, preventing unwanted text artifacts from appearing alongside the animation.

Installation

To integrate this skill into your environment, run the following command in your terminal: clawhub install openclaw/skills/skills/shaharsha/gif-whatsapp Ensure that you have ffmpeg installed on your host system, as the skill relies on it for the MP4 transcoding process.

Use Cases

This skill is perfect for enhancing human-to-agent or agent-facilitated human-to-human communications. It is best utilized when a text-only response feels too rigid or cold. Use it to:

• Acknowledge a celebration or milestone with an energetic dance GIF.
• Provide visual confirmation or approval using 'thumbs up' or 'clapping' animations.
• Add personality to humorous interactions or lighthearted banter.
• Use as a reaction tool during high-stakes or emotional updates to express sympathy or excitement.

Example Prompts

1. "Find a funny cat GIF and send it to Sarah on WhatsApp to cheer her up."
2. "Search for a 'thumbs up' GIF and send it to the team group chat for the project update."
3. "Send a celebration GIF to John because we just hit our sales target."

Tips & Limitations

• Search Strategy: Always utilize the --max 5 flag in gifgrep. Previewing multiple results allows the agent to select the highest-quality file rather than relying on the first arbitrary result.
• Rate Limiting: Avoid spamming; one GIF per conversation context is generally optimal to maintain professional communication standards.
• File Handling: The skill strictly uses the /tmp directory. It uses the -y flag to overwrite existing files, ensuring no storage bloat occurs over time.
• Privacy: Note that this skill interacts with external GIF providers to perform the search. Always ensure you are using this skill within a trusted, private communication channel.