Migration (from OpenClaw)

Import settings, memories, skills, and API keys from an existing OpenClaw install.

Coming from OpenClaw, Synapse imports your SOUL.md persona, memories (MEMORY.md / USER.md), user-created skills, command allowlist, messaging settings, allowlisted API keys, TTS assets, and AGENTS.md workspace instructions. Your agent's identity and history come with you.

During first-time setup

The setup wizard detects ~/.openclaw automatically and offers migration before configuration begins.

Anytime after install

bash

synapse claw migrate              # interactive migration (full preset)
synapse claw migrate --dry-run    # preview what would be migrated
synapse claw migrate --preset user-data   # migrate without secrets
synapse claw migrate --overwrite  # overwrite existing conflicts

Presets

Preset	Includes
full	Everything: persona, memories, skills, keys, messaging settings
user-data	Persona, memories, skills — no secrets

Run synapse claw migrate --help for all options, or use the openclaw-migration skill for an interactive, agent-guided migration with dry-run previews.