Plugin Microsoft Foundry

Menambahkan dukungan penyedia model Microsoft Foundry ke OpenClaw.

Distribusi

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

Permukaan

penyedia: microsoft-foundry; kontrak: imageGenerationProviders

• Penyedia pembuatan gambar: microsoft-foundry

Persyaratan

• Sumber daya Microsoft Foundry atau Azure AI Foundry dengan deployment.
• Autentikasi kunci API melalui AZURE_OPENAI_API_KEY atau kunci API penyedia yang dikonfigurasi.
• Untuk autentikasi Entra ID, instal Azure CLI dan jalankan az login sebelum orientasi. OpenClaw memperbarui 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 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:

• Keluarga 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 dikonfigurasi secara eksplisit.
• MAI-DS-R1 dicatat sebagai berkemampuan 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 /openai/v1 yang kompatibel dengan OpenAI. 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 protokol khusus model, memetakan /think off dengan benar, dan mempertahankan pemikiran yang ditandatangani secara 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 diterapkan 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 prompt memanggil endpoint pembuatan MAI milik Microsoft Foundry: /mai/v1/images/generations. Pengeditan gambar referensi memanggil /mai/v1/images/edits dan dibatasi pada deployment MAI-Image-2.5-Flash dan MAI-Image-2.5.

Pembuatan hanya dengan prompt dapat menggunakan nama deployment khusus hanya dengan endpoint Foundry yang dikonfigurasi. Untuk pengeditan gambar dengan nama deployment khusus, pilih deployment melalui orientasi atau sertakan metadata model agar OpenClaw dapat memverifikasi bahwa deployment tersebut 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 minimal 768 px.
• Total piksel: lebar × tinggi maksimal 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 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 diterapkan untuk image_generate.