Bildgenerierung

Ein model-Override pro Aufruf versucht nur diesen Provider/dieses Modell und fährt nicht mit konfigurierten primären/Fallback- oder automatisch erkannten Providern fort.

Ein Provider-Standard wird nur in die Kandidatenliste aufgenommen, wenn OpenClaw diesen Provider tatsächlich authentifizieren kann. Legen Sie agents.defaults.mediaGenerationAutoProviderFallback: false fest, um nur explizite Einträge für model, primary und fallbacks zu verwenden.

Legen Sie agents.defaults.imageGenerationModel.timeoutMs für langsame Bild-Backends fest. Ein Tool-Parameter timeoutMs pro Aufruf überschreibt den konfigurierten Standard.

Verwenden Sie action: "list", um die derzeit registrierten Provider, ihre Standardmodelle und Hinweise zu Authentifizierungs-Umgebungsvariablen zu prüfen.

Die OpenAI-Bildgenerierung verwendet standardmäßig openai/gpt-image-2. Wenn ein openai-codex-OAuth-Profil konfiguriert ist, verwendet OpenClaw dasselbe OAuth-Profil wieder, das von Codex-Abonnement-Chatmodellen genutzt wird, und sendet die Bildanfrage über das Codex-Responses-Backend. Legacy-Codex-Basis-URLs wie https://chatgpt.com/backend-api werden für Bildanfragen zu https://chatgpt.com/backend-api/codex kanonisiert. OpenClaw fällt für diese Anfrage nicht stillschweigend auf OPENAI_API_KEY zurück - um das direkte Routing über die OpenAI Images API zu erzwingen, konfigurieren Sie models.providers.openai explizit mit einem API-Schlüssel, einer benutzerdefinierten Basis-URL oder einem Azure-Endpunkt.

Die Modelle openai/gpt-image-1.5, openai/gpt-image-1 und openai/gpt-image-1-mini können weiterhin explizit ausgewählt werden. Verwenden Sie gpt-image-1.5 für PNG-/WebP-Ausgaben mit transparentem Hintergrund; die aktuelle gpt-image-2-API lehnt background: "transparent" ab.

gpt-image-2 unterstützt sowohl Text-zu-Bild-Generierung als auch die Bearbeitung von Referenzbildern über dasselbe image_generate-Tool. OpenClaw leitet prompt, count, size, quality, outputFormat und Referenzbilder an OpenAI weiter. OpenAI erhält aspectRatio oder resolution nicht direkt; wenn möglich, ordnet OpenClaw diese einer unterstützten size zu, andernfalls meldet das Tool sie als ignorierte Überschreibungen.

OpenAI-spezifische Optionen befinden sich unter dem Objekt openai:

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

openai.background akzeptiert transparent, opaque oder auto; transparente Ausgaben erfordern outputFormat png oder webp und ein transparenzfähiges OpenAI-Bildmodell. OpenClaw routet standardmäßige gpt-image-2-Anfragen mit transparentem Hintergrund an gpt-image-1.5. openai.outputCompression gilt für JPEG-/WebP-Ausgaben.

Der oberste background-Hinweis ist Provider-neutral und wird derzeit demselben OpenAI-Anfragefeld background zugeordnet, wenn der OpenAI-Provider ausgewählt ist. Provider, die keine Hintergrundunterstützung deklarieren, geben ihn in ignoredOverrides zurück, statt den nicht unterstützten Parameter zu erhalten.

Informationen zum Routing der OpenAI-Bildgenerierung über eine Azure-OpenAI-Bereitstellung statt über api.openai.com finden Sie unter Azure-OpenAI-Endpunkte.

Die OpenRouter-Bildgenerierung verwendet denselben OPENROUTER_API_KEY und routet über die OpenRouter-Chat-Completions-Bild-API. Wählen Sie OpenRouter-Bildmodelle mit dem Präfix openrouter/ aus:

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

OpenClaw leitet prompt, count, Referenzbilder und Gemini-kompatible aspectRatio- / resolution-Hinweise an OpenRouter weiter. Aktuelle integrierte OpenRouter-Bildmodell-Kurzbefehle umfassen google/gemini-3.1-flash-image-preview, google/gemini-3-pro-image-preview und openai/gpt-5.4-image-2. Verwenden Sie action: "list", um zu sehen, was Ihr konfiguriertes Plugin bereitstellt.

MiniMax-Bildgenerierung ist über beide gebündelten MiniMax- Authentifizierungspfade verfügbar:

• minimax/image-01 für API-Schlüssel-Setups
• minimax-portal/image-01 für OAuth-Setups

Der gebündelte xAI-Provider verwendet /v1/images/generations für reine Prompt- Anfragen und /v1/images/edits, wenn image oder images vorhanden ist.

• Modelle: xai/grok-imagine-image, xai/grok-imagine-image-pro
• Anzahl: bis zu 4
• Referenzen: ein image oder bis zu fünf images
• Seitenverhältnisse: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Auflösungen: 1K, 2K
• Ausgaben: als von OpenClaw verwaltete Bildanhänge zurückgegeben

OpenClaw stellt xAI-native Optionen wie quality, mask, user oder zusätzliche nur nativ verfügbare Seitenverhältnisse absichtlich nicht bereit, bis diese Steuerelemente im gemeinsamen Provider-übergreifenden image_generate-Vertrag vorhanden sind.