影像生成

每次呼叫的 model 覆寫只會嘗試該提供者/模型，不會繼續使用已設定的主要/備援或自動偵測的提供者。

只有當 OpenClaw 能實際驗證該提供者時，提供者預設值才會進入候選清單。設定 agents.defaults.mediaGenerationAutoProviderFallback: false，即可只使用明確的 model、primary 與 fallbacks 項目。

對速度較慢的影像後端設定 agents.defaults.imageGenerationModel.timeoutMs。每次呼叫的 timeoutMs 工具參數會覆寫已設定的預設值。

使用 action: "list" 檢查目前已註冊的提供者、其預設模型與驗證環境變數提示。

OpenAI 影像生成預設使用 openai/gpt-image-2。如果已設定 openai-codex OAuth 設定檔，OpenClaw 會重用 Codex 訂閱聊天模型所使用的相同 OAuth 設定檔，並透過 Codex Responses 後端傳送影像請求。舊版 Codex 基礎 URL，例如 https://chatgpt.com/backend-api，會針對影像請求標準化為 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 影像生成路由到 Azure OpenAI 部署， 而不是 api.openai.com，請參閱 Azure OpenAI 端點。

OpenRouter 影像生成使用相同的 OPENROUTER_API_KEY，並透過 OpenRouter 的聊天完成影像 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。使用 action: "list" 查看你已設定的 Plugin 公開哪些項目。

MiniMax 影像生成可透過兩種內建 MiniMax 驗證路徑使用：

• minimax/image-01 適用於 API 金鑰設定
• minimax-portal/image-01 適用於 OAuth 設定

內建的 xAI 提供者會針對純提示請求使用 /v1/images/generations， 並在存在 image 或 images 時使用 /v1/images/edits。

• 模型：xai/grok-imagine-image、xai/grok-imagine-image-pro
• 數量：最多 4 張
• 參考：一個 image 或最多五個 images
• 長寬比：1:1、16:9、9:16、4:3、3:4、2:3、3:2
• 解析度：1K、2K
• 輸出：以 OpenClaw 管理的影像附件傳回

OpenClaw 會刻意不公開 xAI 原生的 quality、mask、 user 或額外的原生專用長寬比，直到這些控制項存在於共用的跨提供者 image_generate 合約中。