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 を再起動します。

openclaw plugins install @openclaw/qianfan-provider
openclaw gateway restart

はじめに

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

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

API キーを生成する

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

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

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

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

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

openclaw models list --provider qianfan

組み込みカタログ

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

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

カスタムのベース URL またはモデルメタデータが必要な場合にのみ、models.providers.qianfan を上書きする必要があります。

設定例

{
  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/ プレフィックスを使用します（例：qianfan/deepseek-v3.2）。

トランスポートと互換性

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

トラブルシューティング

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

モデルの選択

プロバイダー、モデル参照、フェイルオーバー動作の選択方法。

設定リファレンス

OpenClaw の完全な設定リファレンス。

エージェントのセットアップ

エージェントのデフォルト値とモデル割り当ての設定方法。

Qianfan API ドキュメント

Qianfan API の公式ドキュメント。

Overview

Concepts and configuration

Providers

Plugin のインストール

はじめに

組み込みカタログ

設定例

関連情報

モデルの選択

設定リファレンス

エージェントのセットアップ

Qianfan API ドキュメント

​Plugin のインストール

​はじめに

​組み込みカタログ

​設定例

​関連情報

モデルの選択

設定リファレンス

エージェントのセットアップ

Qianfan API ドキュメント

Plugin のインストール

はじめに

組み込みカタログ

設定例

関連情報