Providers
NVIDIA
NVIDIA 透過相容 OpenAI 的 API,在
https://integrate.api.nvidia.com/v1 免費提供開放模型服務;驗證時使用從
build.nvidia.com 取得的 API 金鑰。OpenClaw
預設將 NVIDIA 提供者設為 Nemotron 3 Ultra,這是 NVIDIA 的總參數量 550B/啟用參數量 55B
推理模型,適合長上下文代理式工作。
開始使用
取得 API 金鑰
在 build.nvidia.com 建立 API 金鑰。
匯出金鑰並執行初始設定
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 金鑰後,設定與模型選擇流程會從
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 金鑰,或動態來源無法使用或格式錯誤,OpenClaw 會改用下方的內建目錄與內建預設值。
Nemotron 3 Ultra
Nemotron 3 Ultra 是 OpenClaw 中的預設 NVIDIA 模型。NVIDIA 的
nvidia/nemotron-3-ultra-550b-a55b
建置頁面將其列為可免費使用的端點,並標示 100 萬權杖的上下文規格。
內建的 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 提供者項目,請提高提供者逾時,而不是整體代理程式執行階段逾時;
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" }, }, }, }, },}