Skip to content

Make nemoclaw onboard robust when rerun after a failed install instead of requiring uninstall.sh as a workaround #23

@kjw3

Description

@kjw3

Summary

When installation or onboarding fails, the known workaround is to run uninstall.sh before trying again. This recovery path is not documented in product output and suggests the setup flow is not idempotent.

Problem

Users should not need to discover from external notes that a full uninstall is required to recover from a transient namespace or gateway failure.

Expected behavior

Onboarding should either be safely rerunnable or should print an explicit cleanup step when the environment cannot be reused.

Acceptance criteria

  • Failed onboarding attempts can be retried without a full manual uninstall in common cases.
  • If a retry requires cleanup, the CLI prints the exact remediation command.
  • The troubleshooting docs include the current rerun failure modes.
  • A test covers rerunning onboarding after an interrupted or failed setup.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Getting StartedUse this label to identify setup, installation, or onboarding issues.NemoClaw CLIUse this label to identify issues with the NemoClaw command-line interface (CLI).documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions