快速开始
NVIDIA
NVIDIA 通过位于 https://integrate.api.nvidia.com/v1 的 OpenAI 兼容 API 免费提供开放模型，并使用来自 build.nvidia.com 的 API key 进行身份验证。OpenClaw 默认将 NVIDIA provider 配置为 Nemotron 3 Ultra；这是 NVIDIA 的推理模型，总参数量为 550B、激活参数量为 55B，适用于长上下文智能体工作。
入门指南
获取 API key
在 build.nvidia.com 创建 API key。
导出密钥并运行新手引导
export NVIDIA_API_KEY="nvapi-..."openclaw onboard --auth-choice nvidia-api-key设置 NVIDIA 模型
openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55b对于非交互式设置，请直接传入密钥：
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" }, }, },}精选目录
配置 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 构建页面将其列为可用的免费端点，并标明其上下文规格为 100 万 token。
内置的 Ultra 条目默认发送 chat_template_kwargs: { enable_thinking: false, force_nonempty_content: true }，以便常规聊天输出保留在可见回答中，而不会暴露推理文本。
如需 NVIDIA 默认模型中的最高能力，请使用 Ultra。如果需要较小的 Nemotron 3 选项，请继续选择 Super；如果 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。它们仍可通过精确引用使用，但绝不会出现在新手引导或模型选择器中。
高级配置
自动启用行为
设置 NVIDIA_API_KEY 环境变量，或在新手引导期间存储密钥后，此提供商会自动启用。除密钥外，无需显式配置提供商。
目录和定价
配置 NVIDIA 身份验证后，OpenClaw 会优先使用 NVIDIA 的公开精选模型目录，并将其缓存 24 小时。可选择的内置回退目录是 NVIDIA 精选模型目录的静态快照；已弃用且仅供精确引用的兼容性条目不会显示在模型选择器中。由于 NVIDIA 目前为所列模型提供免费 API 访问，源代码中的费用默认值为 0。
OpenAI 兼容端点
OpenClaw 使用 openai-completions 适配器，通过标准 /v1 聊天补全路由与 NVIDIA 通信。任何 OpenAI 兼容工具都应能直接配合 NVIDIA 基础 URL 使用。
Nemotron 3 Ultra 推理参数
NVIDIA 的 Ultra 示例请求使用 chat_template_kwargs.enable_thinking 和 reasoning_budget 控制推理输出。OpenClaw 的内置 Ultra 条目默认禁用模板思考，以用于常规聊天。如果需要启用 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.chat_template_kwargs 会合并到请求中已有的任何 chat_template_kwargs，而不是替换整个对象。
params.extra_body 是最终的 OpenAI 兼容请求体覆盖项，会覆盖发生冲突的负载键，因此仅应将其用于 NVIDIA 为所选端点记录的字段。
自定义提供商响应缓慢
某些由 NVIDIA 托管的自定义模型可能需要比默认约 120 秒的模型空闲监视超时时间更久，才能发出第一个响应分块。对于自定义 NVIDIA provider 条目，应提高提供商超时时间，而不是整个智能体运行时的超时时间；timeoutSeconds 适用于提供商 HTTP 请求，并会提高该提供商的空闲/流式传输监视超时上限：
{ 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" }, }, }, }, },}