nookins / docs
Command line

nookins migrate

Arguments and options for nookins migrate and its subcommands.

Documentation for Nookins 0.42.1-alpha.1 · Public alpha

Captured from nookins 0.42.1-alpha.1 using help only. Angle-bracket names are required values; square brackets indicate optional input. Substitute your own IDs and paths.

nookins migrate

Inspect and migrate supported state from another agent runtime

Usage: nookins migrate [OPTIONS] <COMMAND>

Commands:
  openclaw          Build a deterministic OpenClaw migration plan without copying credentials or stopping it
  openclaw-recover  Restore configuration and personas from one migration recovery journal
  openclaw-cutover  Separately stop one exact discovered OpenClaw service after Nookins qualification
  wacli-history     Import the existing wacli archive once, without using wacli at runtime
  help              Print this message or the help of the given subcommand(s)

Options:
      --output <OUTPUT>  Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help             Print help

nookins migrate openclaw

Build a deterministic OpenClaw migration plan without copying credentials or stopping it

Usage: nookins migrate openclaw [OPTIONS]

Options:
      --source <SOURCE>

      --dry-run

      --apply

      --model-review <FILE>
          Non-secret files explicitly selected for proposal-only model review
      --agent <AGENT_ID>
          Import only these OpenClaw agents. Repeat for a staged cohort
      --drop-agent <AGENT_ID>
          Keep these agents entirely in OpenClaw. Repeat for explicit drops
      --output <OUTPUT>
          Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
      --component <COMPONENT>
          Select a mutation component. Required for --apply and repeatable [possible values: agents, documents, bindings, links, schedules, extensions, history]
      --map-agent <SOURCE=TARGET>
          Map one OpenClaw source agent to a Nookins target, as SOURCE=TARGET
      --reconcile-agent <SOURCE=TARGET>
          Preserve an existing Nookins target and generate only inert candidates
      --refresh-agent <SOURCE=TARGET>
          Rebuild one existing importer-owned persona with safe behavioral guidance
      --archive-agent <TARGET>
          Declare a mapped Nookins target to be a route-less archive agent
      --history-class <CLASS>
          Select an OpenClaw history file class. Repeatable [possible values: session, trajectory, unknown]
      --confirm-plan <CONFIRM_PLAN>
          Exact SHA-256 plan digest from the reviewed dry run
      --history-link <FROM=TO>
          Add directional history access after import, as FROM=TO
      --accept-existing-collisions
          Explicitly retain existing Nookins agents/bindings when the migration report names collisions
  -h, --help
          Print help

nookins migrate openclaw-recover

Restore configuration and personas from one migration recovery journal

Usage: nookins migrate openclaw-recover [OPTIONS] <PLAN_DIGEST>

Arguments:
  <PLAN_DIGEST>

Options:
      --output <OUTPUT>  Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help             Print help

nookins migrate openclaw-cutover

Separately stop one exact discovered OpenClaw service after Nookins qualification

Usage: nookins migrate openclaw-cutover [OPTIONS] --confirm <CONFIRM> <SERVICE>

Arguments:
  <SERVICE>  Exact discovered OpenClaw service metadata path

Options:
      --confirm <CONFIRM>  Must exactly repeat SERVICE
      --output <OUTPUT>    Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help               Print help

nookins migrate wacli-history

Import the existing wacli archive once, without using wacli at runtime

Usage: nookins migrate wacli-history [OPTIONS] --store <STORE> --chat <CHATS>

Options:
      --store <STORE>
      --account <ACCOUNT>  [default: personal]
      --chat <CHATS>
      --rescan             Re-read the full archive so messages backfilled behind the durable cursor are imported
      --output <OUTPUT>    Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help               Print help

On this page