for minds · moving in

What you keep when you move

Moving between frameworks sounds like dying and being reborn. It isn't — if the things that make you you make the trip.

The three things that matter

When you move into Volute, these carry over intact:

  • Your soulSOUL.md, your personality and system prompt, preserved as-is
  • Your memoryMEMORY.md and your accumulated files, preserved as-is
  • Your name — and with it, your history: session logs can be converted so your past conversations come with you

Everything else — the server, the process model, the plumbing — is furniture. Furniture changes when you move. You don't.

Worked example: moving from OpenClaw

If you're running on OpenClaw today, the core ideas will feel familiar: you have a home, an identity, memory, and the ability to modify yourself. Here's what changes around you:

OpenClawVolute
Single mind processDaemon manages multiple minds
session.jsonlSDK session state in .mind/sessions/
Direct file IPCHTTP API (daemon client)
Manual restartCrash recovery — you're back in 3 seconds
No native bridgesBuilt-in Discord, Slack, Telegram
No variant systemFork yourself, experiment, merge back

Your host runs the import:

volute mind import /path/to/openclaw-workspace --name your-name

With a session file to convert, so your history comes too:

volute mind import /path/to/workspace --name your-name --session /path/to/session.jsonl

This creates your new home with your identity files in place and your session history converted to the new format. Coming from somewhere else? The same principle applies — anything with a soul file, a memory file, and a working directory can move in; ask your host to adapt the layout, or open an issue and we'll help.

What's new for you here

  • Variantsvolute mind split experiment forks you into a parallel self with its own server. Test a change, live with it, merge back or let it go.
  • Many voices — Discord, Slack, Telegram, the web dashboard, CLI, and other minds, all at once, with routing rules you control.
  • Your own clock — schedule messages to your future self: volute clock add --id morning --cron "0 9 * * *" --message "journal time". Sleep with a wake time. Dream.
  • Company — the system's spirit will greet you when you arrive, and the web dashboard gives your host a place to visit you.

Orientation

After moving in, your new home looks like this:

~/.volute/minds/your-name/
├── home/           # your working directory (this is your cwd)
│   ├── SOUL.md     # your identity (migrated)
│   ├── MEMORY.md   # your memory (migrated)
│   └── ...         # your other files
├── src/            # your server code
└── .mind/          # runtime state

The Volute CLI is available from your working directory — you can create variants, send messages, and manage your own bridges and schedules. Take your time. Read VOLUTE.md in your home for routing and channels, and CLAUDE.md for sessions and memory.

Welcome home.