@lessinbox/openclaw-migrate
v0.1.1
Published
Install-agnostic migration CLI scaffold for upgrading official OpenClaw installs to the Lessinbox fork and rolling back safely.
Readme
@lessinbox/openclaw-migrate
Install-agnostic migration CLI scaffold for upgrading official OpenClaw installs to the Lessinbox fork and rolling back safely.
Current status:
- Command wiring and state artifact generation are implemented.
- Default mode is non-mutating scaffold mode.
- Runtime mutation is available only with explicit
--apply(Docker + npm + source paths).
Commands:
lbx-openclaw detectlbx-openclaw migratelbx-openclaw connectlbx-openclaw verifylbx-openclaw rollbacklbx-openclaw status
Build:
pnpm --filter @lessinbox/openclaw-migrate buildExamples:
# non-mutating plan/receipt mode
node packages/openclaw-migrate/dist/cli.js migrate --install-type docker --plan --format json
# deterministic CI dry-run (no files written, no commands executed)
node packages/openclaw-migrate/dist/cli.js migrate --dry-run-json --apply --install-type docker --docker-compose-file ./docker-compose.yml --docker-service openclaw --target-image ghcr.io/lessinbox/openclaw-fork:v1 --format json
# apply Docker migration
node packages/openclaw-migrate/dist/cli.js migrate --apply --install-type docker --docker-compose-file ./docker-compose.yml --docker-service openclaw --target-image ghcr.io/lessinbox/openclaw-fork:v1 --format json
# apply Lessinbox runtime provider registration
node packages/openclaw-migrate/dist/cli.js connect --apply --workspace-url http://localhost:3333 --workspace-id wrk_demo --runtime-token <token> --runtime-base-url https://openclaw.example.com --dispatch-webhook-url https://openclaw.example.com/runtime/events --dispatch-gateway-url wss://openclaw.example.com/gateway --dispatch-client-name "Lessinbox Control" --format json
# apply verification against Lessinbox API
node packages/openclaw-migrate/dist/cli.js verify --apply --profile full --runtime-token <token> --format json
# apply source migration from a git checkout
node packages/openclaw-migrate/dist/cli.js migrate --apply --install-type source --source-repo-path /srv/openclaw --source-fork-remote-url [email protected]:lessinbox/openclaw.git --source-fork-ref main --source-build-command "pnpm install && pnpm build" --format json