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

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

1

Получите API-ключ

Создайте API-ключ на build.nvidia.com.
2

Экспортируйте ключ и запустите онбординг

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

Задайте модель NVIDIA

openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55b
Если передать --nvidia-api-key вместо переменной окружения, значение попадет в историю оболочки и вывод ps. По возможности предпочитайте переменную окружения NVIDIA_API_KEY.
Для неинтерактивной настройки ключ также можно передать напрямую: 
openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."

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

{
  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 настроен, пути настройки OpenClaw и выбора моделей пытаются использовать публичный каталог избранных моделей NVIDIA с https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json и кэшируют ранжированный результат на 24 часа. Поэтому новые избранные модели с 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 указывает ее как доступную бесплатную конечную точку со спецификацией контекста в 1M токенов. Во встроенном каталоге указан максимальный вывод в 16 384 токена, чтобы соответствовать текущему OpenAI-совместимому примеру запроса NVIDIA для размещенной конечной точки. Используйте Ultra как вариант NVIDIA по умолчанию с максимальными возможностями. Оставьте Super выбранной, когда нужен меньший вариант Nemotron 3, или выберите одну из сторонних моделей, размещенных в каталоге NVIDIA, если их контекст, задержка или поведение подходят лучше. Встроенная строка Ultra по умолчанию отправляет chat_template_kwargs.enable_thinking: false и force_nonempty_content: true, чтобы обычный вывод чата оставался в видимом ответе вместо раскрытия текста рассуждений.

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

Ссылка на модельНазваниеКонтекстМакс. выводПримечания
nvidia/nvidia/nemotron-3-ultra-550b-a55bNVIDIA Nemotron 3 Ultra 550B1,000,00016,384По умолчанию
nvidia/nvidia/nemotron-3-super-120b-a12bNVIDIA Nemotron 3 Super 120B262,1448,192Резервный вариант из избранного каталога
nvidia/moonshotai/kimi-k2.5Kimi K2.5262,1448,192Резервный вариант из избранного каталога
nvidia/minimaxai/minimax-m2.7Minimax M2.7196,6088,192Резервный вариант из избранного каталога
nvidia/z-ai/glm-5.1GLM 5.1202,7528,192Резервный вариант из избранного каталога
nvidia/minimaxai/minimax-m2.5MiniMax M2.5196,6088,192Устарело, совместимость обновления
nvidia/z-ai/glm5GLM-5202,7528,192Устарело, совместимость обновления

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

Провайдер автоматически включается, когда установлена переменная окружения NVIDIA_API_KEY. Явная конфигурация провайдера помимо ключа не требуется.
OpenClaw предпочитает публичный каталог избранных моделей NVIDIA, когда аутентификация NVIDIA настроена, и кэширует его на 24 часа. Встроенный резервный каталог статичен и сохраняет устаревшие поставлявшиеся ссылки для совместимости обновления. Стоимость по умолчанию равна 0 в исходном коде, поскольку NVIDIA сейчас предлагает бесплатный API-доступ для перечисленных моделей.
NVIDIA использует стандартную конечную точку завершений /v1. Любой OpenAI-совместимый инструментарий должен работать сразу с базовым URL NVIDIA.
Пример запроса NVIDIA для Ultra использует chat_template_kwargs.enable_thinking и reasoning_budget для вывода рассуждений. Встроенная строка Ultra в OpenClaw по умолчанию отключает шаблонное мышление для обычного использования чата. Если нужно включить вывод рассуждений NVIDIA или принудительно задать другие специфичные для NVIDIA поля запроса, задайте параметры для модели и ограничьте специфичные для провайдера переопределения моделью NVIDIA:
{
  agents: {
    defaults: {
      models: {
        "nvidia/nvidia/nemotron-3-ultra-550b-a55b": {
          params: {
            chat_template_kwargs: { enable_thinking: true },
            extra_body: { reasoning_budget: 16384 },
          },
        },
      },
    },
  },
}
params.extra_body — итоговое переопределение тела OpenAI-совместимого запроса, поэтому используйте его только для полей, которые NVIDIA документирует для выбранной конечной точки.
Некоторым пользовательским моделям, размещенным NVIDIA, может требоваться больше времени, чем допускает стандартный сторожевой таймер простоя модели, прежде чем они выдадут первый фрагмент ответа. Для пользовательских записей провайдера NVIDIA увеличьте тайм-аут провайдера вместо увеличения тайм-аута всей среды выполнения агента:
{
  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 сейчас бесплатны для использования. Проверяйте build.nvidia.com для получения актуальных сведений о доступности и лимитах скорости.

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

Выбор модели

Выбор провайдеров, ссылок на модели и поведения при отказе.

Справочник конфигурации

Полный справочник конфигурации для агентов, моделей и провайдеров.