Azure 端点

Azure OpenAI 端点¶

捆绑的 openai 提供程序可以通过覆盖基础 URL 来指向 Azure OpenAI 资源，用于图像生成。在图像生成路径中，OpenClaw 会检测 models.providers.openai.baseUrl 上的 Azure 主机名，并自动切换到 Azure 的请求格式。

在以下情况下使用 Azure OpenAI：

• 您已有 Azure OpenAI 订阅、配额或企业协议
• 您需要 Azure 提供的区域数据驻留或合规控制
• 您希望将流量保留在现有 Azure 租户内

配置¶

对于通过捆绑的 openai 提供程序进行的 Azure 图像生成，请将 models.providers.openai.baseUrl 指向您的 Azure 资源，并将 apiKey 设置为 Azure OpenAI 密钥（而不是 OpenAI Platform 密钥）：

{
  models: {
    providers: {
      openai: {
        baseUrl: "https://<your-resource>.openai.azure.com",
        apiKey: "<azure-openai-api-key>",
      },
    },
  },
}

OpenClaw 为 Azure 图像生成路由识别以下 Azure 主机后缀：

• *.openai.azure.com
• *.services.ai.azure.com
• *.cognitiveservices.azure.com

对于在受识别 Azure 主机上的图像生成请求，OpenClaw：

• 发送 api-key 请求头，而不是 Authorization: Bearer
• 使用部署作用域路径（/openai/deployments/{deployment}/...）
• 为每个请求追加 ?api-version=...
• 对 Azure 图像生成调用使用 600 秒的默认请求超时。 每次调用的 timeoutMs 值仍会覆盖此默认值。

其他基础 URL（公共 OpenAI、OpenAI 兼容代理）保持标准 OpenAI 图像请求格式。

API 版本¶

设置 AZURE_OPENAI_API_VERSION 可为 Azure 图像生成路径固定特定的 Azure 预览版或 GA 版本：

export AZURE_OPENAI_API_VERSION="2024-12-01-preview"

当变量未设置时，默认值为 2024-12-01-preview。

模型名称是部署名称¶

Azure OpenAI 将模型绑定到部署。对于通过捆绑的 openai 提供程序路由的 Azure 图像生成请求，OpenClaw 中的 model 字段必须是您在 Azure 门户中配置的 Azure 部署名称，而不是公共 OpenAI 模型 id。

如果您创建了一个名为 gpt-image-2-prod 的部署来提供 gpt-image-2：

/tool image_generate model=openai/gpt-image-2-prod prompt="A clean poster" size=1024x1024 count=1

相同的部署名称规则适用于任何通过捆绑的 openai 提供程序路由的图像生成调用。

区域可用性¶

Azure 图像生成目前仅在部分区域可用 （例如 eastus2、swedencentral、polandcentral、westus3、 uaenorth）。创建部署前，请检查 Microsoft 当前的区域列表，并确认特定模型在您的区域提供。

参数差异¶

Azure OpenAI 和公共 OpenAI 并不总是接受相同的图像参数。 Azure 可能会拒绝公共 OpenAI 允许的选项（例如 gpt-image-2 上的某些 background 值），或仅在特定模型版本上公开它们。这些差异来自 Azure 和底层模型，而不是 OpenClaw。如果 Azure 请求因验证错误而失败，请在 Azure 门户中检查您的特定部署和 API 版本支持的参数集。