Migration

Migrating from OpenClaw

One command. Everything comes along.

phoenix

If an OpenClaw config exists, first flight migrates it automatically:

• ✅ model choice + fallbacks
• ✅ every API key (all providers, whole rotation rings)
• ✅ Claude Code OAuth token
• ✅ Telegram bot token + allowlists
• ✅ workspace + approval settings
• ✅ personality: SOUL.md, AGENTS.md, USER.md, IDENTITY.md, TOOLS.md
• ✅ memory: MEMORY.md + daily notes

Your assistant wakes up as itself — same soul, same rules, same memories — not a stranger.

Non-interactive version: phoenix migrate --secrets --write.

Safe cutover

openclaw gateway stop        # old bird rests (don't uninstall yet)
phoenix service install      # new bird takes the chats

Live with it a few days. Rollback is just starting OpenClaw again. Happy? Then remove OpenClaw. Nothing was burned prematurely.