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 penyiapan awal. OpenClaw menyegarkan token runtime Microsoft Foundry melalui az account get-access-token.

Model chat

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

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

• Keluarga model GPT, o*, computer-use-preview, dan DeepSeek-V4 secara default menggunakan openai-responses.
• Deployment MAI-DS-R1 dan chat-completion lainnya menggunakan openai-completions kecuali API yang didukung dikonfigurasi secara eksplisit.
• MAI-DS-R1 dicatat sebagai mampu melakukan penalaran melalui konten penalaran, bukan melalui reasoning_effort. Metadata token konteks dan outputnya adalah 163.840 token.

Deployment Anthropic Claude di Microsoft Foundry menggunakan bentuk API Anthropic Messages, bukan bentuk /openai/v1 yang kompatibel OpenAI. Konfigurasikan ini sebagai penyedia anthropic-messages kustom hingga Plugin Microsoft Foundry menambahkan runtime Anthropic native. Ketika nama deployment Foundry berbeda dari ID model Claude, atur params.canonicalModelId pada entri model agar OpenClaw dapat menerapkan kontrak protokol 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 sudah di-deploy sebagai referensi model. Penyedia tidak mendeklarasikan model gambar default karena API MAI memerlukan nama deployment Anda di bidang model permintaan:

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

Panggilan pembuatan hanya dengan prompt menggunakan endpoint pembuatan MAI Microsoft Foundry: /mai/v1/images/generations. Edit gambar referensi memanggil /mai/v1/images/edits dan dibatasi untuk deployment MAI-Image-2.5-Flash dan MAI-Image-2.5.

Pembuatan hanya dengan prompt dapat menggunakan nama deployment kustom hanya dengan endpoint Foundry yang dikonfigurasi. Untuk edit gambar dengan nama deployment kustom, pilih deployment melalui penyiapan 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:

• Output: 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.
• Edit: satu gambar input 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 penyiapan 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 sudah di-deploy untuk image_generate.