Skip to content
sumelabsPublic

About

Clawra - Openclaw as your companion

Resources

Stars

2.4k stars

Watchers

19 watching

Forks

Latest commit

 

History

18 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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 companion

Resources

Stars

2.4k stars

Watchers

19 watching

Forks

Releases

Packages

Contributors

Languages