Memory Transfer

Memory Transfer Skill

Transfer memory files and context between OpenClaw agents with advanced filtering and transformation options.

Core Features

1. Topic-Specific Transfer - Transfer only memories related to a specific topic/keyword
2. Memory Sharing - Share memories with role/perspective transformation (I → you, my → your)
3. Memory Cloning - Clone memories verbatim without any transformation

Mode Differences

Memory Sharing (share mode)

Best for knowledge/context transfer between agents

This mode:

1. Filters out user information - Removes personal data about the user:

   • User names: "我叫小明", "我的名字是..."
   • User preferences: "我喜欢...", "我讨厌..."
   • User personal info: email, phone, address, birthday
   • About user: "关于我..."

2. Transforms to target agent's identity - Converts references to match the target agent:

   • "I am Agent Main" → "I am Agent Skill Master" (adopts target identity)
   • "Agent Main's workspace" → "Agent Skill Master's workspace"
   • "I work as a helper" → "I work as Agent Skill Master"
   • First-person pronouns (I, my, me) remain as first-person

Use when: Sharing project knowledge, workflows, or task context. The target agent adopts the knowledge as their own experience.

Memory Cloning (clone mode)

Copies memory exactly as-is without filtering or transformation:

• All content preserved verbatim
• User information remains
• Original context maintained

Use when: Full backup/migration or preserving original author's voice.

Commands

List available agents

ls /home/node/.openclaw/

Transfer all memory from source to target

node memory-transfer.js transfer <source-agent-id> <target-agent-id>

Transfer with mode selection (interactive)

node memory-transfer.js transfer <source> <target> --mode interactive

This will prompt for:

1. Topic filter (optional - press Enter to transfer all)
2. Mode selection: share or clone
3. Confirmation before proceeding

Transfer specific topic memory

node memory-transfer.js transfer <source> <target> --topic "claude"

Force memory sharing (with transformation)

node memory-transfer.js transfer <source> <target> --mode share

Force memory cloning (verbatim)

node memory-transfer.js transfer <source> <target> --mode clone

Preview transfer (dry run)

node memory-transfer.js transfer <source> <target> --dry-run

List agent memories

node memory-transfer.js list <agent-id>

Search memories by topic

node memory-transfer.js search <agent-id> <topic>

Interactive Workflow

When running without explicit flags, the skill will:

1. Prompt for source agent - Select which agent's memory to transfer
2. Prompt for target agent - Select destination agent
3. Prompt for topic (optional) - Enter keyword to filter, or press Enter for all
4. Prompt for mode - Choose:
   • share - Filter user info + transform pronouns (recommended for knowledge sharing)
   • clone - Keep original verbatim (for backup)
5. Show preview - Display what will be transferred
6. Confirm - Require explicit confirmation before executing
7. Execute or cancel - Proceed or abort based on user decision

Examples

Transfer all memories as sharing (with transformation)

node memory-transfer.js transfer main coder --mode share

Transfer specific date memory as clone

node memory-transfer.js transfer main coder 2026-03-01.md --mode clone

Transfer topic-filtered memory with preview

node memory-transfer.js transfer main coder --topic "preferences" --dry-run

Interactive mode (recommended for first-time use)

node memory-transfer.js transfer main coder --mode interactive

Target Agent Adaptation Rules

When using share mode, the memory is transformed to match the target agent's identity:

Agent Identity

Role Statements

Result example: "I bought a phone" → "Agent Main bought a phone"

This way the target agent knows this is the source agent's experience, not their own.

Important: The transformation converts both pronouns AND role descriptions so the target agent doesn't inherit confused identity. For example:

• "I am Agent Skill Master" → "you are Agent Skill Master"
• "My role is to create skills" → "your role is to create skills"
• "I was created to help you" → "you were created to help me"

Agent Workspaces

OpenClaw agent workspaces are typically at:

• /home/node/.openclaw/workspace-<agent-id>/
• Main agent: /home/node/.openclaw/workspace-main/

Memory files:

• MEMORY.md - Long-term memory
• memory/YYYY-MM-DD.md - Daily memories
• memory/*.md - Topic-specific memories

Safety Features

1. Dry-run by default - Preview before executing
2. Explicit confirmation - Never auto-execute without approval
3. Backup option - Can create backup before overwriting
4. Mode clarification - Always ask to confirm share vs clone mode