Switch Inference Models
Change the model on an existing provider route with a runtime update or a fresh sandbox recreation. The command requires both the provider and model even when the provider does not change.
Check the Current Route
Read the live route before changing it.
Use the provider ID in the output with the new model ID.
Change the Model at Runtime
Deep Agents uses the fresh recreation path for model changes.
This path keeps the OpenShell route and /sandbox/.deepagents/config.toml aligned.
To validate a new model before replacing the current sandbox, onboard it under a new name and make it the default after validation.
Account for Shared Gateways
One gateway has one live route even when NemoClaw records different intended routes for its sandboxes.
Review Use Shared Gateway Routes before changing a model that another registered sandbox shares.
Runtime inference set remains fail-closed when the requested change conflicts with another registered sandbox or when route metadata is incomplete.
Verify the Change
Read the route again after the switch.
Use a sandbox-route verification when you also need to prove that the agent can reach the model.
Related Topics
- View the Active Inference Route to inspect the current provider and model.
- Use Shared Gateway Routes when multiple sandboxes use one gateway.
- Switch Providers to move to another provider family.
- Verify the Sandbox Inference Route to test the agent path.