Плагин Microsoft Foundry

Добавляет в OpenClaw поддержку поставщика моделей Microsoft Foundry.

Распространение

• Пакет: @openclaw/microsoft-foundry
• Способ установки: входит в состав OpenClaw

Поверхность

поставщики: microsoft-foundry; контракты: imageGenerationProviders

• Поставщик генерации изображений: microsoft-foundry

Требования

• Ресурс Microsoft Foundry или Azure AI Foundry с развертываниями.
• Аутентификация с помощью ключа API через AZURE_OPENAI_API_KEY или настроенный ключ API поставщика.
• Для аутентификации Entra ID установите Azure CLI и выполните az login перед начальной настройкой. OpenClaw обновляет токены среды выполнения Microsoft Foundry через az account get-access-token.

Модели чата

Развертывания чата Microsoft Foundry используют ссылку на модель поставщика microsoft-foundry/<deployment-name>. Во время начальной настройки ресурсы и развертывания Foundry обнаруживаются с помощью Azure CLI, после чего имя выбранного развертывания записывается в конфигурацию модели.

OpenClaw использует конечную точку Foundry /openai/v1 для поддерживаемых совместимых с OpenAI API чата:

• Семейства моделей GPT, o*, computer-use-preview и DeepSeek-V4 по умолчанию используют openai-responses.
• MAI-DS-R1 и другие развертывания завершения чата используют openai-completions, если явно не настроен поддерживаемый API.
• MAI-DS-R1 регистрируется как модель с поддержкой рассуждений через содержимое рассуждений, а не через reasoning_effort. Метаданные контекста и выходных токенов этой модели составляют 163,840 токенов.

Развертывания Anthropic Claude в Microsoft Foundry используют формат API Anthropic Messages, а не совместимый с OpenAI формат /openai/v1. Настройте их как пользовательского поставщика anthropic-messages, пока в плагине Microsoft Foundry не появится нативная среда выполнения Anthropic. Если имя развертывания Foundry отличается от идентификатора модели Claude, задайте params.canonicalModelId в записи модели, чтобы OpenClaw мог применять специфичные для модели контракты передачи данных, правильно сопоставлять /think off и безопасно сохранять подписанные рассуждения.

Генерация изображений MAI

Плагин регистрирует microsoft-foundry для image_generate с текущими моделями изображений Microsoft AI:

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

Используйте имя развернутого развертывания изображений MAI как ссылку на модель. Поставщик не объявляет модель изображений по умолчанию, поскольку API MAI требует указывать имя вашего развертывания в поле запроса model:

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

При генерации только по запросу вызывается конечная точка генераций MAI Microsoft Foundry: /mai/v1/images/generations. При редактировании по эталонному изображению вызывается /mai/v1/images/edits; такая возможность доступна только для развертываний MAI-Image-2.5-Flash и MAI-Image-2.5.

Для генерации только по запросу можно использовать пользовательское имя развертывания, настроив лишь конечную точку Foundry. Для редактирования изображений с пользовательским именем развертывания выберите развертывание во время начальной настройки или укажите метаданные модели, чтобы OpenClaw мог проверить, что развертывание основано на MAI-Image-2.5-Flash или MAI-Image-2.5.

Ограничения изображений MAI:

• Выходные данные: одно изображение PNG на запрос.
• Размер: по умолчанию 1024x1024; ширина и высота должны быть не менее 768 пикселей.
• Общее количество пикселей: ширина × высота не должно превышать 1,048,576.
• Редактирование: одно входное изображение PNG или JPEG.
• Неподдерживаемые общие подсказки, такие как aspectRatio, resolution, quality, background, а также outputFormat в формате, отличном от PNG, не отправляются в Microsoft Foundry.

Устранение неполадок

• az: command not found: установите Azure CLI или используйте аутентификацию с помощью ключа API.
• Microsoft Foundry endpoint missing for MAI image generation: выберите развертывание Foundry во время начальной настройки или добавьте models.providers.microsoft-foundry.baseUrl.
• supports MAI image deployments only: выбранная модель изображений указывает на развертывание, отличное от MAI. Используйте развернутую модель изображений MAI для image_generate.