Providers

NVIDIA

NVIDIA は、build.nvidia.com で取得した API キーによって認証する OpenAI 互換 API を介して、https://integrate.api.nvidia.com/v1 でオープンモデルを無料提供しています。OpenClaw では NVIDIA プロバイダーのデフォルトとして、長いコンテキストを扱うエージェント型処理向けの NVIDIA 製推論モデル Nemotron 3 Ultra(総パラメーター数 550B、有効パラメーター数 55B)を使用します。

はじめに

  • API キーを取得する

    build.nvidia.com で API キーを作成します。

  • キーをエクスポートしてオンボーディングを実行する

    bash
    export NVIDIA_API_KEY="nvapi-..."openclaw onboard --auth-choice nvidia-api-key
  • NVIDIA モデルを設定する

    bash
    openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55b
  • 非対話型セットアップでは、キーを直接渡します。

    bash
    openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."

    設定例

    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 の 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.5nvidia/z-ai/glm-5.1nvidia/minimaxai/minimax-m2.5nvidia/z-ai/glm5nvidia/minimaxai/minimax-m2.7。これらは正確な参照を指定すれば引き続き利用できますが、オンボーディングやモデル選択画面には表示されません。

    高度な設定

    自動有効化の動作

    NVIDIA_API_KEY 環境変数が設定されている場合、またはオンボーディング中にキーが保存された場合、プロバイダーは自動的に有効になります。キー以外に明示的なプロバイダー設定は必要ありません。

    カタログと料金

    NVIDIA の認証が設定されている場合、OpenClaw は NVIDIA の公開注目モデルカタログを優先し、24 時間キャッシュします。選択可能な同梱フォールバックは NVIDIA の注目モデルカタログの静的スナップショットであり、正確な参照による非推奨の互換性用行はモデル選択画面で非表示になります。NVIDIA は現在、記載されているモデルへの無料 API アクセスを提供しているため、ソース内のコストはデフォルトで 0 です。

    OpenAI 互換エンドポイント

    OpenClaw は、標準の /v1 チャット補完ルートに対して openai-completions アダプターを使用して NVIDIA と通信します。OpenAI 互換のツールは、NVIDIA のベース URL を指定するだけでそのまま動作します。

    Nemotron 3 Ultra の推論パラメーター

    NVIDIA の Ultra サンプルリクエストでは、推論出力に chat_template_kwargs.enable_thinkingreasoning_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" },        },      },    },  },}

    関連項目

    Was this useful?
    On this page

    On this page