---
read_when:
    - Está instalando, configurando o auditando el plugin microsoft-foundry
summary: Añade compatibilidad con el proveedor de modelos Microsoft Foundry a OpenClaw.
title: Plugin de Microsoft Foundry
x-i18n:
    generated_at: "2026-07-11T23:20:46Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: c120a68393626e5ff9f24cd80bce4612a3772faf3722b93f2ff4677f743d0252
    source_path: plugins/reference/microsoft-foundry.md
    workflow: 16
---

# 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

<!-- openclaw-plugin-reference:manual-start -->

- 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:

```json5
{
  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`.

<!-- openclaw-plugin-reference:manual-end -->