OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Get started

Microsoft Foundry Plugin

Microsoft Foundry Plugin

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

배포

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

제공 기능

제공자: microsoft-foundry; 계약: 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와 다르면 모델 항목에 params.canonicalModelId를 설정하여 OpenClaw가 모델별 통신 계약을 적용하고, /think off를 올바르게 매핑하며, 서명된 사고 내용을 안전하게 보존할 수 있도록 합니다.

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이며, 너비와 높이는 모두 768px 이상이어야 합니다.
  • 총 픽셀 수: 너비 × 높이는 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 이미지 모델을 사용합니다.
Was this useful?
On this page

On this page