Microsoft-Foundry-Plugin

Fügt OpenClaw Unterstützung für den Microsoft-Foundry-Modell-Provider hinzu.

Distribution

• Paket: @openclaw/microsoft-foundry
• Installationsweg: in OpenClaw enthalten

Oberfläche

Provider: microsoft-foundry; Verträge: imageGenerationProviders

• Provider für die Bilderzeugung: microsoft-foundry

Anforderungen

• Eine Microsoft-Foundry- oder Azure-AI-Foundry-Ressource mit Bereitstellungen.
• API-Schlüssel-Authentifizierung über AZURE_OPENAI_API_KEY oder einen konfigurierten Provider-API-Schlüssel.
• Installieren Sie für die Entra-ID-Authentifizierung die Azure CLI und führen Sie vor dem Onboarding az login aus. OpenClaw aktualisiert Microsoft-Foundry-Laufzeittoken über az account get-access-token.

Chatmodelle

Microsoft-Foundry-Chatbereitstellungen verwenden die Provider-Modellreferenz microsoft-foundry/<deployment-name>. Beim Onboarding werden Foundry-Ressourcen und -Bereitstellungen mit der Azure CLI ermittelt; anschließend wird der Name der ausgewählten Bereitstellung in die Modellkonfiguration geschrieben.

OpenClaw verwendet den Foundry-Endpunkt /openai/v1 für unterstützte OpenAI-kompatible Chat-APIs:

• Die Modellfamilien GPT, o*, computer-use-preview und DeepSeek-V4 verwenden standardmäßig openai-responses.
• MAI-DS-R1 und andere Chat-Completion-Bereitstellungen verwenden openai-completions, sofern keine explizite unterstützte API konfiguriert ist.
• MAI-DS-R1 wird anhand des Reasoning-Inhalts als Reasoning-fähig erfasst, nicht anhand von reasoning_effort. Die Metadaten für Kontext- und Ausgabetoken betragen 163,840 Token.

Anthropic-Claude-Bereitstellungen in Microsoft Foundry verwenden das Format der Anthropic Messages API und nicht das OpenAI-kompatible Format /openai/v1. Konfigurieren Sie diese als benutzerdefinierten anthropic-messages-Provider, bis das Microsoft-Foundry-Plugin eine native Anthropic-Laufzeit erhält. Wenn sich der Foundry-Bereitstellungsname von der Claude-Modell-ID unterscheidet, legen Sie im Modelleintrag params.canonicalModelId fest, damit OpenClaw modellspezifische Übertragungsverträge anwenden, /think off korrekt zuordnen und signiertes Denken sicher beibehalten kann.

MAI-Bilderzeugung

Das Plugin registriert microsoft-foundry für image_generate mit den aktuellen Microsoft-AI-Bildmodellen:

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

Verwenden Sie den Namen einer bereitgestellten MAI-Bildbereitstellung als Modellreferenz. Der Provider deklariert kein Standardbildmodell, da die MAI-API den Namen Ihrer Bereitstellung im Anfragefeld model erfordert:

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

Bei der Erzeugung nur anhand eines Prompts wird der MAI-Generierungsendpunkt von Microsoft Foundry aufgerufen: /mai/v1/images/generations. Bearbeitungen mit Referenzbildern rufen /mai/v1/images/edits auf und sind auf Bereitstellungen von MAI-Image-2.5-Flash und MAI-Image-2.5 beschränkt.

Für die Erzeugung nur anhand eines Prompts kann ein benutzerdefinierter Bereitstellungsname verwendet werden, wenn lediglich der Foundry- Endpunkt konfiguriert ist. Wählen Sie für Bildbearbeitungen mit einem benutzerdefinierten Bereitstellungsnamen die Bereitstellung während des Onboardings aus oder fügen Sie Modellmetadaten hinzu, damit OpenClaw überprüfen kann, dass die Bereitstellung auf MAI-Image-2.5-Flash oder MAI-Image-2.5 basiert.

Einschränkungen für MAI-Bilder:

• Ausgabe: ein PNG-Bild pro Anfrage.
• Größe: standardmäßig 1024x1024; Breite und Höhe müssen jeweils mindestens 768 px betragen.
• Gesamtpixelzahl: Breite × Höhe darf höchstens 1,048,576 betragen.
• Bearbeitungen: ein PNG- oder JPEG-Eingabebild.
• Nicht unterstützte gemeinsame Hinweise wie aspectRatio, resolution, quality, background und andere outputFormat-Formate als PNG werden nicht an Microsoft Foundry gesendet.

Fehlerbehebung

• az: command not found: Installieren Sie die Azure CLI oder verwenden Sie die API-Schlüssel-Authentifizierung.
• Microsoft Foundry endpoint missing for MAI image generation: Wählen Sie während des Onboardings eine Foundry-Bereitstellung aus oder fügen Sie models.providers.microsoft-foundry.baseUrl hinzu.
• supports MAI image deployments only: Das ausgewählte Bildmodell verweist auf eine Nicht-MAI-Bereitstellung. Verwenden Sie für image_generate ein bereitgestelltes MAI-Bildmodell.