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 Plugin

Microsoft Foundry Plugin

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 のランタイムトークンを更新します。

チャットモデル

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 およびその他のチャット補完デプロイでは、サポートされている API が明示的に設定されていない限り、openai-completions を使用します。
  • MAI-DS-R1 は、reasoning_effort ではなく推論コンテンツによって推論対応として記録されます。コンテキストおよび出力トークンのメタデータは 163,840 トークンです。

Microsoft Foundry の Anthropic Claude デプロイでは、OpenAI 互換の /openai/v1 形式ではなく、Anthropic Messages API 形式を使用します。Microsoft Foundry Plugin にネイティブの Anthropic ランタイムが追加されるまでは、カスタム anthropic-messages プロバイダーとして設定してください。Foundry のデプロイ名が Claude モデル ID と異なる場合は、モデルエントリに params.canonicalModelId を設定します。これにより、OpenClaw はモデル固有の通信コントラクトを適用し、/think off を正しくマッピングして、署名付き思考を安全に保持できます。

MAI 画像生成

この Plugin は、現在の Microsoft AI 画像モデル向けに image_generate の microsoft-foundry を登録します。

  • 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 エンドポイントを設定するだけで、カスタムデプロイ名を使用できます。カスタムデプロイ名で画像を編集する場合は、オンボーディングでデプロイを選択するか、モデルメタデータを含めて、そのデプロイが MAI-Image-2.5-Flash または MAI-Image-2.5 を基盤としていることを OpenClaw が検証できるようにします。

MAI 画像の制約:

  • 出力: リクエストごとに PNG 画像 1 枚。
  • サイズ: デフォルトは 1024x1024。幅と高さはどちらも 768 px 以上である必要があります。
  • 総ピクセル数: 幅 × 高さは 1,048,576 以下である必要があります。
  • 編集: PNG または JPEG の入力画像 1 枚。
  • 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 画像モデルを使用してください。
Was this useful?
On this page

On this page