--- read_when: - OpenClawでオープンモデルを無料で使用したい場合 - NVIDIA_API_KEY の設定が必要です - NVIDIA 経由で Nemotron 3 Ultra を使用する場合 summary: OpenClaw で NVIDIA の OpenAI 互換 API を使用する title: NVIDIA x-i18n: generated_at: "2026-07-11T22:36:26Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: b5ac7bcc19400a661b2f2861a1dd4d2306c94e445783929e342e9184003314e9 source_path: providers/nvidia.md workflow: 16 --- NVIDIA は、[build.nvidia.com](https://build.nvidia.com/settings/api-keys) で取得した API キーによって認証する OpenAI 互換 API を介して、`https://integrate.api.nvidia.com/v1` でオープンモデルを無料提供しています。OpenClaw では NVIDIA プロバイダーのデフォルトとして、長いコンテキストを扱うエージェント型処理向けの NVIDIA 製推論モデル Nemotron 3 Ultra（総パラメーター数 550B、有効パラメーター数 55B）を使用します。 ## はじめに [build.nvidia.com](https://build.nvidia.com/settings/api-keys) で API キーを作成します。 ```bash export NVIDIA_API_KEY="nvapi-..." openclaw onboard --auth-choice nvidia-api-key ``` ```bash openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55b ``` 非対話型セットアップでは、キーを直接渡します。 ```bash openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..." ``` `--nvidia-api-key` を使用すると、キーがシェル履歴と `ps` の出力に残ります。可能な場合は、`NVIDIA_API_KEY` 環境変数を使用してください。 ## 設定例 ```json5 { 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/nemotron-3-ultra-550b-a55b`](https://build.nvidia.com/nvidia/nemotron-3-ultra-550b-a55b) の NVIDIA ビルドページには、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` です。 OpenClaw は、標準の `/v1` チャット補完ルートに対して `openai-completions` アダプターを使用して NVIDIA と通信します。OpenAI 互換のツールは、NVIDIA のベース URL を指定するだけでそのまま動作します。 NVIDIA の Ultra サンプルリクエストでは、推論出力に `chat_template_kwargs.enable_thinking` と `reasoning_budget` を使用します。OpenClaw に同梱されている Ultra の行では、通常のチャット利用向けにテンプレートの思考機能をデフォルトで無効にしています。NVIDIA の推論出力を明示的に有効にする必要がある場合、または NVIDIA 固有のその他のリクエストフィールドを強制する必要がある場合は、モデルごとのパラメーターを設定し、プロバイダー固有の上書きを NVIDIA モデルのスコープ内に限定してください。 ```json5 { 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 リクエストを対象とし、そのプロバイダーのアイドル／ストリーム監視時間の上限を引き上げます。 ```json5 { 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" }, }, }, }, }, } ``` NVIDIA モデルは現在無料で使用できます。最新の提供状況とレート制限の詳細については、[build.nvidia.com](https://build.nvidia.com/) を確認してください。 ## 関連項目 プロバイダー、モデル参照、フェイルオーバー動作の選択方法。 エージェント、モデル、プロバイダーの完全な設定リファレンス。