Plugin Microsoft Foundry

Menambahkan dukungan penyedia model Microsoft Foundry ke OpenClaw.

Distribusi

• Paket: @openclaw/microsoft-foundry
• Jalur instalasi: disertakan dalam OpenClaw

Permukaan

penyedia: microsoft-foundry; kontrak: imageGenerationProviders

• Penyedia pembuatan gambar: microsoft-foundry

Persyaratan

• Sumber daya Microsoft Foundry atau Azure AI Foundry yang memiliki deployment.
• Autentikasi kunci API melalui AZURE_OPENAI_API_KEY atau kunci API penyedia yang telah dikonfigurasi.
• Untuk autentikasi Entra ID, instal Azure CLI dan jalankan az login sebelum orientasi awal. OpenClaw menyegarkan token runtime Microsoft Foundry melalui az account get-access-token.

Model percakapan

Deployment percakapan Microsoft Foundry menggunakan referensi model penyedia microsoft-foundry/<deployment-name>. Orientasi awal menemukan sumber daya dan deployment Foundry dengan Azure CLI, lalu menulis nama deployment yang dipilih ke konfigurasi model.

OpenClaw menggunakan endpoint Foundry /openai/v1 untuk API percakapan kompatibel OpenAI yang didukung:

• Kelompok model GPT, o*, computer-use-preview, dan DeepSeek-V4 secara default menggunakan openai-responses.
• MAI-DS-R1 dan deployment penyelesaian percakapan lainnya menggunakan openai-completions, kecuali API yang didukung telah dikonfigurasi secara eksplisit.
• MAI-DS-R1 dicatat sebagai model yang mendukung penalaran melalui konten penalaran, bukan melalui reasoning_effort. Metadata token konteks dan keluarannya adalah 163.840 token.

Deployment Anthropic Claude di Microsoft Foundry menggunakan format API Anthropic Messages, bukan format kompatibel OpenAI /openai/v1. Konfigurasikan deployment tersebut sebagai penyedia anthropic-messages khusus hingga Plugin Microsoft Foundry memiliki runtime Anthropic native. Jika nama deployment Foundry berbeda dari ID model Claude, tetapkan params.canonicalModelId pada entri model agar OpenClaw dapat menerapkan kontrak komunikasi khusus model, memetakan /think off dengan benar, dan mempertahankan pemikiran bertanda tangan dengan aman.

Pembuatan gambar MAI

Plugin mendaftarkan microsoft-foundry untuk image_generate dengan model gambar Microsoft AI saat ini:

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

Gunakan nama deployment gambar MAI yang telah di-deploy sebagai referensi model. Penyedia tidak mendeklarasikan model gambar default karena API MAI memerlukan nama deployment Anda dalam bidang permintaan model:

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

Pembuatan hanya dengan perintah teks memanggil endpoint pembuatan MAI Microsoft Foundry: /mai/v1/images/generations. Pengeditan gambar referensi memanggil /mai/v1/images/edits dan terbatas pada deployment MAI-Image-2.5-Flash dan MAI-Image-2.5.

Pembuatan hanya dengan perintah teks dapat menggunakan nama deployment khusus hanya dengan endpoint Foundry yang dikonfigurasi. Untuk pengeditan gambar dengan nama deployment khusus, pilih deployment melalui orientasi awal atau sertakan metadata model agar OpenClaw dapat memverifikasi bahwa deployment didukung oleh MAI-Image-2.5-Flash atau MAI-Image-2.5.

Batasan gambar MAI:

• Keluaran: satu gambar PNG per permintaan.
• Ukuran: default 1024x1024; lebar dan tinggi masing-masing harus setidaknya 768 px.
• Total piksel: lebar × tinggi harus paling banyak 1.048.576.
• Pengeditan: satu gambar masukan PNG atau JPEG.
• Petunjuk bersama yang tidak didukung seperti aspectRatio, resolution, quality, background, dan outputFormat non-PNG tidak dikirim ke Microsoft Foundry.

Pemecahan masalah

• az: command not found: instal Azure CLI atau gunakan autentikasi kunci API.
• Microsoft Foundry endpoint missing for MAI image generation: pilih deployment Foundry melalui orientasi awal atau tambahkan models.providers.microsoft-foundry.baseUrl.
• supports MAI image deployments only: model gambar yang dipilih mengarah ke deployment non-MAI. Gunakan model gambar MAI yang telah di-deploy untuk image_generate.