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 CLI 并运行 az login。OpenClaw 通过 az account get-access-token 刷新 Microsoft Foundry 运行时 Token。

聊天模型¶

Microsoft Foundry 聊天部署使用提供商模型引用 microsoft-foundry/<deployment-name>。引导配置会通过 Azure CLI 发现 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 被记录为具备推理能力。其上下文和输出 Token 元数据为 163,840 个 Token。

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 字段中提供你的部署名称：

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

仅 Prompt 生成会调用 Microsoft Foundry 的 MAI generations 端点：/mai/v1/images/generations。参考图像编辑会调用 /mai/v1/images/edits，并且仅限于 MAI-Image-2.5-Flash 和 MAI-Image-2.5 部署。

仅 Prompt 生成可以在仅配置 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 CLI 或使用 API 密钥认证。
• Microsoft Foundry endpoint missing for MAI image generation：通过引导配置选择 Foundry 部署，或添加 models.providers.microsoft-foundry.baseUrl。
• supports MAI image deployments only：所选图像模型指向非 MAI 部署。对于 image_generate，请使用已部署的 MAI 图像模型。