Qianfan

Qianfan — это MaaS-платформа Baidu: унифицированный API, совместимый с OpenAI, который направляет запросы к множеству моделей через единую конечную точку и ключ API. OpenClaw поставляет её в виде официального внешнего плагина @openclaw/qianfan-provider.

Свойство	Значение
Провайдер	`qianfan`
Аутентификация	`QIANFAN_API_KEY`
API	Совместимый с OpenAI (`openai-completions`)
Базовый URL	`https://qianfan.baidubce.com/v2`
Модель по умолчанию	`qianfan/deepseek-v3.2`

Установка плагина

Установите официальный плагин, затем перезапустите Gateway:

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

Начало работы

Создание учётной записи Baidu Cloud

Зарегистрируйтесь или войдите в консоль Qianfan и убедитесь, что для вас включён доступ к API Qianfan.

Создание ключа 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	Да	Мультимодальная

Каталог статический; динамическое обнаружение моделей не предусмотрено.

Переопределять models.providers.qianfan нужно только при использовании собственного базового URL или метаданных модели.

Пример конфигурации

{
  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. Стандартные возможности SDK OpenAI работают, но специфичные для провайдера параметры могут не передаваться.

Устранение неполадок

Убедитесь, что ключ API начинается с bce-v3/ALTAK-, а доступ к API Qianfan включён в консоли Baidu Cloud.
Если модели не отображаются, убедитесь, что для вашей учётной записи активирована служба Qianfan.
Изменяйте базовый URL только при использовании собственной конечной точки или прокси-сервера.

Связанные материалы

Выбор модели

Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.

Справочник по конфигурации

Полный справочник по конфигурации OpenClaw.

Настройка агента

Настройка параметров агентов по умолчанию и назначение моделей.

Документация API Qianfan

Официальная документация API Qianfan.

Overview

Concepts and configuration

Providers

Установка плагина

Начало работы

Встроенный каталог

Пример конфигурации

Связанные материалы

Выбор модели

Справочник по конфигурации

Настройка агента

Документация API Qianfan

​Установка плагина

​Начало работы

​Встроенный каталог

​Пример конфигурации

​Связанные материалы

Выбор модели

Справочник по конфигурации

Настройка агента

Документация API Qianfan

Установка плагина

Начало работы

Встроенный каталог

Пример конфигурации

Связанные материалы