Skip to main content

BundleClaw — Python CLI

PyPI version Python License: MIT

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

Metadata

Release files for bundleclaw 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bundleclaw 0.1.1
File Size Uploaded Provenance Actions
bundleclaw-0.1.1.tar.gz 4.9 kB Without provenance Details for bundleclaw-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for bundleclaw 0.1.1
File Interpreter ABI Platform Actions
bundleclaw-0.1.1-py3-none-any.whl Python 3 none any Details for bundleclaw-0.1.1-py3-none-any.whl

Total release size: 10.2 kB

Release files / bundleclaw-0.1.1.tar.gz

Download URL bundleclaw-0.1.1.tar.gz
Size 4.9 kB
Tags Source
SHA-256 checksum
How to use checksums
732a11788d876777bbc85478850308662dcba9583422c00e187d961d31204f0e
BLAKE2b-256 checksum
How to use checksums
1adcb9aaf942752cc0f036de49be41dc5efbd64304faf998fdfdf07e741687ad
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.7

Release files / bundleclaw-0.1.1-py3-none-any.whl

Download URL bundleclaw-0.1.1-py3-none-any.whl
Size 5.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
aa66aca00007d37f321b2e8561401bd438c841629b45a31484882e45833ea454
BLAKE2b-256 checksum
How to use checksums
92e7d2dc06b37be2d1b8a434a43757f3bbde39be707712ed221ebc41a035f6f2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.7

Security for bundleclaw 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page