Ana içeriğe atla

​
OpenAI

OpenAI, GPT modelleri için geliştirici API’leri sunar. OpenClaw iki kimlik doğrulama yolunu destekler:
  • API key — kullanım bazlı faturalandırma ile doğrudan OpenAI Platform erişimi (openai/* modelleri)
  • Codex aboneliği — abonelik erişimiyle ChatGPT/Codex oturum açma (openai-codex/* modelleri)
OpenAI, OpenClaw gibi harici araçlar ve iş akışlarında abonelik OAuth kullanımını açıkça destekler.

​
Başlangıç

Tercih ettiğiniz kimlik doğrulama yöntemini seçin ve kurulum adımlarını izleyin.
En iyisi: doğrudan API erişimi ve kullanım bazlı faturalandırma.
1

API anahtarınızı alın

OpenAI Platform dashboard üzerinden bir API anahtarı oluşturun veya kopyalayın.
2

Başlangıç kurulumunu çalıştırın

openclaw onboard --auth-choice openai-api-key
Veya anahtarı doğrudan iletin:
openclaw onboard --openai-api-key "$OPENAI_API_KEY"
3

Modelin kullanılabilir olduğunu doğrulayın

openclaw models list --provider openai

​
Yol özeti

Model refYolKimlik doğrulama
openai/gpt-5.4Doğrudan OpenAI Platform APIOPENAI_API_KEY
openai/gpt-5.4-proDoğrudan OpenAI Platform APIOPENAI_API_KEY
ChatGPT/Codex oturum açma, openai/* yerine openai-codex/* üzerinden yönlendirilir.

​
Yapılandırma örneği

{
  env: { OPENAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "openai/gpt-5.4" } } },
}
OpenClaw, openai/gpt-5.3-codex-spark modelini doğrudan API yolunda sunmaz. Canlı OpenAI API istekleri bu modeli reddeder. Spark yalnızca Codex içindir.

​
Görüntü oluşturma

Paketlenmiş openai Plugin’i, image_generate aracı üzerinden görüntü oluşturmayı kaydeder.
YetenekDeğer
Varsayılan modelopenai/gpt-image-1
İstek başına en fazla görüntü4
Düzenleme moduEtkin (en fazla 5 referans görüntü)
Boyut geçersiz kılmalarıDesteklenir
En boy oranı / çözünürlükOpenAI Images API’ye iletilmez
{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "openai/gpt-image-1" },
    },
  },
}
Paylaşılan araç parametreleri, sağlayıcı seçimi ve yük devretme davranışı için Image Generation bölümüne bakın.

​
Video oluşturma

Paketlenmiş openai Plugin’i, video_generate aracı üzerinden video oluşturmayı kaydeder.
YetenekDeğer
Varsayılan modelopenai/sora-2
ModlarMetinden videoya, görüntüden videoya, tek video düzenleme
Referans girdileri1 görüntü veya 1 video
Boyut geçersiz kılmalarıDesteklenir
Diğer geçersiz kılmalaraspectRatio, resolution, audio, watermark bir araç uyarısıyla yok sayılır
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "openai/sora-2" },
    },
  },
}
Paylaşılan araç parametreleri, sağlayıcı seçimi ve yük devretme davranışı için Video Generation bölümüne bakın.

​
Kişilik katmanı

OpenClaw, openai/* ve openai-codex/* çalıştırmaları için OpenAI’ya özgü küçük bir istem katmanı ekler. Bu katman, temel sistem isteminin yerini almadan asistanı sıcak, işbirlikçi, özlü ve duygusal olarak biraz daha dışavurumlu tutar.
DeğerEtki
"friendly" (varsayılan)OpenAI’ya özgü katmanı etkinleştir
"on""friendly" için takma ad
"off"Yalnızca temel OpenClaw istemini kullan
{
  plugins: {
    entries: {
      openai: { config: { personality: "friendly" } },
    },
  },
}
Değerler çalışma zamanında büyük/küçük harfe duyarsızdır; bu nedenle "Off" ve "off" ikisi de katmanı devre dışı bırakır.

​
Ses ve konuşma

Paketlenmiş openai Plugin’i, messages.tts yüzeyi için konuşma sentezini kaydeder.
AyarYapılandırma yoluVarsayılan
Modelmessages.tts.providers.openai.modelgpt-4o-mini-tts
Sesmessages.tts.providers.openai.voicecoral
Hızmessages.tts.providers.openai.speed(ayarlanmamış)
Yönergelermessages.tts.providers.openai.instructions(ayarlanmamış, yalnızca gpt-4o-mini-tts)
Biçimmessages.tts.providers.openai.responseFormatsesli notlar için opus, dosyalar için mp3
API keymessages.tts.providers.openai.apiKeyOPENAI_API_KEY değerine geri döner
Temel URLmessages.tts.providers.openai.baseUrlhttps://api.openai.com/v1
Kullanılabilir modeller: gpt-4o-mini-tts, tts-1, tts-1-hd. Kullanılabilir sesler: alloy, ash, ballad, cedar, coral, echo, fable, juniper, marin, onyx, nova, sage, shimmer, verse.
{
  messages: {
    tts: {
      providers: {
        openai: { model: "gpt-4o-mini-tts", voice: "coral" },
      },
    },
  },
}
Sohbet API uç noktasını etkilemeden TTS temel URL’sini geçersiz kılmak için OPENAI_TTS_BASE_URL ayarlayın.
Paketlenmiş openai Plugin’i, Voice Call Plugin’i için gerçek zamanlı transkripsiyonu kaydeder.
AyarYapılandırma yoluVarsayılan
Modelplugins.entries.voice-call.config.streaming.providers.openai.modelgpt-4o-transcribe
Sessizlik süresi...openai.silenceDurationMs800
VAD eşiği...openai.vadThreshold0.5
API key...openai.apiKeyOPENAI_API_KEY değerine geri döner
G.711 u-law ses ile wss://api.openai.com/v1/realtime adresine bir WebSocket bağlantısı kullanır.
Paketlenmiş openai Plugin’i, Voice Call Plugin’i için gerçek zamanlı sesi kaydeder.
AyarYapılandırma yoluVarsayılan
Modelplugins.entries.voice-call.config.realtime.providers.openai.modelgpt-realtime
Ses...openai.voicealloy
Sıcaklık...openai.temperature0.8
VAD eşiği...openai.vadThreshold0.5
Sessizlik süresi...openai.silenceDurationMs500
API key...openai.apiKeyOPENAI_API_KEY değerine geri döner
azureEndpoint ve azureDeployment yapılandırma anahtarları aracılığıyla Azure OpenAI’ı destekler. Çift yönlü araç çağırmayı destekler. G.711 u-law ses biçimini kullanır.

​
Gelişmiş yapılandırma

OpenClaw, hem openai/* hem de openai-codex/* için önce WebSocket ve ardından SSE geri dönüşü ("auto") kullanır."auto" modunda OpenClaw:
  • SSE’ye geri dönmeden önce bir erken WebSocket hatasını yeniden dener
  • Bir hatadan sonra WebSocket’i yaklaşık 60 saniye boyunca bozulmuş olarak işaretler ve soğuma süresince SSE kullanır
  • Yeniden denemeler ve yeniden bağlantılar için kararlı oturum ve tur kimliği üst bilgileri ekler
  • Aktarım varyantları arasında kullanım sayaçlarını (input_tokens / prompt_tokens) normalize eder
DeğerDavranış
"auto" (varsayılan)Önce WebSocket, SSE geri dönüşü
"sse"Yalnızca SSE’yi zorla
"websocket"Yalnızca WebSocket’i zorla
{
  agents: {
    defaults: {
      models: {
        "openai-codex/gpt-5.4": {
          params: { transport: "auto" },
        },
      },
    },
  },
}
İlgili OpenAI belgeleri:
OpenClaw, ilk tur gecikmesini azaltmak için openai/* için varsayılan olarak WebSocket ısınmasını etkinleştirir.
// Isınmayı devre dışı bırak
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: { openaiWsWarmup: false },
        },
      },
    },
  },
}
OpenClaw, hem openai/* hem de openai-codex/* için paylaşılan bir hızlı mod anahtarı sunar:
  • Sohbet/UI: /fast status|on|off
  • Yapılandırma: agents.defaults.models["<provider>/<model>"].params.fastMode
Etkinleştirildiğinde OpenClaw, hızlı modu OpenAI öncelikli işlemeye eşler (service_tier = "priority"). Mevcut service_tier değerleri korunur ve hızlı mod reasoning veya text.verbosity değerlerini yeniden yazmaz.
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": { params: { fastMode: true } },
        "openai-codex/gpt-5.4": { params: { fastMode: true } },
      },
    },
  },
}
Oturum geçersiz kılmaları yapılandırmaya üstün gelir. Sessions UI içinde oturum geçersiz kılmasını temizlemek, oturumu yapılandırılmış varsayılana geri döndürür.
OpenAI API’si, service_tier aracılığıyla öncelikli işleme sunar. Bunu OpenClaw içinde model başına ayarlayın:
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": { params: { serviceTier: "priority" } },
        "openai-codex/gpt-5.4": { params: { serviceTier: "priority" } },
      },
    },
  },
}
Desteklenen değerler: auto, default, flex, priority.
serviceTier yalnızca yerel OpenAI uç noktalarına (api.openai.com) ve yerel Codex uç noktalarına (chatgpt.com/backend-api) iletilir. Her iki sağlayıcıyı da bir proxy üzerinden yönlendirirseniz OpenClaw service_tier değerine dokunmaz.
Doğrudan OpenAI Responses modelleri için (api.openai.com üzerindeki openai/*) OpenClaw, sunucu tarafı Compaction özelliğini otomatik olarak etkinleştirir:
  • store: true değerini zorlar (supportsStore: false ayarlayan model uyumluluğu yoksa)
  • context_management: [{ type: "compaction", compact_threshold: ... }] ekler
  • Varsayılan compact_threshold: contextWindow değerinin %70’i (veya mevcut değilse 80000)
Azure OpenAI Responses gibi uyumlu uç noktalar için kullanışlıdır:
{
  agents: {
    defaults: {
      models: {
        "azure-openai-responses/gpt-5.4": {
          params: { responsesServerCompaction: true },
        },
      },
    },
  },
}
responsesServerCompaction yalnızca context_management eklemeyi kontrol eder. Doğrudan OpenAI Responses modelleri, uyumluluk supportsStore: false ayarlamadığı sürece yine de store: true değerini zorlar.
openai/* ve openai-codex/* üzerindeki GPT-5 ailesi çalıştırmaları için OpenClaw, daha sıkı bir gömülü yürütme sözleşmesi kullanabilir:
{
  agents: {
    defaults: {
      embeddedPi: { executionContract: "strict-agentic" },
    },
  },
}
strict-agentic ile OpenClaw:
  • Bir araç eylemi kullanılabiliyorken artık yalnızca plan içeren bir turu başarılı ilerleme olarak değerlendirmez
  • Turu şimdi harekete geç yönlendirmesiyle yeniden dener
  • Önemli işler için update_plan özelliğini otomatik etkinleştirir
  • Model eyleme geçmeden plan yapmaya devam ederse açık bir engellenmiş durum gösterir
Yalnızca OpenAI ve Codex GPT-5 ailesi çalıştırmalarıyla sınırlıdır. Diğer sağlayıcılar ve daha eski model aileleri varsayılan davranışı korur.
OpenClaw, doğrudan OpenAI, Codex ve Azure OpenAI uç noktalarını genel OpenAI uyumlu /v1 proxy’lerinden farklı şekilde ele alır:Yerel yollar (openai/*, openai-codex/*, Azure OpenAI):
  • Akıl yürütme açıkça devre dışı bırakıldığında reasoning: { effort: "none" } değerini korur
  • Araç şemalarını varsayılan olarak sıkı moda ayarlar
  • Gizli atıf üst bilgilerini yalnızca doğrulanmış yerel ana makinelere ekler
  • Yalnızca OpenAI’a özgü istek şekillendirmesini korur (service_tier, store, reasoning-compat, prompt-cache ipuçları)
Proxy/uyumlu yollar:
  • Daha gevşek uyumluluk davranışı kullanır
  • Sıkı araç şemalarını veya yalnızca yerel üst bilgileri zorlamaz
Azure OpenAI, yerel aktarım ve uyumluluk davranışını kullanır ancak gizli atıf üst bilgilerini almaz.

​
İlgili

Model seçimi

Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme.

Image Generation

Paylaşılan görüntü aracı parametreleri ve sağlayıcı seçimi.

Video Generation

Paylaşılan video aracı parametreleri ve sağlayıcı seçimi.

OAuth ve kimlik doğrulama

Kimlik doğrulama ayrıntıları ve kimlik bilgisi yeniden kullanım kuralları.