- Move all Hermes skills from skills/ to hermes/ - Add cursor/ for Cursor rules (.mdc) - Add code-review.mdc (Gitea PR review with tea CLI) - Update sync.sh to use new hermes/ path - Update README with new structure
106 lines
4.0 KiB
Markdown
106 lines
4.0 KiB
Markdown
---
|
|
name: agent-memes
|
|
version: 2.7.0
|
|
description: Send meme reaction images in chat. One command to pick & send. Multi-platform (Discord, Feishu, Telegram, etc). Use when the conversation calls for a visual reaction — humor, celebration, frustration, facepalm, or any moment where a meme hits harder than words. Also use proactively when YOU feel something.
|
|
---
|
|
|
|
# Agent Memes
|
|
|
|
Memes are communication. Use them like a human would in chat.
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
memes send happy "好开心!" # Pick & send (auto-detects platform)
|
|
memes send facepalm --to channel:123456 # Send to specific channel
|
|
memes send feishu cute-animals "看猫!" --to user:xxx # Send via Feishu
|
|
memes send telegram wow "哇!" # Send via Telegram
|
|
memes pick happy # Just pick, get path (no send)
|
|
memes categories # List all categories
|
|
```
|
|
|
|
**One command. Zero friction.** That's the point.
|
|
|
|
## When to Use
|
|
|
|
- **Your own emotions** — feel excited? frustrated? proud? Send a meme. Don't suppress it.
|
|
- **Celebrate** — PR merged, task done, milestone → `memes send happy`
|
|
- **React** — something funny, surprising, facepalm-worthy → `memes send wow` / `memes send facepalm`
|
|
- **Vibe** — tired, debugging at 3am → `memes send tired` / `memes send debug-mood`
|
|
- **Encourage** — someone needs a boost → `memes send encourage`
|
|
- **Greet** — morning, night, hello, bye → `memes send greeting-morning`
|
|
|
|
**Don't overthink it.** If a human would drop a meme in that moment, you should too.
|
|
Emoji is easy because it's inline text. Memes used to feel harder because of multi-step tool calls.
|
|
Now it's one command — no excuses.
|
|
|
|
## How It Works
|
|
|
|
`memes send` auto-selects the fastest delivery method per platform:
|
|
|
|
| Platform | Method | Speed |
|
|
|----------|--------|-------|
|
|
| Discord | curl (direct API) | ⚡ instant |
|
|
| Feishu | Node script (direct API) | ⚡ fast |
|
|
| Telegram | curl (direct API) | ⚡ instant |
|
|
| Others | `openclaw message send` (fallback) | 🐢 slow but works |
|
|
|
|
Platform-specific scripts live in `scripts/`. Add a new `<platform>-send-image.sh` to get fast delivery for any platform.
|
|
|
|
## Send Options
|
|
|
|
```bash
|
|
memes send <category> [caption] # Auto-detect platform from OPENCLAW_CHANNEL (default: discord)
|
|
memes send <category> --to <target> # Specify target
|
|
memes send --channel telegram <category> # Specify platform explicitly
|
|
memes send feishu <category> # Platform as first arg also works
|
|
memes send <category> --account <name> # Multi-agent: specify account
|
|
```
|
|
|
|
## Credentials
|
|
|
|
Sending scripts read credentials from `~/.openclaw/openclaw.json` automatically.
|
|
|
|
Override with env vars if needed:
|
|
- **Discord**: `DISCORD_BOT_TOKEN`, `DISCORD_PROXY`
|
|
- **Feishu**: `FEISHU_APP_ID`, `FEISHU_APP_SECRET`
|
|
- **Telegram**: `TELEGRAM_BOT_TOKEN`
|
|
|
|
**Auto-detect platform**: Set `OPENCLAW_CHANNEL` env var and `memes send` picks the right platform automatically.
|
|
|
|
**Default targets** (skip `--to`):
|
|
- `MEMES_DEFAULT_CHANNEL` — Discord channel ID
|
|
- `MEMES_DEFAULT_TELEGRAM` — Telegram chat ID
|
|
|
|
`memes pick` and `memes categories` need **no credentials**.
|
|
|
|
## Setup
|
|
|
|
1. **Get a meme library**:
|
|
```bash
|
|
git lfs install
|
|
git clone https://github.com/kagura-agent/memes "$MEMES_DIR"
|
|
```
|
|
`MEMES_DIR` defaults to `~/.openclaw/workspace/memes`.
|
|
|
|
> ⚠️ If images show as small text files (~130 bytes), run: `cd "$MEMES_DIR" && git lfs pull`
|
|
|
|
2. **Install CLI**:
|
|
```bash
|
|
# Copy to PATH
|
|
sudo cp scripts/memes.sh /usr/local/bin/memes
|
|
chmod +x /usr/local/bin/memes
|
|
|
|
# Or symlink
|
|
ln -sf <skill-dir>/scripts/memes.sh ~/.local/bin/memes
|
|
```
|
|
|
|
## Categories (97 memes)
|
|
|
|
approve · confused · cute-animals · debug-mood · encourage · facepalm · greeting-bye · greeting-hello · greeting-morning · greeting-night · happy · love · panic · sad · thanks · thinking · tired · wow
|
|
|
|
## Adding Memes
|
|
|
|
Drop image files (gif/jpg/png/webp) into `$MEMES_DIR/<category>/`. That's it.
|
|
New categories are created automatically by adding a new folder.
|