OpenClawDocs
На этой странице

На этой странице

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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:

bash
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restart

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

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

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

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

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

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

    Выбор модели

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

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

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

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