NVIDIA

NVIDIA 通过兼容 OpenAI 的 API 免费提供开放模型，地址为 https://integrate.api.nvidia.com/v1，使用来自 build.nvidia.com 的 API 密钥进行身份验证。OpenClaw 默认将 NVIDIA 提供者设置为 Nemotron 3 Ultra，这是 NVIDIA 总参数量 550B / 激活参数量 55B 的推理模型，专为长上下文 agentic 工作设计。

开始入门¶

1. 获取你的 API 密钥

在 build.nvidia.com 创建一个 API 密钥。

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

对于非交互式设置，可直接传入密钥：

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

配置示例¶

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

实时模型目录¶

当配置了 NVIDIA API 密钥时，设置和模型选择流程会检查 https://integrate.api.nvidia.com/v1/models 以获取可用的模型 ID，结果缓存 30 秒。NVIDIA 公开的 https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json 数据源提供排名和 token 限制，缓存 24 小时。特色模型仅在推理清单仍列出它们时才会优先显示；其他可用的捆绑聊天模型随后显示。新的清单可以恢复 NVIDIA 已重新发布的先前被隐藏的模型。

该清单还包含 embeddings 和其他非聊天端点，但没有任何能力元数据。因此，OpenClaw 只提供带有捆绑聊天元数据或有效特色模型元数据的精确模型；它不会根据模型名称猜测能力。未知 ID 仍然可以显式配置；仅凭清单列表并不能证明聊天兼容性。这并不是 NVIDIA 所有模型的完整自动目录。

这两次公开请求都使用固定的 HTTPS 主机，且不发送任何凭据。失败的清单或特色请求会将发现机制标记为不可用，并保留相同提供者配置和凭据下最后一次成功的目录。失败的特性元数据不会悄悄移除先前发现的模型。成功的空清单会清除已发现的模型，即使特色数据源请求失败。在没有 NVIDIA 认证的情况下，浏览会使用捆绑目录而不进行拉取。

Nemotron 3.5 Lightning¶

nvidia/nemotron-3.5-lightning-30b-a3b 是 NVIDIA 面向 agentic 工作的较小规模 30B 总参数量 / 3B 激活参数量的推理模型。捆绑行记录了其 1M 上下文和 16,384-token 输出预算，与 NVIDIA 托管示例一致。可通过以下命令选择它：

openclaw models set nvidia/nvidia/nemotron-3.5-lightning-30b-a3b

只要实时清单中列出了 Lightning，即使特色数据源中没有它，也可以选择。Nemotron 3 Ultra 仍是默认模型。

Nemotron 3 Ultra¶

Nemotron 3 Ultra 是 OpenClaw 中默认的 NVIDIA 模型。NVIDIA 的构建页面 nvidia/nemotron-3-ultra-550b-a55b 将其列为可用的免费端点，并带有 1M-token 上下文规格。

捆绑的 Ultra 行默认发送 chat_template_kwargs: { enable_thinking: false, force_nonempty_content: true }，以便正常的聊天输出保留在可见答案中，而不是暴露推理文本。

如需 NVIDIA 默认模型中最高能力，请使用 Ultra。当你想要更小的 Nemotron 选项时，可选择 Nemotron 3.5 Lightning 或 Nemotron 3 Super；或者，当 NVIDIA 目录中托管的第三方模型的上下文、延迟或行为更合适时，也可选择其中一个。

捆绑的备用目录¶

捆绑行提供已知的聊天元数据和离线备用方案。已弃用的兼容性行保留现有精确模型引用以便识别，但不会出现在模型选择器中。

完整的兼容性目录还保留了这些随附引用，供现有配置和迁移使用：nvidia/qwen/qwen3.5-397b-a17b、nvidia/moonshotai/kimi-k2.5、nvidia/z-ai/glm-5.1、nvidia/z-ai/glm5 和 nvidia/minimaxai/minimax-m2.7。除非 NVIDIA 在其推理清单中重新发布，否则这些引用将保持隐藏在捆绑和离线模型选择器中。NVIDIA 已退役 Qwen 端点，因此使用其模型引用的请求不再有效。请将现有的 Qwen 配置迁移到活跃模型。

高级配置¶

{
  agents: {
    defaults: {
      models: {
        "nvidia/nvidia/nemotron-3-ultra-550b-a55b": {
          params: {
            chat_template_kwargs: { enable_thinking: true },
            extra_body: { reasoning_budget: 16384 },
          },
        },
      },
    },
  },
}

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

相关¶

模型选择

选择提供商、模型引用和故障转移行为。

配置参考

代理、模型和提供商的完整配置参考。