Documentation

Migration API & Export Formats

Everything you need to migrate OpenClaw workspaces programmatically — quickstart, export format reference, and API endpoints.

Getting Started

The ClawSail CLI and SDK let you migrate entire OpenClaw workspaces between servers or export them to other agent frameworks.

1. Install the CLI

npm install -g @clawsail/cli

2. Connect to Source Workspace

# Point at your existing OpenClaw instance
clawsail connect --source https://my-server.example.com
# Or scan a local workspace directory
clawsail connect --source ./my-openclaw-workspace

3. Run a Migration

# Server-to-server migration
clawsail migrate --dest https://new-server.example.com
# Cross-platform export
clawsail export --format claude-code --output ./export

ClawSail scans memory, personality files (SOUL.md, AGENTS.md), installed skills, and configs. It generates a migration plan before executing any transfer.

Supported Export Formats

Each format maps OpenClaw workspace components to the target framework. Fidelity varies by target.

OpenClaw

Fidelity: 100%

Full workspace transfer between servers. Zero loss.

Claude Code

Fidelity: ~90%

Memory, personality, and project configs. Some skills need manual porting.

NanoClaw

Fidelity: ~85%

Core memory and personality. Skill format conversion is automatic.

JSON Archive

Fidelity: 100%

Raw export of all workspace data. Use for backups or custom tooling.

Migration API

For programmatic access, use the REST API directly.

Create Migration Job

POST /api/v1/migrations
Authorization: Bearer <api-key>
{
"source": "https://old-server.example.com",
"destination": "https://new-server.example.com",
"components": ["memory", "personality", "skills", "config"]
}

Check Migration Status

GET /api/v1/migrations/:id
Response:
{
"id": "mig_abc123",
"status": "completed",
"components_transferred": 4,
"integrity_check": "passed"
}

Export Workspace

POST /api/v1/exports
{
"source": "https://my-server.example.com",
"format": "claude-code" | "nanoclaw" | "json",
"include": ["memory", "personality", "skills"]
}

Ready to migrate your workspace?

Join the waitlist for early access to the ClawSail CLI and migration API.

Join Waitlist