Microsoft Foundry Plugin

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

배포

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

표면

providers: microsoft-foundry; contracts: imageGenerationProviders

• 이미지 생성 공급자: 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 필드에 배포 이름을 요구하므로 공급자는 기본 이미지 모델을 선언하지 않습니다.

{  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 이미지 모델을 사용하세요.