​

Microsoft Foundry 插件

​

分发

• 包：@openclaw/microsoft-foundry
• 安装途径：包含在 OpenClaw 中

​

接口

• 图像生成提供程序：microsoft-foundry

​

要求

• 需要一个带有部署的 Microsoft Foundry 或 Azure AI Foundry 资源。
• 通过 AZURE_OPENAI_API_KEY 或已配置的提供程序 API 密钥进行 API 密钥认证。
• 对于 Entra ID 认证，请先安装 Azure CLI 并在 入门流程之前运行 az login。OpenClaw 通过 az account get-access-token 刷新 Microsoft Foundry 运行时令牌。

​

聊天模型

• GPT、o*、computer-use-preview 和 DeepSeek-V4 模型系列默认使用 openai-responses。
• MAI-DS-R1 和其他 chat-completion 部署使用 openai-completions ，除非配置了明确受支持的 API。
• MAI-DS-R1 通过 reasoning content 被记录为支持推理，而不是通过 reasoning_effort。其上下文和输出 token 元数据为 163,840 tokens。

​

MAI 图像生成

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

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

• 输出：每个请求一张 PNG 图像。
• 大小：默认 1024x1024；宽度和高度都必须至少为 768 px。
• 总像素数：宽度 × 高度最多为 1,048,576。
• 编辑：输入一张 PNG 或 JPEG 图像。
• 不支持的共享提示，例如 aspectRatio、resolution、quality、 background 以及非 PNG 的 outputFormat 不会发送到 Microsoft Foundry。

​

故障排除

• az: command not found：安装 Azure CLI 或使用 API 密钥认证。
• Microsoft Foundry endpoint missing for MAI image generation：通过 onboarding 选择一个 Foundry 部署，或添加 models.providers.microsoft-foundry.baseUrl。
• supports MAI image deployments only：所选图像模型指向一个 非 MAI 部署。请为 image_generate 使用已部署的 MAI 图像模型。