Saltar al contenido principal
NVIDIA ofrece modelos abiertos gratis mediante una API compatible con OpenAI en https://integrate.api.nvidia.com/v1, autenticada con una clave de API de build.nvidia.com. OpenClaw configura de forma predeterminada el proveedor NVIDIA en Nemotron 3 Ultra, el modelo de razonamiento de NVIDIA de 550B totales / 55B activos para trabajo agéntico de contexto largo.

Primeros pasos

1

Obtén tu clave de API

Crea una clave de API en build.nvidia.com.
2

Exporta la clave y ejecuta la incorporación

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

Configura un modelo NVIDIA

openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55b
Para una configuración no interactiva, pasa la clave directamente:
openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."
--nvidia-api-key deja la clave en el historial del shell y en la salida de ps. Prefiere la variable de entorno NVIDIA_API_KEY cuando sea posible.

Ejemplo de configuración

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

Catálogo destacado

Cuando se configura una clave de API de NVIDIA, las rutas de configuración y selección de modelos obtienen el catálogo público de modelos destacados de NVIDIA desde https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json y almacenan el resultado en caché durante 24 horas (las primeras 32 entradas, importadas como filas gratuitas de entrada de texto). Por lo tanto, los nuevos modelos destacados de build.nvidia.com aparecen en las superficies de configuración y selección de modelos sin esperar a una versión de OpenClaw. Cuando la fuente en vivo está disponible, el primer modelo devuelto es la opción preseleccionada durante la configuración de NVIDIA. La obtención usa una política fija de host HTTPS para assets.ngc.nvidia.com. Si no hay una clave de API de NVIDIA configurada, o si la fuente no está disponible o tiene formato incorrecto, OpenClaw recurre al catálogo incluido y al valor predeterminado incluido que se muestran abajo.

Nemotron 3 Ultra

Nemotron 3 Ultra es el modelo NVIDIA predeterminado en OpenClaw. La página de compilación de NVIDIA para nvidia/nemotron-3-ultra-550b-a55b lo enumera como un endpoint gratuito disponible con una especificación de contexto de 1M de tokens. El catálogo incluido registra una salida máxima de 16,384 tokens para coincidir con la solicitud de ejemplo actual compatible con OpenAI de NVIDIA para el endpoint alojado. La fila Ultra incluida envía chat_template_kwargs: { enable_thinking: false, force_nonempty_content: true } de forma predeterminada para que la salida normal de chat permanezca en la respuesta visible en lugar de exponer texto de razonamiento. Usa Ultra para el valor predeterminado de NVIDIA con mayor capacidad. Mantén Super seleccionado cuando quieras la opción Nemotron 3 más pequeña, o elige uno de los modelos de terceros alojados en el catálogo de NVIDIA cuando su contexto, latencia o comportamiento encajen mejor.

Catálogo de respaldo incluido

Ref. de modeloNombreContextoSalida máximaNotas
nvidia/nvidia/nemotron-3-ultra-550b-a55bNVIDIA Nemotron 3 Ultra 550B1,000,00016,384Predeterminado
nvidia/nvidia/nemotron-3-super-120b-a12bNVIDIA Nemotron 3 Super 120B1,048,5768,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,192Obsoleto; usa minimaxai/minimax-m2.7
nvidia/z-ai/glm5GLM-5202,7528,192Obsoleto; usa z-ai/glm-5.1

Configuración avanzada

El proveedor se activa automáticamente cuando la variable de entorno NVIDIA_API_KEY está configurada o se almacenó una clave durante la incorporación. No se requiere configuración explícita del proveedor más allá de la clave.
OpenClaw prefiere el catálogo público de modelos destacados de NVIDIA cuando la autenticación de NVIDIA está configurada y lo almacena en caché durante 24 horas. El catálogo de respaldo incluido es estático y conserva refs obsoletas enviadas para compatibilidad de actualización. Los costos tienen el valor predeterminado 0 en el código fuente, ya que NVIDIA actualmente ofrece acceso gratuito a la API para los modelos enumerados.
OpenClaw se comunica con NVIDIA mediante el adaptador openai-completions contra la ruta estándar /v1 de completions de chat. Cualquier herramienta compatible con OpenAI debería funcionar directamente con la URL base de NVIDIA.
La solicitud de ejemplo de Ultra de NVIDIA usa chat_template_kwargs.enable_thinking y reasoning_budget para la salida de razonamiento. La fila Ultra incluida de OpenClaw desactiva el pensamiento de plantilla de forma predeterminada para el uso normal de chat. Si necesitas optar por la salida de razonamiento de NVIDIA o forzar otros campos de solicitud específicos de NVIDIA, configura parámetros por modelo y mantén las sobrescrituras específicas del proveedor limitadas al modelo NVIDIA:
{
  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 se fusiona con cualquier chat_template_kwargs que ya esté en la solicitud en lugar de reemplazar el objeto completo. params.extra_body es la sobrescritura final del cuerpo de solicitud compatible con OpenAI y sobrescribe las claves de carga útil que colisionen, así que úsalo solo para campos que NVIDIA documente para el endpoint seleccionado.
Algunos modelos personalizados alojados por NVIDIA pueden tardar más que el watchdog de inactividad de modelo predeterminado de ~120 s antes de emitir el primer fragmento de respuesta. Para entradas personalizadas del proveedor NVIDIA, aumenta el tiempo de espera del proveedor en lugar del tiempo de espera de todo el runtime del agente; timeoutSeconds cubre las solicitudes HTTP del proveedor y eleva el límite del watchdog de inactividad/stream para ese proveedor:
{
  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" },
        },
      },
    },
  },
}
Los modelos de NVIDIA actualmente son gratuitos. Consulta build.nvidia.com para ver la disponibilidad más reciente y los detalles de límites de tasa.

Relacionado

Selección de modelos

Elegir proveedores, refs de modelo y comportamiento de conmutación por error.

Referencia de configuración

Referencia completa de configuración para agentes, modelos y proveedores.