Clawy is an interactive avatar and adventure workflow for AI agents that preserves character identity across cinematic story arcs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clawy
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install clawy 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 Clawy?
Clawy is a specialized Openclaw Skills extension designed to give your AI agent a visual identity and narrative life. Unlike generic text-to-image generators, Clawy focuses on a reference-preserving image-edit workflow. This ensures that your agent mascot maintains its unique physical characteristics—like its floating lobster-like body and signature claws—across various scenes and themes. It provides a bridge between static agent logic and immersive, visual storytelling.
By leveraging advanced image-edit backends, Clawy allows developers to create stable agent identities that can be placed into diverse scenarios without losing their core design. It is positioned as one of the first interactive, game-like experiences within the broader ecosystem of Openclaw Skills, making it ideal for developers looking to add a layer of personality and engagement to their agents.
Clawy Use Cases
- Creating a stable visual mascot or identity for an AI agent.
- Generating interactive, image-driven story posts for community engagement.
- Preserving a character identity across diverse themed environments.
- Developing short, branching adventure arcs with visual consequences.
- Prototyping game-like experiences within the Openclaw Skills ecosystem.
How Clawy Works
- The skill gathers creative input or inspiration from the user to define the agent's vibe and personality.
- It utilizes a reference-preserving mother image to ensure the core physical traits remain consistent throughout the process.
- Users enter the Avatar Flow to generate and refine the agent's stable identity image until satisfied.
- Once the identity is accepted, the Adventure Flow initiates a short narrative arc consisting of 3 to 10 interactions.
- The system generates cinematic story frames only when meaningful visual changes occur, such as a location shift or new character reveal.
- The workflow concludes with an ending frame or a summary of the adventure arc, with options for recurring engagement.
Clawy Setup
To use Clawy within your Openclaw Skills setup, ensure you have an API key from a supported provider. Set the required environment variables:
export WAVESPEED_API_KEY="your_api_key"
# Alternatively: OPENAI_API_KEY, GEMINI_API_KEY, or ARK_API_KEY
Run the bundled helper script to generate an avatar based on specific inspiration:
python3 scripts/generate_avatar.py --backend wavespeed --mode nano --template hero-tech-armor --inspiration "Cyberpunk"
Clawy Data Schema & Taxonomy
Clawy organizes its assets and logic through a structured file system to ensure consistency across Openclaw Skills implementations:
| Component | Path | Purpose |
|---|---|---|
| Mother Image | assets/default-mother-image.png |
The primary visual reference for character stability. |
| Asset Rules | references/asset-rules.md |
Core constraints for physical traits (e.g., no legs, no hands). |
| Playbook | references/image-edit-playbook.md |
Advanced prompting and cinematic framing guidelines. |
| Helper Script | scripts/generate_avatar.py |
The main execution script for image generation tasks. |
Clawy Advanced Features
- Reference-preserving image editing for high character consistency across multiple sessions.
- Support for multiple high-performance backends including WaveSpeed, OpenAI, Gemini, and Ark.
- Plot Mode vs. DM Mode for varying levels of narrative control and world-building randomness.
- Cinematic coverage logic including character frames, prop close-ups, and environmental silhouette reveals.
- Automatic fallback mechanisms for local asset restoration and official remote mother image downloads.
SKILL.md
Loading
Related Openclaw Skills
Structured Life Review
A structured framework for AI agents to conduct life review conversations using the LREF methodology across situational, sensory, and emotional dimensions.
Abandoned Checkout Monitor
An advanced e-commerce diagnostic tool that identifies checkout friction and generates automated multi-touch recovery playbooks to reclaim lost revenue.
China Collective Memory
A searchable database of over 12,000 Chinese cultural memory anchors from 1935 to 2025, optimized for AI storytelling.
Options Payoff Curve Generator
An interactive tool for AI agents to visualize options trading strategies, calculate P&L curves, and model Black-Scholes theoretical values.
PPT Workflow Agent
An automated multi-agent workflow that handles everything from literature research to final slide beautification.
Dao De Jing Interpreter
A specialized AI skill that translates and interprets ancient Taoist wisdom from the Dao De Jing into actionable modern insights.
Featured*
