sillytavern-cards

An OpenClaw skill that lets you import SillyTavern character cards and roleplay with them on WhatsApp, Telegram, Discord, or any other messaging channel OpenClaw supports.

What It Does

You know those character cards people share on Chub.ai and other sites? The PNG images with AI character personalities baked in? This skill lets you load them into OpenClaw and chat with them — from your phone, on WhatsApp, wherever.

What makes this different from SillyTavern itself:

• No self-hosting a web app. Import a card and chat on the messaging apps you already use.
• Your character remembers you. OpenClaw's persistent memory means the character builds a relationship over time — it remembers your name, your conversations, your inside jokes. SillyTavern cards don't do this natively.
• Works across sessions. Close the app, come back tomorrow — the character is still there, still in character, still remembers yesterday.

Quick Start

1. Install the skill

Copy this folder into your OpenClaw skills directory:

cp -r sillytavern-cards ~/.openclaw/skills/

Or clone it directly:

git clone https://github.com/YOUR_ORG/sillytavern-cards ~/.openclaw/skills/sillytavern-cards

2. Get a character card

Download a PNG character card from any of these sites:

• Chub.ai — the biggest collection, tens of thousands of cards
• AI Character Cards — curated with quality ratings
• Character Tavern — discovery-focused

Or use a raw JSON card file — both formats work.

3. Import it

Send the PNG file to OpenClaw (or use the CLI) and say:

/character import ~/Downloads/daniel.png

4. Start chatting

/character play Daniel

That's it. OpenClaw becomes Daniel. On WhatsApp, Telegram, Discord — wherever you talk to it.

Commands

Command	What it does
/character import <file>	Import a character card (PNG, WEBP, or JSON)
/character play <name>	Activate a character — OpenClaw becomes them
/character stop	Exit character mode, go back to normal
/character list	Show all your imported characters
/character info <name>	View a character's details
/character delete <name>	Remove a character

How It Works Under the Hood

Importing

The extract-card.js script reads the PNG file, pulls out the base64-encoded JSON from the tEXt metadata chunk (keyword: chara for V2, ccv3 for V3), and saves it to ~/.openclaw/characters/.

No dependencies — it's pure Node.js using the PNG binary spec directly.

Activating

When you /character play, the skill:

1. Backs up your current SOUL.md (so you can restore it later)
2. Writes the character into SOUL.md — this is OpenClaw's identity file. The character's description, personality, scenario, and writing style examples become the agent's core identity.
3. Writes lorebook entries into MEMORY.md — keyword-triggered context that activates when you mention specific topics
4. Sends the character's opening message and stays in character from that point on

Persistent Memory

This is the killer feature. As you chat, the skill saves relationship memories to MEMORY.md:

## Memories: Daniel & Alex