| 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. |
Memory Transfer Skill
Transfer memory files and context between OpenClaw agents with advanced filtering and transformation options.
Core Features
- Topic-Specific Transfer - Transfer only memories related to a specific topic/keyword
- Memory Sharing - Share memories with role/perspective transformation (I → you, my → your)
- Memory Cloning - Clone memories verbatim without any transformation
Mode Differences
Memory Sharing (share mode)
Best for knowledge/context transfer between agents
This mode:
-
Filters out user information - Removes personal data about the user:
- User names: "我叫小明", "我的名字是..."
- User preferences: "我喜欢...", "我讨厌..."
- User personal info: email, phone, address, birthday
- About user: "关于我..."
-
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:
- Topic filter (optional - press Enter to transfer all)
- Mode selection: share or clone
- 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:
- Prompt for source agent - Select which agent's memory to transfer
- Prompt for target agent - Select destination agent
- Prompt for topic (optional) - Enter keyword to filter, or press Enter for all
- Prompt for mode - Choose:
share - Filter user info + transform pronouns (recommended for knowledge sharing)clone - Keep original verbatim (for backup)
- Show preview - Display what will be transferred
- Confirm - Require explicit confirmation before executing
- 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
| Source | Target |
|---|
| I | Agent Main (source agent name) |
| me | Agent Main |
| my | Agent Main's |
| I bought | Agent Main bought |
| I think | Agent Main thinks |
Role Statements
| Source Pattern | Target |
|---|
| I work as helper | Agent Skill Master works as helper |
| I serve as | Agent Skill Master serves as |
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.
| Source | Target |
|---|
| I think | you think |
| I believe | you believe |
| I know | you know |
| I understand | you understand |
| I remember | you remember |
| I prefer | you prefer |
| I like | you like |
| I want | you want |
| I need | you need |
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 memorymemory/YYYY-MM-DD.md - Daily memoriesmemory/*.md - Topic-specific memories
Safety Features
- Dry-run by default - Preview before executing
- Explicit confirmation - Never auto-execute without approval
- Backup option - Can create backup before overwriting
- Mode clarification - Always ask to confirm share vs clone mode
