OpenAI

• Modelos de agente - openai/* por meio do runtime selecionado pela configuração explícita agentRuntime ou pela política de rota implícita da OpenAI. Entre com a autenticação do Codex para usar uma assinatura do ChatGPT/Codex ou configure um perfil de autenticação por chave de API quando quiser cobrança baseada em chave.
• APIs da OpenAI não relacionadas a agentes - acesso direto à OpenAI Platform, com cobrança por uso, por meio de OPENAI_API_KEY ou de um perfil de autenticação por chave de API openai.
• Configuração legada - as referências codex/* e openai-codex/* são corrigidas para openai/*, com agentRuntime.id: "codex" com escopo de modelo, por openclaw doctor --fix.

​

Acompanhamento de uso e custos

• O OAuth do ChatGPT/Codex mostra o plano de assinatura, as janelas de cota e o saldo de créditos.
• OPENAI_ADMIN_KEY mostra 30 dias de custos da organização e uso de conclusões informados pelo provedor na seção Uso da Control UI, incluindo gastos diários, totais de solicitações/tokens, principais modelos e categorias de custos.
• OPENAI_PROJECT_ID restringe opcionalmente o histórico da Admin API a um único projeto.
• O OpenClaw nunca envia OPENAI_API_KEY nem um perfil de inferência openai às APIs da organização; essas credenciais podem pertencer a endpoints personalizados, do Azure ou locais do agente.

​

Escolha rápida

​

Mapa de nomes

​

Runtime implícito do agente

​

Prévia limitada do GPT-5.6

openclaw models list --provider openai

openclaw models set openai/gpt-5.5

​

Cobertura de recursos do OpenClaw

​

Embeddings de memória

{
  agents: {
    defaults: {
      memorySearch: {
        provider: "openai",
        model: "text-embedding-3-small",
      },
    },
  },
}

​

Introdução

openclaw onboard --auth-choice openai-api-key

openclaw onboard --openai-api-key "$OPENAI_API_KEY"

openclaw models list --provider openai

{
  env: { OPENAI_API_KEY: "example-openai-key-not-real" },
  agents: { defaults: { model: { primary: "openai/gpt-5.6" } } },
}

{
  env: { OPENAI_API_KEY: "example-openai-key-not-real" },
  agents: { defaults: { model: { primary: "openai/chat-latest" } } },
}

openclaw onboard --auth-choice openai

openclaw models auth login --provider openai

openclaw models auth login --provider openai --device-code

openclaw config set agents.defaults.model.primary openai/gpt-5.6-sol

openclaw models list --provider openai

{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.6-sol" },
    },
  },
}

{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.6-sol" },
    },
  },
  auth: {
    order: {
      openai: [
        "openai:user@example.com",
        "openai:api-key-backup",
      ],
    },
  },
}

openclaw models status
openclaw models auth list --provider openai
openclaw config get agents.defaults.model --json
openclaw config get models.providers.openai.agentRuntime --json

openclaw models status --agent <id>
openclaw models auth list --agent <id> --provider openai

openclaw doctor --fix
openclaw config validate

openclaw models auth login --provider openai
openclaw models status --probe --probe-provider openai

openclaw models auth login --provider openai --profile-id openai:ritsuko
openclaw models auth login --provider openai --profile-id openai:lain

{
  models: {
    providers: {
      openai: {
        models: [{ id: "gpt-5.5", contextTokens: 160000 }],
      },
    },
  },
}

​

Autenticação nativa do app-server do Codex

1. Perfis de autenticação OpenAI ordenados para o agente, de preferência em auth.order.openai. Execute openclaw doctor --fix para migrar IDs de perfil de autenticação legados do Codex e a ordem de autenticação.
2. A conta existente do app-server, como um login local do ChatGPT na CLI do Codex. Para o diretório inicial isolado padrão do agente, o OpenClaw conecta essa conta nativa da CLI ao app-server por meio do RPC de login; ele não compartilha a configuração, os plugins nem o armazenamento de threads da CLI.
3. Somente para inicializações locais do app-server por stdio e apenas quando o app-server não informar nenhuma conta: CODEX_API_KEY e depois OPENAI_API_KEY.

​

Geração de imagens

{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "openai/gpt-image-2" },
    },
  },
}

openclaw infer image generate \
  --model openai/gpt-image-1.5 \
  --output-format png \
  --background transparent \
  --prompt "Um adesivo simples de círculo vermelho sobre um fundo transparente" \
  --json

/tool image_generate model=openai/gpt-image-2 prompt="Um pôster de lançamento refinado do OpenClaw no macOS" size=3840x2160 count=1

/tool image_generate model=openai/gpt-image-1.5 prompt="Um adesivo simples de círculo vermelho sobre um fundo transparente" outputFormat=png background=transparent

/tool image_generate model=openai/gpt-image-2 prompt="Preserve o formato do objeto e altere o material para vidro translúcido" image=/path/to/reference.png size=1024x1536

​

Geração de vídeos

{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "openai/sora-2" },
    },
  },
}

​

Contribuição de prompt do GPT-5

{
  agents: {
    defaults: {
      promptOverlays: {
        gpt5: { personality: "friendly" },
      },
    },
  },
}

openclaw config set agents.defaults.promptOverlays.gpt5.personality off

​

Voz e fala

{
  messages: {
    tts: {
      providers: {
        openai: { model: "gpt-4o-mini-tts", speakerVoice: "coral" },
      },
    },
  },
}

{
  tools: {
    media: {
      audio: {
        models: [
          {
            type: "provider",
            provider: "openai",
            model: "gpt-4o-transcribe",
          },
        ],
      },
    },
  },
}

​

Endpoints do Azure OpenAI

• Você já tiver uma assinatura, cota ou contrato empresarial do Azure OpenAI
• Você precisar dos controles de residência regional de dados ou conformidade fornecidos pelo Azure
• Você quiser manter o tráfego dentro de uma locação existente do Azure

​

Configuração

{
  models: {
    providers: {
      openai: {
        baseUrl: "https://<your-resource>.openai.azure.com",
        apiKey: "<azure-openai-api-key>",
      },
    },
  },
}

• *.openai.azure.com
• *.services.ai.azure.com
• *.cognitiveservices.azure.com

• Envia o cabeçalho api-key em vez de Authorization: Bearer
• Usa caminhos específicos da implantação (/openai/deployments/{deployment}/...)
• Acrescenta ?api-version=... a cada solicitação
• Usa um tempo limite padrão de solicitação de 600s para chamadas de geração de imagens do Azure. Os valores de timeoutMs por chamada ainda substituem esse padrão.

​

Versão da API

export AZURE_OPENAI_API_VERSION="2024-12-01-preview"

​

Os nomes dos modelos são nomes de implantação

/tool image_generate model=openai/gpt-image-2-prod prompt="Um pôster limpo" size=1024x1024 count=1

​

Disponibilidade regional

​

Diferenças de parâmetros

​

Configuração avançada

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": {
          params: { transport: "auto" },
        },
      },
    },
  },
}

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": { params: { fastMode: "auto", fastAutoOnSeconds: 30 } },
      },
    },
  },
}

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": { params: { serviceTier: "priority" } },
      },
    },
  },
}

{
  agents: {
    defaults: {
      models: {
        "azure-openai-responses/gpt-5.5": {
          params: { responsesServerCompaction: true },
        },
      },
    },
  },
}

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": {
          params: {
            responsesServerCompaction: true,
            responsesCompactThreshold: 120000,
          },
        },
      },
    },
  },
}

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": {
          params: { responsesServerCompaction: false },
        },
      },
    },
  },
}

{
  agents: {
    defaults: {
      embeddedAgent: { executionContract: "default" },
    },
  },
}

​

Relacionados