Skip to content

SumeLabs/clawra

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Clawra

image

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

About

Clawra - Openclaw as your girlfriend

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •