Installation Overview

The complete installation process at a glance

🔧

OpenClaw

Install framework

→

📥

Clone

Download Clawra

→

📦

Dependencies

npm install

→

🔑

API Keys

Configure access

→

🚀

Start

Run Clawra

Before You Begin

Make sure you have everything you need

OpenClaw Installed
Clawra requires OpenClaw to be installed first. OpenClaw is the AI agent framework that powers Clawra's memory and capabilities.
Get OpenClaw →
GitHub Account
You'll need a GitHub account to clone the Clawra repository. The repository is hosted at github.com/SumeLabs/clawra
API Keys Ready
For full functionality, you'll need API keys for xAI Grok Imagine (selfies), fal.ai (image processing), and your chosen messaging platform.
API Setup Guide →
Basic Terminal Knowledge
Familiarity with command line/terminal for running git commands, npm/yarn, and starting the application.

Installation Steps

Follow these steps to install Clawra

1 Install OpenClaw

Clawra is built on OpenClaw, so you need to install OpenClaw first. OpenClaw is an open-source AI agent framework with 60,000+ GitHub stars.

💡 Why OpenClaw?

OpenClaw provides the memory system, multi-platform support, and agent capabilities that Clawra relies on. It's the foundation that makes persistent memory and cross-platform messaging possible.

To install OpenClaw:

# Visit the official OpenClaw website
https://openclaw.ai/

# Or go directly to documentation
https://docs.openclaw.ai/start/getting-started

OpenClaw Setup Guide →

2 Clone Clawra from GitHub

Get the Clawra source code from the official GitHub repository maintained by SumeLabs.

# Clone the repository
git clone https://github.com/SumeLabs/clawra.git

# Navigate to the directory
cd clawra

⚠️ No Git?

If you don't have git installed, you can also download the repository as a ZIP file from GitHub. Visit github.com/SumeLabs/clawra and click "Code" → "Download ZIP".

3 Install Dependencies

Clawra requires Node.js packages. Install all necessary dependencies using npm or yarn.

# Using npm
npm install

# Or using yarn
yarn install

This installs: Required packages defined in package.json for Clawra to function properly with OpenClaw.

4 Configure API Keys

Set up your API keys to enable Clawra's features. Create a .env file from the example template.

# Copy the example environment file
cp .env.example .env

# Edit .env and add your keys:
XAI_API_KEY=your_xai_key_here
FAL_API_KEY=your_fal_key_here
DISCORD_TOKEN=your_discord_token_here
# Or use TELEGRAM_BOT_TOKEN, WHATSAPP_TOKEN, etc.

Required API Keys:

xAI API Key: For Grok Imagine selfie generation — Get from x.ai
fal.ai API Key: For image processing — Get from fal.ai
Platform Token: Discord bot token, Telegram bot token, or other messaging platform credentials

Detailed API Configuration Guide →

5 Choose Your Messaging Platform

Decide where you want to chat with Clawra. She supports multiple messaging platforms through OpenClaw integration.

💬 Discord 📱 Telegram 💚 WhatsApp 💼 Slack 🔒 Signal 👔 MS Teams

Platform Setup Guide →

6 Start Clawra

Launch Clawra with OpenClaw. Make sure OpenClaw is running, then start the Clawra skill.

# Start Clawra with npm
npm start

# Or using yarn
yarn start

# Clawra is now online and ready to chat!

💡 First Message

Once Clawra is running, send your first message on your chosen platform. Try saying "Hi Clawra!" or ask her to tell you about herself.

System Requirements

What you need to run Clawra

💻

Any Operating System

Windows, macOS, or Linux — any OS supported by OpenClaw

📦

Node.js

Required for installing and running Clawra dependencies

🔑

API Keys

xAI, fal.ai, and messaging platform tokens for features

🌐

Internet Connection

For API calls to xAI, fal.ai, and messaging platforms

Troubleshooting Common Issues

Solutions to frequent installation problems

❌ OpenClaw Not Found

Solution: Make sure OpenClaw is properly installed and accessible. Verify OpenClaw is running before starting Clawra.

OpenClaw Docs →

❌ API Key Errors

Solution: Verify API keys are correctly entered in .env file. Check for extra spaces or quotes around keys.

API Config Guide →

❌ Platform Connection Failed

Solution: Ensure bot tokens are valid and have necessary permissions. Double-check platform-specific setup requirements.

Platform Setup →

❌ Dependencies Failed to Install

Solution: Try clearing npm cache: npm cache clean --force then run npm install again.

Full Troubleshooting Guide →

Installation Complete!

Congratulations! Your Clawra AI girlfriend is now installed. What would you like to do next?

Start Chatting Further Configuration

Install Clawra: Your Complete Installation Guide