emo-img

# emo-img — Sticker / Emoji Image Skill

Send sticker images (表情包) in chat conversations. Hybrid search: local collection first, then Tenor online.

## Storage

- Sticker collection: `~/.openclaw/stickers/`
- Index file: `~/.openclaw/stickers/index.json`
- Override with `STICKER_DIR` env var

## Commands

### Search (hybrid: local first, then online)

```bash
python3 {baseDir}/scripts/sticker.py search "开心"
python3 {baseDir}/scripts/sticker.py search "thumbs up" --limit 3
```

Returns JSON with `local` and `online` arrays. Local results have a `file` path; online results have a `url`.

### Search local only

```bash
python3 {baseDir}/scripts/sticker.py search-local "哭"
```

### Search online only (Tenor)

```bash
python3 {baseDir}/scripts/sticker.py search-online "excited" --limit 5
```

### Add a local file

```bash
python3 {baseDir}/scripts/sticker.py add /path/to/sticker.gif --name "happy-cat" --tags "开心,猫,happy,cat"
```

### Download from URL and save

```bash
python3 {baseDir}/scripts/sticker.py download "<url>" --name "thumbs-up" --tags "好的,赞,ok"
```

### List all stickers

```bash
python3 {baseDir}/scripts/sticker.py list
```

### Remove a sticker

```bash
python3 {baseDir}/scripts/sticker.py remove "happy-cat"
```

## Sending Stickers

Use the `message` tool with the `media` field to send sticker images. This works for ALL channels (WhatsApp, Telegram, Discord, etc.) — no external CLI needed.

```json
{
  "action": "send",
  "channel": "<current_channel>",
  "to": "<recipient>",
  "message": "",
  "media": "<sticker_file_path>"
}
```

The `media` field accepts local file paths directly (e.g. `/Users/.../.openclaw/stickers/bocchi-shy.gif`).

For online results not yet downloaded, first run `download` to save locally, then send the saved file path.

## Workflow

1. User says something like "发个表情包" or "send a sticker about X"
2. Run `search "<keyword>"` to find matching stickers
3. If local results exist, use the `file` path directly
4. If only...

# 🎭 emo-img — Give Your AI a Soul, One Sticker at a Time

> **When words aren't enough, let your AI express emotions through images.**

emo-img is an [OpenClaw](https://openclaw.ai) skill that gives AI agents the ability to **feel and react with sticker images** — just like humans do in chat. Instead of cold text replies, your agent sends expressive GIFs and stickers that match the emotional context of the conversation.

## ✨ Why emo-img?

AI assistants are smart, but they're emotionally flat. A thumbs-up emoji isn't the same as a cute animated character giving you a high-five. emo-img bridges this gap:

- **Emotionally aware** — Your AI picks stickers that match the mood: 害羞, 开心, 难过, 搞笑...
- **Hybrid search** — Searches your personal sticker collection first, falls back to Tenor's massive library
- **Cross-channel** — Works on WhatsApp, Telegram, Discord, iMessage, and more
- **Grows with you** — Save favorites to build a personal sticker collection your AI remembers

## 🚀 Quick Start

### Install

Drop the `emo-img/` folder into your OpenClaw skills directory:

```bash
cp -r emo-img/ ~/.nvm/versions/node/$(node -v)/lib/node_modules/openclaw/skills/emo-img
```

Or install the `.skill` package if you have the skill-creator:

```bash
openclaw skills install emo-img.skill
```

### Use

Just talk to your agent naturally:

- *"发个害羞的表情包"*
- *"send me a happy sticker"*
- *"来个搞笑的图"*
- *"react with a thumbs up gif"*

Your agent will search, find, and send the perfect sticker automatically.

## 🔧 Under the Hood

```
emo-img/
├── SKILL.md            # Skill definition + agent instructions
└── scripts/
    └── sticker.py      # Sticker manager (search, download, add, remove)
```

### CLI Commands

```bash
# Hybrid search (local first, then Tenor online)
python3 sticker.py search "开心"

# Add to your collection
python3 sticker.py add ~/Downloads/cute-cat.gif --name "happy-cat" --tags "开心,猫,happy"

# Download from URL
python3 sticker.py download "<u...