OpenAI

OpenAI, GPT modelleri için geliştirici API'leri sağlar ve Codex ayrıca OpenAI'ın Codex istemcileri üzerinden ChatGPT planına dahil bir kodlama ajanı olarak da kullanılabilir. OpenClaw, her iki kimlik doğrulama biçimi için tek bir sağlayıcı kimliği, openai, kullanır.

OpenClaw, kanonik OpenAI model rotası olarak openai/* kullanır. OpenAI modellerindeki gömülü ajan turları varsayılan olarak yerel Codex app-server çalışma zamanı üzerinden çalışır; doğrudan OpenAI API anahtarı kimlik doğrulaması, görüntüler, embeddings, konuşma ve realtime gibi ajan dışı OpenAI yüzeyleri için kullanılabilir kalır.

• Ajan modelleri - Codex çalışma zamanı üzerinden openai/* modelleri; ChatGPT/Codex abonelik kullanımı için Codex kimlik doğrulamasıyla oturum açın veya özellikle API anahtarı kimlik doğrulaması istediğinizde Codex uyumlu bir OpenAI API anahtarı yedeği yapılandırın.
• Ajan dışı OpenAI API'leri - OPENAI_API_KEY veya OpenAI API anahtarı onboarding üzerinden kullanıma dayalı faturalandırmayla doğrudan OpenAI Platform erişimi.
• Eski yapılandırma - eski Codex model başvuruları openclaw doctor --fix tarafından openai/* artı Codex çalışma zamanına onarılır.

OpenAI, OpenClaw gibi dış araçlarda ve iş akışlarında abonelik OAuth kullanımını açıkça destekler.

Sağlayıcı, model, çalışma zamanı ve kanal ayrı katmanlardır. Bu etiketler birbirine karışıyorsa, yapılandırmayı değiştirmeden önce Ajan çalışma zamanları sayfasını okuyun.

Hızlı seçim

Adlandırma haritası

Adlar benzerdir ancak birbirinin yerine kullanılamaz:

Bu, bir yapılandırmanın bilerek openai/* model başvuruları içerebileceği, kimlik doğrulama profillerinin ise API anahtarı veya ChatGPT/Codex OAuth kimlik bilgilerine işaret edebileceği anlamına gelir. Yapılandırma için auth.order.openai kullanın; openclaw doctor --fix, eski eski Codex model başvurularını, eski Codex kimlik doğrulama profil kimliklerini ve eski Codex kimlik doğrulama sırasını kanonik OpenAI rotasına yeniden yazar.

GPT-5.6 sınırlı önizleme

OpenClaw üç genel GPT-5.6 model kimliğini tanır:

• openai/gpt-5.6-sol
• openai/gpt-5.6-terra
• openai/gpt-5.6-luna

Üçü de geçerli Codex app-server kataloğunda max reasoning sunar. OpenAI lansman duyurusu Sol'u flagship tier, Terra'yı balanced tier ve Luna'yı hızlı, daha düşük maliyetli tier olarak tanımlar. GPT-5.6 lansman duyurusu ve önizleme erişim kılavuzu sayfalarına bakın.

Erişim önizleme sırasında allowlist ile verilir ve API ile Codex için ayrı ayrı verilebilir. Yalnızca ücretli bir ChatGPT planı erişim sağlamaz. OpenClaw, openai/gpt-5.5 değerini varsayılan olarak tutar; erişim olmadan bir GPT-5.6 başvurusu seçmek, sessizce fallback yapmak yerine upstream erişim hatasını döndürür.

OpenClaw özellik kapsamı

Bellek embeddings

OpenClaw, memory_search indeksleme ve sorgu embeddings için OpenAI'ı veya OpenAI uyumlu bir embedding endpoint'ini kullanabilir:

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

Asimetrik embedding etiketleri gerektiren OpenAI uyumlu endpoint'ler için memorySearch altında queryInputType ve documentInputType ayarlayın. OpenClaw bunları sağlayıcıya özgü input_type istek alanları olarak iletir: sorgu embeddings queryInputType kullanır; indekslenen bellek parçaları ve toplu indeksleme documentInputType kullanır. Tam örnek için Bellek yapılandırma başvurusu sayfasına bakın.

Başlarken

Tercih ettiğiniz kimlik doğrulama yöntemini seçin ve kurulum adımlarını izleyin.

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 statusopenclaw models auth list --provider openaiopenclaw config get agents.defaults.model --jsonopenclaw config get models.providers.openai.agentRuntime --json

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

openclaw doctor --fixopenclaw config validate

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

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

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

Doğal Codex app-server kimlik doğrulaması

Doğal Codex app-server donanımı, openai/* model ref'lerini ve atlanmış çalışma zamanı yapılandırmasını veya provider/model agentRuntime.id: "codex" kullanır, ancak kimlik doğrulaması hâlâ hesap tabanlıdır. OpenClaw kimlik doğrulamayı şu sırayla seçer:

1. Ajan için sıralı OpenAI kimlik doğrulama profilleri, tercihen auth.order.openai altında. Eski legacy Codex kimlik doğrulama profil id'lerini ve legacy Codex kimlik doğrulama sırasını taşımak için openclaw doctor --fix çalıştırın.
2. App-server'ın mevcut hesabı, örneğin yerel Codex CLI ChatGPT oturumu.
3. Yalnızca yerel stdio app-server başlatmaları için, app-server hesap bildirmediğinde ve hâlâ OpenAI kimlik doğrulaması gerektirdiğinde CODEX_API_KEY, ardından OPENAI_API_KEY.

Bu, gateway işleminin doğrudan OpenAI modelleri veya embeddings için OPENAI_API_KEY içermesi nedeniyle yerel ChatGPT/Codex abonelik oturumunun değiştirilmediği anlamına gelir. Env API anahtarı yedeği yalnızca yerel stdio hesapsız yoludur; WebSocket app-server bağlantılarına gönderilmez. Abonelik tarzı bir Codex profili seçildiğinde OpenClaw ayrıca CODEX_API_KEY ve OPENAI_API_KEY değerlerini başlatılan stdio app-server alt işleminden uzak tutar ve seçili kimlik bilgilerini app-server login RPC üzerinden gönderir. Bu abonelik profili Codex kullanım sınırı tarafından engellendiğinde OpenClaw, seçili modeli değiştirmeden veya Codex donanımından çıkmadan sıradaki openai:* API anahtarı profiline dönebilir. Abonelik sıfırlama zamanı geçtikten sonra abonelik profili yeniden uygun olur.

Görüntü üretimi

Paketli openai plugin'i, image_generate aracı üzerinden görüntü üretimini kaydeder. Aynı openai/gpt-image-2 model ref'i üzerinden hem OpenAI API anahtarı görüntü üretimini hem de Codex OAuth görüntü üretimini destekler.

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

gpt-image-2, hem OpenAI metinden görsel oluşturmada hem de görsel düzenlemede varsayılandır. gpt-image-1.5, gpt-image-1 ve gpt-image-1-mini açık model geçersiz kılmaları olarak kullanılabilir kalır. Saydam arka planlı PNG/WebP çıktısı için openai/gpt-image-1.5 kullanın; mevcut gpt-image-2 API'si background: "transparent" değerini reddeder.

Saydam arka plan isteği için aracıların image_generate aracını model: "openai/gpt-image-1.5", outputFormat: "png" veya "webp" ve background: "transparent" ile çağırması gerekir; eski openai.background sağlayıcı seçeneği hâlâ kabul edilir. OpenClaw ayrıca varsayılan openai/gpt-image-2 saydam isteklerini gpt-image-1.5 olarak yeniden yazarak genel OpenAI ve OpenAI Codex OAuth rotalarını korur; Azure ve özel OpenAI uyumlu uç noktalar yapılandırılmış dağıtım/model adlarını korur.

Aynı ayar headless CLI çalıştırmaları için de sunulur:

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

Bir girdi dosyasından başlarken aynı --output-format ve --background bayraklarını openclaw infer image edit ile kullanın. --openai-background, OpenAI'ye özgü bir alias olarak kullanılabilir kalır. OpenAI Images kalitesini ve maliyetini denetlemeniz gerektiğinde --quality low|medium|high|auto kullanın. OpenAI'nin sağlayıcıya özgü moderasyon ipucunu image generate veya image edit üzerinden geçirmek için --openai-moderation low|auto kullanın.

ChatGPT/Codex OAuth kurulumları için aynı openai/gpt-image-2 ref değerini koruyun. Bir openai OAuth profili yapılandırıldığında OpenClaw, saklanan OAuth erişim belirtecini çözer ve görsel isteklerini Codex Responses arka ucu üzerinden gönderir. Bu istek için önce OPENAI_API_KEY denemez veya sessizce bir API anahtarına geri dönülmez. Bunun yerine doğrudan OpenAI Images API rotasını istediğinizde models.providers.openai değerini bir API anahtarı, özel temel URL veya Azure uç noktasıyla açıkça yapılandırın. Bu özel görsel uç noktası güvenilir bir LAN/özel adresteyse browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true değerini de ayarlayın; OpenClaw, bu opt-in mevcut olmadığı sürece özel/dahili OpenAI uyumlu görsel uç noktalarını engelli tutar.

Oluştur:

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

Saydam bir PNG oluştur:

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

Düzenle:

/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

Video oluşturma

Paketlenmiş openai Plugin'i, video_generate aracı üzerinden video oluşturmayı kaydeder.

OpenAI görselden videoya istekleri, görsel input_reference ile POST /v1/videos kullanır. Tek video düzenlemeleri, yüklenen video video alanında olacak şekilde POST /v1/videos/edits kullanır.

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

GPT-5 istem katkısı

OpenClaw, OpenClaw tarafından birleştirilmiş istem yüzeylerindeki GPT-5 ailesi çalıştırmaları için paylaşılan bir GPT-5 istem katkısı ekler. Model kimliğine göre uygulanır; bu nedenle eski onarım öncesi ref değerleri (eski Codex GPT-5.5 ref), openrouter/openai/gpt-5.5, opencode/gpt-5.5 ve diğer uyumlu GPT-5 ref değerleri gibi OpenClaw/sağlayıcı rotaları aynı overlay'i alır. Daha eski GPT-4.x modelleri almaz.

Paketlenmiş yerel Codex harness, bu OpenClaw GPT-5 overlay'ini Codex app-server geliştirici yönergeleri üzerinden almaz. Yerel Codex, Codex'e ait temel, model ve proje belgesi davranışını korurken OpenClaw, aracı çalışma alanı kişilik dosyalarının yetkili kalması için yerel thread'lerde Codex'in yerleşik kişiliğini devre dışı bırakır. OpenClaw yalnızca kanal teslimi, OpenClaw dinamik araçları, ACP delegasyonu, çalışma alanı bağlamı ve OpenClaw Skills gibi çalışma zamanı bağlamını katkı olarak ekler.

GPT-5 katkısı, eşleşen OpenClaw tarafından birleştirilmiş istemlerde persona kalıcılığı, yürütme güvenliği, araç disiplini, çıktı şekli, tamamlama kontrolleri ve doğrulama için etiketli bir davranış sözleşmesi ekler. Kanala özgü yanıt ve sessiz mesaj davranışı, paylaşılan OpenClaw sistem isteminde ve giden teslim politikası içinde kalır. Dostça etkileşim stili katmanı ayrıdır ve yapılandırılabilir.

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

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

Ses ve konuşma

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

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

Azure OpenAI uç noktaları

Paketle gelen openai sağlayıcısı, temel URL'yi geçersiz kılarak görüntü üretimi için bir Azure OpenAI kaynağını hedefleyebilir. Görüntü üretimi yolunda OpenClaw, models.providers.openai.baseUrl üzerindeki Azure ana makine adlarını algılar ve otomatik olarak Azure'un istek şekline geçer.

Azure OpenAI'yi şu durumlarda kullanın:

• Zaten bir Azure OpenAI aboneliğiniz, kotanız veya kurumsal anlaşmanız varsa
• Azure'un sağladığı bölgesel veri yerleşimi veya uyumluluk denetimlerine ihtiyacınız varsa
• Trafiği mevcut bir Azure kiracısı içinde tutmak istiyorsanız

Yapılandırma

Paketle gelen openai sağlayıcısı üzerinden Azure görüntü üretimi için models.providers.openai.baseUrl değerini Azure kaynağınıza yönlendirin ve apiKey değerini Azure OpenAI anahtarına ayarlayın (OpenAI Platform anahtarı değil):

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

OpenClaw, Azure görüntü üretimi rotası için şu Azure ana makine son eklerini tanır:

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

Tanınan bir Azure ana makinesindeki görüntü üretimi isteklerinde OpenClaw:

• Authorization: Bearer yerine api-key üst bilgisini gönderir
• Dağıtım kapsamlı yolları kullanır (/openai/deployments/{deployment}/...)
• Her isteğe ?api-version=... ekler
• Azure görüntü üretimi çağrıları için 600 sn varsayılan istek zaman aşımı kullanır. Çağrı başına timeoutMs değerleri yine de bu varsayılanı geçersiz kılar.

Diğer temel URL'ler (genel OpenAI, OpenAI uyumlu proxy'ler) standart OpenAI görüntü isteği şeklini korur.

API sürümü

Azure görüntü üretimi yolu için belirli bir Azure preview veya GA sürümünü sabitlemek üzere AZURE_OPENAI_API_VERSION değerini ayarlayın:

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

Değişken ayarlanmamışsa varsayılan 2024-12-01-preview olur.

Model adları dağıtım adlarıdır

Azure OpenAI modelleri dağıtımlara bağlar. Paketle gelen openai sağlayıcısı üzerinden yönlendirilen Azure görüntü üretimi isteklerinde OpenClaw'daki model alanı, genel OpenAI model kimliği değil, Azure portalında yapılandırdığınız Azure dağıtım adı olmalıdır.

gpt-image-2 sunan gpt-image-2-prod adlı bir dağıtım oluşturursanız:

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

Aynı dağıtım adı kuralı, paketle gelen openai sağlayıcısı üzerinden yönlendirilen görüntü üretimi çağrıları için de geçerlidir.

Bölgesel kullanılabilirlik

Azure görüntü üretimi şu anda yalnızca bir bölge alt kümesinde kullanılabilir (örneğin eastus2, swedencentral, polandcentral, westus3, uaenorth). Bir dağıtım oluşturmadan önce Microsoft'un güncel bölge listesini kontrol edin ve belirli modelin bölgenizde sunulduğunu doğrulayın.

Parametre farkları

Azure OpenAI ve genel OpenAI her zaman aynı görüntü parametrelerini kabul etmez. Azure, genel OpenAI'nin izin verdiği seçenekleri reddedebilir (örneğin gpt-image-2 üzerindeki bazı background değerleri) veya bunları yalnızca belirli model sürümlerinde sunabilir. Bu farklar OpenClaw'dan değil, Azure'dan ve alttaki modelden kaynaklanır. Bir Azure isteği doğrulama hatasıyla başarısız olursa, Azure portalında belirli dağıtımınız ve API sürümünüz tarafından desteklenen parametre kümesini kontrol edin.

Gelişmiş yapılandırma

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

İlgili