Migration Guide: Moltbot to OpenClaw

OpenClaw (formerly Moltbot/Clawdbot) is moving fast. This guide covers how to safely migrate your existing installation to the latest version (v2026.1.30+).

Snapshot your current configuration and workspace:

• Config: ~/.openclaw/openclaw.json (or ~/.moltbot/moltbot.json)
• Credentials: ~/.openclaw/credentials/
• Workspace: ~/.openclaw/workspace

The easiest way to update is to re-run the installer. It detects existing installs, upgrades in place, and runs openclaw doctor automatically.

curl -fsSL https://openclaw.ai/install.sh | bash

Notes:

• Add --no-onboard if you don’t want the onboarding wizard to run again.
• This works for both global and source installs.

If you installed via npm or pnpm globally, you can update using your package manager.

Using npm:

npm i -g openclaw@latest

Using pnpm:

pnpm add -g openclaw@latest

After updating, run the doctor command to ensure everything is migrated correctly:

openclaw doctor
openclaw gateway restart

If you are running from a git clone, use the built-in update command:

openclaw update

This command will:

1. Switch to the selected channel.
2. Fetch and rebase against upstream.
3. Rebuild dependencies and the Control UI.
4. Run openclaw doctor.
5. Restart the gateway.

After updating, verify your installation status:

openclaw --version
openclaw health

• Per-Agent Models: Check model status with openclaw gateway status --agent.
• Shell Completion: Run openclaw completion to set up tab completion for Zsh/Bash/PowerShell.

If you encounter issues:

1. Run openclaw doctor - it fixes most common config and migration issues.
2. Check the logs: openclaw logs --follow.
3. If necessary, you can rollback to a specific version (see Updating Docs).