Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.ai2me.io/llms.txt

Use this file to discover all available pages before exploring further.

NVIDIA provides an OpenAI-compatible API at https://integrate.api.nvidia.com/v1 for open models for free. Authenticate with an API key from build.nvidia.com.

​
Getting started

1

Get your API key

Create an API key at build.nvidia.com.
2

Export the key and run onboarding

export NVIDIA_API_KEY="nvapi-..."
openclaw onboard --auth-choice nvidia-api-key
3

Set an NVIDIA model

openclaw models set nvidia/nvidia/nemotron-3-super-120b-a12b
If you pass --nvidia-api-key instead of the env var, the value lands in shell history and ps output. Prefer the NVIDIA_API_KEY environment variable when possible.
For non-interactive setup, you can also pass the key directly: 
openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."

​
Config example

{
  env: { NVIDIA_API_KEY: "nvapi-..." },
  models: {
    providers: {
      nvidia: {
        baseUrl: "https://integrate.api.nvidia.com/v1",
        api: "openai-completions",
      },
    },
  },
  agents: {
    defaults: {
      model: { primary: "nvidia/nvidia/nemotron-3-super-120b-a12b" },
    },
  },
}
When an NVIDIA API key is configured, OpenClaw setup and model-selection paths try NVIDIA’s public featured-model catalog from https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json and caches the ranked result for 24 hours. New featured models from build.nvidia.com therefore appear in setup and model-selection surfaces without waiting for an OpenClaw release. The fetch uses a fixed HTTPS host policy for assets.ngc.nvidia.com. If no NVIDIA API key is configured, or if that public catalog is unavailable or malformed, OpenClaw falls back to the bundled catalog below.

​
Bundled fallback catalog

Model refNameContextMax outputNotes
nvidia/nvidia/nemotron-3-super-120b-a12bNVIDIA Nemotron 3 Super 120B262,1448,192Featured fallback
nvidia/moonshotai/kimi-k2.5Kimi K2.5262,1448,192Featured fallback
nvidia/minimaxai/minimax-m2.7Minimax M2.7196,6088,192Featured fallback
nvidia/z-ai/glm-5.1GLM 5.1202,7528,192Featured fallback
nvidia/minimaxai/minimax-m2.5MiniMax M2.5196,6088,192Deprecated, upgrade compatibility
nvidia/z-ai/glm5GLM-5202,7528,192Deprecated, upgrade compatibility

​
Advanced configuration

The provider auto-enables when the NVIDIA_API_KEY environment variable is set. No explicit provider config is required beyond the key.
OpenClaw prefers NVIDIA’s public featured-model catalog when NVIDIA auth is configured and caches it for 24 hours. The bundled fallback catalog is static and keeps deprecated shipped refs for upgrade compatibility. Costs default to 0 in source since NVIDIA currently offers free API access for the listed models.
NVIDIA uses the standard /v1 completions endpoint. Any OpenAI-compatible tooling should work out of the box with the NVIDIA base URL.
Some NVIDIA-hosted custom models can take longer than the default model idle watchdog before they emit a first response chunk. For custom NVIDIA provider entries, raise the provider timeout instead of raising the whole agent runtime timeout:
{
  models: {
    providers: {
      "custom-integrate-api-nvidia-com": {
        baseUrl: "https://integrate.api.nvidia.com/v1",
        api: "openai-completions",
        apiKey: "NVIDIA_API_KEY",
        timeoutSeconds: 300,
      },
    },
  },
  agents: {
    defaults: {
      models: {
        "custom-integrate-api-nvidia-com/meta/llama-3.1-70b-instruct": {
          params: { thinking: "off" },
        },
      },
    },
  },
}
NVIDIA models are currently free to use. Check build.nvidia.com for the latest availability and rate-limit details.

Model selection

Choosing providers, model refs, and failover behavior.

Configuration reference

Full config reference for agents, models, and providers.