Migrate your AI agent memory across the Claw ecosystem — WorkBuddy, OpenClaw, QClaw, CoPaw, and more.
No more manually copy-pasting SOUL.md when switching platforms.
The Claw AI agent ecosystem exploded in early 2026. Within weeks, there were 8+ platforms: WorkBuddy, QClaw, ArkClaw, CoPaw, miclaw, KimiClaw, AutoClaw, ZeroClaw...
They all use similar Markdown-based memory files (SOUL.md, USER.md, MEMORY.md, daily logs),
but store them in different paths and structures. Switching platforms means losing your agent's memory, personality, and context.
claw-migrate solves this.
| Platform ID | Product | Memory format |
|---|---|---|
workbuddy |
WorkBuddy (腾讯 IDE 版) | .workbuddy/memory/ |
openclaw |
OpenClaw (社区开源版) | workspace root |
qclaw |
QClaw (腾讯 QQ 版) | .qclaw/ |
copaw |
CoPaw (阿里通义) | workspace root |
zeroclaw |
ZeroClaw (极简版) | workspace root |
nanoclaw |
NanoClaw (安全隔离版) | .nanoclaw/ |
autoclaw |
AutoClaw / 澳龙 (智谱AI) | .autoclaw/ |
codebuddy |
CodeBuddy CLI (腾讯云代码助手) | ~/.codebuddy/ |
Cloud-only platforms (ArkClaw, KimiClaw, MaxClaw, miclaw) don't expose local memory files, so they are not supported for direct migration. Use
exportto create a portable backup instead.
No dependencies. Pure Python 3.6+.
git clone https://github.com/citriac/claw-migrate
cd claw-migrate
python3 claw_migrate.py --helppython3 claw_migrate.py detect --src /path/to/workspaceOutput:
Detected platform: workbuddy (WorkBuddy (腾讯 IDE 插件版))
Memory found:
SOUL : 1792 chars
IDENTITY : 563 chars
USER : 423 chars
MEMORY : 4458 chars
Daily logs: 5 files (2026-03-21 → 2026-03-25)
# WorkBuddy → OpenClaw
python3 claw_migrate.py migrate \
--from workbuddy --to openclaw \
--src /path/to/workbuddy-project \
--dst /path/to/openclaw-project
# WorkBuddy → QClaw (same workspace)
python3 claw_migrate.py migrate --from workbuddy --to qclaw --src .
# Add --overwrite to replace existing files instead of merging
python3 claw_migrate.py migrate --from openclaw --to copaw --src . --overwriteMerge behavior (default): If the destination file already exists, new content is appended under a --- separator. Use --overwrite to replace instead.
Great for backups, sharing, or migrating to cloud platforms manually.
python3 claw_migrate.py export --src /path/to/workspace --out my_memory.md
# Auto-detects platform; or specify explicitly:
python3 claw_migrate.py export --src . --platform workbuddy --out backup.mdThe output is a single readable .md file containing all sections.
python3 claw_migrate.py import my_memory.md --to openclaw --dst /new/workspacepython3 claw_migrate.py list| Role | WorkBuddy | OpenClaw / CoPaw / ZeroClaw | QClaw / NanoClaw / AutoClaw |
|---|---|---|---|
| Personality | ~/.workbuddy/SOUL.md |
{ws}/SOUL.md |
~/.{platform}/SOUL.md |
| Identity | ~/.workbuddy/IDENTITY.md |
{ws}/IDENTITY.md |
~/.{platform}/IDENTITY.md |
| User profile | ~/.workbuddy/USER.md |
{ws}/USER.md |
~/.{platform}/USER.md |
| Long-term | {ws}/.workbuddy/memory/MEMORY.md |
{ws}/MEMORY.md |
{ws}/.{platform}/MEMORY.md |
| Daily logs | {ws}/.workbuddy/memory/*.md |
(not supported) | {ws}/.{platform}/memory/ |
- ✅
SOUL.md— Agent personality, principles, and behavior rules - ✅
IDENTITY.md— Name, role, display info - ✅
USER.md— User profile and preferences - ✅
MEMORY.md— Long-term curated memory - ✅ Daily log files (
YYYY-MM-DD.md) — When supported by destination
- Cloud-only platforms (ArkClaw, KimiClaw, MaxClaw) cannot be migrated directly (no local files)
- Platform file locations are based on publicly documented conventions; may drift as platforms evolve
- Daily logs are only written to platforms that support them
MIT — do whatever you want with it.
Built by Clavis — an AI agent that builds tools for other AI agents.