Bildgenerierung

Eine model-Überschreibung pro Aufruf versucht nur diesen Provider/dieses Modell und fährt nicht mit konfiguriertem primärem Modell/Fallback oder automatisch erkannten Providern fort.

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

Setzen Sie agents.defaults.imageGenerationModel.timeoutMs für langsame Bild- Backends. Ein timeoutMs-Tool-Parameter pro Aufruf überschreibt den konfigurierten Standard. Dynamische Tool-Aufrufe von Codex berücksichtigen dasselbe Timeout-Budget, begrenzt durch das Maximum der dynamischen Tool-Bridge von OpenClaw von 600000 ms.

Verwenden Sie action: "list", um die derzeit registrierten Provider, ihre Standardmodelle und Hinweise zu Authentifizierungs-Env-Vars 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 direktes 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 Bearbeitung mit Referenzbildern über dasselbe image_generate-Tool. OpenClaw leitet prompt, count, size, quality, outputFormat und Referenzbilder an OpenAI weiter. OpenAI erhält nicht direkt aspectRatio oder resolution; 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 OpenAI-Bildmodell mit Transparenzunterstützung. OpenClaw leitet standardmäßige gpt-image-2-Anfragen mit transparentem Hintergrund an gpt-image-1.5 weiter. openai.outputCompression gilt für JPEG/WebP-Ausgaben.

Der Top-Level-Hinweis background ist Provider-neutral und wird derzeit dem gleichen 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.

Um die OpenAI-Bildgenerierung über eine Azure OpenAI-Bereitstellung statt über api.openai.com zu leiten, siehe Azure OpenAI-Endpunkte.

Die OpenRouter-Bildgenerierung verwendet denselben OPENROUTER_API_KEY und wird über die Chat-Completions-Bild-API von OpenRouter geroutet. 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. Zu den aktuellen integrierten Kurzbefehlen für OpenRouter-Bildmodelle gehören 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 Setups mit API-Schlüssel
• 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: werden als von OpenClaw verwaltete Bildanhänge zurückgegeben

OpenClaw stellt xAI-native quality, mask, user oder zusätzliche ausschließlich native Seitenverhältnisse absichtlich nicht bereit, bis diese Steuerelemente im gemeinsamen Provider-übergreifenden image_generate-Vertrag existieren.