核心配置原理
OpenClaw 通过配置 models.providers来接入 NVIDIA Build 平台。由于 NVIDIA Build 提供了 OpenAI 兼容的 API 端点，你可以直接将其配置为一个自定义提供商。
步骤 1：获取 NVIDIA API Key
访问 build.nvidia.com。
注册并登录账号。
点击右上角头像，进入 API Keys 页面。
点击 Generate API Key，复制生成的密钥（格式通常为 nvapi-xxxxx）。
步骤 2：修改 OpenClaw 配置文件
编辑配置文件 ~/.openclaw/openclaw.json（如果不存在，请运行 openclaw onboard初始化）。
或者在 web UI 界面：Config -> Settings ->选 RAW -> 编辑 -> Save
将以下 JSON 配置添加到文件的 models.providers部分：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
| {
"models": {
"mode": "merge",
"providers": {
"nvidia-build": {
"baseUrl": "https://integrate.api.nvidia.com/v1",
"apiKey": "YOUR_NVIDIA_API_KEY_HERE", // 替换为你的密钥
"api": "openai-completions",
"models": [
// 用户指定的模型
{
"id": "moonshotai/kimi-k2.5",
"name": "Kimi K2.5",
"reasoning": false,
"input": ["text", "image"],
"contextWindow": 262144,
"maxTokens": 8192
},
{
"id": "z-ai/glm4.7",
"name": "GLM 4.7",
"reasoning": false,
"input": ["text"],
"contextWindow": 131072,
"maxTokens": 8192
},
{
"id": "deepseek-ai/deepseek-v3.2",
"name": "DeepSeek V3.2",
"reasoning": false,
"input": ["text"],
"contextWindow": 131072,
"maxTokens": 8192
},
// 推荐的顶级模型 1：Mixtral 8x22B Instruct
{
"id": "mistralai/mixtral-8x22b-instruct",
"name": "Mixtral 8x22B Instruct",
"reasoning": false,
"input": ["text"],
"contextWindow": 65536,
"maxTokens": 8192
},
// 推荐的顶级模型 2：Nemotron 4 340B Instruct
{
"id": "nvidia/nemotron-4-340b-instruct",
"name": "Nemotron 4 340B Instruct",
"reasoning": false,
"input": ["text"],
"contextWindow": 4096,
"maxTokens": 8192
}
]
}
}
},
"agents": {
"defaults": {
"models": {
// 设置默认使用的模型（可选）
"nvidia-build/moonshotai/kimi-k2.5": {
"alias": "kimi"
}
}
}
}
}
|
步骤 3：重启 OpenClaw 服务
保存配置文件后，重启 OpenClaw 网关以加载新的配置：
1
| openclaw gateway restart
|
步骤 4：验证配置
运行以下命令查看模型列表，确认配置成功：
你应该能看到列表中包含了 nvidia-build/moonshotai/kimi-k2.5等模型。
Mixtral 8x22B Instruct：MoE 架构，推理能力强，性价比高，适合通用任务。
Nemotron 4 340B Instruct：NVIDIA 自家旗舰模型，参数规模巨大，擅长复杂推理和指令遵循 。
关键配置参数解释
baseUrl：NVIDIA Build 的 API 端点地址。
api：必须设置为 openai-completions，因为 NVIDIA Build 兼容 OpenAI API 格式。
id：必须与 NVIDIA Build 平台上的模型 ID 完全一致（包含组织前缀，如 moonshotai/）。
contextWindow：模型支持的上下文长度（token 数）。
注意事项
