Codex çalıştırma altyapısı

Codex düzenek turları için çalışma zamanı sözleşmesi. Kurulum ve yönlendirme için Codex düzeneği bölümüne bakın. Yapılandırma alanları için Codex düzeneği referansı bölümüne bakın.

Genel Bakış

Codex; yerel model döngüsünü, yerel iş parçacığını sürdürmeyi, yerel araç devamını ve yerel Compaction işlemini yönetir. OpenClaw ise kanal yönlendirmesini, oturum dosyalarını, görünür ileti teslimini, OpenClaw dinamik araçlarını, onayları, medya teslimini ve bu sınırın çevresindeki transkript yansısını yönetir.

İstem yönlendirmesi yalnızca sağlayıcı dizesini değil, seçilen çalışma zamanını izler. Yerel bir Codex turu, Codex uygulama sunucusu geliştirici talimatlarını alır; açıkça belirtilmiş bir OpenClaw uyumluluk rotası ise Codex tarzı OpenAI kimlik doğrulamasını veya aktarımını kullansa bile normal OpenClaw sistem istemini korur.

OpenClaw, yerel Codex iş parçacıklarını Codex'in yerleşik kişiliği devre dışı bırakılmış şekilde (personality: "none") başlatır ve sürdürür; böylece çalışma alanı kişilik dosyaları ile OpenClaw aracısı kimliği belirleyici olmaya devam eder. Bunun dışında yerel Codex, Codex tarafından yönetilen temel/model talimatlarını ve proje belgesi yüklemeyi korur. Hafif OpenClaw çalıştırmaları (örneğin cron) proje belgesi yüklemeyi yine engeller.

OpenClaw geliştirici talimatları, OpenClaw çalışma zamanı konularını kapsar: kaynak kanal teslimi, OpenClaw dinamik araçları, ACP devri, bağdaştırıcı bağlamı ve etkin aracı çalışma alanı profil dosyaları. Skills katalogları ve araçla yönlendirilen MEMORY.md işaretçileri, tur kapsamlı iş birliği geliştirici talimatları olarak yansıtılır. Bellek araçları kullanılamadığında etkin BOOTSTRAP.md içeriği ve tam MEMORY.md bunun yerine düz tur giriş bağlamına geri döner.

Çoğu OpenClaw dinamik aracı, aranabilir openclaw ad alanını kullanır. catalogMode: "direct-only" olarak işaretlenen araçlar openclaw_direct kullanır; Codex bunu, iç içe Code Mode yürütmesine sunmak yerine DirectModelOnly olarak doğrudan modele görünür tutar.

İş parçacığı bağlamaları ve model değişiklikleri

Bir OpenClaw oturumu mevcut bir Codex iş parçacığına eklendiğinde sonraki tur; seçili modeli, onay politikasını, korumalı alanı, onay inceleyicisini ve hizmet katmanını uygulama sunucusuna yeniden gönderir. openai/gpt-5.5 modelinden openai/gpt-5.2 modeline geçiş, iş parçacığı bağlamasını korur ancak Codex'ten yeni seçilen modelle devam etmesini ister.

Gözetimli bağlamalar istisnadır. OpenClaw model seçici kilitli kalır ve sürdürme işlemleri model ile sağlayıcı geçersiz kılmalarını atlar; böylece Codex, kurallı iş parçacığının kalıcı modelini ve sağlayıcısını geri yükler. Ayrı bir yerel Codex denetimi, kalıcı hale getirilmiş bu çifti değiştirebilir ve ilk anlık görüntü Codex'in normal model farklılığı uyarısını oluşturabilir; dıştaki OpenClaw modeli ve geri dönüş zinciri bunların hiçbirinin yerine geçmez.

Gözetim ve güvenli devam

Codex gözetimi, aynı codex Plugin'inin isteğe bağlı bir özelliğidir. Yerel iş parçacıklarını ayrı bir bağlantı üzerinden keşfeder ve yalnızca arşivlenmemiş oturumları Gateway kataloğuna yansıtır. Açık appServer bağlantı ayarları yoksa sıradan düzenek aracı kapsamında kalırken bu bağlantı, yönetilen kullanıcı ana dizini stdio'sunu kullanır. Listeleme ve meta veri okumaları pasiftir: bir iş parçacığını sürdürmez, OpenClaw'u canlı olaylarına abone etmez veya onaylarını yanıtlamaz.

Gateway bilgisayarındaki depolanmış veya boşta olan bir oturum için Dal olarak devam et, normal, modeli kilitli bir Sohbet oluşturur ve sınırlı kullanıcı ile asistan geçmişini kaynağın kalıcı hale getirilmiş son sonlandırıcı turuna kadar yansıtır. İlk normal Sohbet turu gerçek onay işleyicilerini kurar ve anlık görüntüyü bir model ya da sağlayıcı geçersiz kılması olmadan sabitlemek için geçici bir yerel çatal kullanır. Codex App Server, mevcut yerel yapılandırmasını kullanıp seçili çifti döndürür; bu model kaynağın kaydedilen son modelinden farklıysa normal uyarısını verir. Aynı gözetim bağlantısında OpenClaw, kurallı appServer kaynaklı Codex düzenek iş parçacığını kendi çalışma dizini ve çalışma zamanı politikası altında, ilk başlatma için döndürülen model ve sağlayıcıyı tam olarak kullanarak başlatır; sınırlı görünür geçmişi ekler ve geçici çatalı arşivler. Kaynak hiçbir zaman sürdürülmez. Kurallı iş parçacığı tam OpenClaw düzenek araç yüzeyine sahiptir; kaynaktaki akıl yürütme, araç çağrıları ve araç sonuçları bu iş parçacığına kopyalanmaz. Özel bağlantı kapsamı, bekleyen ve işlenmiş bağlama durumlarında varlığını korur; böylece sonraki her tur, yerel kimlik doğrulaması ve sağlayıcı yapılandırmasıyla bu bağlantıda kalır. Devre dışı bırakılmış gözetim veya bağlama/bağlantı sapması, sıradan aracı ana dizini düzeneğine geçmek yerine kapalı biçimde başarısız olur.

Özgün CLI, VS Code, Atlas veya ChatGPT kaynağı her iki katalog için de uygun olmaya devam eder. Kurallı dal yerel bir Codex iş parçacığıdır, ancak kaynak türü appServer şeklindedir; yerel istemciler bu kaynak türünü filtreleyebileceğinden Codex Desktop'ta görünmesi garanti edilmez.

Etkin kaynaklar yeni bir dal başlatamaz veya arşivlenemez; mevcut gözetimli Sohbet yine de açılabilir. notLoaded, boşta olmayı değil etkinliğin bilinmediğini belirtir; OpenClaw, yerel bir idle veya notLoaded satırını yalnızca başka çalıştırıcı olmadığına dair açık onayın ve işlem düzeyinde yeni bir durum okumasının ardından arşivlemeye izin verir. Codex, iş parçacığı değişikliklerini tek bir App Server işlemi içinde seri hale getirir ancak işlemler arası özel bir çalıştırıcı veya onay sahibi kiralaması sağlamaz; dolayısıyla bu okuma, başka bir işlemin iş parçacığını kullanmadığını kanıtlayamaz. OpenClaw, tam hedef ya da Codex'in sayfalandırılmış alt öğe sorgusunun döndürdüğü arşivlenmemiş herhangi bir oluşturulmuş alt öğe için bilinen etkin bir bağlama sahibini engeller. Numaralandırma hataları, döngüler ve güvenlik sınırının tükenmesi kapalı biçimde başarısız olur. Yerel arşivleme, başka bir işlemdeki yeni bir turla yine de yarışabilir; bu nedenle onay, bilinmeyen istemcileri ve durum okumasıyla arşivleme arasındaki boşluğu kapsar. Gözetimli, modeli kilitli bir Sohbet, yerel bağlamayı korurken silinemez.

Eşleştirilmiş Node katalogları ilk sürümde yalnızca meta veri olarak kalır. Mevcut Node çağırma sınırı istek/yanıt biçimindedir ve gerçek bir Codex düzenek bağlamasının gerektirdiği uzun ömürlü tur olaylarını, onay isteklerini veya akışlı çıktıyı taşıyamaz. Bu nedenle satır boşta olsa bile uzaktan Devam Et ve Arşivle kullanılamaz.

Operatör kurulumu ve görünür Control UI davranışı için Codex gözetimi bölümüne bakın.

Görünür yanıtlar ve Heartbeat'ler

Codex düzeneği üzerinden yapılan doğrudan/kaynak sohbet turları, dahili WebChat yüzeyleri için varsayılan olarak otomatik son asistan teslimini kullanır ve Pi düzeneği sözleşmesiyle eşleşir: aracı normal şekilde yanıt verir ve OpenClaw son metni kaynak konuşmaya gönderir. Aracı message(action="send") çağrısı yapmadığı sürece son asistan metnini özel tutmak için messages.visibleReplies: "message_tool" ayarını belirleyin.

Codex Heartbeat turları, uyandırmanın sessiz kalması mı yoksa bildirim göndermesi mi gerektiğini aracının kaydedebilmesi için varsayılan olarak aranabilir OpenClaw araç kataloğunda heartbeat_respond alır. Heartbeat girişim rehberliği, Heartbeat turuyla sınırlı bir Codex iş birliği modu geliştirici talimatı olarak gönderilir; sıradan sohbet turları Codex Default modunda kalır. HEARTBEAT.md boş olmadığında Heartbeat talimatları, içeriğini satır içinde vermek yerine Codex'i dosyaya yönlendirir.

Kanca sınırları

OpenClaw, Plugin davranışını yönlendirmek için proje veya genel Codex hooks.json dosyalarını kullanmaz. Yerel araç ve izin köprüsü için OpenClaw; PreToolUse, PostToolUse, PermissionRequest ve Stop için iş parçacığı başına Codex yapılandırması ekler.

Codex app-server onayları etkinleştirildiğinde (approvalPolicy, "never" değilse), varsayılan olarak eklenen yerel kanca yapılandırması PermissionRequest öğesini atlar; böylece Codex'in app-server inceleyicisi ile OpenClaw'un onay köprüsü, incelemenin ardından gerçek yetki yükseltmelerini işler. Uyumluluk aktarıcısını yine de zorlamak için nativeHookRelay.events öğesine permission_request ekleyin. SessionStart ve UserPromptSubmit gibi diğer Codex kancaları Codex düzeyinde denetimler olarak kalır; v1 sözleşmesinde OpenClaw Plugin kancaları olarak sunulmaz.

OpenClaw dinamik araçları için OpenClaw, Codex çağrıyı istedikten sonra aracı yürütür; dolayısıyla Plugin ve ara yazılım davranışı düzenek bağdaştırıcısında çalışır. Codex Code Mode, genel dinamik sonuçları metin olarak alır ve iç içe dinamik çağrıları seri hale getirir; çağıranlar JSON görünümündeki sonuçları ayrıştırmalı ve eşzamanlı gönderim için Promise.all öğesine güvenmemelidir. Codex'e özgü araçlarda Codex, kurallı araç kaydını yönetir; OpenClaw seçili olayları yansıtabilir ancak Codex bunu app-server veya yerel kanca geri çağırmaları üzerinden sunmadıkça yerel iş parçacığını yeniden yazamaz.

Codex app-server rapor modu PreToolUse olayları, Plugin onayını eşleşen app-server onayına erteler. Yerel yük openclaw_approval_mode: "report" değerini ayarlarken bir OpenClaw before_tool_call kancası requireApproval döndürürse yerel kanca aktarıcısı, Plugin onayı gereksinimini kaydeder ve hiçbir yerel karar döndürmez. Codex daha sonra aynı araç kullanımı için app-server onay isteğini gönderdiğinde OpenClaw, Plugin onayı istemini açar ve kararı Codex'e eşler. Codex PermissionRequest olayları, ayrı bir onay yoludur ve bu köprü için yapılandırıldığında yine de OpenClaw onayları üzerinden yönlendirilebilir.

Codex app-server öğe bildirimleri ayrıca, yerel PostToolUse aktarıcısının zaten kapsamadığı yerel araç tamamlanmaları için eşzamansız after_tool_call gözlemleri sağlar. Bunlar yalnızca telemetri/uyumluluk içindir; yerel araç çağrısını engelleyemez, geciktiremez veya değiştiremez.

Compaction ve LLM yaşam döngüsü yansıtmaları, yerel Codex kanca komutlarından değil Codex app-server bildirimlerinden ve OpenClaw bağdaştırıcı durumundan gelir. before_compaction, after_compaction, llm_input ve llm_output, Codex'in dahili istek veya Compaction yüklerinin bayt bayt yakalamaları değil, bağdaştırıcı düzeyindeki gözlemlerdir.

Codex yerel hook/started ve hook/completed app-server bildirimleri, yörünge ve hata ayıklama için codex_app_server.hook aracı olayları olarak yansıtılır. Bunlar OpenClaw Plugin kancalarını çağırmaz.

V1 destek sözleşmesi

Codex çalışma zamanı v1'de desteklenenler:

Codex çalışma zamanı v1'de desteklenmeyenler:

Yerel izinler ve MCP bilgi istemleri

PermissionRequest için OpenClaw, yalnızca politika karar verdiğinde açık izin veya ret kararları döndürür. Karar verilmemesi izin anlamına gelmez: Codex bunu kanca kararı yok şeklinde değerlendirir ve kendi koruyucu veya kullanıcı onayı yoluna geçer.

Codex app-server onay modları varsayılan olarak bu yerel kancayı içermez. Bu, permission_request açıkça nativeHookRelay.events içine eklenmedikçe veya bir uyumluluk çalışma zamanı bunu yüklemedikçe geçerlidir.

Bir operatör Codex yerel izin isteği için allow-always seçtiğinde, OpenClaw bu tam sağlayıcı/oturum/araç girdisi/cwd parmak izini sınırlı bir oturum aralığı boyunca hatırlar. Hatırlanan karar kasıtlı olarak yalnızca tam eşleşme için geçerlidir: değişen bir komut, bağımsız değişkenler, araç yükü veya cwd yeni bir onay oluşturur.

Codex MCP araç onayı bilgi istemleri, Codex _meta.codex_approval_kind değerini "mcp_tool_call" olarak işaretlediğinde OpenClaw'ın Plugin onay akışı üzerinden yönlendirilir. Codex request_user_input, kaynak oturum için sağlayıcıdan bağımsız bir Gateway sorusu kaydeder. Control UI, Gateway soru kartını görüntüler ve kanal destekliyorsa gizli olmayan tek bir seçim için türlü kanal düğmeleri kullanılır. Düğme dokunuşları, Control UI yanıtları ve sıradaki kuyruğa alınmış düz metin yanıtı; OpenClaw app-server yanıtını döndürmeden önce aynı Gateway kaydını çözümler. Codex otomatik çözümleme ve deneme iptalleri, bekleme süresini sınırlar ve kaydı iptal eder. Gizli sorular tamamen uyarılı metin yanıtı yolunda kalır. Diğer MCP bilgi istemi istekleri güvenli biçimde reddedilir.

Bu istemleri taşıyan genel Plugin onay akışı için Plugin izin istekleri bölümüne bakın.

Kuyruk yönlendirmesi

Etkin çalıştırma kuyruğu yönlendirmesi, Codex app-server turn/steer üzerine eşlenir. Varsayılan messages.queue.mode: "steer" ile OpenClaw, yönlendirme modundaki sohbet mesajlarını yapılandırılmış sessizlik aralığı boyunca toplu hâle getirir ve varış sırasına göre tek bir turn/steer isteği olarak gönderir.

Codex inceleme ve manuel Compaction dönüşleri, aynı dönüşte yönlendirmeyi reddedebilir. Bu durumda OpenClaw, istemi başlatmadan önce etkin çalıştırmanın tamamlanmasını bekler. Mesajların varsayılan olarak yönlendirilmek yerine kuyruğa alınması gerektiğinde /queue followup veya /queue collect kullanın. Bkz. Yönlendirme kuyruğu.

Codex geri bildirimini yükleme

Yerel Codex çalıştırma altyapısındaki bir oturum için /diagnostics [note] onaylandığında OpenClaw, listelenen her iş parçacığının günlükleri ve mevcut olduğunda oluşturulan Codex alt iş parçacıkları dâhil olmak üzere ilgili Codex iş parçacıkları için Codex app-server feedback/upload çağrısını da yapar.

Yükleme, Codex'in normal geri bildirim yolu üzerinden OpenAI sunucularına gider. Bu app-server'da Codex geri bildirimi devre dışıysa komut, app-server hatasını döndürür. Tamamlanan tanılama yanıtı; gönderilen iş parçacıklarına ait kanalları, OpenClaw oturum kimliklerini, Codex iş parçacığı kimliklerini ve yerel codex resume <thread-id> komutlarını listeler.

Onayı reddeder veya yok sayarsanız OpenClaw, bu Codex kimliklerini yazdırmaz ve Codex geri bildirimi göndermez. Yükleme, yerel Gateway tanılama dışa aktarımının yerini almaz. Onay, gizlilik, yerel paket ve grup sohbeti davranışı için bkz. Tanılama dışa aktarımı.

/codex diagnostics [note] seçeneğini yalnızca tam Gateway tanılama paketi olmadan, o anda bağlı olan iş parçacığının Codex geri bildirimini yüklemek istediğinizde kullanın.

Compaction ve transkript yansısı

Seçilen model Codex çalıştırma altyapısını kullandığında, yerel iş parçacığı Compaction işlemi Codex app-server'a aittir. OpenClaw; Codex dönüşleri için ön kontrol Compaction işlemi çalıştırmaz, Codex Compaction işlemini bağlam motoru Compaction işlemiyle değiştirmez veya yerel Compaction başlatılamadığında OpenClaw ya da herkese açık OpenAI özetlemesine geri dönmez. OpenClaw; kanal geçmişi, arama, /new, /reset ve gelecekteki model ya da çalıştırma altyapısı geçişleri için bir transkript yansısı tutar.

/compact veya bir Plugin tarafından istenen manuel Compaction işlemi gibi açık Compaction istekleri, thread/compact/start ile yerel Codex Compaction işlemini başlatır. OpenClaw, Codex eşleşen contextCompaction tamamlanma öğesini yayımlayana kadar isteği ve paylaşılan istemci kirasını açık tutar, ardından Compaction dönüşünü tamamlandı olarak bildirir. Bu sonlandırıcı dönüş, yapılandırılmış Compaction zaman aşımını geçerse OpenClaw yerel dönüş kesintisi ister. Kira ve iş parçacığı başına Compaction engeli, Codex sonlandırıcı durumu bildirene veya kesinti RPC'sini onaylayana kadar tutulmaya devam eder. Codex, kesinti tolerans süresi içinde onay vermezse OpenClaw engeli serbest bırakmadan önce bağlantıyı kullanımdan kaldırır. Uzak bağlantılar ayrıca eşleşen iş parçacığı bağlamasını ayırır; böylece sonraki çalışmalar, onaylanmamış bir uzak dönüşle çakışamaz. Kullanımdan kaldırılmış bir bağlantıdaki diğer dönüşler başarısız olur ve yeni bir istemcide yeniden denenebilir. İstemcinin kapanması, isteğin iptal edilmesi veya başarısız bir Compaction dönüşü, başarısız bir işlem döndürür. Bağlam baskısına bağlı otomatik Compaction, Codex'in görevidir; OpenClaw yerel Compaction işlemini yalnızca manuel olarak istenen tetikleyiciler için başlatır.

Bir bağlam motoru Codex iş parçacığı önyükleme projeksiyonu istediğinde OpenClaw, araç çağrısı adlarını ve kimliklerini, girdi şekillerini ve sansürlenmiş araç sonucu içeriğini yeni Codex iş parçacığına yansıtır. Ham araç çağrısı bağımsız değişkeni değerlerini bu projeksiyona kopyalamaz.

Yansı; kullanıcı istemini, nihai asistan metnini ve app-server bunları yayımladığında hafif Codex akıl yürütme veya plan kayıtlarını içerir. OpenClaw, yerel Compaction başlangıcını ve sonlandırıcı durumunu kaydeder ancak insanlar tarafından okunabilir bir Compaction özeti ya da Codex'in Compaction sonrasında hangi girdileri tuttuğunu gösteren denetlenebilir bir liste sunmaz.

Codex, kurallı yerel iş parçacığının sahibi olduğundan tool_result_persist, Codex'e özgü araç sonucu kayıtlarını yeniden yazmaz. Yalnızca OpenClaw, OpenClaw'a ait bir oturum transkripti araç sonucu yazdığında uygulanır.

Medya ve teslimat

OpenClaw, medya teslimatının ve medya sağlayıcısı seçiminin sahibi olmaya devam eder. Görsel, video, müzik, PDF, TTS ve medya anlama; agents.defaults.mediaModels.image, agents.defaults.mediaModels.video, pdfModel ve tts gibi eşleşen sağlayıcı/model ayarlarını kullanır.

Metin, görseller, video, müzik, TTS, onaylar ve mesajlaşma aracı çıktıları normal OpenClaw teslimat yolu üzerinden devam eder; medya üretimi, eski çalışma zamanını gerektirmez. Codex bir savedPath içeren yerel bir görsel üretme öğesi yayımladığında OpenClaw, Codex dönüşünde asistan metni olmasa bile tam olarak bu dosyayı normal yanıt medyası yolu üzerinden iletir.

İlgili

• Codex çalıştırma altyapısı
• Codex çalıştırma altyapısı başvurusu
• Codex gözetimi
• Yerel Codex Plugin'leri
• Plugin kancaları
• Ajan çalıştırma altyapısı Plugin'leri
• Tanılama dışa aktarımı
• Yörünge dışa aktarımı