English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Providers

NVIDIA

Edit source

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

  • Get your API key

    Create an API key at build.nvidia.com.

  • Export the key and run onboarding

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

  • Set an NVIDIA model

    bash
    openclaw models set nvidia/nvidia/nemotron-3-super-120b-a12b

    • For non-interactive setup, you can also pass the key directly:

    bash
    openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."

    Config example

    json5
    {  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 ref Name Context Max output Notes
    nvidia/nvidia/nemotron-3-super-120b-a12b NVIDIA Nemotron 3 Super 120B 262,144 8,192 Featured fallback
    nvidia/moonshotai/kimi-k2.5 Kimi K2.5 262,144 8,192 Featured fallback
    nvidia/minimaxai/minimax-m2.7 Minimax M2.7 196,608 8,192 Featured fallback
    nvidia/z-ai/glm-5.1 GLM 5.1 202,752 8,192 Featured fallback
    nvidia/minimaxai/minimax-m2.5 MiniMax M2.5 196,608 8,192 Deprecated, upgrade compatibility
    nvidia/z-ai/glm5 GLM-5 202,752 8,192 Deprecated, upgrade compatibility

    Advanced configuration

    Auto-enable behavior

    The provider auto-enables when the NVIDIA_API_KEY environment variable is set. No explicit provider config is required beyond the key.

    Catalog and pricing

    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.

    OpenAI-compatible endpoint

    NVIDIA uses the standard /v1 completions endpoint. Any OpenAI-compatible tooling should work out of the box with the NVIDIA base URL.

    Slow custom provider responses

    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:

    json5
    {  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" },        },      },    },  },}
    Model selection

    Choosing providers, model refs, and failover behavior.
    Configuration reference

    Full config reference for agents, models, and providers.
    Was this useful?