Plugin de Microsoft Foundry

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

Distribución

• Paquete: @openclaw/microsoft-foundry
• Método 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 configurada para el proveedor.
• 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 usan la referencia de modelo del proveedor microsoft-foundry/<deployment-name>. Durante la incorporación, se detectan los recursos y las implementaciones de Foundry mediante la CLI de Azure y, a continuación, se escribe el nombre de la implementación seleccionada en la configuración del modelo.

OpenClaw usa el endpoint /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 usan openai-completions, salvo que se configure explícitamente una API compatible.
• MAI-DS-R1 se registra como capaz de razonamiento mediante contenido de razonamiento, no mediante reasoning_effort. Los metadatos de tokens de contexto y salida son de 163 840 tokens.

Las implementaciones de Anthropic Claude en Microsoft Foundry usan el formato de la API Anthropic Messages, no el formato compatible con OpenAI de /openai/v1. 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 identificador del modelo Claude, establezca params.canonicalModelId en la entrada del modelo para que OpenClaw pueda aplicar los 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

Use como referencia de modelo el nombre de una implementación de imágenes MAI. 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 una instrucción llama al endpoint de generaciones de MAI de Microsoft Foundry: /mai/v1/images/generations. Las ediciones con imágenes de referencia llaman a /mai/v1/images/edits y se limitan a implementaciones de MAI-Image-2.5-Flash y MAI-Image-2.5.

La generación basada únicamente en una instrucción puede usar un nombre de implementación personalizado con solo el endpoint de Foundry configurado. Para editar 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 se basa en 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 el alto deben ser de al menos 768 px.
• Píxeles totales: el producto de ancho × alto 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 use 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. Use un modelo de imágenes MAI implementado para image_generate.