Switch Inference Providers

Move a sandbox to another provider family while keeping the OpenShell route, agent configuration, and host registry aligned. Use onboarding first when the target is neither compatible-endpoint nor compatible-anthropic-endpoint and is not registered. The compatible endpoint workflow below can register an absent custom provider from complete route metadata.

Recreate a Deep Agents Sandbox

Deep Agents uses fresh sandbox recreation for provider changes. The recreation validates the provider and rewrites /sandbox/.deepagents/config.toml with the OpenShell route.

$
nemo-deepagents onboard --fresh --name <sandbox-name> --recreate-sandbox

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 provider that another registered sandbox shares. Runtime inference set also refuses a change that would leave another registered sandbox with a different recorded route.

Related Topics

• View the Active Inference Route to inspect the route before and after a switch.
• Use Shared Gateway Routes when multiple sandboxes use one gateway.
• Switch Models when the provider does not change.
• Set Up an OpenAI-Compatible Endpoint to register a custom route through onboarding.