clawd-migrate

Migrate from moltbot or clawdbot to openclaw. Preserves config, memory, and clawdbook (Moltbook) data. Works on any system.

Quick start

Requirements: Node.js 14+ and Python 3.x. Works on Windows, macOS, and Linux.

npx clawd-migrate

That starts the interactive menu (lobster + guided steps). For full install options and all commands, see HOW_TO_RUN.md.

What it does

• Discovers your existing bot assets (memory files, config, clawdbook/Moltbook).
• Backs up everything into a timestamped folder before any changes.
• Migrates your files into the openclaw layout: memory/, .config/openclaw/, .config/clawdbook/, and preserves projects/.
• Optionally installs openclaw (npm i -g openclaw) and runs openclaw onboard in the migrated directory so openclaw is set up with your existing files in place.

Migration does not download openclaw by itself; use the post-migration step (TUI prompt or --setup-openclaw) to install openclaw and onboard the directory. Supports both moltbot and clawdbot source layouts; no machine-specific paths.

Install and run

| Method | Command | |--------|--------| | Run without installing | npx clawd-migrate | | Install globally | npm install -g clawd-migrate then clawd-migrate | | Install in a project | npm install clawd-migrate then npx clawd-migrate |

Full details, CLI options, and Python-only usage: HOW_TO_RUN.md.

Commands (CLI)

clawd-migrate                    # Interactive menu (default)
clawd-migrate discover [--root PATH]
clawd-migrate backup [--root PATH] [--backup-dir PATH]
clawd-migrate migrate [--root PATH] [--no-backup] [--output PATH] [--setup-openclaw]

--root defaults to the current directory. Use --setup-openclaw to run npm i -g openclaw and openclaw onboard in the output directory after migration.

What gets migrated

• Memory/identity: SOUL.md, USER.md, TOOLS.md, IDENTITY.md, AGENTS.md, MEMORY.md
• Config: .config/moltbook/, .config/moltbot/ (credentials and API keys)
• Clawdbook/Moltbook: Kept under .config/clawdbook in the openclaw layout
• Extra: projects/ (if present)

Backups go under backups/ (or --backup-dir) with prefix openclaw_migrate_backup_.

Tests

From the repo root:

npm test

Runs Python unit tests for discover, backup, and migrate.

Documentation

| Doc | Description | |-----|-------------| | HOW_TO_RUN.md | How to run – install, interactive mode, CLI, examples | | Documentation/GITHUB.md | Publishing this repo to GitHub | | Documentation/NPM_PUBLISH.md | Publishing to npm | | Documentation/TESTS.md | Running and writing tests | | Documentation/MIGRATION_SOURCES.md | Moltbot/clawdbot support | | Documentation/MIGRATION_TUI.md | Interactive TUI (lobster + menu) |

License

MIT