Transfer memories between OpenClaw agents with optional topic filtering, supporting sharing mode with role transformation or cloning mode for verbatim copies.
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
Transfer with mode selection (interactive)
node memory-transfer.js transfer --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 --topic "claude"
Force memory sharing (with transformation)
node memory-transfer.js transfer --mode share
Force memory cloning (verbatim)
node memory-transfer.js transfer --mode clone
Preview transfer (dry run)
node memory-transfer.js transfer --dry-run
List agent memories
node memory-transfer.js list
Search memories by topic
node memory-transfer.js search
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
| 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-/
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
đĄ 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
