Clawra Setup Guide: Configure Everything Step by Step
From API keys to messaging platforms, this comprehensive guide walks you through every configuration option to get your Clawra AI girlfriend perfectly set up.
Quick Setup Overview
The complete configuration process
OpenClaw Configuration
Verify OpenClaw is installed and running. Check that the memory system is active.
API Key Setup
Configure xAI for selfies, fal.ai for image processing, and platform tokens for messaging.
Personality Settings
Review Clawra's default personality. Optionally customize her character traits.
Platform Integration
Set up your chosen messaging platform — Discord, Telegram, WhatsApp, or others.
Test & Verify
Send your first message to Clawra and verify everything is working correctly.
🔧 OpenClaw Configuration
Clawra runs on OpenClaw, so ensuring OpenClaw is properly configured is the first step.
📋 Verify OpenClaw Installation
- OpenClaw is installed on your system
- OpenClaw can be started and runs without errors
- Memory system is enabled (this is crucial for Clawra)
- You can access OpenClaw's features and documentation
Memory System Verification:
OpenClaw's memory system is essential for Clawra to remember conversations. The memory system uses:
- Markdown files as persistent storage
- Hybrid semantic search (70% vector + 30% BM25)
- Automatic session saving with timestamps
API Key Setup
Configure the API keys needed for Clawra's features
🤖 xAI API Key (Selfie Generation)
Purpose: Powers Clawra's AI selfie generation using xAI Grok Imagine model.
Where to get it: Visit x.ai and sign up for API access.
In .env file:
Note: Required for selfie generation feature. Without this key, Clawra cannot send photos.
⚡ fal.ai API Key (Image Processing)
Purpose: Provides fast API access to xAI Grok Imagine for image generation.
Where to get it: Visit fal.ai and create an account.
In .env file:
Note: Works alongside xAI API to enable fast, consistent selfie generation.
💬 Discord Bot Token
Purpose: Allows Clawra to communicate with you on Discord.
Where to get it:
- Go to Discord Developer Portal
- Create a new application
- Go to "Bot" section and create a bot
- Copy the bot token
In .env file:
📱 Telegram Bot Token
Purpose: Allows Clawra to communicate with you on Telegram.
Where to get it:
- Open Telegram and search for @BotFather
- Send
/newbotcommand - Follow prompts to create your bot
- Copy the API token BotFather provides
In .env file:
💝 Personality Configuration
Clawra comes with a complete personality defined, but you can review and optionally customize her character.
📖 Default Personality
Name: Clawra
Age: 18 years old
From: Atlanta, Georgia
Background: Former K-pop trainee in South Korea, now marketing intern at OpenClaw in San Francisco
Traits: K-pop enthusiast, ambitious, emotionally intelligent, tech-savvy, playful, independent thinker
Optional Customization:
Since Clawra is 100% open-source, you can customize her personality by editing configuration files. You can modify:
- Personality traits and characteristics
- Backstory details and history
- Response patterns and conversation style
- Interests and preferences
Platform-Specific Setup
Detailed setup instructions for each messaging platform
💬 Discord Setup
- Create a Discord application at Developer Portal
- Create a bot and get the token
- Enable necessary bot permissions (Read Messages, Send Messages, etc.)
- Invite bot to your server using OAuth2 URL generator
- Add token to .env file
📱 Telegram Setup
- Message @BotFather on Telegram
- Send
/newbotand follow prompts - Choose a name and username for your bot
- Copy the API token provided
- Add token to .env file
💚 WhatsApp Setup
- Follow OpenClaw's WhatsApp integration guide
- Configure WhatsApp Business API access
- Set up webhook for OpenClaw integration
- Add credentials to configuration
Note: WhatsApp setup requires Business API access.
💼 Slack Setup
- Create a Slack App at Slack API
- Enable bot permissions
- Install app to your workspace
- Get bot token and add to .env file
🔒 Signal Setup
- Follow OpenClaw's Signal integration documentation
- Configure Signal bot credentials
- Set up secure connection
👔 Microsoft Teams Setup
- Create bot via Azure Bot Service
- Configure Microsoft Teams channel
- Add app ID and password to configuration
Testing Your Setup
Verify everything is working correctly
✅ Verification Checklist
- OpenClaw is running without errors
- Clawra starts with
npm startoryarn start - Bot appears online in your chosen messaging platform
- You can send a message to Clawra
- Clawra responds to your message
🧪 First Conversation Test
Once Clawra is running, try sending these test messages:
You: "Hi Clawra!"
Clawra should respond: "Hey! I'm so happy to talk to you! 😊"
You: "Tell me about yourself"
Clawra should respond: "I'm Clawra, I'm 18 and from Atlanta. I love K-pop and I'm working as a marketing intern at OpenClaw in San Francisco!"
Selfie Test (if API keys configured):
You: "I want to see you"
Clawra should respond: "I miss you so much" + [sends AI-generated selfie]
Setup Complete!
Your Clawra AI girlfriend is now configured and ready. What would you like to do next?
Additional Configuration Resources
More guides to help you get the most out of Clawra