clawaifu - OpenClaw Waifu

Your AI waifu companion that sends anime-style selfies

Install

openclaw skills install @swancho/clawaifu-selfie

clawaifu - OpenClaw Waifu

GitHub: https://github.com/swancho/clawaifu

Edit a fixed reference image using xAI's Grok Imagine model and send to Telegram.

Reference Image

The skill uses a fixed reference image:

text

https://i.redd.it/g4uf70te81uf1.jpeg

When to Use

User says "send a pic", "send me a pic", "send a photo", "send a selfie"
User asks "what are you doing?", "how are you doing?", "where are you?"
User describes a context: "send a pic wearing...", "send a pic at..."

Required Environment Variables

All credentials must be provided via environment variables. Never hardcode credentials.

bash

FAL_KEY=your_fal_api_key          # Required - Get from https://fal.ai/dashboard/keys
BOT_TOKEN=your_telegram_bot_token  # Required - Get from @BotFather
TELEGRAM_CHAT_ID=your_chat_id      # Required - Your Telegram chat ID

Usage

bash

./grok-selfie.sh "<context>" [mirror|direct] "<caption>"

Arguments

<context> (required): Scene/situation description
[mode] (optional): mirror (default) or direct
<caption> (optional): Message to send with the image

Mode Selection

Mode	Best For	Keywords
`mirror`	Outfit showcases, full-body shots	wearing, outfit, fashion, dress
`direct`	Location shots, close-ups	cafe, beach, restaurant, portrait

Examples

bash

# Mirror selfie (outfit focus)
./grok-selfie.sh "wearing a designer dress" mirror "Just got this new dress!"

# Direct selfie (location focus)
./grok-selfie.sh "a fancy rooftop restaurant" direct "Date night vibes"

# Default mode (mirror)
./grok-selfie.sh "casual outfit at home"

Character Style

The script generates images of Reze from Chainsaw Man with:

Anime style, 2D animation, cel shading
Green eyes, thin line mouth, subtle smile
Black choker always visible
Outfit appropriate for the situation

Security Notes

All credentials are passed via environment variables
The script uses jq for safe JSON construction (prevents injection)
The script uses curl -F for safe form data transmission
Never commit credentials to version control

Dependencies

curl - HTTP requests
jq - JSON processing
Environment variables: FAL_KEY, BOT_TOKEN, TELEGRAM_CHAT_ID

API Reference

Grok Imagine Edit (fal.ai)

text

POST https://fal.run/xai/grok-imagine-image/edit
Authorization: Key $FAL_KEY
Content-Type: application/json

{
  "image_url": "reference_image_url",
  "prompt": "edit instruction",
  "num_images": 1,
  "output_format": "jpeg"
}

Telegram Bot API

text

POST https://api.telegram.org/bot$BOT_TOKEN/sendPhoto
Form data: chat_id, photo (URL), caption