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 постачає її як офіційний зовнішній 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 і переконайтеся, що для вас увімкнено доступ до 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?