OpenClaw Codex harness: oturumlar, kimlik bilgileri ve faturalandırma

OpenClaw Codex harness, resmi @openclaw/codex eklentisidir: bir OpenClaw aracısı turunu OpenAI'nin Codex app-server'ına devreder; böylece model döngüsünün, iş parçacığı sürdürmenin, araç devamlılığının ve sıkıştırmanın sahibi Codex olur. Bu bir kodlama devri ürünü, faturalandırma katmanı veya — çoğu kurulumu zorlayan nokta — Codex'i üçüncü taraf bir API uç noktasına karşı çalıştırma yolu değildir. Bunlardan hangisine gerçekten ihtiyacınız olduğu, bu sayfanın karar vermenize yardımcı olmak için var olmasının nedenidir.

Önce tarihler; böylece burada tarihsiz hiçbir şey kalmaz. npm paketi openclaw 2026.9.5 sürümündedir ve Node >=24.16.0 <25 || >=26.1.0 gerektirir; @openclaw/codex de 2026.9.5 sürümündedir ve 18 Eylül 2026'da yayımlanmıştır. Her ikisi de 21 Eylül 2026'da kayıt defterinden okunmuştur. Birbiriyle ilgisiz üç proje bu adları paylaşır ve sayılarının hiçbiri burada geçerli değildir: pjasicek/OpenClaw kendisini 1997 tarihli platform oyunu Captain Claw'ın yeniden uygulanması olarak tanımlar; çıplak npm paketi codex kendisini en son 2012'de yayımlanmış bir "statik site ve kod belgesi oluşturucusu" olarak tanımlar; OpenAI'nin CLI'si ise @openai/codex (aynı tarihte 0.155.1 sürümünde) şeklindedir.

Beş OpenClaw yüzeyi "Codex" adını paylaşır

OpenClaw'ın agent-runtimes belgeleri bunları "kasıtlı olarak bağımsız" olarak adlandırır. Yanlış olanı seçmek, yapılandırmanın doğru görünüp hiçbir şey yapmamasının en yaygın nedenidir.

Altıncı bir ad aslında hiç OpenClaw'a ait değildir. openclaw-code-agent, plan onayı ve çalışma ağacı yalıtımıyla arka planda kodlama oturumları çalıştıran üçüncü taraf bir eklentidir; kendi README'si bunun OpenClaw'ın paketlenmiş acpx çalışma zamanı eklentisinden ve paketlenmiş temel codex eklentisinden ayrı olduğunu belirtir. Buraya bir çalışma zamanı değişimi yerine devretme isteğiyle geldiyseniz bu, farklı yapılandırma anahtarlarına sahip farklı bir üründür.

Harness'ı etkinleştirme ve etkin olduğunu kanıtlama

Belgelenen yol iki komuttur — önce eklenti, ardından oturum açma.

openclaw plugins install @openclaw/codex
openclaw models auth login --provider openai

Ardından minimum yapılandırma. Bir plugins.allow listesi kullanıyorsanız buna "codex" değerini de ekleyin.

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      // The docs' own example ref. Legacy codex-cli/* refs are
      // repaired to the same openai/<model> route by doctor --fix.
      model: "openai/gpt-6-astra",
    },
  },
}

Harness belgelerinin açıkça belirttiği iki ayrıntı var. Eklenti yapılandırması değişiklikleri hibrit yeniden yükleme modunda otomatik olarak uygulanır; ancak mevcut bir sohbette, bir sonraki turun harness'ı güncel yapılandırmadan çözümlemesi için önce /new veya /reset kullanılması gerekir. Etkin araç profili, Codex'e özgü kabuk ve dosya sistemi yeteneklerine izin vermelidir: coding ve full buna izin verirken messaging ve minimal Codex'e özgü yüzeyi devre dışı bırakır. Sıradan bir OpenClaw sandbox'ı veya kısıtlı araç politikası, aynı belgede daha dar kapsamlı bir kısıtlama olarak açıklanır — deneysel sandbox exec-server yolunu seçmediğiniz sürece Codex'e özgü kod modunu devre dışı bırakır — ve sandbox Codex'e özgü yüzeyi devre dışı bıraktığında izin verilen kabuk komutlarına sandbox_exec üzerinden erişilebilir.

Sürüm gereksinimleri 21 Eylül 2026'da app-server aktarım başvurusuna göre kontrol edilmiştir: eklenti kararlı Codex app-server 0.154.0 sürümünü yönetir; açık özel yürütülebilir dosyalar, uzak app-server'lar ve macOS masaüstü ikili dosyaları ise ayrıştırılabilir, 0.149.0 veya daha yeni bir anlamsal sürüm bildirmelidir. Aynı gün npm'in en yeni @openai/codex sürümü 0.155.1'dir; dolayısıyla yönetilen sabit sürüm bir yama gerisindedir — bu nedenle tarihi olmayan "Codex en son sürüm" diyen her öğretici birkaç gün içinde eskir. Eski bir kurulumu taşımak da önemlidir: agent-runtimes sayfası, OpenClaw'ın paketlenmiş Codex CLI arka ucunun v2026.5.14'te kaldırıldığını ve eski codex-cli/* başvurularının, genel eski Codex rota onarımının sahibi olan openclaw doctor --fix altındaki aynı openai/<model> Codex app-server rotasına düzeltildiğini belirtir.

Doğrulamak için: Codex destekli bir tur, /status altında Runtime: OpenAI Codex bilgisini bildirir; /codex status, /codex models ve /codex binding ise app-server durumunu inceler. Bir lint işlemi — openclaw doctor --lint --only codex/managed-app-server --json — yönetilen ikili dosyayı kontrol eder; ancak belgeler bunun salt okunur olduğunu belirtir ve seçilmiş bir Codex Desktop ikili dosyasını, açık bir özel komutu ve uzak app-server'ı bu paket kontrolünün dışında bırakır.

Bunu temel almadan önce bilinmeye değer bir gerilim var. OpenAI'nin kendi app-server belgeleri, "app-server komutu ile WebSocket aktarımının deneysel olduğunu ve üretim iş yüklerinde desteklenmediğini" belirtir — uyarının aktarımın yanı sıra komutu da adlandırdığına dikkat edin. OpenClaw bu komutun üzerine yayımlanmış bir özellik kurar ve transport alanı varsayılan olarak stdio değerini kullanır; websocket ise yalnızca bir url yapılandırdığınızda kullanılır. Her iki ifade aynı anda doğrudur; kararınızı ikisini de göz önünde bulundurarak verin.

Yetkilendirme artefaktları, izinler, iptal ve devam ettirme

Harness belgeleri, Codex'in kendi alt aracılarının durumunun neyi kanıtladığının sınırları konusunda dürüsttür: yürütme, görev sonucu ve sonucun teslimi ayrı olgulardır; boşta olan, kesintiye uğramış veya yüklenmemiş bir Codex iş parçacığı görevin başarıyla tamamlandığını kanıtlamaz ve kapatma onayı alınamadığında görev sizden kapatmayı yeniden denemenizi ister. Codex'in kendi alt aracıları, Codex'in kendi mekanizmasıdır — açıkça OpenClaw veya ACP üzerinden görev devretme yine de sessions_spawn üzerinden gerçekleşir.

Eklentinin yapılandırma alanları tablosuna göre, OpenClaw'ın başlattığı app-server işleminin yürütme izinleri varsayılan olarak mod yolo, onay ilkesi never ve korumalı alan danger-full-access şeklindedir; ancak yerel Codex gereksinimleri bu yapılandırmaya izin vermiyorsa guardian varsayılanları istek üzerine onayları ve workspace-write korumalı alanını, aksi durumda read-only korumalı alanını tercih eder; app-server denetim düzlemi çağrılarının zaman aşımı olan requestTimeoutMs, varsayılan olarak 60000'dir. Bunlar Codex CLI'ın kendi varsayılanları değil, OpenClaw'ın başlattığı işlem için geçerli varsayılanlardır ve tanımadığınız bir depoda ilk çalıştırmadan önce gözden geçirmeniz gereken ayar, bu ilk varsayılandır.

Bir tur sırasındaki denetim yerleşiktir: /codex stop, /codex steer, /codex resume, /codex detach, /codex bind, /codex compact, /codex threads, /codex goal, /codex model, /codex fast ve /codex permissions. Kısıtlı tur bir oturum modu değil, tur başına uygulanan bir ayardır ve yalnızca o tur için yerleşik Code Mode'u, ortam seçimlerini, yapılandırılmış MCP sunucularını ve yerleşik kanca aktarımlarını devre dışı bırakır. OpenClaw'ın runtime v1 destek sözleşmesi ayrıca desteklenmeyen özellikler olarak şunları listeler: yerleşik araç bağımsız değişkeni değiştirme (araç öncesi kancalar engelleyebilir, ancak OpenClaw bağımsız değişkenleri yeniden yazmaz), Codex'in kendi döküm geçmişinin düzenlenebilmesi, sıkıştırmaya müdahale ve model API isteğinin baytı baytına yakalanması — dolayısıyla denetim gereksiniminiz gönderilen isteğin birebir kaydıysa bu çalışma zamanı bunu sağlayamaz.

Yetkilendirme, plan kapsamı ve token harcaması üç farklı şeydir

21 Eylül 2026'da OpenClaw'ın Codex app-server ilkeleri sayfasından okundu. Bunun üzerinde bir adlandırma tuzağı bulunuyor: OpenAI'ın API fiyatlandırma sayfası, Priority processing'in 30 Temmuz 2026'da Fast mode olarak yeniden adlandırıldığını ve service_tier alanında "priority" veya "fast" değerinin gönderilebileceğini söylüyor; OpenClaw'ın appServer.serviceTier ayarına ilişkin belgeleri ise "priority" ve "flex" değerlerini belgeliyor ve eski "fast" değerini "priority" değerine normalleştiriyor — yani ters yönde. “Fast mode'u aç” ifadesi iki sistemde farklı anlamlara gelir.

Üçüncü taraf bir uç nokta neden harness'ten çıkar?

Bu, üçüncü taraf yazıların çoğunun tersine çevirdiği tek olgudur. Bir sağlayıcı veya model çalışma zamanı ayarlanmamışsa ya da auto ise OpenClaw'ın örtük araç çalışma zamanı tablosu şöyledir:

Dolayısıyla OpenClaw'ı herhangi bir üçüncü taraf temel URL'sine — Kunavo dahil — yönlendirmek, tasarım gereği turu OpenClaw'ın yerleşik çalışma zamanına taşır. Tek başına openai/* öneki harness'i hiçbir zaman seçmez ve agentRuntime.id: "codex" ayarını zorlamak da bunu kurtarmaz. Çalışma zamanları sayfası, bu ayarın “kayıtlı bir Codex harness'i gerektirdiğini; desteklenmeyen rotaların/kimlik doğrulamaların yürütmeye izin vermeden başarısız olduğunu, ancak yazılmış istek geçersiz kılmalarının yürütme öncesinde Codex'in bildirdiği tam istek OpenClaw geri dönüşünü kullanabileceğini” söyler — dolayısıyla iki sonuç, başarısız bir tur veya bir OpenClaw turudur ve bunların hiçbiri özel bir uç noktada Codex değildir. Eklentinin belgelenmiş yapılandırma alanlarında da bir model temel URL ayarı yoktur; buradaki tek url alanı app-server'ın kendi WebSocket veya unix:// adresidir. appServer.args alanının yönetilen app-server'a bir sağlayıcı geçersiz kılması sokup sokamayacağı belgelenmemiş ve test edilmemiştir; bu sayfa bunu bir geçici çözüm olarak sunmaz.

Yerleşik çalışma zamanı rotası da isteği yeniden şekillendirir ve OpenClaw'ın özel sağlayıcı sayfası her kuralın kapsamını açıkça belirtir. Sağlayıcının kendi uç noktası olmayan bir uç noktadaki api: "openai-completions" için — bunu, boş olmayan herhangi bir baseUrl değerinin ana makinesinin api.openai.com olmaması şeklinde tanımlar — OpenClaw compat.supportsDeveloperRole ayarını false değerine zorlar ve açıkça belirtilmiş bir true değerini geçersiz kılar. Ayrı olarak, proxy tarzı OpenAI uyumlu rotalar “yalnızca OpenAI'ın kendi uç noktasına özgü istek şekillendirmesini atlar”: service_tier yok, Responses store yok, Completions store yok, istem önbelleği ipuçları yok, OpenAI akıl yürütme uyumluluğu yük şekillendirmesi yok ve gizli ilişkilendirme başlıkları yok. Gönderilen istekte service_tier bulunmadığında Fast mode ve Flex böyle bir rotada seçilemez. Aynı sayfa bunun yerine OpenAI uyumlu Completions proxy'leri için params.extra_body aktarımını, sağlayıcı başına headers kullanımını ve yavaş veya uzak ana makineler için models.providers.<id>.timeoutSeconds ayarını sunar.

Codex'in kendisi hikâyenin diğer yarısıdır ve daha izin vericidir: Codex'in gelişmiş yapılandırma sayfası, ~/.codex/config.toml dosyasında [model_providers.<id>] bölümünün base_url ve env_key anahtarlarıyla desteklendiğini gösterir. Ancak kesin bir engel vardır — yapılandırma başvurusu, model_providers.<id>.wire_api için “responses desteklenen tek değerdir ve belirtilmediğinde varsayılandır” der. Bu nedenle yalnızca Chat Completions sunan bir uç nokta Codex'i çalıştıramaz. Aynı gelişmiş yapılandırma sayfası yerleşik kimlikleri openai, ollama ve lmstudio olarak ayırır ve Codex'in proje düzeyindeki .codex/config.toml dosyasında yok saydığı anahtarlar arasında model_provider ile model_providers anahtarlarını listeler; dolayısıyla sağlayıcı anahtarları kullanıcı düzeyindeki yapılandırmaya aittir. Kunavo, /v1/responses uç noktasında doğrudan bir Responses yüzeyi sunar; bu da Codex CLI kurulumunu mümkün kılar — ancak bu bağımsız Codex CLI'dır, OpenClaw harness'i değildir ve Kunavo her iki istemciyi de çalışma zamanında test etmemiştir.

Yazılımın maliyeti ve token'ların maliyeti

OpenClaw'ın kendisi 0 $'dır. Belge dizini, projeyi MIT lisanslı, topluluk odaklı ve bağımsız bir 501(c)(3) vakfı tarafından geliştirilen, “Ücretli katman yok” bir proje olarak tanımlar; @openclaw/codex herkese açık npm kayıt defterinde ücretsiz yayımlanır. Gerçek maliyetlerin tümü Gateway'i çalıştırdığınız makine ile model kullanımından oluşur ve model kullanımı üç sözleşmeden biriyle gelir.

21 Eylül 2026'da kontrol edilen OpenAI'ın Codex fiyatlandırma sayfasından. Bu tabloyla birlikte üç uyarı dikkate alınmalıdır. Fiyatlandırma kartı Pro için yalnızca “100 $'dan başlayan” ifadesini yayımlar; OpenAI'ın ayrı ChatGPT Pro katmanları hakkında makalesi, 10 Eylül 2026 itibarıyla yeni kayıtları ve yükseltmeleri duraklatılmış olan daha yüksek 200 $'lık bir katmandan söz eder; bu nedenle bu sayfanın bir fiyatlandırma kartında görmediği bir rakamı bütçelemek yerine ödeme sırasında doğrulayın. Dahil kullanım, sabit bir ileti sayısı olarak değil, beş saatlik dönem başına yerel ileti tahmin aralıkları olarak yayımlanır. Dahil limitlerden sonraki kredi oranları milyon token başına kredi olarak yayımlanır ve bu fiyatlandırma sayfasında bir kredinin dolar değeri belirtilmez — dolayısıyla bu satır için dolar dönüşümü sağlamaz. Ayrıca GPT-5.5, 14 Ekim 2026'da tüm planlarda ChatGPT, ChatGPT Work ve Codex'ten kaldırılır; OpenAI API bundan etkilenmez.

Üçüncü sözleşme, OpenClaw'ın yerleşik çalışma zamanındaki bir ağ geçididir. Önbelleğe alınmamış 180.000 giriş token'ı gönderen ve 9.000 çıkış token'ı alan tek bir devredilmiş tur varsayın; oranlar milyon token başına güncel Kunavo kataloğu fiyatlarıdır.

Bunlar ölçülmüş görev maliyetleri veya fatura tavanı değil, örnek amaçlı token aritmetiğidir — tur biçimi bir varsayımdır ve gerçek bir aracı turu her araç gidiş-dönüşünde bağlamı yeniden gönderir. Kunavo'nun katalog tutarı bir faturalandırma tabanıdır, tavan değildir: üst akış sağlayıcı ücretini bildirdiğinde fatura, katalog maliyeti ile üst akış maliğinin geçerli çarpanla çarpımından büyük olanıdır. Önbellek ücretleri ve harici araçlar örneğin dışındadır. Minimum yükleme, plan satın almak yerine bir bakiyeyi finanse eden ön ödemeli 10 $ kredidir — faturalandırma ayrıntılarına bakın.

Kunavo hiçbir embedding modeli, metinden konuşmaya modeli veya konuşmadan metne modeli sunmaz. Bu adımlar hiçbir rotada Kunavo tarafından sunulmaz; bunlar için ilgili hizmeti sunan bir sağlayıcıya başvurun.

Bu sınır burada önemlidir; çünkü yukarıdaki yüzeyler tablosu aracı olmayan bir OpenAI Platform rotasını harness'ten ayrı tutar ve bir Gateway anahtarı yalnızca Kunavo kataloğundaki sohbet modellerini kapsar.

Hangi rota ne zaman kazanır?

Yanıt Gateway satırıysa, Responses API biçimi için Codex CLI entegrasyonuyla başlayın; OpenClaw için en iyi API ve Codex için en iyi API bölümlerinde seçenekleri karşılaştırın ve bir anahtara bakiye yüklemeye hazır olduğunuzda Kunavo hesabı oluşturun. Kendi barındırdığınız bir asistanın bütçe tarafında OpenClaw fiyatlandırması, yazılım, barındırma ve model harcamalarını birbirinden ayırır.

Sık sorulan sorular

Çalışma zamanı tablosu, kimlik doğrulama sırası, app-server uyarısı, wire_api geçidi, sürüm sabitlemeleri ve yukarıdaki plan fiyatları 21 Eylül 2026'da OpenClaw ve OpenAI'ın kendi belgelerinden, OpenAI'ın yardım merkezinden ve openclaw, @openclaw/codex, @openai/codex, codex ile openclaw-code-agent için npm kayıt defteri girdilerinden alındı. Her iddia geldiği sayfaya bağlanmıştır; bir belge bir soruyu kesinleştirmediğinde metin boşluğu doldurmak yerine bunu belirtir. Kunavo, OpenClaw'ı veya Codex harness'ini çalışma zamanında test etmemiştir; bu nedenle buradaki her yapılandırma, Kunavo'nun uç noktasına karşı gösterilmek yerine kaynak belgelerle doğrulanmıştır. Kunavo token oranları canlı katalogdan alınır ve her dolar tutarı örnek amaçlı aritmetiktir.