---
read_when:
    - microsoft-foundry Plugin을 설치, 구성 또는 감사하고 있습니다
summary: OpenClaw에 Microsoft Foundry 모델 제공자 지원을 추가합니다.
title: Microsoft Foundry Plugin
x-i18n:
    generated_at: "2026-06-27T17:52:23Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: c120a68393626e5ff9f24cd80bce4612a3772faf3722b93f2ff4677f743d0252
    source_path: plugins/reference/microsoft-foundry.md
    workflow: 16
---

# Microsoft Foundry Plugin

OpenClaw에 Microsoft Foundry 모델 공급자 지원을 추가합니다.

## 배포

- 패키지: `@openclaw/microsoft-foundry`
- 설치 경로: OpenClaw에 포함됨

## 표면

providers: microsoft-foundry; contracts: imageGenerationProviders

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

- 이미지 생성 공급자: `microsoft-foundry`

## 요구 사항

- 배포가 있는 Microsoft Foundry 또는 Azure AI Foundry 리소스.
- `AZURE_OPENAI_API_KEY` 또는 구성된 공급자 API 키를 통한 API 키 인증.
- Entra ID 인증의 경우, 온보딩 전에 Azure CLI를 설치하고 `az login`을 실행하세요. OpenClaw는 `az account get-access-token`을 통해 Microsoft Foundry 런타임 토큰을 갱신합니다.

## 채팅 모델

Microsoft Foundry 채팅 배포는 공급자 모델 참조 `microsoft-foundry/<deployment-name>`을 사용합니다. 온보딩은 Azure CLI로 Foundry 리소스와 배포를 발견한 다음, 선택한 배포 이름을 모델 구성에 기록합니다.

OpenClaw는 지원되는 OpenAI 호환 채팅 API에 Foundry `/openai/v1` 엔드포인트를 사용합니다.

- GPT, `o*`, `computer-use-preview`, DeepSeek-V4 모델 계열은 기본값으로 `openai-responses`를 사용합니다.
- MAI-DS-R1 및 기타 채팅 완료 배포는 명시적으로 지원되는 API가 구성되지 않은 경우 `openai-completions`를 사용합니다.
- MAI-DS-R1은 `reasoning_effort`가 아니라 추론 콘텐츠를 통해 추론 가능 모델로 기록됩니다. 컨텍스트 및 출력 토큰 메타데이터는 163,840 토큰입니다.

Microsoft Foundry의 Anthropic Claude 배포는 OpenAI 호환 `/openai/v1` 형식이 아니라 Anthropic Messages API 형식을 사용합니다. Microsoft Foundry Plugin에 네이티브 Anthropic 런타임이 추가될 때까지 이를 사용자 지정 `anthropic-messages` 공급자로 구성하세요. Foundry 배포 이름이 Claude 모델 ID와 다른 경우, OpenClaw가 모델별 와이어 계약을 적용하고, `/think off`를 올바르게 매핑하며, 서명된 thinking을 안전하게 보존할 수 있도록 모델 항목에 `params.canonicalModelId`를 설정하세요.

## MAI 이미지 생성

Plugin은 현재 Microsoft AI 이미지 모델과 함께 `image_generate`용 `microsoft-foundry`를 등록합니다.

- `MAI-Image-2.5-Flash`
- `MAI-Image-2.5`
- `MAI-Image-2e`
- `MAI-Image-2`

배포된 MAI 이미지 배포 이름을 모델 참조로 사용하세요. MAI API는 요청 `model` 필드에 배포 이름을 요구하므로 공급자는 기본 이미지 모델을 선언하지 않습니다.

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

프롬프트 전용 생성 호출은 Microsoft Foundry의 MAI 생성 엔드포인트 `/mai/v1/images/generations`를 사용합니다. 참조 이미지 편집은 `/mai/v1/images/edits`를 호출하며 `MAI-Image-2.5-Flash` 및 `MAI-Image-2.5` 배포로 제한됩니다.

프롬프트 전용 생성은 Foundry 엔드포인트만 구성된 상태에서 사용자 지정 배포 이름을 사용할 수 있습니다. 사용자 지정 배포 이름으로 이미지 편집을 수행하려면, 온보딩을 통해 배포를 선택하거나 OpenClaw가 해당 배포가 `MAI-Image-2.5-Flash` 또는 `MAI-Image-2.5`를 기반으로 하는지 확인할 수 있도록 모델 메타데이터를 포함하세요.

MAI 이미지 제약 사항:

- 출력: 요청당 PNG 이미지 1개.
- 크기: 기본값 `1024x1024`; 너비와 높이는 모두 최소 768 px여야 합니다.
- 총 픽셀: 너비 × 높이는 최대 1,048,576이어야 합니다.
- 편집: PNG 또는 JPEG 입력 이미지 1개.
- `aspectRatio`, `resolution`, `quality`, `background`, 비 PNG `outputFormat` 같은 지원되지 않는 공유 힌트는 Microsoft Foundry로 전송되지 않습니다.

## 문제 해결

- `az: command not found`: Azure CLI를 설치하거나 API 키 인증을 사용하세요.
- `Microsoft Foundry endpoint missing for MAI image generation`: 온보딩을 통해 Foundry 배포를 선택하거나 `models.providers.microsoft-foundry.baseUrl`을 추가하세요.
- `supports MAI image deployments only`: 선택한 이미지 모델이 MAI가 아닌 배포를 가리킵니다. `image_generate`에는 배포된 MAI 이미지 모델을 사용하세요.

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