Plugin de Microsoft Foundry

Añade compatibilidad con el proveedor de modelos Microsoft Foundry a OpenClaw.

Distribución

• Paquete: @openclaw/microsoft-foundry
• Vía de instalación: incluido en OpenClaw

Superficie

proveedores: microsoft-foundry; contratos: imageGenerationProviders

• Proveedor de generación de imágenes: microsoft-foundry

Requisitos

• Un recurso de Microsoft Foundry o Azure AI Foundry con implementaciones.
• Autenticación mediante clave de API a través de AZURE_OPENAI_API_KEY o una clave de API de proveedor configurada.
• Para la autenticación con Entra ID, instale la CLI de Azure y ejecute az login antes de la incorporación. OpenClaw actualiza los tokens de ejecución de Microsoft Foundry mediante az account get-access-token.

Modelos de chat

Las implementaciones de chat de Microsoft Foundry utilizan la referencia de modelo del proveedor microsoft-foundry/<deployment-name>. Durante la incorporación, se detectan los recursos y las implementaciones de Foundry con la CLI de Azure y, a continuación, se escribe el nombre de la implementación seleccionada en la configuración del modelo.

OpenClaw utiliza el punto de conexión /openai/v1 de Foundry para las API de chat compatibles con OpenAI admitidas:

• Las familias de modelos GPT, o*, computer-use-preview y DeepSeek-V4 usan de forma predeterminada openai-responses.
• MAI-DS-R1 y otras implementaciones de finalización de chat utilizan openai-completions, salvo que se configure explícitamente una API compatible.
• MAI-DS-R1 se registra como compatible con razonamiento mediante contenido de razonamiento, no mediante reasoning_effort. Los metadatos de sus tokens de contexto y salida son de 163,840 tokens.

Las implementaciones de Anthropic Claude en Microsoft Foundry utilizan el formato de la API Anthropic Messages, no el formato /openai/v1 compatible con OpenAI. Configúrelas como un proveedor anthropic-messages personalizado hasta que el Plugin de Microsoft Foundry incorpore un entorno de ejecución nativo de Anthropic. Cuando el nombre de la implementación de Foundry difiera del ID del modelo Claude, establezca params.canonicalModelId en la entrada del modelo para que OpenClaw pueda aplicar contratos de comunicación específicos del modelo, asignar correctamente /think off y conservar de forma segura el razonamiento firmado.

Generación de imágenes con MAI

El Plugin registra microsoft-foundry para image_generate con los modelos actuales de imágenes de Microsoft AI:

• MAI-Image-2.5-Flash
• MAI-Image-2.5
• MAI-Image-2e
• MAI-Image-2

Utilice el nombre de una implementación de imágenes MAI implementada como referencia del modelo. El proveedor no declara un modelo de imágenes predeterminado porque la API de MAI requiere el nombre de su implementación en el campo model de la solicitud:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "microsoft-foundry/<deployment-name>",        timeoutMs: 600000,      },    },  },}

La generación basada únicamente en instrucciones utiliza el punto de conexión de generaciones de MAI de Microsoft Foundry: /mai/v1/images/generations. Las ediciones con una imagen de referencia utilizan /mai/v1/images/edits y están limitadas a las implementaciones MAI-Image-2.5-Flash y MAI-Image-2.5.

La generación basada únicamente en instrucciones puede utilizar un nombre de implementación personalizado con solo configurar el punto de conexión de Foundry. Para las ediciones de imágenes con un nombre de implementación personalizado, seleccione la implementación durante la incorporación o incluya metadatos del modelo para que OpenClaw pueda verificar que la implementación utiliza MAI-Image-2.5-Flash o MAI-Image-2.5.

Restricciones de imágenes de MAI:

• Salida: una imagen PNG por solicitud.
• Tamaño: valor predeterminado 1024x1024; tanto el ancho como la altura deben ser de al menos 768 px.
• Píxeles totales: el ancho × la altura debe ser como máximo 1,048,576.
• Ediciones: una imagen de entrada PNG o JPEG.
• Las indicaciones compartidas no compatibles, como aspectRatio, resolution, quality, background y los valores de outputFormat distintos de PNG, no se envían a Microsoft Foundry.

Solución de problemas

• az: command not found: instale la CLI de Azure o utilice la autenticación mediante clave de API.
• Microsoft Foundry endpoint missing for MAI image generation: seleccione una implementación de Foundry durante la incorporación o añada models.providers.microsoft-foundry.baseUrl.
• supports MAI image deployments only: el modelo de imágenes seleccionado apunta a una implementación que no es de MAI. Utilice un modelo de imágenes MAI implementado para image_generate.