Microsoft Foundry plugin'i

OpenClaw'a Microsoft Foundry model sağlayıcısı desteği ekler.

Dağıtım

• Paket: @openclaw/microsoft-foundry
• Kurulum yolu: OpenClaw'a dahildir

Yüzey

sağlayıcılar: microsoft-foundry; sözleşmeler: imageGenerationProviders

• Görüntü oluşturma sağlayıcısı: microsoft-foundry

Gereksinimler

• Dağıtımları olan bir Microsoft Foundry veya Azure AI Foundry kaynağı.
• AZURE_OPENAI_API_KEY üzerinden API anahtarıyla kimlik doğrulaması veya yapılandırılmış bir sağlayıcı API anahtarı.
• Entra ID kimlik doğrulaması için Azure CLI'ı yükleyin ve ilk katılımdan önce az login komutunu çalıştırın. OpenClaw, Microsoft Foundry çalışma zamanı tokenlarını az account get-access-token üzerinden yeniler.

Sohbet modelleri

Microsoft Foundry sohbet dağıtımları, microsoft-foundry/<deployment-name> sağlayıcı model referansını kullanır. İlk katılım, Azure CLI ile Foundry kaynaklarını ve dağıtımlarını keşfeder, ardından seçilen dağıtım adını model yapılandırmasına yazar.

OpenClaw, desteklenen OpenAI uyumlu sohbet API'leri için Foundry /openai/v1 uç noktasını kullanır:

• GPT, o*, computer-use-preview ve DeepSeek-V4 model aileleri varsayılan olarak openai-responses kullanır.
• MAI-DS-R1 ve diğer sohbet tamamlama dağıtımları, desteklenen bir API açıkça yapılandırılmadığı sürece openai-completions kullanır.
• MAI-DS-R1'in akıl yürütme özelliği reasoning_effort üzerinden değil, akıl yürütme içeriği üzerinden kaydedilir. Bağlam ve çıktı tokenı meta verileri 163,840 tokendır.

Microsoft Foundry'deki Anthropic Claude dağıtımları, OpenAI uyumlu /openai/v1 biçimini değil, Anthropic Messages API biçimini kullanır. Microsoft Foundry plugin'i yerel bir Anthropic çalışma zamanı kazanana kadar bunları özel bir anthropic-messages sağlayıcısı olarak yapılandırın. Foundry dağıtım adı Claude model kimliğinden farklı olduğunda model girdisinde params.canonicalModelId değerini ayarlayın; böylece OpenClaw modele özgü bağlantı sözleşmelerini uygulayabilir, /think off değerini doğru şekilde eşleyebilir ve imzalı düşünmeyi güvenle koruyabilir.

MAI görüntü oluşturma

Plugin, mevcut Microsoft AI görüntü modelleriyle image_generate için microsoft-foundry kaydeder:

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

Model referansı olarak dağıtılmış bir MAI görüntü dağıtımının adını kullanın. MAI API, isteğin model alanında dağıtım adınızı gerektirdiğinden sağlayıcı varsayılan bir görüntü modeli bildirmez:

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

Yalnızca istem içeren oluşturma işlemleri Microsoft Foundry'nin MAI oluşturma uç noktasını çağırır: /mai/v1/images/generations. Referans görüntü düzenlemeleri /mai/v1/images/edits uç noktasını çağırır ve MAI-Image-2.5-Flash ile MAI-Image-2.5 dağıtımlarıyla sınırlıdır.

Yalnızca istem içeren oluşturma işlemlerinde, sadece Foundry uç noktası yapılandırılarak özel bir dağıtım adı kullanılabilir. Özel bir dağıtım adıyla görüntü düzenlemek için dağıtımı ilk katılım üzerinden seçin veya OpenClaw'ın dağıtımın MAI-Image-2.5-Flash ya da MAI-Image-2.5 tarafından desteklendiğini doğrulayabilmesi için model meta verilerini ekleyin.

MAI görüntü kısıtlamaları:

• Çıktı: istek başına bir PNG görüntüsü.
• Boyut: varsayılan 1024x1024; hem genişlik hem de yükseklik en az 768 px olmalıdır.
• Toplam piksel: genişlik × yükseklik en fazla 1,048,576 olmalıdır.
• Düzenlemeler: bir PNG veya JPEG girdi görüntüsü.
• aspectRatio, resolution, quality, background ve PNG olmayan outputFormat gibi desteklenmeyen ortak ipuçları Microsoft Foundry'ye gönderilmez.

Sorun giderme

• az: command not found: Azure CLI'ı yükleyin veya API anahtarıyla kimlik doğrulamasını kullanın.
• Microsoft Foundry endpoint missing for MAI image generation: ilk katılım üzerinden bir Foundry dağıtımı seçin veya models.providers.microsoft-foundry.baseUrl ekleyin.
• supports MAI image deployments only: seçilen görüntü modeli MAI olmayan bir dağıtımı gösteriyor. image_generate için dağıtılmış bir MAI görüntü modeli kullanın.