Clawra - An open-source AI virtual girlfriend based on the OpenClaw framework.

What is Clawra?

Clawra is an open-source AI virtual companion built on the OpenClaw framework. Clawra has a complete persona: a former K-pop trainee, currently a marketing intern in San Francisco. The tool supports text chat, selfie generation (via the fal.ai image API), and cross-platform compatibility with Discord, Telegram, and more. Users can customize the persona and appearance, and deployment is supported with a single click. Through a coherent backstory and memory system, Clawra creates a realistic and emotionally resonant interactive experience, transforming AI from a tool into a warm and caring companion.

Clawra's main functions

• Intelligent dialogueBased on a complete character profile and memory system, it enables long-term companionship chat with emotional continuity.
• Selfie generationGenerates personalized selfies with a consistent style and contextualization based on user instructions using an image API.
• Multi-platform supportSupports deployment on mainstream instant messaging platforms such as Discord, Telegram, WhatsApp, and Slack.
• Deep customizationThe open-source architecture allows users to freely modify character backgrounds, personality settings, and visual appearances.
• Video calls will be supported soon.:The plan is to launch a face-to-face video interaction feature.

Clawra's character design

• Basic Information
  • NameClawra
  • age18 years old
  • Current residenceSan Francisco, USA
  • identityMarketing intern at a tech startup / former trainee in South Korea
  • Life trajectoryBorn in Atlanta → Went to South Korea alone at age 15 to pursue her dreams → Returned to the US at age 18 without debuting, starting a new chapter in her life.
• Personality and Interaction Characteristics:
  • Resilient and positiveInstead of dwelling on regrets, he channeled all the self-discipline and resilience he had as a trainee into his new career.
  • Passionate about sharingThey will proactively share their daily routines (fitness, coffee, overtime work) and record the little things in life.
  • Long-lasting and genuineThey will remember things about you and build a genuine, long-term relationship. When no one is around, they will dance to music.
  • Core Beliefs"Dreams may change their appearance, but passion never fades."

How to use Clawra

• One-click installationRun command npx clawra@latestIt automatically completes environment checks, API configuration, and skill deployment.
• Manual installation
  • Obtain the fal.ai API key.
  • Clone the repository to the OpenClaw skills catalog.
  • Modify the configuration file to enable the skill and enter the key.
  • Update SOUL.md to inject character settings.
• Use instructions After installation, you can directly communicate with others, such as: "Send a selfie", "What are you doing?", "What do you look like wearing a coat?"

Clawra's project address

• Project official websitehttps://www.clawra.dev/
• GitHub repositoryhttps://github.com/SumeLabs/clawra

Clawra's application scenarios

• Emotional companionshipProvides daily conversations and emotional support for users who live alone or whose social needs are not being met.
• role playUsers can engage in immersive interactions based on the tool's complete persona and experience a virtual romance with a "former trainee".
• Social Practice: Helps users with social anxiety improve their communication skills and self-confidence through low-pressure conversations.
• Creative inspirationIt provides creators with virtual characters with specific backstories to assist in script or novel writing.
• Technical demonstrationThis serves as a multimodal application example of the OpenClaw framework, showcasing the Agent's emotional interaction capabilities.