doppel

从 WhatsApp 聊天记录导出中创建真人的 AI 数字双胞胎。 将您的朋友、同事或联系人克隆到人工智能代理中，使其像他们一样说话、思考和反应。 当用户想要执行以下操作时使用：创建数字孪生、将 WhatsApp 联系人克隆到 AI 代理、 根据聊天记录构建角色，制作某人的人工智能版本，创建分身代理， 或者根据某人的真实信息模拟与某人的对话。 触发器：数字孪生、克隆朋友、聊天克隆、角色、分身、孪生特工、 AI克隆，模拟人，WhatsApp克隆，聊天个性，模仿朋友。 重要提示：需要被克隆人的明确同意。在继续之前请务必确认许可。

## 概述（中文）

从 WhatsApp 聊天记录导出中创建真人的 AI 数字双胞胎。
将您的朋友、同事或联系人克隆到人工智能代理中，使其像他们一样说话、思考和反应。
当用户想要执行以下操作时使用：创建数字孪生、将 WhatsApp 联系人克隆到 AI 代理、
根据聊天记录构建角色，制作某人的人工智能版本，创建分身代理，
或者根据某人的真实信息模拟与某人的对话。
触发器：数字孪生、克隆朋友、聊天克隆、角色、分身、孪生特工、
AI克隆，模拟人，WhatsApp克隆，聊天个性，模仿朋友。
重要提示：需要被克隆人的明确同意。在继续之前请务必确认许可。

## 原文

# Doppel — AI Digital Twins from Chat History

Create realistic AI digital twins of real people by analyzing their WhatsApp chat exports.

## ⚠️ Ethics & Consent

**Informed consent is required.** Before creating a digital twin of any person, you **must** obtain their explicit, informed consent. This means:

1. **Inform** the person that their chat messages will be used to create an AI agent that mimics their personality and communication style.
2. **Explain** what the twin will be used for (personal use, entertainment, testing, etc.).
3. **Obtain explicit permission** — verbal or written — before proceeding.
4. **Respect refusal.** If the person declines, do not create the twin.
5. **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.

## How It Works

1. User provides a WhatsApp chat export (`.txt` file)
2. Parser script extracts and categorizes messages by sender
3. LLM analyzes the parsed messages to generate personality profile files
4. A new OpenClaw agent is created with the twin's identity

## Quick Start

### Step 1: Get the Chat Export

Tell the user to export the chat from WhatsApp:
- Open the chat → ⋮ → More → Export Chat → Without Media
- Send the `.txt` or `.zip` file

### Step 2: Parse the Chat

Run the parser to extract messages:

```bash
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.

### Step 3: Generate Twin Profile

Using the parsed messages, create these files in the twin's workspace:

1. **SOUL.md** — Read `references/soul-guide.md` for structure
2. **EXAMPLES.md** — Read `references/examples-guide.md` for structure
3. **ANTI-EXAMPLES.md** — Read `references/anti-examples-guide.md` for structure
4. **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

### Step 4: Create the Agent

1. Create workspace: `~/.openclaw/workspace-<agent_id>/`
2. Create agent dir: `~/.openclaw/agents/<agent_id>/agent/`
3. Place SOUL.md, EXAMPLES.md, ANTI-EXAMPLES.md, MEMORY.md in workspace
4. Create AGENTS.md in agent dir — read `references/agents-guide.md` for template
5. Register agent in OpenClaw config via `gateway config.patch`

### Step 5: Test

Send a message to the twin and verify it responds in character. Iterate on SOUL.md if needed.

## Privacy & Data Handling

- 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.

## Tips for Better Twins

- **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.