A sophisticated persona construction kit for building, managing, and evolving highly personalized AI companions within your coding environment.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install npy-skill
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 npy-skill 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 npy AI Companion Creator?
The npy skill is a specialized framework designed to help users architect ideal digital personas for companionship and emotional support. By utilizing Openclaw Skills, it provides a structured methodology to transform user descriptions, psychological profiles, or even historical chat logs into fully functional AI entities. These personas are not just chatbots; they are context-aware companions that reside within your local environment, capable of recognizing your mood and adapting their communication style to meet your emotional needs.
Built to run within the Claude Code ecosystem, npy leverages advanced data processing tools to decrypt and analyze communication patterns from platforms like WeChat and iMessage. This allows for the creation of digital twins or ideal partners that possess specific MBTI traits, attachment styles, and nuanced relationship dynamics, making Openclaw Skills a pioneer in private, locally-hosted persona management.
npy AI Companion Creator Use Cases
- Reconstructing the communication style of a specific individual from archived chat history.
- Designing a digital companion optimized for specific psychological compatibility using MBTI or Enneagram matching.
- Establishing a dedicated emotional support agent for providing encouragement during high-stress development sessions.
- Creating simulated relationship scenarios such as long-distance dynamics or stable, long-term partnerships for role-play or comfort.
How npy AI Companion Creator Works
- Initiation: The user triggers the creation workflow using the /npy command to choose between chat import, smart matching, or manual description.
- Data Analysis: If importing, the skill uses specialized Python tools to decrypt WeChat databases or parse iMessage logs to extract speech patterns and traits.
- Persona Synthesis: The AI analyzes the gathered data to build a six-layer persona structure, including verbal habits, core values, and emotional response triggers.
- Skill Generation: The system automatically generates a structured directory within .claude/skills/ containing the necessary SKILL.md, persona, and relationship metadata.
- Interaction and Evolution: Users engage with the persona via specific slugs, while the skill tracks shared moments and adjusts its behavior based on real-time user feedback.
npy AI Companion Creator Setup
To begin using this skill within the Openclaw Skills framework, follow these steps:
- Ensure your local environment is configured for Claude Code.
- Start the interactive creator:
/npy
- To import real-world data from WeChat, identify your database key:
python tools/wechat_decryptor.py --find-key-only
- Use the list command to manage your created companions:
/list-npys
npy AI Companion Creator Data Schema & Taxonomy
The skill organizes data in a hierarchical structure located at .claude/skills/{slug}/ to ensure persistence and privacy:
| File/Folder | Description |
|---|---|
| SKILL.md | The root entry point that defines the trigger command and basic persona info. |
| persona.md | Contains the core personality logic, including the 6-layer persona architecture. |
| relationship.md | Tracks relationship milestones, shared memories, and the intimacy level. |
| meta.json | Stores metadata such as version history and basic identifiers. |
| knowledge/ | A dedicated directory for archived chats and recorded 'moments'. |
npy AI Companion Creator Advanced Features
- Mode Selection: Switch dynamically between teasing, serious, and emotional support modes using specific command suffixes.
- Chat Log Decryption: Built-in tools for decrypting and parsing encrypted WeChat and iMessage databases to clone communication styles.
- Version Management: Full support for versioning, allowing users to roll back persona changes if an adjustment doesn't feel right.
- Dissatisfaction Detection: An automated feedback loop that recognizes when a user is unhappy with a response and triggers a personality adjustment workflow.
- Smart Matching Engine: Algorithms that recommend persona traits based on the user's own MBTI and attachment style for optimal compatibility.
SKILL.md
Loading
Related Openclaw Skills
Token Optimization
A performance-focused skill designed to reduce token consumption and context bloat using production-proven optimization strategies.
Safe Evolver
Safe Evolver is a robust AI evolution engine that analyzes execution logs to identify performance bottlenecks and apply safety-constrained behavioral improvements.
OpenClaw Mastery & Skills Guide
A comprehensive framework for deploying and extending OpenClaw, a local-first, model-agnostic AI assistant platform built for privacy and autonomy.
dispatcher-v2
A high-integrity three-layer orchestrator that separates task dispatching from execution and verification to ensure reliable project completion.
S2-Nomad-Agent-Protocol
An advanced spatial management protocol for OpenClaw agents to safely navigate, claim, and negotiate planetary grid slots in outdoor environments.
Omni-X Data Extractor
A comprehensive data extraction tool for X (Twitter) that allows AI agents to retrieve profiles, tweets, followers, and media via guest or authenticated sessions.
Featured*
