画像生成

呼び出しごとの model 上書きは、そのプロバイダー/モデルのみを試し、設定済みの primary/fallback や自動検出されたプロバイダーには進みません。

OpenClaw がそのプロバイダーで実際に認証できる場合にのみ、プロバイダーのデフォルトが候補リストに入ります。明示的な model、primary、fallbacks エントリのみを使用するには、agents.defaults.mediaGenerationAutoProviderFallback: false を設定します。

低速な画像バックエンドには agents.defaults.imageGenerationModel.timeoutMs を設定します。呼び出しごとの timeoutMs ツールパラメーターは、設定済みのデフォルトを上書きします。

現在登録されているプロバイダー、そのデフォルトモデル、認証 env-var ヒントを調べるには、action: "list" を使用します。

OpenAI の画像生成はデフォルトで openai/gpt-image-2 を使用します。 openai-codex OAuth プロファイルが設定されている場合、OpenClaw は Codex サブスクリプションのチャットモデルで使用されるものと同じ OAuth プロファイルを再利用し、画像リクエストを Codex Responses バックエンド経由で送信します。 https://chatgpt.com/backend-api のような従来の Codex ベース URL は、画像リクエストでは https://chatgpt.com/backend-api/codex に正規化されます。OpenClaw は そのリクエストで OPENAI_API_KEY へ暗黙的にフォールバックすることはありません - OpenAI Images API への直接ルーティングを強制するには、 API キー、カスタムベース URL、または Azure エンドポイントを使って models.providers.openai を明示的に設定してください。

openai/gpt-image-1.5、openai/gpt-image-1、および openai/gpt-image-1-mini モデルは、引き続き明示的に選択できます。 透明背景の PNG/WebP 出力には gpt-image-1.5 を使用してください。現在の gpt-image-2 API は background: "transparent" を拒否します。

gpt-image-2 は、同じ image_generate ツールを通じて、テキストから画像への生成と 参照画像の編集の両方をサポートします。 OpenClaw は prompt、count、size、quality、outputFormat、 および参照画像を OpenAI に転送します。OpenAI は aspectRatio や resolution を直接受け取りません。可能な場合、OpenClaw は それらをサポートされる size にマッピングし、それ以外の場合はツールが 無視された上書きとして報告します。

OpenAI 固有のオプションは openai オブジェクト配下にあります。

{
  "quality": "low",
  "outputFormat": "jpeg",
  "openai": {
    "background": "opaque",
    "moderation": "low",
    "outputCompression": 60,
    "user": "end-user-42"
  }
}

openai.background は transparent、opaque、または auto を受け付けます。 透明出力には outputFormat png または webp と、 透明度に対応した OpenAI 画像モデルが必要です。OpenClaw は、デフォルトの gpt-image-2 透明背景リクエストを gpt-image-1.5 にルーティングします。 openai.outputCompression は JPEG/WebP 出力に適用されます。

トップレベルの background ヒントはプロバイダー中立であり、現在は OpenAI プロバイダーが選択されている場合、同じ OpenAI background リクエストフィールドに マッピングされます。背景サポートを宣言していないプロバイダーは、 サポートされていないパラメーターを受け取る代わりに、それを ignoredOverrides で返します。

OpenAI の画像生成を api.openai.com ではなく Azure OpenAI デプロイメント経由でルーティングするには、 Azure OpenAI エンドポイントを参照してください。

OpenRouter の画像生成は同じ OPENROUTER_API_KEY を使用し、 OpenRouter の chat completions image API 経由でルーティングされます。 OpenRouter 画像モデルは openrouter/ プレフィックスで選択します。

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "openrouter/google/gemini-3.1-flash-image-preview",
      },
    },
  },
}

OpenClaw は prompt、count、参照画像、および Gemini 互換の aspectRatio / resolution ヒントを OpenRouter に転送します。 現在の組み込み OpenRouter 画像モデルのショートカットには、 google/gemini-3.1-flash-image-preview、 google/gemini-3-pro-image-preview、および openai/gpt-5.4-image-2 が含まれます。 設定済みの plugin が公開している内容を確認するには、action: "list" を使用してください。

MiniMax 画像生成は、バンドルされた MiniMax の両方の 認証パスから利用できます。

• API キー設定では minimax/image-01
• OAuth 設定では minimax-portal/image-01

バンドルされた xAI プロバイダーは、プロンプトのみの リクエストには /v1/images/generations を使用し、image または images が存在する場合は /v1/images/edits を使用します。

• モデル: xai/grok-imagine-image, xai/grok-imagine-image-pro
• 数: 最大 4
• 参照: 1 つの image、または最大 5 つの images
• アスペクト比: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• 解像度: 1K, 2K
• 出力: OpenClaw が管理する画像添付として返されます

OpenClaw は、共有のクロスプロバイダー image_generate コントラクトに これらのコントロールが存在するまで、xAI ネイティブの quality, mask, user、または追加のネイティブ専用アスペクト比を意図的に公開しません。