快速开始
NVIDIA
NVIDIA 在 https://integrate.api.nvidia.com/v1 提供 OpenAI 兼容 API，可免费使用开放模型。使用来自 build.nvidia.com 的 API key 进行身份验证。
入门指南
获取你的 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-super-120b-a12b
对于非交互式设置，你也可以直接传入密钥：
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-super-120b-a12b" },
},
},
}
内置目录
| 模型引用 | 名称 | 上下文 | 最大输出 |
|---|---|---|---|
nvidia/nvidia/nemotron-3-super-120b-a12b |
NVIDIA Nemotron 3 Super 120B | 262,144 | 8,192 |
nvidia/moonshotai/kimi-k2.5 |
Kimi K2.5 | 262,144 | 8,192 |
nvidia/minimaxai/minimax-m2.5 |
Minimax M2.5 | 196,608 | 8,192 |
nvidia/z-ai/glm5 |
GLM 5 | 202,752 | 8,192 |
高级配置
自动启用行为
设置 NVIDIA_API_KEY 环境变量后，提供商会自动启用。除了该密钥之外，不需要显式提供商配置。
目录和定价
内置目录是静态的。由于 NVIDIA 目前为列出的模型提供免费 API 访问，源代码中的费用默认值为 0。
OpenAI 兼容端点
NVIDIA 使用标准的 /v1 completions 端点。任何 OpenAI 兼容工具都应能与 NVIDIA base URL 开箱即用地配合使用。
较慢的自定义提供商响应
一些由 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" },
},
},
},
},
}