Clawra - Openclaw as your companion
Overview
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 Clawra Selfie enables your OpenClaw agent to: - using a consistent reference image - across all messaging platforms (Discord, Telegram, WhatsApp, etc.) - to "what are you doing?" and "send a pic" requests - OpenClaw installed and configured - fal.ai account (free tier available) Visit fal.ai/dashboard/keys and create an API key. Add the selfie persona to ~/.openclaw/workspace/SOUL.md: The skill uses a fixed reference image hosted on CDN: This ensures consistent appearance across all generated images. - : xAI Grok Imagine via fal.ai - : OpenClaw Gateway API - : Discord, Telegram, WhatsApp, Slack, Signal, MS Teams
README
Clawra
Quick Start
npx clawra@latest
This will:
- Check OpenClaw is installed
- Guide you to get a fal.ai API key
- Install the skill to
~/.openclaw/skills/clawra-selfie/ - Configure OpenClaw to use the skill
- 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
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
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add sumelabs/clawra