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:

openclaw plugins install @openclaw/qianfan-provider
openclaw 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

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

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.

Solo es necesario reemplazar models.providers.qianfan cuando se requiere una URL base personalizada o metadatos de modelos personalizados.

Ejemplo de configuración

{
  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,
          },
        ],
      },
    },
  },
}

Las referencias de modelos usan el prefijo qianfan/ (por ejemplo, qianfan/deepseek-v3.2).

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.

Overview

Concepts and configuration

Providers

Instalar el Plugin

Primeros pasos

Catálogo integrado

Ejemplo de configuración

Contenido relacionado

Selección de modelos

Referencia de configuración

Configuración del agente

Documentación de la API de Qianfan

​Instalar el Plugin

​Primeros pasos

​Catálogo integrado

​Ejemplo de configuración

​Contenido relacionado

Selección de modelos

Referencia de configuración

Configuración del agente

Documentación de la API de Qianfan

Instalar el Plugin

Primeros pasos

Catálogo integrado

Ejemplo de configuración

Contenido relacionado