OpenAI

OpenClaw, hem doğrudan API anahtarı kimlik doğrulaması hem de ChatGPT/Codex abonelik kimlik doğrulaması için openai adlı tek bir sağlayıcı kimliği kullanır. openai/*, standart model rotasıdır. Çalışma zamanı ilkesi ayarlanmamış veya auto olan gömülü ajan turlarında OpenAI'ın rota bilgileri, OpenClaw'ın paketle birlikte gelen Codex uygulama sunucusu çalışma zamanını örtük olarak seçip seçemeyeceğini belirler. Tek başına openai/* ön eki bir çalışma zamanı seçmez.

• Ajan modelleri - açık agentRuntime yapılandırması veya OpenAI'ın örtük rota ilkesiyle seçilen çalışma zamanı üzerinden openai/*. ChatGPT/Codex aboneliği kullanımı için Codex kimlik doğrulamasıyla oturum açın veya anahtar tabanlı faturalandırma istediğinizde bir API anahtarı kimlik doğrulama profili yapılandırın.
• Ajan dışı OpenAI API'leri - OPENAI_API_KEY veya bir openai API anahtarı kimlik doğrulama profili üzerinden, kullanım başına faturalandırılan doğrudan OpenAI Platform erişimi.
• Eski yapılandırma - codex/* ve openai-codex/* başvuruları, openclaw doctor --fix tarafından openai/* ile model kapsamlı agentRuntime.id: "codex" biçimine onarılır.

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

Kullanım ve maliyet takibi

OpenClaw, abonelik kotası ile Platform API faturalandırmasını ayrı tutar:

• ChatGPT/Codex OAuth; abonelik planını, kota aralıklarını ve kredi bakiyesini gösterir.
• OPENAI_ADMIN_KEY, Control UI Kullanım bölümünde günlük harcama, istek/token toplamları, en çok kullanılan modeller ve maliyet kategorileri dâhil olmak üzere sağlayıcının bildirdiği 30 günlük kuruluş maliyetini ve tamamlama kullanımını gösterir.
• OPENAI_PROJECT_ID, isteğe bağlı olarak Admin API geçmişini tek bir projeyle sınırlar.
• OpenClaw, OPENAI_API_KEY veya bir openai çıkarım profilini kuruluş API'lerine asla göndermez; bu kimlik bilgileri özel, Azure veya ajan yerel uç noktalarına ait olabilir.

Açıkça belirtilen bir Admin anahtarı OAuth'a göre önceliklidir. Sağlayıcının bildirdiği geçmiş, OpenClaw'ın oturumdan türetilen tahmini maliyetiyle birleştirilmez; diğer istemcilerden gelen API etkinliklerini ve sağlayıcı tarafındaki faturalandırma düzeltmelerini içerebilir.

OpenAI'ın API Kullanım Panosu belgeleri, kullanım verileri için kuruluş sahibi olma ve açık Kullanım Panosu izni gereksinimlerini açıklar.

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 eşlemesi

Örtük ajan çalışma zamanı

Sağlayıcı/model agentRuntime ilkesi ayarlanmamış veya auto olduğunda OpenAI'ın sağlayıcıya ait rota ilkesi, etkin uç nokta ve bağdaştırıcıya göre örtük çalışma zamanını seçer:

Açıkça belirtilen varsayılan dışı sağlayıcı/model agentRuntime.id ayarı belirleyici olmaya devam eder. Örneğin agentRuntime.id: "openclaw", normalde Codex'e uygun olan bir rotayı OpenClaw'da tutarken agentRuntime.id: "codex", Codex'i zorunlu kılar ve etkin rota Codex uyumlu olarak bildirilmemişse güvenli biçimde başarısız olur. Çalışma zamanı seçimi, kimlik bilgisi türünü veya faturalandırmayı değiştirmez: Platform API anahtarı kimlik doğrulaması ile ChatGPT/Codex abonelik kimlik doğrulaması ayrı kalır.

openclaw doctor --fix; eski codex/* ve openai-codex/* model başvurularını, eski Codex kimlik doğrulama profili kimliklerini ve eski Codex kimlik doğrulama sırası girdilerini standart openai rotasına taşır. Taşınan model başvuruları model kapsamlı agentRuntime.id: "codex" alır; yeni kimlik doğrulama sırası yapılandırması için auth.order.openai kullanın.

GPT-5.6 sınırlı önizlemesi

OpenClaw, tam openai/gpt-5.6-sol, openai/gpt-5.6-terra ve openai/gpt-5.6-luna model kimliklerini tanır. Mevcut katalogda üçü de xhigh ve max akıl yürütme sunar. OpenAI; Sol'u amiral gemisi katmanı, Terra'yı dengeli katman, Luna'yı ise hızlı ve daha düşük maliyetli katman olarak tanımlar. Bkz. GPT-5.6 lansman duyurusu ve erişim kılavuzu.

Doğrudan OpenAI API anahtarı kimlik doğrulamasıyla yalın openai/gpt-5.6 kimliği, Sol'un diğer adıdır ve yeni kurulumun varsayılanıdır. Yerel Codex kataloğu bu doğrudan API diğer adını istemci tarafında uygulamaz; çalışma alanı erişimine bağlı olarak tam Sol, Terra ve Luna kimliklerini gösterebilir. Bu nedenle yeni ChatGPT/Codex OAuth kurulumu openai/gpt-5.6-sol kullanır. Mevcut hesabı şununla kontrol edin:

openclaw models list --provider openai

API kuruluşu ile Codex çalışma alanı erişimi farklı olabilir. GPT-5.6 kullanılamıyorsa GPT-5.5'i açıkça seçin:

openclaw models set openai/gpt-5.5

OpenClaw, üst sistemden gelen erişim hatasını gösterir ve bir GPT-5.6 seçimini sessizce GPT-5.5 ile değiştirmez.

OpenClaw özellik kapsamı

Bellek gömme vektörleri

OpenClaw, memory_search indeksleme ve sorgu gömme vektörleri için OpenAI'ı veya OpenAI uyumlu bir gömme vektörü uç noktasını kullanabilir:

{  memory: {    search: {      provider: "openai",      model: "text-embedding-3-small",    },  },}

Asimetrik gömme vektörü etiketleri gerektiren OpenAI uyumlu uç noktalar için memory.search altında queryInputType ve documentInputType değerlerini ayarlayın. OpenClaw bunları sağlayıcıya özgü input_type istek alanları olarak iletir: sorgu gömme vektörleri queryInputType kullanır; indekslenen bellek parçaları ve toplu indeksleme documentInputType kullanır. Tam örnek için Bellek yapılandırması referansına bakın.

Başlarken

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 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.6-terra",            name: "GPT-5.6 Terra",            contextWindow: 1050000,            contextTokens: 922000,            maxTokens: 128000,          },        ],      },    },  },  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-terra" },      models: {        "openai/gpt-5.6-terra": {          agentRuntime: { id: "openclaw" },          params: {            responsesServerCompaction: true,            responsesCompactThreshold: 700000,          },        },      },    },  },}

Yerel Codex app-server kimlik doğrulaması

Yerel Codex app-server altyapısı, uygun bir tam resmî HTTPS rotası tarafından örtük olarak seçildiğinde veya sağlayıcı/model agentRuntime.id: "codex" tarafından açıkça seçildiğinde openai/* model referanslarını kullanır. Kimlik doğrulaması yine hesap tabanlıdır. OpenClaw kimlik doğrulamayı şu sırayla seçer:

1. Ajan için tercihen auth.order.openai altında sıralanmış OpenAI kimlik doğrulama profilleri. Eski Codex kimlik doğrulama profili kimliklerini ve kimlik doğrulama sırasını taşımak için openclaw doctor --fix çalıştırın.
2. Yerel Codex CLI ChatGPT oturum açması gibi app-server'ın mevcut hesabı. Varsayılan yalıtılmış ajan ana dizini için OpenClaw, bu yerel CLI hesabını oturum açma RPC'si üzerinden app-server'a bağlar; CLI'ın yapılandırmasını, pluginlerini veya iş parçacığı deposunu paylaşmaz.
3. Yalnızca yerel stdio app-server başlatmaları için ve yalnızca app-server hesap olmadığını bildirdiğinde: CODEX_API_KEY, ardından OPENAI_API_KEY.

Yerel ChatGPT/Codex abonelik oturum açması, Gateway işlemi doğrudan OpenAI modelleri veya gömmeleri için OPENAI_API_KEY değerine de sahip diye değiştirilmez. Ortam API anahtarı geri dönüşü yalnızca yerel stdio hesapsız yoluna uygulanır; WebSocket app-server bağlantıları üzerinden asla 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çilen kimlik bilgilerini bunun yerine app-server oturum açma RPC'si üzerinden gönderir.

Bu abonelik profili bir Codex kullanım sınırı nedeniyle engellendiğinde OpenClaw, profili Codex'in bildirdiği sıfırlama zamanına kadar engellenmiş olarak işaretler ve seçilen modeli değiştirmeden ya da Codex altyapısından çıkmadan kimlik doğrulama sıralamasının bir sonraki openai:* profiline geçmesine izin verir. Sıfırlama zamanı geçtikten sonra abonelik profili yeniden uygun hâle gelir.

Görsel oluşturma

Paketle gelen openai plugini, image_generate aracı üzerinden görsel oluşturmayı kaydeder. Aynı openai/gpt-image-2 model referansı üzerinden hem OpenAI API anahtarıyla hem de Codex OAuth ile görsel oluşturmayı destekler.

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

gpt-image-2, OpenAI metinden görsele oluşturma ve görsel düzenleme için 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 durumda kalır. Şeffaf arka planlı PNG/WebP çıktısı için openai/gpt-image-1.5 kullanın; geçerli gpt-image-2 API, background: "transparent" değerini reddeder.

Şeffaf arka plan isteği için image_generate öğesini model: "openai/gpt-image-1.5", outputFormat: "png" veya "webp" ve background: "transparent" ile çağırın; eski openai.background sağlayıcı seçeneği hâlâ kabul edilir. OpenClaw ayrıca varsayılan openai/gpt-image-2 şeffaf isteklerini gpt-image-1.5 olarak yeniden yazarak herkese açık 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, başsız CLI çalıştırmaları için de sunulur:

openclaw infer image generate \  --model openai/gpt-image-1.5 \  --output-format png \  --background transparent \  --prompt "Şeffaf bir arka plan üzerinde basit bir kırmızı daire çıkartması" \  --json

Bir girdi dosyasından başlarken openclaw infer image edit ile aynı --output-format ve --background bayraklarını kullanın. --openai-background, OpenAI'ya özgü bir diğer ad olarak kullanılabilir durumda kalır. OpenAI Images kalitesini ve maliyetini denetlemek için --quality low|medium|high|auto kullanın. OpenAI'ın moderasyon ipucunu image generate veya image edit üzerinden iletmek için --openai-moderation low|auto kullanın.

ChatGPT/Codex OAuth kurulumları için aynı openai/gpt-image-2 referansını koruyun. Bir openai OAuth profili yapılandırıldığında OpenClaw, depolanan OAuth erişim belirtecini çözümler ve görüntü isteklerini Codex Responses arka ucu üzerinden gönderir; önce OPENAI_API_KEY yöntemini denemez veya sessizce bir API anahtarına geri dönmez. Bunun yerine doğrudan OpenAI Images API yolunu kullanmak 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örüntü uç noktası güvenilen bir LAN/özel adresteyse browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true değerini de ayarlayın; OpenClaw, bu açık katılım olmadığı sürece özel/dahili OpenAI uyumlu görüntü uç noktalarını engellemeyi sürdürür.

Oluşturma:

/tool image_generate model=openai/gpt-image-2 prompt="macOS'te OpenClaw için özenle hazırlanmış bir lansman posteri" size=3840x2160 count=1

Şeffaf bir PNG oluşturma:

/tool image_generate model=openai/gpt-image-1.5 prompt="Şeffaf bir arka plan üzerinde basit bir kırmızı daire çıkartması" outputFormat=png background=transparent

Düzenleme:

/tool image_generate model=openai/gpt-image-2 prompt="Nesnenin şeklini koru, malzemeyi yarı saydam cama dönüştür" image=/path/to/reference.png size=1024x1536

Video oluşturma

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

OpenAI görüntüden videoya istekleri, bir görüntü 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, openai sağlayıcısındaki GPT-5 ailesi modelleri için paylaşılan bir GPT-5 istem katkısı ekler (normalleştirilerek openai/* olan onarım öncesi eski Codex referansları dâhil). OpenRouter veya opencode yolları gibi GPT-5 ailesi model kimliklerini de sunan diğer sağlayıcılar bu katmanı almaz; bu katman yalnızca model kimliğine göre değil, openai sağlayıcı kimliğine göre sınırlandırılır. Eski GPT-4.x modelleri bunu hiçbir zaman almaz.

Yerel Codex uygulama sunucusu donanımı, kişilik/araç disiplini davranış sözleşmesini veya samimi etkileşim tarzı katmanını geliştirici talimatları üzerinden almaz; yerel Codex, Codex'e ait temel, model ve proje belgesi davranışını korur ve OpenClaw, ajan çalışma alanı kişilik dosyalarının yetkili kalması için yerel iş parçacıklarında Codex'in yerleşik kişiliğini devre dışı bırakır. OpenClaw, yerel Codex iş parçacıklarına yalnızca çalışma zamanı bağlamı sağlar: kanal teslimatı, OpenClaw dinamik araçları, ACP devri, çalışma alanı bağlamı ve OpenClaw Skills. Aynı katkıdaki Heartbeat rehberlik metni tek istisnadır: yerel Codex Heartbeat dönüşleri bunu alır; metin, paylaşılan istem katkısı kancası üzerinden değil, özel iş birliği talimatları olarak eklenir.

GPT-5 katkısı, eşleşen OpenClaw tarafından birleştirilmiş istemlere kişilik kalıcılığı, yürütme güvenliği, araç disiplini, çıktı biçimi, tamamlanma 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 teslimat politikasında kalır. Samimi etkileşim tarzı 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

{  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ü oluşturma için bir Azure OpenAI kaynağını hedefleyebilir. Görüntü oluşturma yolunda OpenClaw, models.providers.openai.baseUrl üzerindeki Azure ana bilgisayar adlarını algılar ve otomatik olarak Azure'un istek biçimine geçer.

Şu durumlarda Azure OpenAI kullanın:

• Zaten bir Azure OpenAI aboneliğiniz, kotanız veya kurumsal sözleşmeniz 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ü oluşturmak için models.providers.openai.baseUrl değerini Azure kaynağınıza yönlendirin ve apiKey değerini Azure OpenAI anahtarı (OpenAI Platform anahtarı değil) olarak ayarlayın:

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

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

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

Tanınan bir Azure ana bilgisayarındaki görüntü oluşturma istekleri için OpenClaw:

• Authorization: Bearer yerine api-key üst bilgisini gönderir
• Dağıtım kapsamlı yolları (/openai/deployments/{deployment}/...) kullanır
• Her isteğe ?api-version=... ekler
• Azure görüntü oluşturma çağrıları için varsayılan 600s istek zaman aşımını 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 biçimini korur.

API sürümü

Azure görüntü oluşturma yolu için belirli bir Azure önizleme veya genel kullanıma sunulmuş sürümü sabitlemek üzere AZURE_OPENAI_API_VERSION ayarlayın:

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

Değişken ayarlanmadığında varsayılan değer 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ü oluşturma 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="Temiz bir poster" size=1024x1024 count=1

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

Bölgesel kullanılabilirlik

Azure görüntü oluşturma şu anda yalnızca belirli bölgelerin bir 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 ilgili modelin bölgenizde sunulduğunu doğrulayın.

Parametre farklılıkları

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

Gelişmiş yapılandırma

Aşağıdaki model başına params örnekleri, OpenClaw'ın gömülü sağlayıcı isteğini biçimlendirir. Bunları yapılandırmak, açıkça tanımlanmış istek davranışıdır; bu nedenle normalde uygun olan bir auto rotası, Codex'i örtük olarak seçmek yerine OpenClaw'da kalır. Yerel Codex uygulama sunucusu test sistemi kendi taşımasını ve istek ayarlarını yönetir; etkin rota Codex uyumlu olarak bildirilmemişse açık agentRuntime.id: "codex" kapalı biçimde başarısız olur.

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

İlgili