Providers
Qianfan
Qianfan es la plataforma MaaS de Baidu, que proporciona una API unificada que enruta solicitudes a muchos modelos detrás de un único endpoint y clave de API. Es compatible con OpenAI, por lo que la mayoría de los SDK de OpenAI funcionan cambiando la URL base.
| Propiedad | Valor |
|---|---|
| Proveedor | qianfan |
| Autenticación | QIANFAN_API_KEY |
| API | Compatible con OpenAI |
| URL base | https://qianfan.baidubce.com/v2 |
Instalar Plugin
Instala el Plugin oficial y luego reinicia Gateway:
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartPrimeros pasos
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.
Generar una clave de API
Crea una aplicación nueva o selecciona una existente y luego genera una clave de API. El formato de la clave es bce-v3/ALTAK-....
Ejecutar la incorporación
openclaw onboard --auth-choice qianfan-api-keyVerificar que el modelo esté disponible
openclaw models list --provider qianfanCatálogo integrado
| Ref. 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 |
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, }, ], }, }, },}Transporte y compatibilidad
Qianfan se ejecuta mediante la ruta de transporte compatible con OpenAI, no mediante el formato nativo de solicitudes de OpenAI. Esto significa que las funciones estándar del SDK de OpenAI funcionan, pero es posible que los parámetros específicos del proveedor no se reenvíen.
Catálogo y sobrescrituras
El catálogo estático actualmente incluye deepseek-v3.2 y ernie-5.0-thinking-preview. Añade o sobrescribe models.providers.qianfan solo cuando necesites una URL base personalizada o metadatos de modelo.
Solución de problemas
- 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 en la lista, confirma que tu cuenta tenga activado el servicio Qianfan.
- La URL base predeterminada es
https://qianfan.baidubce.com/v2. Cámbiala solo si usas un endpoint o proxy personalizado.
Relacionado
Elección de proveedores, refs. de modelo y comportamiento de conmutación por error.
Referencia completa de configuración de OpenClaw.
Configuración de valores predeterminados de agentes y asignaciones de modelos.
Documentación oficial de la API de Qianfan.
