OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Get started

Microsoft Foundry 外掛

Microsoft Foundry 外掛

為 OpenClaw 新增 Microsoft Foundry 模型供應商支援。

發行方式

  • 套件：@openclaw/microsoft-foundry
  • 安裝途徑：已包含於 OpenClaw

介面

供應商：microsoft-foundry；合約：imageGenerationProviders

  • 圖像生成供應商：microsoft-foundry

需求

  • 具有部署的 Microsoft Foundry 或 Azure AI Foundry 資源。
  • 透過 AZURE_OPENAI_API_KEY 或已設定的供應商 API 金鑰進行 API 金鑰驗證。
  • 若使用 Entra ID 驗證，請安裝 Azure 命令列介面，並在引導設定前執行 az login。OpenClaw 會透過 az account get-access-token 重新整理 Microsoft Foundry 執行階段權杖。

聊天模型

Microsoft Foundry 聊天部署使用供應商模型參照 microsoft-foundry/<deployment-name>。引導設定會透過 Azure 命令列介面探索 Foundry 資源與部署，接著將所選的部署名稱寫入模型設定。

OpenClaw 對支援的 OpenAI 相容聊天 API 使用 Foundry /openai/v1 端點：

  • GPT、o*、computer-use-preview 和 DeepSeek-V4 模型系列預設使用 openai-responses。
  • MAI-DS-R1 與其他聊天補全部署使用 openai-completions，除非已明確設定受支援的 API。
  • MAI-DS-R1 會透過推理內容記錄為具備推理能力，而非透過 reasoning_effort。其上下文與輸出權杖中繼資料皆為 163,840 個權杖。

Microsoft Foundry 中的 Anthropic Claude 部署使用 Anthropic Messages API 格式，而非 OpenAI 相容的 /openai/v1 格式。在 Microsoft Foundry 外掛新增原生 Anthropic 執行階段前，請將其設定為自訂 anthropic-messages 供應商。若 Foundry 部署名稱與 Claude 模型 ID 不同，請在模型項目上設定 params.canonicalModelId，讓 OpenClaw 能套用模型專屬的傳輸合約、正確對應 /think off，並安全保留已簽署的思考內容。

MAI 圖像生成

此外掛會為 image_generate 註冊 microsoft-foundry，並支援目前的 Microsoft AI 圖像模型：

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

請使用已部署的 MAI 圖像部署名稱作為模型參照。此供應商不宣告預設圖像模型，因為 MAI API 要求在請求的 model 欄位中使用您的部署名稱：

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

僅含提示詞的生成會呼叫 Microsoft Foundry 的 MAI 生成端點：/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 px。
  • 總像素數：寬度 × 高度不得超過 1,048,576。
  • 編輯：一張 PNG 或 JPEG 輸入圖像。
  • 不支援的共用提示，例如 aspectRatio、resolution、quality、background，以及非 PNG 的 outputFormat，不會傳送至 Microsoft Foundry。

疑難排解

  • az: command not found：安裝 Azure 命令列介面，或使用 API 金鑰驗證。
  • Microsoft Foundry endpoint missing for MAI image generation：透過引導設定選取 Foundry 部署，或新增 models.providers.microsoft-foundry.baseUrl。
  • supports MAI image deployments only：所選的圖像模型指向非 MAI 部署。請為 image_generate 使用已部署的 MAI 圖像模型。
Was this useful?
On this page

On this page