Plugin Microsoft Foundry

Adiciona ao OpenClaw suporte ao provedor de modelos Microsoft Foundry.

Distribuição

• Pacote: @openclaw/microsoft-foundry
• Forma de instalação: incluído no OpenClaw

Superfície

provedores: microsoft-foundry; contratos: imageGenerationProviders

• Provedor de geração de imagens: microsoft-foundry

Requisitos

• Um recurso do Microsoft Foundry ou do Azure AI Foundry com implantações.
• Autenticação por chave de API por meio de AZURE_OPENAI_API_KEY ou de uma chave de API de provedor configurada.
• Para autenticação com o Entra ID, instale a CLI do Azure e execute az login antes da configuração inicial. O OpenClaw atualiza os tokens de runtime do Microsoft Foundry por meio de az account get-access-token.

Modelos de chat

As implantações de chat do Microsoft Foundry usam a referência de modelo do provedor microsoft-foundry/<deployment-name>. A configuração inicial descobre recursos e implantações do Foundry com a CLI do Azure e grava o nome da implantação selecionada na configuração do modelo.

O OpenClaw usa o endpoint /openai/v1 do Foundry para APIs de chat compatíveis com a OpenAI:

• As famílias de modelos GPT, o*, computer-use-preview e DeepSeek-V4 usam openai-responses por padrão.
• O MAI-DS-R1 e outras implantações de conclusão de chat usam openai-completions, a menos que uma API compatível explícita esteja configurada.
• O MAI-DS-R1 é registrado como compatível com raciocínio por meio do conteúdo de raciocínio, e não por meio de reasoning_effort. Os metadados de tokens de contexto e saída são de 163.840 tokens.

As implantações do Anthropic Claude no Microsoft Foundry usam o formato da API Anthropic Messages, e não o formato compatível com a OpenAI em /openai/v1. Configure-as como um provedor anthropic-messages personalizado até que o Plugin Microsoft Foundry tenha um runtime nativo da Anthropic. Quando o nome da implantação do Foundry for diferente do ID do modelo Claude, defina params.canonicalModelId na entrada do modelo para que o OpenClaw possa aplicar contratos de comunicação específicos do modelo, mapear /think off corretamente e preservar com segurança o pensamento assinado.

Geração de imagens com MAI

O Plugin registra microsoft-foundry para image_generate com os modelos atuais de imagem da Microsoft AI:

• MAI-Image-2.5-Flash
• MAI-Image-2.5
• MAI-Image-2e
• MAI-Image-2

Use o nome de uma implantação de imagens MAI implantada como referência do modelo. O provedor não declara um modelo de imagem padrão porque a API MAI exige o nome da sua implantação no campo model da solicitação:

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

A geração somente por prompt chama o endpoint de gerações MAI do Microsoft Foundry: /mai/v1/images/generations. As edições com imagem de referência chamam /mai/v1/images/edits e são limitadas às implantações MAI-Image-2.5-Flash e MAI-Image-2.5.

A geração somente por prompt pode usar um nome de implantação personalizado apenas com o endpoint do Foundry configurado. Para edições de imagem com um nome de implantação personalizado, selecione a implantação durante a configuração inicial ou inclua metadados do modelo para que o OpenClaw possa verificar se a implantação é baseada em MAI-Image-2.5-Flash ou MAI-Image-2.5.

Restrições de imagem do MAI:

• Saída: uma imagem PNG por solicitação.
• Tamanho: padrão 1024x1024; tanto a largura quanto a altura devem ter pelo menos 768 px.
• Total de pixels: largura × altura deve ser de, no máximo, 1.048.576.
• Edições: uma imagem de entrada PNG ou JPEG.
• Dicas compartilhadas incompatíveis, como aspectRatio, resolution, quality, background e valores de outputFormat diferentes de PNG não são enviadas ao Microsoft Foundry.

Solução de problemas

• az: command not found: instale a CLI do Azure ou use autenticação por chave de API.
• Microsoft Foundry endpoint missing for MAI image generation: selecione uma implantação do Foundry durante a configuração inicial ou adicione models.providers.microsoft-foundry.baseUrl.
• supports MAI image deployments only: o modelo de imagem selecionado aponta para uma implantação que não é MAI. Use um modelo de imagem MAI implantado para image_generate.