Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions .agents/skills/nemoclaw-user-reference/references/commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -158,6 +158,25 @@ In interactive mode, the wizard asks for confirmation before delete and recreate
In non-interactive mode, NemoClaw recreates automatically when the stored selection is readable and differs; if NemoClaw cannot read the stored selection, NemoClaw reuses by default.
Set `NEMOCLAW_RECREATE_SANDBOX=1` to force recreation even when no drift is detected.

#### `--recreate-sandbox`

Delete and recreate the existing sandbox instead of reusing it.
Use this when you need onboarding to rebuild the sandbox after configuration changes, to recover from a broken sandbox state, or to force recreation when no provider or model drift is detected.

```console
$ nemoclaw onboard --resume --recreate-sandbox

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please mirror the source docs correction in the generated skill copy so the two files stay in sync.

Suggested change
$ nemoclaw onboard --resume --recreate-sandbox
$ nemoclaw onboard --recreate-sandbox

```

In non-interactive mode, `NEMOCLAW_RECREATE_SANDBOX=1` provides the same behavior.

#### `--agent <name>`

Select a specific installed agent profile during onboarding instead of using the default agent.

```console
$ nemoclaw onboard --agent hermes
```

Before creating the gateway, the wizard runs preflight checks.
It verifies that Docker is reachable, warns on untested runtimes such as Podman, and prints host remediation guidance when prerequisites are missing.
The preflight also enforces the OpenShell version range declared in the blueprint (`min_openshell_version` and `max_openshell_version`).
Expand Down
19 changes: 19 additions & 0 deletions docs/reference/commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -180,6 +180,25 @@ In interactive mode, the wizard asks for confirmation before delete and recreate
In non-interactive mode, NemoClaw recreates automatically when the stored selection is readable and differs; if NemoClaw cannot read the stored selection, NemoClaw reuses by default.
Set `NEMOCLAW_RECREATE_SANDBOX=1` to force recreation even when no drift is detected.

#### `--recreate-sandbox`

Delete and recreate the existing sandbox instead of reusing it.
Use this when you need onboarding to rebuild the sandbox after configuration changes, to recover from a broken sandbox state, or to force recreation when no provider or model drift is detected.

```console
$ nemoclaw onboard --resume --recreate-sandbox

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

--resume is only for continuing an interrupted onboarding session; completed sessions are marked non-resumable, so this example can fail for the normal "recreate an existing sandbox" case. Suggest dropping --resume here.

Suggested change
$ nemoclaw onboard --resume --recreate-sandbox
$ nemoclaw onboard --recreate-sandbox

```

In non-interactive mode, `NEMOCLAW_RECREATE_SANDBOX=1` provides the same behavior.

#### `--agent <name>`

Select a specific installed agent profile during onboarding instead of using the default agent.

```console
$ nemoclaw onboard --agent hermes
```

Before creating the gateway, the wizard runs preflight checks.
It verifies that Docker is reachable, warns on untested runtimes such as Podman, and prints host remediation guidance when prerequisites are missing.
The preflight also enforces the OpenShell version range declared in the blueprint (`min_openshell_version` and `max_openshell_version`).
Expand Down