> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# NVIDIA

NVIDIA бесплатно предоставляет открытые модели через API, совместимый с OpenAI, по адресу
`https://integrate.api.nvidia.com/v1`; для аутентификации используется ключ API с сайта
[build.nvidia.com](https://build.nvidia.com/settings/api-keys). По умолчанию OpenClaw
использует для провайдера NVIDIA модель Nemotron 3 Ultra — модель рассуждений NVIDIA
с 550 млрд параметров всего и 55 млрд активных параметров, предназначенную для агентных
задач с длинным контекстом.

## Начало работы

**1. Получите ключ API**

Создайте ключ API на сайте [build.nvidia.com](https://build.nvidia.com/settings/api-keys).

**2. Экспортируйте ключ и запустите первоначальную настройку**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export NVIDIA_API_KEY="nvapi-..."
openclaw onboard --auth-choice nvidia-api-key
```

**3. Выберите модель NVIDIA**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55b
```

Для неинтерактивной настройки передайте ключ напрямую:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."
```

> [!WARNING]
>
> `--nvidia-api-key` сохраняет ключ в истории командной оболочки и выводе `ps`. По возможности используйте
> переменную окружения `NVIDIA_API_KEY`.

## Пример конфигурации

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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-ultra-550b-a55b" },
    },
  },
}
```

## Рекомендуемый каталог

Когда настроен ключ API NVIDIA, при первоначальной настройке и выборе модели
загружается публичный каталог рекомендуемых моделей NVIDIA из
`https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json`, а
результат кэшируется на 24 часа (первые 32 записи импортируются как строки
с текстовым вводом без дополнительной обработки). Поэтому новые рекомендуемые модели с build.nvidia.com появляются при первоначальной настройке
и на экранах выбора моделей без необходимости ждать выпуска новой версии OpenClaw. Когда
динамический канал данных доступен, первая возвращённая модель предварительно выбирается
при настройке NVIDIA.

Для загрузки применяется фиксированная политика HTTPS-хоста для `assets.ngc.nvidia.com`. Если
ключ API NVIDIA не настроен либо канал данных недоступен или имеет некорректный формат,
OpenClaw использует приведённые ниже встроенный каталог и модель по умолчанию.

## Nemotron 3 Ultra

Nemotron 3 Ultra — модель NVIDIA по умолчанию в OpenClaw. На странице NVIDIA
[`nvidia/nemotron-3-ultra-550b-a55b`](https://build.nvidia.com/nvidia/nemotron-3-ultra-550b-a55b)
она указана как доступная бесплатная конечная точка со спецификацией контекста на 1 млн токенов.

Встроенная запись Ultra по умолчанию отправляет
`chat_template_kwargs: { enable_thinking: false, force_nonempty_content: true }`,
чтобы обычный ответ чата оставался в видимой части ответа, а текст рассуждений
не раскрывался.

Используйте Ultra как модель NVIDIA по умолчанию с максимальными возможностями. Оставьте выбранной Super, если
вам нужна уменьшенная версия Nemotron 3, или выберите одну из сторонних моделей,
размещённых в каталоге NVIDIA, если её контекст, задержка или поведение подходят лучше.

## Встроенный резервный каталог

Доступные для выбора встроенные записи представляют собой снимок каталога рекомендуемых моделей NVIDIA. Устаревшие
записи совместимости по-прежнему доступны по точной ссылке на модель, но не отображаются в средствах
выбора моделей.

| Ссылка на модель | Название | Контекст | Максимальный вывод |
| - | - | - | - |
| `nvidia/nvidia/nemotron-3-ultra-550b-a55b` | Nemotron 3 Ultra 550B | 1,048,576 | 8,192 |
| `nvidia/nvidia/nemotron-3-super-120b-a12b` | Nemotron 3 Super 120B | 1,000,000 | 8,192 |
| `nvidia/z-ai/glm-5.2` | GLM 5.2 | 202,752 | 8,192 |
| `nvidia/moonshotai/kimi-k2.6` | Kimi K2.6 | 262,144 | 8,192 |
| `nvidia/minimaxai/minimax-m3` | Minimax M3 | 196,608 | 8,192 |
| `nvidia/deepseek-ai/deepseek-v4-pro` | DeepSeek V4 Pro | 262,144 | 16,384 |
| `nvidia/qwen/qwen3.5-397b-a17b` | Qwen3.5 397B A17B | 262,144 | 16,384 |

Полный каталог совместимости также сохраняет следующие ранее выпущенные ссылки на модели для существующих
конфигураций: `nvidia/moonshotai/kimi-k2.5`, `nvidia/z-ai/glm-5.1`,
`nvidia/minimaxai/minimax-m2.5`, `nvidia/z-ai/glm5` и
`nvidia/minimaxai/minimax-m2.7`. Они по-прежнему доступны по точной ссылке, но
никогда не отображаются при первоначальной настройке или в средствах выбора моделей.

## Расширенная конфигурация

> [accordion] Автоматическое включение
>
> Провайдер включается автоматически, если задана переменная окружения `NVIDIA_API_KEY`
> или ключ был сохранён во время первоначальной настройки. Помимо ключа, явная конфигурация провайдера
> не требуется.

> [accordion] Каталог и стоимость
>
> При настроенной аутентификации NVIDIA OpenClaw предпочитает публичный каталог рекомендуемых моделей NVIDIA
> и кэширует его на 24 часа. Встроенный резервный каталог доступных для выбора моделей —
> статический снимок каталога рекомендуемых моделей NVIDIA; устаревшие записи совместимости,
> доступные по точной ссылке, скрыты из средств выбора моделей. В исходном коде стоимость по умолчанию равна `0`,
> поскольку NVIDIA в настоящее время предоставляет бесплатный доступ через API к перечисленным моделям.

> [accordion] Конечная точка, совместимая с OpenAI
>
> OpenClaw взаимодействует с NVIDIA через адаптер `openai-completions`, используя
> стандартный маршрут завершений чата `/v1`. Любые инструменты, совместимые с OpenAI, должны
> работать без дополнительной настройки с базовым URL NVIDIA.

> [accordion] Параметры рассуждений Nemotron 3 Ultra
>
> В примере запроса Ultra от NVIDIA для вывода рассуждений используются `chat_template_kwargs.enable_thinking`
> и `reasoning_budget`. Встроенная запись Ultra в OpenClaw
> по умолчанию отключает рассуждения в шаблоне для обычного чата. Если вам нужно
> включить вывод рассуждений NVIDIA или принудительно задать другие поля запроса,
> специфичные для NVIDIA, настройте параметры конкретной модели и ограничьте переопределения провайдера
> моделью NVIDIA:
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       models: {
>         "nvidia/nvidia/nemotron-3-ultra-550b-a55b": {
>           params: {
>             chat_template_kwargs: { enable_thinking: true },
>             extra_body: { reasoning_budget: 16384 },
>           },
>         },
>       },
>     },
>   },
> }
> ```
>
> `params.chat_template_kwargs` объединяется с уже имеющимся в запросе объектом
> `chat_template_kwargs`, а не заменяет его целиком.
> `params.extra_body` — окончательное переопределение тела запроса, совместимого с OpenAI,
> которое заменяет конфликтующие ключи полезной нагрузки, поэтому используйте его только для полей,
> документированных NVIDIA для выбранной конечной точки.

> [accordion] Медленные ответы пользовательского провайдера
>
> Некоторым пользовательским моделям, размещённым NVIDIA, может потребоваться больше времени, чем предусмотрено
> таймером бездействия модели по умолчанию (\~120 с), прежде чем они отправят первый фрагмент ответа. Для пользовательских
> записей провайдера NVIDIA увеличьте тайм-аут провайдера, а не всего
> времени выполнения агента; `timeoutSeconds` распространяется на HTTP-запросы провайдера и
> повышает предел таймера бездействия и потоковой передачи для этого провайдера:
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   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" },
>         },
>       },
>     },
>   },
> }
> ```

> [!TIP]
>
> В настоящее время модели NVIDIA можно использовать бесплатно. Актуальные сведения о доступности и
> ограничениях частоты запросов см. на сайте
> [build.nvidia.com](https://build.nvidia.com/).

## Связанные материалы

> [card] [Выбор модели](https://docs2.openclaw.ai/ru/concepts/model-providers.md)
>
> Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.

> [card] [Справочник по конфигурации](https://docs2.openclaw.ai/ru/gateway/configuration-reference.md)
>
> Полный справочник по конфигурации агентов, моделей и провайдеров.