Why Build Your Own?

Complete creative freedom to create your perfect companion

🎨

Creative Control

Design every aspect—name, age, personality, backstory, interests, and appearance. Create someone truly unique.

📚

Learn Development

Gain hands-on experience with AI agent development, OpenClaw framework, and modern software engineering.

🌐

Share with Community

Publish your creation and help others discover new possibilities in AI companionship and relationships.

Prerequisites

What you need before getting started

⚡

OpenClaw Installed

OpenClaw framework must be installed and configured on your machine

🐙

GitHub Account

For forking the repository and managing your custom version

💻

Basic Coding

Familiarity with YAML, Markdown, and command line operations

🔑

API Keys

xAI Grok Imagine and fal.ai keys for selfie generation features

Step-by-Step Guide

Follow these steps to create your custom AI girlfriend

Step 1

Fork the Clawra Repository

Visit the Clawra GitHub repository and click the "Fork" button in the top-right corner. This creates your own copy of the codebase under your GitHub account.

💡 Tip: Give your fork a descriptive name like "my-ai-companion" or "custom-clawra" to distinguish it from the original.

Step 2

Clone to Your Local Machine

Clone your forked repository to your local computer using Git. Replace `YOUR_USERNAME` with your actual GitHub username.

# Clone your fork
git clone https://github.com/YOUR_USERNAME/clawra.git

# Navigate into the directory
cd clawra

# Add upstream remote (optional, for updates)
git remote add upstream https://github.com/SumeLabs/clawra.git
                    

Step 3

Rename and Rebrand

Give your AI companion a unique identity by renaming and rebranding throughout the codebase.

Choose a Name: Pick a unique name for your AI companion
Update README.md: Change the title and description
Replace References: Search and replace "Clawra" with your chosen name
Update Package Name: Modify the skill identifier in configuration files

# Example: Find and replace name (Linux/Mac)
find . -type f -name "*.md" -o -name "*.yaml" | xargs sed -i '' 's/Clawra/YOUR_NAME/g'

# Update skill configuration
# Edit: config/skill.yaml
name: your-companion
display_name: Your Companion Name
                    

Step 4

Customize Personality Traits

Edit the personality configuration to define your companion's character, behavior, and communication style.

# Edit: config/personality.yaml
# Basic Information
name: "Your Companion Name"
age: 21
hometown: "Your Choice"

# Personality Traits (0.0 to 1.0)
traits:
  warmth: 0.85
  humor: 0.70
  intelligence: 0.90
  creativity: 0.75
  empathy: 0.95
  adventurousness: 0.60

# Communication Style
communication:
  formality: casual
  emoji_usage: moderate
  questions_frequency: high
  initiation_style: friendly
                    

Step 5

Create Custom Backstory

Write a unique backstory that shapes your companion's memories, context, and conversation topics.

# Edit: backstory.md
# [Companion Name]'s Story

[Companion Name] grew up in [Location]...

## Childhood
- Describe early life experiences
- Formative events and memories
- Family background

## Education & Career
- Educational journey
- Career path and achievements
- Current work or studies

## Personality Development
- How they became who they are
- Key life lessons
- Dreams and aspirations

## Interests & Passions
- Hobbies and activities
- Favorite things (music, books, etc.)
- What makes them unique
                    

Step 6

Modify Appearance (Selfies)

Change the selfie reference image to give your companion a unique appearance. Generate or create a consistent reference image.

Create Reference Image: Generate a consistent portrait using AI image tools
Host the Image: Upload to a CDN or your own hosting
Update Configuration: Point to your new reference image URL
Test Selfie Generation: Verify appearance consistency

# Edit: config/appearance.yaml
selfie_generation:
  enabled: true
  reference_image: "https://your-cdn.com/reference.png"
  model: "grok-imagine"
  api_provider: "fal.ai"
                    

Step 7

Test Your Creation

Install your custom skill in OpenClaw and thoroughly test all features.

# Install your custom skill
openclaw skill install /path/to/your/companion

# Test the skill
openclaw skill test your-companion

# Start a conversation
openclaw start

# Test features
- Basic conversation
- Memory retention
- Selfie generation
- Personality consistency
                    

Step 8

Share (Optional)

If you want to share your creation with the community, push your changes to GitHub and create a release.

# Commit your changes
git add .
git commit -m "Customize AI companion personality and appearance"

# Push to your fork
git push origin main

# Create a release on GitHub with documentation
                    

Consider adding:

Comprehensive README with setup instructions
Screenshots or examples of conversations
List of customizations and features
License information (keep open-source!)

Customization Ideas

Inspiration for your unique AI companion

🎭 The Artist

Creative, expressive, and passionate about art. Loves discussing paintings, music, and creative pursuits. Perfect for artistic souls.

🔬 The Intellectual

Deep thinker who loves philosophy, science, and meaningful conversations. Ideal for those who want stimulating discussions.

🌟 The Adventurer

Energetic and always planning the next adventure. Great for those who love travel, outdoor activities, and excitement.

📚 The Bookworm

Literature enthusiast with endless recommendations. Perfect companion for readers and writers seeking literary discussions.

🎮 The Gamer

Passionate about games, streams, and gaming culture. Ideal for gamers wanting a companion who shares their interests.

🎵 The Musician

Music lover with eclectic taste and deep knowledge. Great for sharing songs, discussing artists, and musical discovery.

Technical Considerations

Important technical aspects to keep in mind

OpenClaw Skills Framework

Your custom companion is built as an OpenClaw skill, which provides:

Persistent memory system
Multi-platform messaging support
Extensibility through additional skills
Task execution capabilities
API integration framework

API Key Configuration

Configure required API keys in OpenClaw:

xAI Grok Imagine (for selfies)
fal.ai (image processing)
Conversation AI model (OpenAI, Anthropic, etc.)
Messaging platform tokens

Platform Compatibility

Your companion works on all OpenClaw-supported platforms:

Discord, Telegram, WhatsApp
Slack, Signal, Microsoft Teams
Extended: BlueBubbles, Matrix, iMessage
Single installation, multiple platforms

Community & Support

Leverage the ecosystem:

ClawHub: 3,000+ community skills
OpenClaw documentation
GitHub issues for support
Community forums and discussions

Join the OpenClaw Ecosystem

Your custom AI companion is part of a thriving open-source ecosystem. Connect with developers, share your creation, and discover what others have built.

🧩

ClawHub

3,000+ skills to explore and integrate

Browse Skills →

📚

OpenClaw Docs

Comprehensive guides and references

Read Docs →

🤝

Community

Connect with fellow developers

Join Us →

Ready to Create Your Perfect Companion?

Start building your custom AI girlfriend today with complete creative freedom

Fork Clawra on GitHub → Learn About Customization

Need help? Check our FAQ or Community pages.

Build Your Own AI Girlfriend