画像生成

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

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

遅い画像バックエンドには agents.defaults.imageGenerationModel.timeoutMs を設定します。呼び出しごとの timeoutMs ツールパラメーターは、構成済みのデフォルトを上書きします。Codex の動的ツール呼び出しも同じタイムアウト予算を尊重し、OpenClaw の 600000 ms の動的ツールブリッジ上限で制限されます。

現在登録されているプロバイダー、そのデフォルトモデル、認証環境変数のヒントを確認するには、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 に返されます。

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

OpenRouter 画像生成は同じ OPENROUTER_API_KEY を使用し、 OpenRouter の chat completions 画像 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、または追加のネイティブ専用アスペクト比を意図的に公開しません。