SillyTavern Character Cards for OpenClaw for Openclaw

A professional engine for importing and interacting with SillyTavern character cards within the OpenClaw ecosystem.

pearyj
v0.1.0
Mar 16, 2026
0
932
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install cn

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install cn using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is SillyTavern Character Cards for OpenClaw?

This skill enables AI agents to process SillyTavern compatible character cards in PNG, WEBP, or JSON formats. By extracting embedded metadata from TavernAI V2 and V3 specifications, it allows users to engage in deep roleplay or integrate specific character personalities into their daily AI interactions using Openclaw Skills. The engine translates complex character definitions into actionable prompts that redefine the agent's behavior and knowledge base.

SillyTavern Character Cards for OpenClaw Use Cases

  • Importing existing waifu or character personas from community hubs like Chub.ai or CharaVault.
  • Transforming a standard AI assistant into a specialized persona with unique traits, lore, and speaking styles.
  • Engaging in immersive roleplay sessions that utilize persistent memory and context-aware lore books.
  • Managing a local library of digital characters with the ability to switch between them seamlessly using Openclaw Skills.

How SillyTavern Character Cards for OpenClaw Works

  1. The user provides a file path or URL to a character card which the agent identifies as a roleplay trigger.
  2. Metadata is extracted via a dedicated Node.js script that parses tEXt chunks or base64 encoded JSON within the image.
  3. Character definitions and avatars are stored locally in the .openclaw directory for persistence.
  4. Depending on the user command, the skill modifies the agent core files like SOUL.md to adopt the persona or MEMORY.md to inject character lore.
  5. The agent initiates the conversation using the character's unique greeting and maintains the persona through specialized system instructions.

SillyTavern Character Cards for OpenClaw Setup

Ensure you have Node.js installed as it is required for metadata extraction. Use the following commands to prepare your environment for Openclaw Skills:

mkdir -p ~/.openclaw/characters
# Place the provided extract-card.js in your skill base directory

You can then import characters directly via URL:

# Example for importing from a direct URL
curl -sL "[CARD_URL]" -o /tmp/card.png
node extract-card.js /tmp/card.png > ~/.openclaw/characters/character_name.json

SillyTavern Character Cards for OpenClaw Data Schema & Taxonomy

The skill follows the TavernAI V2/V3 specification to ensure compatibility across the roleplay ecosystem. Data is organized as follows:

Component Description
Character JSON Contains name, description, personality, and scenario metadata.
Lore Book Keyword-triggered entries stored in MEMORY.md for deep world-building.
Relationship Memory Chronological interaction logs to maintain continuity across Openclaw Skills sessions.
Macros Support for dynamic replacements like {{char}}, {{user}}, and random dice rolls.

SillyTavern Character Cards for OpenClaw Advanced Features

  • Multi-source character search integration supporting both Chub.ai and CharaVault APIs.
  • Three distinct operating modes: Play (Full Immersion), Soul (Personality Overlay), and Chat (Temporary Session).
  • Persistent relationship tracking that saves user preferences and past interactions to MEMORY.md.
  • Automated macro processing for complex character greetings and interactive storytelling elements.
  • Full support for TavernAI V3 features including secondary keys and selective lore activation within Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins node
Github Stars: 0
forks: 0