bundleclaw 0.1.0

Migrate OpenClaw agent state between machines

BundleClaw — Python CLI

Python implementation of the BundleClaw migration CLI.

---

Install

# pip
pip install bundleclaw

# uv
uv pip install bundleclaw

# Or run directly
uvx bundleclaw --help

Usage

# Export agent state
bundleclaw export \
  --source ~/.openclaw \
  --workspace ~/.openclaw/workspace \
  --profile full \
  --encrypt-pass 'strong-passphrase' \
  --out agent-state.bcz

# Import on target machine
bundleclaw import \
  --bundle agent-state.bcz \
  --target ~/.openclaw \
  --encrypt-pass 'strong-passphrase'

# Verify integrity
bundleclaw verify --target ~/.openclaw

# Transfer via SCP
bundleclaw transfer \
  --bundle agent-state.bcz \
  --to user@host:/tmp/agent-state.bcz

# Full bootstrap (import + verify + restart + health check)
bundleclaw bootstrap \
  --bundle agent-state.bcz \
  --encrypt-pass 'strong-passphrase' \
  --target ~/.openclaw

Development

python -m venv .venv
source .venv/bin/activate
pip install -e .
bundleclaw --help

Tech Stack

• Typer for CLI argument parsing (Click-based)
• cryptography for AES-256-GCM encryption
• zipfile (stdlib) for ZIP archive handling
• hashlib (stdlib) for SHA-256 checksums

Interoperability

Bundles created with this CLI are fully compatible with the Node CLI. The shared .bcz format is documented in spec/FORMAT.md.

License

MIT