Skip to main content
NVIDIA 通过位于 https://integrate.api.nvidia.com/v1 的兼容 OpenAI 的 API 免费提供开放模型，并使用来自 build.nvidia.com 的 API key 进行身份验证。OpenClaw 默认将 NVIDIA provider 设为 Nemotron 3 Ultra，这是 NVIDIA 的 550B 总参数 / 55B 激活参数推理模型，适用于长上下文智能体工作。

​
入门指南

1

获取你的 API key

在 build.nvidia.com 创建 API key。
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-..."
--nvidia-api-key 会让密钥进入 shell 历史记录和 ps 输出。尽可能优先使用 NVIDIA_API_KEY 环境变量。

​
配置示例

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

​
精选目录

配置 NVIDIA API key 后，设置和模型选择路径会从 https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json 获取 NVIDIA 的公开精选模型目录，并将结果缓存 24 小时（前 32 个条目，作为免费文本输入行导入）。因此，build.nvidia.com 上的新精选模型会出现在设置和模型选择界面中，而无需等待 OpenClaw 发布。当实时源可用时，返回的第一个模型会成为 NVIDIA 设置期间的预选选项。 获取过程会对 assets.ngc.nvidia.com 使用固定 HTTPS 主机策略。如果未配置 NVIDIA API key，或者该源不可用或格式异常，OpenClaw 会回退到下面的内置目录和内置默认值。

​
Nemotron 3 Ultra

Nemotron 3 Ultra 是 OpenClaw 中的默认 NVIDIA 模型。NVIDIA 关于 nvidia/nemotron-3-ultra-550b-a55b 的构建页面将其列为可用的免费端点，并标明 1M token 上下文规格。内置目录记录了 16,384 token 的最大输出，以匹配 NVIDIA 当前针对托管端点的兼容 OpenAI 的示例请求。 内置 Ultra 行默认发送 chat_template_kwargs: { enable_thinking: false, force_nonempty_content: true }，因此普通聊天输出会保留在可见答案中，而不会暴露推理文本。 如果需要最高能力的 NVIDIA 默认模型，请使用 Ultra。如果你想要较小的 Nemotron 3 选项，请继续选择 Super；或者在 NVIDIA 目录中托管的第三方模型的上下文、延迟或行为更合适时，选择其中之一。

​
内置回退目录

模型引用名称上下文最大输出说明
nvidia/nvidia/nemotron-3-ultra-550b-a55bNVIDIA Nemotron 3 Ultra 550B1,000,00016,384默认
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,192已弃用；使用 minimaxai/minimax-m2.7
nvidia/z-ai/glm5GLM-5202,7528,192已弃用；使用 z-ai/glm-5.1

​
高级配置

当设置了 NVIDIA_API_KEY 环境变量，或新手引导期间存储了密钥时，该 provider 会自动启用。除密钥外，不需要显式 provider 配置。
配置 NVIDIA 身份验证后，OpenClaw 会优先使用 NVIDIA 的公开精选模型目录，并将其缓存 24 小时。内置回退目录是静态的，并保留已发布的弃用引用以保持升级兼容性。源代码中的成本默认值为 0，因为 NVIDIA 目前为列出的模型提供免费 API 访问。
OpenClaw 使用 openai-completions 适配器，通过标准 /v1 聊天补全路由与 NVIDIA 通信。任何兼容 OpenAI 的工具都应能通过 NVIDIA base URL 开箱即用。
NVIDIA 的 Ultra 示例请求使用 chat_template_kwargs.enable_thinking 和 reasoning_budget 输出推理内容。OpenClaw 的内置 Ultra 行默认禁用模板思考，以适配普通聊天用途。如果你需要选择启用 NVIDIA 推理输出，或强制使用其他 NVIDIA 专用请求字段，请设置按模型参数，并将 provider 专用覆盖限制在 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 会合并到请求中已有的任何 chat_template_kwargs，而不是替换整个对象。params.extra_body 是最终的兼容 OpenAI 的请求体覆盖项，会覆盖冲突的载荷键，因此仅应将其用于 NVIDIA 为所选端点记录的字段。
某些由 NVIDIA 托管的自定义模型可能会比默认约 120 秒的模型空闲看门狗更久才发出第一个响应分块。对于自定义 NVIDIA provider 条目，请提高 provider 超时时间，而不是整个 Agent Runtimes 超时时间；timeoutSeconds 覆盖 provider HTTP 请求，并提高该 provider 的空闲/流式看门狗上限：
{
  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 获取最新可用性和速率限制详情。

​
相关内容

模型选择

选择 provider、模型引用和故障转移行为。

配置参考

针对智能体、模型和 provider 的完整配置参考。