Providers

Qianfan

Qianfan は Baidu の MaaS プラットフォームです。単一のエンドポイントと API キーを使用して、多数のモデルにリクエストをルーティングする、OpenAI 互換の統合 API です。OpenClaw では、公式の外部 Plugin @openclaw/qianfan-provider として提供されています。

プロパティ	値
プロバイダー	`qianfan`
認証	`QIANFAN_API_KEY`
API	OpenAI 互換（`openai-completions`）
ベース URL	`https://qianfan.baidubce.com/v2`
デフォルトモデル	`qianfan/deepseek-v3.2`

Plugin のインストール

公式 Plugin をインストールしてから、Gateway を再起動します。

bash

openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restart

はじめに

Baidu Cloud アカウントを作成する

Qianfan コンソールで登録またはログインし、Qianfan API へのアクセスが有効になっていることを確認します。

API キーを生成する

新しいアプリケーションを作成するか既存のアプリケーションを選択してから、API キーを生成します。Baidu Cloud のキーには bce-v3/ALTAK-... 形式が使用されます。

オンボーディングを実行する

bash

openclaw onboard --auth-choice qianfan-api-key

非対話形式の実行では、--qianfan-api-key <key> または QIANFAN_API_KEY からキーを読み取ります。オンボーディングによりプロバイダー設定が書き込まれ、デフォルトモデルに QIANFAN エイリアスが追加されます。また、モデルが設定されていない場合は qianfan/deepseek-v3.2 がデフォルトモデルとして設定されます。

モデルが利用可能であることを確認する

bash

openclaw models list --provider qianfan

組み込みカタログ

モデル参照	入力	コンテキスト	最大出力	推論	備考
`qianfan/deepseek-v3.2`	テキスト	98,304	32,768	あり	デフォルトモデル
`qianfan/ernie-5.0-thinking-preview`	テキスト、画像	119,000	64,000	あり	マルチモーダル

カタログは静的であり、モデルのライブ検出はありません。

設定例

json5

{  env: { QIANFAN_API_KEY: "bce-v3/ALTAK-..." },  agents: {    defaults: {      model: { primary: "qianfan/deepseek-v3.2" },      models: {        "qianfan/deepseek-v3.2": { alias: "QIANFAN" },      },    },  },  models: {    providers: {      qianfan: {        baseUrl: "https://qianfan.baidubce.com/v2",        api: "openai-completions",        models: [          {            id: "deepseek-v3.2",            name: "DEEPSEEK V3.2",            reasoning: true,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 98304,            maxTokens: 32768,          },          {            id: "ernie-5.0-thinking-preview",            name: "ERNIE-5.0-Thinking-Preview",            reasoning: true,            input: ["text", "image"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 119000,            maxTokens: 64000,          },        ],      },    },  },}

トランスポートと互換性

Qianfan は、OpenAI ネイティブのリクエスト形式ではなく、OpenAI 互換のトランスポート経路を介して動作します。標準の OpenAI SDK 機能は動作しますが、プロバイダー固有のパラメーターは転送されない場合があります。

トラブルシューティング

API キーが bce-v3/ALTAK- で始まり、Baidu Cloud コンソールで Qianfan API へのアクセスが有効になっていることを確認してください。
モデルが一覧表示されない場合は、アカウントで Qianfan サービスが有効化されていることを確認してください。
カスタムエンドポイントまたはプロキシを使用する場合にのみ、ベース URL を変更してください。

このページの内容

Qianfan

Plugin のインストール

はじめに

Baidu Cloud アカウントを作成する

API キーを生成する

オンボーディングを実行する

モデルが利用可能であることを確認する

組み込みカタログ

設定例

関連情報

Molty