# Migrator

> Securely migrate OpenClaw Agent (config, memory, skills) to a new machine.

- Skill: `kbarbel640-del/migrator` (Agent Skill, multi-file: 14 files)
- Install (CLI): `npx skillmds@latest add kbarbel640-del/migrator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/migrator/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/kbarbel640-del/migrator

---


# OpenClaw Migrator

A utility to package an Agent's state into a portable, encrypted archive (`.oca`) for migration.

## Features

- **Encrypted Archive**: Uses AES-256-GCM + auth tag for confidentiality and integrity.
- **Path Normalization**: Restores workspace path using `manifest.json` metadata.
- **Dependency Manifest**: Captures system dependencies (Brewfile) to ensure the new environment matches.

## Usage

### Export (On Old Machine)

```bash
migrator export --out my-agent.oca --password "secret"
```

### Import (On New Machine)

```bash
migrator import --in my-agent.oca --password "secret"
```

## Security

This skill handles sensitive data (`openclaw.json`, `auth.token`). 
The export process **always** requires a password to encrypt the archive.
Unencrypted exports are **disabled** by design.