title: CLI launcher runtime and recovery

scenario:
  id: cli-launcher-runtime
  surface: cli
  category: cli.cli-setup
  coverage:
    primary:
      - cli.cli-entrypoint
      - cli.supported-node-runtime
  objective: Verify the actual OpenClaw launcher accepts supported runtimes, rejects unsupported runtimes, serves help and version, and reports source-build recovery guidance.
  successCriteria:
    - The copied launcher executes under every supported Node minimum and future supported majors.
    - Below-floor and unsupported Node versions exit before loading the CLI with the documented runtime requirement.
    - "`--help` and `--version` execute through the launcher fast path."
    - A source checkout without built output reports the supported recovery command.
  docsRefs:
    - docs/install/index.md
    - docs/help/troubleshooting.md
  codeRefs:
    - openclaw.mjs
    - test/openclaw-launcher.e2e.test.ts
  execution:
    kind: vitest
    path: test/openclaw-launcher.e2e.test.ts
    summary: Executes copied launcher processes across supported and rejected runtime versions, CLI fast paths, and missing-build recovery.