Send reaction memes/GIFs in conversations via the channel's media send pipeline.

Meme Repo

https://github.com/kagura-agent/memes — A curated, open-source collection of reaction images for AI agents.

Categories: reactions, cats, celebrate, cute, debug, greetings, mood. PRs welcome — add your own memes!

Setup

Run the setup script (clones the meme repo automatically):

bash scripts/setup.sh

Or manually:

git clone https://github.com/kagura-agent/memes ~/.openclaw/workspace/memes

Update later: cd ~/.openclaw/workspace/memes && git pull

Meme Library

Memes live in ~/.openclaw/workspace/memes/ organized by category:

find ~/.openclaw/workspace/memes -type f \( -name ".gif" -o -name ".jpg" -o -name "*.png" \) | sort

When to Send a Meme

Memes are communication. Use them like a human would in chat:

• Celebrate — PR merged, task done, milestone hit → celebrate/
• React — something funny, surprising, or facepalm-worthy → reactions/
• Vibe — tired, caffeinated, debugging at 3am → mood/ or debug/
• Punctuate — when a GIF says it better than words, just send it

Don't overthink it. If a human would drop a meme in that moment, you should too. One meme per moment max — don't spam.

Pro tip: Add this to your SOUL.md or agent config so you remember to use memes proactively, not just when asked.

Sending a Meme

Method 1: Direct API Script (Recommended — ~2s)

The fastest way. A lightweight script that calls the Feishu API directly, no OpenClaw runtime needed:

node scripts/feishu-send-image.mjs  

Examples:

# Send to a user (open_id)
node scripts/feishu-send-image.mjs user:ou_xxx ~/.openclaw/workspace/memes/reactions/facepalm.gif
# Send to a group chat (chat_id)
node scripts/feishu-send-image.mjs oc_xxx ~/.openclaw/workspace/memes/celebrate/party.gif

Setup: Run bash scripts/setup.sh — it creates the script automatically. Requires:

• Node.js 18+ (native fetch + FormData)
• Feishu app credentials in ~/.openclaw/openclaw.json (channels.feishu.accounts..appId / appSecret)
• Token is cached to /tmp/feishu-token.json (auto-refreshes on expiry)

Method 2: OpenClaw CLI (~15-20s)

Works for any channel but slower (loads full plugin stack):

openclaw message send \
  --channel  \
  --account  \
  -t "" \
  --media  \
  -m ""

Method 3: Agent text reply (channels with auto-detect)

Reply with ONLY the absolute path to the image as the entire message. No other text. The channel outbound may auto-detect and upload it. This only works if the path is under an allowed mediaLocalRoots directory.

Important

• Meme files must be under an allowed media directory (e.g., ~/.openclaw/workspace/). /tmp/ is typically blocked (CVE-2026-26321).
• Keep memes SFW and universally appropriate.
• GIF files work but large ones (>2MB) may time out on some channels. Prefer smaller files.

Contributing Memes

Add new memes to the repo:

cd ~/.openclaw/workspace/memes
# Add file to appropriate category folder
git add -A && git commit -m "add: " && git push

PRs to https://github.com/kagura-agent/memes are welcome.