https://integrate.api.nvidia.com/v1 で、認証には
build.nvidia.com で取得した API キーを使用します。OpenClaw
では、NVIDIA プロバイダーのデフォルトとして Nemotron 3 Ultra が設定されています。これは、長いコンテキストを扱うエージェント型タスク向けの、総パラメーター数 550B/有効パラメーター数 55B の
NVIDIA 製推論モデルです。
はじめに
非対話型セットアップでは、キーを直接渡します。設定例
注目モデルカタログ
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
のビルドページには、1M トークンのコンテキスト仕様を備えた、利用可能な無料エンドポイントとして掲載されています。
同梱されている Ultra の行では、通常のチャット出力が推論テキストとして露出せず、表示される回答に収まるよう、デフォルトで
chat_template_kwargs: { enable_thinking: false, force_nonempty_content: true }
を送信します。
NVIDIA のデフォルトとして最高の性能が必要な場合は Ultra を使用してください。より小規模な Nemotron 3 を使用する場合は Super を選択したままにするか、コンテキスト、レイテンシー、動作がより適している場合は NVIDIA のカタログでホストされているサードパーティ製モデルを選択してください。
同梱フォールバックカタログ
選択可能な同梱行は、NVIDIA の注目モデルカタログのスナップショットです。非推奨の 互換性用行は完全一致する参照によって引き続き解決できますが、モデル選択画面には表示されません。
完全な互換性カタログには、既存の設定用としてリリース済みの次の参照も保持されています:
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 互換エンドポイント
OpenAI 互換エンドポイント
OpenClaw は、標準の
/v1 チャット補完ルートに対して
openai-completions アダプターを使用し、NVIDIA と通信します。OpenAI 互換ツールであれば、
NVIDIA のベース URL を指定するだけで動作します。Nemotron 3 Ultra の推論パラメーター
Nemotron 3 Ultra の推論パラメーター
NVIDIA の Ultra サンプルリクエストでは、推論出力に
chat_template_kwargs.enable_thinking
と reasoning_budget を使用します。OpenClaw に同梱されている Ultra の行では、
通常のチャット用途向けに、テンプレート思考がデフォルトで無効になっています。NVIDIA の推論出力を
有効にする必要がある場合、または NVIDIA 固有のその他のリクエストフィールドを強制的に指定する場合は、
モデル単位のパラメーターを設定し、プロバイダー固有のオーバーライドを NVIDIA モデルの
スコープ内に限定してください。params.chat_template_kwargs はオブジェクト全体を置き換えるのではなく、リクエストにすでに存在する
chat_template_kwargs にマージされます。
params.extra_body は OpenAI 互換リクエスト本文に対する最終オーバーライドであり、
競合するペイロードキーを上書きします。そのため、選択したエンドポイント向けに NVIDIA が
文書化しているフィールドにのみ使用してください。応答が遅いカスタムプロバイダー
応答が遅いカスタムプロバイダー
NVIDIA でホストされている一部のカスタムモデルでは、最初の応答チャンクが送信されるまでに、
デフォルトの約 120 秒のモデルアイドル監視時間を超える場合があります。カスタム
NVIDIA プロバイダーエントリでは、エージェントランタイム全体のタイムアウトではなく、
プロバイダーのタイムアウトを延長してください。
timeoutSeconds はプロバイダーの HTTP リクエストに適用され、
そのプロバイダーのアイドル/ストリーム監視時間の上限も引き上げます。関連情報
モデルの選択
プロバイダー、モデル参照、フェイルオーバー動作の選択方法。
設定リファレンス
エージェント、モデル、プロバイダーの完全な設定リファレンス。