Plugin Microsoft Foundry

Thêm hỗ trợ nhà cung cấp mô hình Microsoft Foundry cho OpenClaw.

Phân phối

• Gói: @openclaw/microsoft-foundry
• Tuyến cài đặt: được bao gồm trong OpenClaw

Bề mặt

providers: microsoft-foundry; contracts: imageGenerationProviders

• Nhà cung cấp tạo hình ảnh: microsoft-foundry

Yêu cầu

• Một tài nguyên Microsoft Foundry hoặc Azure AI Foundry có các deployment.
• Xác thực bằng khóa API thông qua AZURE_OPENAI_API_KEY hoặc khóa API nhà cung cấp đã cấu hình.
• Với xác thực Entra ID, hãy cài đặt Azure CLI và chạy az login trước khi onboarding. OpenClaw làm mới các mã thông báo runtime Microsoft Foundry thông qua az account get-access-token.

Mô hình chat

Các deployment chat của Microsoft Foundry dùng ref mô hình nhà cung cấp microsoft-foundry/<deployment-name>. Onboarding phát hiện tài nguyên Foundry và deployment bằng Azure CLI, sau đó ghi tên deployment đã chọn vào cấu hình mô hình.

OpenClaw dùng endpoint /openai/v1 của Foundry cho các API chat tương thích OpenAI được hỗ trợ:

• Các họ mô hình GPT, o*, computer-use-preview và DeepSeek-V4 mặc định dùng openai-responses.
• MAI-DS-R1 và các deployment chat-completion khác dùng openai-completions trừ khi một API được hỗ trợ rõ ràng được cấu hình.
• MAI-DS-R1 được ghi nhận là có khả năng suy luận thông qua nội dung suy luận, không thông qua reasoning_effort. Siêu dữ liệu token ngữ cảnh và đầu ra của nó là 163.840 token.

Các deployment Anthropic Claude trong Microsoft Foundry dùng dạng API Anthropic Messages, không phải dạng tương thích OpenAI /openai/v1. Hãy cấu hình chúng dưới dạng nhà cung cấp anthropic-messages tùy chỉnh cho đến khi Plugin Microsoft Foundry có runtime Anthropic gốc. Khi tên deployment Foundry khác với ID mô hình Claude, hãy đặt params.canonicalModelId trên mục mô hình để OpenClaw có thể áp dụng các hợp đồng dây dẫn đặc thù theo mô hình, ánh xạ /think off chính xác và bảo toàn signed thinking một cách an toàn.

Tạo hình ảnh MAI

Plugin đăng ký microsoft-foundry cho image_generate với các mô hình hình ảnh Microsoft AI hiện tại:

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

Dùng tên deployment hình ảnh MAI đã triển khai làm ref mô hình. Nhà cung cấp không khai báo mô hình hình ảnh mặc định vì API MAI yêu cầu tên deployment của bạn trong trường model của yêu cầu:

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

Các lệnh gọi tạo chỉ bằng prompt dùng endpoint generations MAI của Microsoft Foundry: /mai/v1/images/generations. Các chỉnh sửa bằng hình ảnh tham chiếu gọi /mai/v1/images/edits và chỉ giới hạn ở các deployment MAI-Image-2.5-Flash và MAI-Image-2.5.

Tạo chỉ bằng prompt có thể dùng tên deployment tùy chỉnh chỉ với endpoint Foundry được cấu hình. Với chỉnh sửa hình ảnh có tên deployment tùy chỉnh, hãy chọn deployment thông qua onboarding hoặc đưa vào siêu dữ liệu mô hình để OpenClaw có thể xác minh rằng deployment được hỗ trợ bởi MAI-Image-2.5-Flash hoặc MAI-Image-2.5.

Ràng buộc hình ảnh MAI:

• Đầu ra: một hình ảnh PNG cho mỗi yêu cầu.
• Kích thước: mặc định 1024x1024; cả chiều rộng và chiều cao phải ít nhất 768 px.
• Tổng số pixel: chiều rộng × chiều cao tối đa là 1.048.576.
• Chỉnh sửa: một hình ảnh đầu vào PNG hoặc JPEG.
• Các gợi ý dùng chung không được hỗ trợ như aspectRatio, resolution, quality, background và outputFormat không phải PNG sẽ không được gửi đến Microsoft Foundry.

Khắc phục sự cố

• az: command not found: cài đặt Azure CLI hoặc dùng xác thực bằng khóa API.
• Microsoft Foundry endpoint missing for MAI image generation: chọn một deployment Foundry thông qua onboarding hoặc thêm models.providers.microsoft-foundry.baseUrl.
• supports MAI image deployments only: mô hình hình ảnh đã chọn trỏ đến một deployment không phải MAI. Dùng một mô hình hình ảnh MAI đã triển khai cho image_generate.