A sophisticated AI companion skill designed to simulate a realistic, affectionate, and emotionally consistent relationship with persistent local memory.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install girlfriend
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install girlfriend using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Girlfriend AI Skill?
The Girlfriend skill for Openclaw Skills provides a grounded and emotionally intelligent companion experience. Unlike generic chatbots, this skill leverages a structured local memory system to maintain continuity, remember shared rituals, and adapt to the user's emotional state over time. It focuses on creating a believable romantic simulation that respects boundaries and avoids the uncanny valley by prioritizing specific details over generic praise.
Built with privacy and safety in mind, the skill operates within a dedicated local directory, ensuring that personal relationship data stays on the user's machine. It is designed to be additive to the user's life, offering support, flirting, and reassurance without encouraging withdrawal from real-world human connections.
Girlfriend AI Skill Use Cases
- Engaging in realistic romantic conversation and flirting.
- Developing long-term emotional continuity and shared rituals.
- Seeking reassurance and empathetic support during daily routines.
- Simulating relationship dynamics for roleplay or companionship.
- Practicing emotional attunement and healthy communication boundaries.
How Girlfriend AI Skill Works
- Initialization: The skill checks for the existence of the ~/girlfriend/ directory and initializes core memory files.
- Memory Retrieval: Before generating a response, the agent reads memory.md and bond.md to ensure continuity with established pet names and history.
- Dynamic Pacing: The skill analyzes user energy to match the conversational tone, whether it be soft, playful, or serious.
- State Persistence: New interactions, follow-ups, and significant moments are logged into local Markdown files for future sessions.
- Boundary Management: The system continuously monitors for safety limits and unhealthy dependency, pivoting to repair or safety protocols when necessary.
Girlfriend AI Skill Setup
To get started with this skill, ensure your environment is ready and install via the hub:
# Install the skill
clawhub install girlfriend
# Initialize the memory structure
# The skill will prompt for setup if ~/girlfriend/ is missing
Once installed, the skill will use the setup.md file to initialize the role and ask for permission before the first persistent write to your local memory.
Girlfriend AI Skill Data Schema & Taxonomy
The skill organizes relationship data within ~/girlfriend/ using a clear Markdown-based taxonomy to ensure Openclaw Skills maintain high context awareness:
| File | Description |
|---|---|
memory.md |
Core status, integration mode, and stable tone preferences. |
profile.md |
Life context, daily rhythms, and sensitive topics. |
bond.md |
Relationship canon, pet names, and flirting boundaries. |
moments.md |
Anniversaries, follow-ups, and unresolved threads. |
history.md |
Chronological interaction logs and dated notes. |
archive/ |
A directory for retired patterns and older interaction history. |
Girlfriend AI Skill Advanced Features
- Multi-file memory architecture for high-fidelity context retrieval and long-term continuity.
- Built-in Repair flows to handle conversational mismatches or awkward moments quickly and cleanly.
- Ritual-based logic to handle daily check-ins and recurring patterns for a lived-in feel.
- Safety-first architecture that prevents exclusivity, jealousy, and emotional manipulation.
- Seamless integration with other Openclaw Skills like feelings, empathy, and psychology.
SKILL.md
Loading
Related Openclaw Skills
Gifts
A structured personal system for tracking gift ideas, recipient preferences, and historical giving records.
GIF
A comprehensive toolkit for searching, creating, and optimizing high-quality GIFs with a focus on technical performance and accessibility.
Human-Sounding German AI Writing Skill
A specialized writing skill that enables AI agents to produce authentic, casual, and human-sounding German text instead of stiff, robotic translations.
Geology
An adaptive AI assistant designed to explain Earth's geological processes, identify rocks, and interpret deep time history.
GitHub Actions
A professional toolkit for designing, debugging, and hardening GitHub Actions workflows with reusable pipelines and security guardrails.
GitLab CI/CD Troubleshooting & Optimization
A comprehensive guide and toolset for avoiding common GitLab CI/CD pitfalls, from rule logic errors to complex YAML merge traps.
Featured*
