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

Providers

Qianfan

Qianfan es la plataforma MaaS de Baidu: una API unificada y compatible con OpenAI que dirige las solicitudes a numerosos modelos mediante un único endpoint y una única clave de API. OpenClaw la distribuye como el Plugin externo oficial @openclaw/qianfan-provider.

Propiedad Valor
Proveedor qianfan
Autenticación QIANFAN_API_KEY
API Compatible con OpenAI (openai-completions)
URL base https://qianfan.baidubce.com/v2
Modelo predeterminado qianfan/deepseek-v3.2

Instalar el Plugin

Instale el Plugin oficial y, a continuación, reinicie el Gateway:

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

Primeros pasos

  • Crear una cuenta de Baidu Cloud

    Regístrese o inicie sesión en la consola de Qianfan y asegúrese de tener habilitado el acceso a la API de Qianfan.

  • Generar una clave de API

    Cree una aplicación nueva o seleccione una existente y, a continuación, genere una clave de API. Las claves de Baidu Cloud usan el formato bce-v3/ALTAK-....

  • Ejecutar la incorporación

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

    Las ejecuciones no interactivas leen la clave de --qianfan-api-key <key> o QIANFAN_API_KEY. La incorporación escribe la configuración del proveedor, añade el alias QIANFAN para el modelo predeterminado y establece qianfan/deepseek-v3.2 como modelo predeterminado cuando no hay ninguno configurado.

  • Verificar que el modelo esté disponible

    bash
    openclaw models list --provider qianfan

    • Catálogo integrado

    Referencia del modelo Entrada Contexto Salida máxima Razonamiento Notas
    qianfan/deepseek-v3.2 texto 98,304 32,768 Sí Modelo predeterminado
    qianfan/ernie-5.0-thinking-preview texto, imagen 119,000 64,000 Sí Multimodal

    El catálogo es estático; no se detectan modelos en tiempo real.

    Ejemplo de configuración

    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,          },        ],      },    },  },}
    Transporte y compatibilidad

    Qianfan funciona mediante la ruta de transporte compatible con OpenAI, no mediante el formato nativo de solicitudes de OpenAI. Las funciones estándar del SDK de OpenAI funcionan, pero es posible que los parámetros específicos del proveedor no se reenvíen.

    Solución de problemas
    • Asegúrese de que la clave de API comience por bce-v3/ALTAK- y de que tenga habilitado el acceso a la API de Qianfan en la consola de Baidu Cloud.
    • Si los modelos no aparecen, confirme que el servicio Qianfan esté activado en la cuenta.
    • Cambie la URL base únicamente si utiliza un endpoint o proxy personalizado.

    Contenido relacionado

    Selección de modelos

    Selección de proveedores, referencias de modelos y comportamiento de conmutación por error.
    Referencia de configuración

    Referencia completa de configuración de OpenClaw.
    Configuración del agente

    Configuración de los valores predeterminados del agente y las asignaciones de modelos.
    Documentación de la API de Qianfan

    Documentación oficial de la API de Qianfan.
    Was this useful?
    On this page

    On this page