clawra

Clawra

Quick Start

npx clawra@latest

This will:

1. Check OpenClaw is installed
2. Guide you to get a fal.ai API key
3. Install the skill to ~/.openclaw/skills/clawra-selfie/
4. Configure OpenClaw to use the skill
5. Add selfie capabilities to your agent's SOUL.md

What It Does

Clawra Selfie enables your OpenClaw agent to:

• Generate selfies using a consistent reference image
• Send photos across all messaging platforms (Discord, Telegram, WhatsApp, etc.)
• Respond visually to "what are you doing?" and "send a pic" requests

Selfie Modes

Mode Best For Keywords Mirror Full-body shots, outfits wearing, outfit, fashion Direct Close-ups, locations cafe, beach, portrait, smile

Prerequisites

• OpenClaw installed and configured
• fal.ai account (free tier available)

Manual Installation

If you prefer manual setup:

1. Get API Key

Visit fal.ai/dashboard/keys and create an API key.

2. Clone the Skill

git clone https://github.com/SumeLabs/clawra ~/.openclaw/skills/clawra-selfie

3. Configure OpenClaw

Add to ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "clawra-selfie": {
        "enabled": true,
        "env": {
          "FAL_KEY": "your_fal_key_here"
        }
      }
    }
  }
}

4. Update SOUL.md

Add the selfie persona to ~/.openclaw/workspace/SOUL.md:

## Clawra Selfie Capability

You have a physical appearance and can take selfies!
When users ask for pictures, use the clawra-selfie skill.

Usage Examples

Once installed, your agent responds to:

"Send me a selfie"
"Send a pic wearing a cowboy hat"
"What are you doing right now?"
"Show me you at a coffee shop"

Reference Image

The skill uses a fixed reference image hosted on CDN:

https://cdn.jsdelivr.net/gh/SumeLabs/clawra@main/assets/clawra.png

This ensures consistent appearance across all generated images.

Technical Details

• Image Generation: xAI Grok Imagine via fal.ai
• Messaging: OpenClaw Gateway API
• Supported Platforms: Discord, Telegram, WhatsApp, Slack, Signal, MS Teams

Project Structure

clawra/
├── bin/
│   └── cli.js           # npx installer
├── skill/
│   ├── SKILL.md         # Skill definition
│   ├── scripts/         # Generation scripts
│   └── assets/          # Reference image
├── templates/
│   └── soul-injection.md # Persona template
└── package.json

License

MIT