OpenAI

• Modelos de agente - openai/* mediante el runtime de Codex. Inicia sesión con autenticación de Codex para usar la suscripción de ChatGPT/Codex, o configura un perfil de autenticación con clave de API cuando quieras facturación basada en clave.
• API de OpenAI que no son de agente - acceso directo a OpenAI Platform, facturado por uso, mediante OPENAI_API_KEY o un perfil de autenticación con clave de API openai.
• Configuración heredada - las referencias de modelos Codex e ids de perfil antiguos se reparan a openai/* con openclaw doctor --fix.

​

Seguimiento de uso y costos

• OAuth de ChatGPT/Codex muestra el plan de suscripción, las ventanas de cuota y el saldo de créditos.
• OPENAI_ADMIN_KEY muestra 30 días de costo de organización y uso de completions reportados por el proveedor en Uso de Control UI, incluidos gasto diario, totales de solicitudes/tokens, modelos principales y categorías de costo.
• OPENAI_PROJECT_ID limita opcionalmente el historial de la API de administración a un proyecto.
• OpenClaw nunca envía OPENAI_API_KEY ni un perfil de inferencia openai a las API de organización; esas credenciales pueden pertenecer a endpoints personalizados, de Azure o locales del agente.

​

Elección rápida

​

Mapa de nombres

​

Vista previa limitada de GPT-5.6

​

Cobertura de funciones de OpenClaw

​

Embeddings de memoria

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

​

Primeros pasos

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.5" } } },
}

{
  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.5

openclaw models list --provider openai

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

{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.5" },
    },
  },
  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 }],
      },
    },
  },
}

​

Autenticación nativa del servidor de aplicaciones Codex

1. Perfiles de autenticación de OpenAI ordenados para el agente, preferiblemente bajo auth.order.openai. Ejecuta openclaw doctor --fix para migrar identificadores antiguos heredados de perfiles de autenticación de Codex y el orden de autenticación.
2. La cuenta existente del servidor de aplicaciones, como un inicio de sesión local de ChatGPT en la CLI de Codex.
3. Solo para lanzamientos locales de servidor de aplicaciones stdio, y solo cuando el servidor de aplicaciones no informa ninguna cuenta: CODEX_API_KEY, luego OPENAI_API_KEY.

​

Generación de imágenes

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

openclaw infer image generate \
  --model openai/gpt-image-1.5 \
  --output-format png \
  --background transparent \
  --prompt "A simple red circle sticker on a transparent background" \
  --json

/tool image_generate model=openai/gpt-image-2 prompt="A polished launch poster for OpenClaw on macOS" size=3840x2160 count=1

/tool image_generate model=openai/gpt-image-1.5 prompt="A simple red circle sticker on a transparent background" outputFormat=png background=transparent

/tool image_generate model=openai/gpt-image-2 prompt="Preserve the object shape, change the material to translucent glass" image=/path/to/reference.png size=1024x1536

​

Generación de video

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

​

Contribución de prompt de GPT-5

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

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

​

Voz y habla

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

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

​

Endpoints de Azure OpenAI

• Ya tienes una suscripción, cuota o contrato empresarial de Azure OpenAI
• Necesitas residencia regional de datos o controles de cumplimiento que proporciona Azure
• Quieres mantener el tráfico dentro de una tenencia de Azure existente

​

Configuración

{
  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

• Envía el encabezado api-key en lugar de Authorization: Bearer
• Usa rutas con alcance de despliegue (/openai/deployments/{deployment}/...)
• Añade ?api-version=... a cada solicitud
• Usa un tiempo de espera de solicitud predeterminado de 600 s para llamadas de generación de imágenes de Azure. Los valores timeoutMs por llamada siguen anulando este valor predeterminado.

​

Versión de API

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

​

Los nombres de modelo son nombres de despliegue

/tool image_generate model=openai/gpt-image-2-prod prompt="A clean poster" size=1024x1024 count=1

​

Disponibilidad regional

​

Diferencias de parámetros

​

Configuración avanzada

{
  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" },
    },
  },
}

​

Relacionado