Geração de imagens

Uma substituição de model por chamada tenta somente esse provedor/modelo e não continua para o primário/fallback configurado nem para provedores detectados automaticamente.

Um padrão de provedor só entra na lista de candidatos quando o OpenClaw consegue realmente autenticar esse provedor. Defina agents.defaults.mediaGenerationAutoProviderFallback: false para usar somente entradas explícitas de model, primary e fallbacks.

Defina agents.defaults.imageGenerationModel.timeoutMs para backends de imagem lentos. Um parâmetro de ferramenta timeoutMs por chamada substitui o padrão configurado. Chamadas de ferramentas dinâmicas do Codex respeitam o mesmo orçamento de tempo limite, limitado pelo máximo de 600000 ms da ponte de ferramentas dinâmicas do OpenClaw.

Use action: "list" para inspecionar os provedores registrados atualmente, seus modelos padrão e dicas de variáveis de ambiente de autenticação.

A geração de imagens da OpenAI usa openai/gpt-image-2 por padrão. Se um perfil OAuth openai-codex estiver configurado, o OpenClaw reutiliza o mesmo perfil OAuth usado pelos modelos de chat por assinatura do Codex e envia a solicitação de imagem pelo backend Codex Responses. URLs base legadas do Codex, como https://chatgpt.com/backend-api, são canonicalizadas para https://chatgpt.com/backend-api/codex em solicitações de imagem. O OpenClaw não recorre silenciosamente a OPENAI_API_KEY para essa solicitação - para forçar o roteamento direto pela API OpenAI Images, configure models.providers.openai explicitamente com uma chave de API, URL base personalizada ou endpoint Azure.

Os modelos openai/gpt-image-1.5, openai/gpt-image-1 e openai/gpt-image-1-mini ainda podem ser selecionados explicitamente. Use gpt-image-1.5 para saída PNG/WebP com fundo transparente; a API atual gpt-image-2 rejeita background: "transparent".

gpt-image-2 oferece suporte tanto à geração texto-para-imagem quanto à edição com imagens de referência pela mesma ferramenta image_generate. O OpenClaw encaminha prompt, count, size, quality, outputFormat e imagens de referência para a OpenAI. A OpenAI não recebe aspectRatio nem resolution diretamente; quando possível, o OpenClaw mapeia esses campos para um size compatível; caso contrário, a ferramenta os relata como substituições ignoradas.

As opções específicas da OpenAI ficam no objeto openai:

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

openai.background aceita transparent, opaque ou auto; saídas transparentes exigem outputFormat png ou webp e um modelo de imagem da OpenAI com suporte a transparência. O OpenClaw roteia solicitações padrão de fundo transparente de gpt-image-2 para gpt-image-1.5. openai.outputCompression se aplica a saídas JPEG/WebP.

A dica de nível superior background é neutra em relação ao provedor e, no momento, mapeia para o mesmo campo de solicitação background da OpenAI quando o provedor OpenAI está selecionado. Provedores que não declaram suporte a fundo a retornam em ignoredOverrides em vez de receberem o parâmetro sem suporte.

Para rotear a geração de imagens da OpenAI por uma implantação Azure OpenAI em vez de api.openai.com, consulte endpoints Azure OpenAI.

A geração de imagens do OpenRouter usa a mesma OPENROUTER_API_KEY e é roteada pela API de imagens de chat completions do OpenRouter. Selecione modelos de imagem do OpenRouter com o prefixo openrouter/:

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

O OpenClaw encaminha prompt, count, imagens de referência e dicas de aspectRatio / resolution compatíveis com Gemini para o OpenRouter. Os atalhos atuais integrados de modelos de imagem do OpenRouter incluem google/gemini-3.1-flash-image-preview, google/gemini-3-pro-image-preview e openai/gpt-5.4-image-2. Use action: "list" para ver o que seu plugin configurado expõe.

A geração de imagens do MiniMax está disponível por ambos os caminhos de autenticação MiniMax integrados:

• minimax/image-01 para configurações com chave de API
• minimax-portal/image-01 para configurações com OAuth

O provedor xAI integrado usa /v1/images/generations para solicitações somente com prompt e /v1/images/edits quando image ou images está presente.

• Modelos: xai/grok-imagine-image, xai/grok-imagine-image-pro
• Contagem: até 4
• Referências: um image ou até cinco images
• Proporções: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Resoluções: 1K, 2K
• Saídas: retornadas como anexos de imagem gerenciados pelo OpenClaw

O OpenClaw intencionalmente não expõe quality, mask, user nativos da xAI nem proporções extras exclusivas do provedor até que esses controles existam no contrato compartilhado entre provedores image_generate.