Saltar al contenido principal
Qianfan es la plataforma MaaS de Baidu: una API unificada y compatible con OpenAI que enruta solicitudes a muchos modelos detrás de un único endpoint y clave de API. OpenClaw la distribuye como el Plugin externo oficial @openclaw/qianfan-provider.
PropiedadValor
Proveedorqianfan
AutenticaciónQIANFAN_API_KEY
APICompatible con OpenAI (openai-completions)
URL basehttps://qianfan.baidubce.com/v2
Modelo predeterminadoqianfan/deepseek-v3.2

​
Instalar Plugin

Instala el Plugin oficial y luego reinicia Gateway: 
openclaw plugins install @openclaw/qianfan-provider
openclaw gateway restart

​
Primeros pasos

1

Crear una cuenta de Baidu Cloud

Regístrate o inicia sesión en la consola de Qianfan y asegúrate de tener habilitado el acceso a la API de Qianfan.
2

Generar una clave de API

Crea una aplicación nueva o selecciona una existente y luego genera una clave de API. Las claves de Baidu Cloud usan el formato bce-v3/ALTAK-....
3

Ejecutar onboarding

openclaw onboard --auth-choice qianfan-api-key
Las ejecuciones no interactivas leen la clave desde --qianfan-api-key <key> o QIANFAN_API_KEY. El onboarding escribe la configuración del proveedor, agrega el alias QIANFAN para el modelo predeterminado y establece qianfan/deepseek-v3.2 como modelo predeterminado cuando no hay ninguno configurado.
4

Verificar que el modelo esté disponible

openclaw models list --provider qianfan

​
Catálogo integrado

Ref. de modeloEntradaContextoSalida máximaRazonamientoNotas
qianfan/deepseek-v3.2texto98,30432,768SíModelo predeterminado
qianfan/ernie-5.0-thinking-previewtexto, imagen119,00064,000SíMultimodal
El catálogo es estático; no hay descubrimiento de modelos en vivo.
Solo necesitas sobrescribir models.providers.qianfan cuando necesitas una URL base personalizada o metadatos de modelo 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 refs. de modelo usan el prefijo qianfan/ (por ejemplo, qianfan/deepseek-v3.2).
Qianfan se ejecuta a través de 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.
  • Asegúrate de que tu clave de API empiece con bce-v3/ALTAK- y tenga habilitado el acceso a la API de Qianfan en la consola de Baidu Cloud.
  • Si los modelos no aparecen, confirma que tu cuenta tenga activado el servicio Qianfan.
  • Cambia la URL base solo si usas un endpoint o proxy personalizado.

​
Relacionado

Selección de modelos

Elegir proveedores, refs. de modelo y comportamiento de failover.

Referencia de configuración

Referencia completa de configuración de OpenClaw.

Configuración de agente

Configurar valores predeterminados de agentes y asignaciones de modelos.

Documentación de la API de Qianfan

Documentación oficial de la API de Qianfan.