name: memory-transfer description: Transfer memory files between OpenClaw agents with support for topic-specific transfers and two modes: memory sharing (with role transformation) and memory cloning (verbatim copy). Use when: (1) Migrating memory from main agent to sub-agent, (2) Sharing specific topic memories between agents, (3) Copying user preferences to new agents, (4) Backing up agent memory before resets. metadata: { "openclaw": { "emoji": "📦" } }

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