Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Create AI digital twins of real people from WhatsApp chat history exports. Clone your friends, colleagues, or contacts into AI agents that talk, think, and react like them. Use when the user wants to: create a digital twin, clone a WhatsApp contact into an AI agent, build a persona from chat history, make an AI version of someone, create a doppelgänger agent, or simulate a conversation with someone based on their real messages. Triggers: digital twin, clone friend, chat clone, persona, doppelgänger, twin agent, AI clone, simulate person, WhatsApp clone, chat personality, mimic friend. Important: Requires explicit consent from the person being cloned. Always confirm permission before proceeding.
Create AI digital twins of real people from WhatsApp chat history exports. Clone your friends, colleagues, or contacts into AI agents that talk, think, and react like them. Use when the user wants to: create a digital twin, clone a WhatsApp contact into an AI agent, build a persona from chat history, make an AI version of someone, create a doppelgänger agent, or simulate a conversation with someone based on their real messages. Triggers: digital twin, clone friend, chat clone, persona, doppelgänger, twin agent, AI clone, simulate person, WhatsApp clone, chat personality, mimic friend. Important: Requires explicit consent from the person being cloned. Always confirm permission before proceeding.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Create realistic AI digital twins of real people by analyzing their WhatsApp chat exports.
Informed consent is required. Before creating a digital twin of any person, you must obtain their explicit, informed consent. This means: Inform the person that their chat messages will be used to create an AI agent that mimics their personality and communication style. Explain what the twin will be used for (personal use, entertainment, testing, etc.). Obtain explicit permission — verbal or written — before proceeding. Respect refusal. If the person declines, do not create the twin. Allow withdrawal. The person may request deletion of the twin at any time. Creating a digital twin without the subject's knowledge or consent is a violation of their privacy and autonomy. This skill is designed for use between friends, family, or colleagues who have mutually agreed to participate. It is not intended for impersonation, deception, harassment, or any use that could harm the subject. The agent must confirm consent before proceeding. When a user requests a twin, ask: "Do you have this person's permission to create an AI twin of them?" Do not proceed unless the user confirms.
User provides a WhatsApp chat export (.txt file) Parser script extracts and categorizes messages by sender LLM analyzes the parsed messages to generate personality profile files A new OpenClaw agent is created with the twin's identity
Tell the user to export the chat from WhatsApp: Open the chat → ⋮ → More → Export Chat → Without Media Send the .txt or .zip file
Run the parser to extract messages: python3 scripts/parse_chat.py <chat_export.txt> <target_name> <output_dir> Arguments: chat_export.txt — Path to the WhatsApp export file target_name — Name of the person to clone (as it appears in the chat) output_dir — Directory to save parsed output This generates <output_dir>/parsed_messages.json with categorized messages.
Using the parsed messages, create these files in the twin's workspace: SOUL.md — Read references/soul-guide.md for structure EXAMPLES.md — Read references/examples-guide.md for structure ANTI-EXAMPLES.md — Read references/anti-examples-guide.md for structure MEMORY.md — Read references/memory-guide.md for structure Analyze the parsed messages thoroughly. Quality depends on: Identifying ALL recurring phrases, gírias, and expressions Capturing emotional patterns and tone shifts Noting relationship dynamics with the chat partner Extracting real events, people, and shared history
Create workspace: ~/.openclaw/workspace-<agent_id>/ Create agent dir: ~/.openclaw/agents/<agent_id>/agent/ Place SOUL.md, EXAMPLES.md, ANTI-EXAMPLES.md, MEMORY.md in workspace Create AGENTS.md in agent dir — read references/agents-guide.md for template Register agent in OpenClaw config via gateway config.patch
Send a message to the twin and verify it responds in character. Iterate on SOUL.md if needed.
Chat exports should be processed locally and never transmitted to external services beyond the LLM API call. Parsed data and generated profiles are stored in the user's local OpenClaw workspace. Users are responsible for securing twin data and respecting the subject's privacy. If the subject requests deletion, remove all workspace files, agent configuration, and parsed data.
More messages = better twin. 50+ messages from the target person recommended. Text messages matter most. Audio/image/sticker messages are lost in export. Recent chats are better. People's communication style evolves. Multiple chats help. If available, combine exports from different chats with the same person. Iterate. Test the twin, identify gaps, refine SOUL.md.
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.