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

시작하기

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