Codex test düzeneği referansı

Bu başvuru, birlikte gelen codex Plugin için ayrıntılı yapılandırmayı kapsar. Kurulum ve yönlendirme kararları için Codex harness ile başlayın.

Plugin yapılandırma yüzeyi

Tüm Codex harness ayarları plugins.entries.codex.config altında yer alır.

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          discovery: {            enabled: true,            timeoutMs: 2500,          },          appServer: {            mode: "guardian",          },        },      },    },  },}

Desteklenen üst düzey alanlar:

App-server taşıması

Varsayılan olarak OpenClaw, birlikte gelen Plugin ile sevk edilen yönetilen Codex ikilisini başlatır:

codex app-server --listen stdio://

Bu, app-server sürümünü yerelde kurulmuş olabilecek ayrı Codex CLI yerine birlikte gelen codex Plugin ile bağlantılı tutar. appServer.command değerini yalnızca kasıtlı olarak farklı bir yürütülebilir dosya çalıştırmak istediğinizde ayarlayın.

Zaten çalışan bir app-server için WebSocket taşımasını kullanın:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          appServer: {            transport: "websocket",            url: "ws://gateway-host:39175",            authToken: "${CODEX_APP_SERVER_TOKEN}",            requestTimeoutMs: 60000,          },        },      },    },  },}

Desteklenen appServer alanları:

appServer.networkProxy açıktır çünkü Codex sandbox sözleşmesini değiştirir. Etkinleştirildiğinde OpenClaw, oluşturulan izin profilinin Codex tarafından yönetilen ağı başlatabilmesi için Codex iş parçacığı yapılandırmasında features.network_proxy.enabled ve default_permissions değerlerini de ayarlar. Varsayılan olarak OpenClaw, profil gövdesinden çakışmaya dayanıklı bir openclaw-network-<fingerprint> profil adı oluşturur; profileName değerini yalnızca kararlı bir yerel ad gerektiğinde kullanın.

export default {  plugins: {    entries: {      codex: {        config: {          appServer: {            sandbox: "workspace-write",            networkProxy: {              enabled: true,              domains: {                "api.openai.com": "allow",                "blocked.example.com": "deny",              },              allowUpstreamProxy: true,              proxyUrl: "http://127.0.0.1:3128",            },          },        },      },    },  },};

Normal app-server çalışma zamanı danger-full-access olacaksa, networkProxy etkinleştirildiğinde oluşturulan izin profili için workspace tarzı dosya sistemi erişimi kullanılır. Codex tarafından yönetilen ağ uygulaması sandbox'lı ağdır, bu nedenle tam erişimli bir profil giden trafiği korumaz.

Plugin, eski veya sürümlendirilmemiş app-server el sıkışmalarını engeller. Codex app-server, kararlı sürüm olarak 0.125.0 veya daha yenisini bildirmelidir.

OpenClaw, loopback olmayan WebSocket app-server URL'lerini uzak olarak ele alır ve appServer.authToken ya da bir Authorization üstbilgisi üzerinden kimlik taşıyan WebSocket kimlik doğrulaması gerektirir. appServer.authToken ve her appServer.headers.* değeri bir SecretInput olabilir; secrets çalışma zamanı, OpenClaw app-server başlatma seçeneklerini oluşturmadan önce SecretRefs ve env kısaltmasını çözer; çözümlenmemiş yapılandırılmış SecretRefs, herhangi bir token veya üstbilgi gönderilmeden önce başarısız olur. Yerel Codex pluginleri yapılandırıldığında, OpenClaw bu pluginleri yüklemek veya yenilemek için bağlı app-server'ın plugin kontrol düzlemini kullanır ve ardından plugin tarafından sahip olunan uygulamaların Codex iş parçacığında görünmesi için uygulama envanterini yeniler. app/list halen yetkili envanter ve meta veri kaynağıdır, ancak OpenClaw ilkesi, Codex şu anda devre dışı olarak işaretlese bile listelenen erişilebilir bir uygulama için thread/start'ın config.apps[appId].enabled = true gönderip göndermeyeceğine karar verir. Bilinmeyen veya eksik uygulama kimlikleri kapalı başarısız kalır; bu yol yalnızca marketplace pluginlerini plugin/install üzerinden etkinleştirir ve envanteri yeniler. OpenClaw'ı yalnızca OpenClaw tarafından yönetilen plugin yüklemelerini ve uygulama envanteri yenilemelerini kabul edeceğine güvenilen uzak app-server'lara bağlayın.

Onay ve sandbox modları

Yerel stdio app-server oturumları varsayılan olarak YOLO moduna geçer: approvalPolicy: "never", approvalsReviewer: "user" ve sandbox: "danger-full-access". Bu güvenilir yerel operatör duruşu, gözetimsiz OpenClaw dönüşlerinin ve Heartbeat'lerin, yanıtlayacak kimsenin olmadığı yerel onay istemleri olmadan ilerlemesini sağlar.

Codex'in yerel sistem gereksinimleri dosyası örtük YOLO onayına, gözden geçirene veya sandbox değerlerine izin vermiyorsa, OpenClaw örtük varsayılanı bunun yerine guardian olarak ele alır ve izin verilen guardian izinlerini seçer. tools.exec.mode: "auto" ayrıca guardian tarafından gözden geçirilen Codex onaylarını zorunlu kılar ve güvenli olmayan eski approvalPolicy: "never" veya sandbox: "danger-full-access" geçersiz kılmalarını korumaz; bilinçli bir onaysız duruş için tools.exec.mode: "full" ayarlayın. Aynı gereksinimler dosyasındaki ana makine adıyla eşleşen [[remote_sandbox_config]] girdileri, sandbox varsayılan kararında dikkate alınır.

Codex guardian tarafından gözden geçirilen onaylar için appServer.mode: "guardian" ayarlayın:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          appServer: {            mode: "guardian",            serviceTier: "priority",          },        },      },    },  },}

guardian ön ayarı, bu değerlere izin verildiğinde approvalPolicy: "on-request", approvalsReviewer: "auto_review" ve sandbox: "workspace-write" olarak genişler. Tekil ilke alanları mode değerini geçersiz kılar. Eski guardian_subagent gözden geçiren değeri hâlâ uyumluluk takma adı olarak kabul edilir, ancak yeni yapılandırmalar auto_review kullanmalıdır.

Bir OpenClaw sandbox'ı etkinken, yerel Codex app-server süreci yine de Gateway ana makinesinde çalışır. Bu nedenle OpenClaw, Codex ana makine tarafı sandbox'ını OpenClaw sandbox arka ucu ile eşdeğer kabul etmek yerine, o dönüş için Codex yerel Code Mode'u, kullanıcı MCP sunucularını ve uygulama destekli plugin yürütmesini devre dışı bırakır. Kabuk erişimi, normal exec/process araçları kullanılabilir olduğunda sandbox_exec ve sandbox_process gibi OpenClaw sandbox destekli dinamik araçlar üzerinden sunulur.

Ubuntu/AppArmor ana makinelerinde, etkin OpenClaw sandbox'ı olmadan yerel Codex workspace-write çalıştırmayı bilinçli olarak kullandığınızda, Codex bwrap kabuk komutu başlamadan önce workspace-write altında başarısız olabilir. bwrap: setting up uid map: Permission denied veya bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted görürseniz, daha geniş Docker container ayrıcalıkları vermek yerine openclaw doctor çalıştırın ve OpenClaw hizmet kullanıcısı için bildirilen ana makine namespace ilkesini düzeltin. Hizmet süreci için kapsamlı bir AppArmor profili tercih edin; kernel.apparmor_restrict_unprivileged_userns=0 fallback'i ana makine genelindedir ve güvenlik ödünleşimleri vardır.

Sandbox'lı yerel yürütme

Kararlı varsayılan kapalı başarısızdır: etkin OpenClaw sandbox'ı, aksi halde Codex app-server ana makinesinden çalışacak yerel Codex yürütme yüzeylerini devre dışı bırakır. Codex'in uzak ortam desteğini OpenClaw'ın sandbox arka ucuyla denemek istediğinizde yalnızca appServer.experimental.sandboxExecServer: true kullanın. Bu önizleme yolu Codex app-server 0.132.0 veya daha yenisini gerektirir.

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          appServer: {            experimental: {              sandboxExecServer: true,            },          },        },      },    },  },}

Bayrak açıkken ve geçerli OpenClaw oturumu sandbox'lıyken, OpenClaw etkin sandbox tarafından desteklenen bir local loopback exec-server başlatır, bunu Codex app-server'a kaydeder ve Codex iş parçacığını ve dönüşünü OpenClaw'a ait bu ortamla başlatır. App-server ortamı kaydedemezse, çalışma sessizce ana makine yürütmesine fallback yapmak yerine kapalı başarısız olur.

Bu önizleme yolu yalnızca yereldir. Uzak bir WebSocket app-server, aynı ana makinede çalışmadığı sürece loopback exec-server'a erişemez; bu nedenle OpenClaw bu birleşimi reddeder.

Kimlik doğrulama ve ortam yalıtımı

Varsayılan ajan başına home içinde kimlik doğrulama şu sırayla seçilir:

1. Ajan için açık bir OpenClaw Codex kimlik doğrulama profili.
2. O ajanın Codex home'u içindeki app-server'ın mevcut hesabı.
3. Yalnızca yerel stdio app-server başlatmaları için, app-server hesabı yoksa ve OpenAI kimlik doğrulaması hâlâ gerekiyorsa CODEX_API_KEY, ardından OPENAI_API_KEY.

OpenClaw bir ChatGPT abonelik tarzı Codex kimlik doğrulama profili gördüğünde, başlatılan Codex alt sürecinden CODEX_API_KEY ve OPENAI_API_KEY değerlerini kaldırır. Bu, Gateway düzeyi API anahtarlarını embeddings veya doğrudan OpenAI modelleri için kullanılabilir tutarken yerel Codex app-server dönüşlerinin yanlışlıkla API üzerinden faturalandırılmasını önler.

Açık Codex API anahtarı profilleri ve yerel stdio env anahtarı fallback'i, miras alınan alt süreç env yerine app-server oturum açmasını kullanır. WebSocket app-server bağlantıları Gateway env API anahtarı fallback'i almaz; açık bir kimlik doğrulama profili veya uzak app-server'ın kendi hesabını kullanın.

Stdio app-server başlatmaları varsayılan olarak OpenClaw'ın süreç ortamını miras alır. OpenClaw, Codex app-server hesap köprüsüne sahiptir ve CODEX_HOME değerini o ajanın OpenClaw durumu altında ajan başına bir dizine ayarlar. Bu, Codex yapılandırmasının, hesapların, plugin cache/verisinin ve iş parçacığı durumunun operatörün kişisel ~/.codex home'undan sızmak yerine OpenClaw ajanı kapsamında kalmasını sağlar.

Yerel Codex durumunu Codex Desktop ve CLI ile paylaşmak için appServer.homeScope: "user" ayarlayın. Bu yalnızca yerel stdio modu, ayarlandığında $CODEX_HOME, aksi halde ~/.codex kullanır; yerel kimlik doğrulama, yapılandırma, pluginler ve iş parçacıkları buna dahildir. OpenClaw, app-server için kimlik doğrulama profili köprüsünü atlar. Doğrulanmış sahip dönüşleri, bu iş parçacıklarını listelemek, aramak, okumak, fork'lamak, yeniden adlandırmak, arşivlemek ve geri yüklemek için codex_threads kullanabilir. OpenClaw'da devam etmeden önce bir iş parçacığını fork'layın; bağımsız Codex süreçleri aynı iş parçacığı için eşzamanlı yazıcıları koordine etmez.

OpenClaw normal yerel app-server başlatmaları için HOME değerini yeniden yazmaz. openclaw, gh, git, bulut CLI'ları ve kabuk komutları gibi Codex tarafından çalıştırılan alt süreçler normal süreç home'unu görür ve kullanıcı home yapılandırmasını ve tokenlarını bulabilir. Codex ayrıca $HOME/.agents/skills ve $HOME/.agents/plugins/marketplace.json keşfedebilir; bu .agents keşfi bilinçli olarak operatör home'u ile paylaşılır ve yalıtılmış ~/.codex durumundan ayrıdır.

Varsayılan ajan kapsamında, OpenClaw pluginleri ve OpenClaw skill snapshot'ları hâlâ OpenClaw'ın kendi plugin registry'si ve skill loader'ı üzerinden akar; kişisel Codex ~/.codex varlıkları akmaz. Codex home'undan yalıtılmış bir OpenClaw ajanının parçası olması gereken kullanışlı Codex CLI skills veya pluginleriniz varsa, bunları açıkça envantere alın:

openclaw migrate codex --dry-runopenclaw migrate apply codex --yes

Bir dağıtım ek ortam yalıtımı gerektiriyorsa, bu değişkenleri appServer.clearEnv öğesine ekleyin:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          appServer: {            clearEnv: ["CODEX_API_KEY", "OPENAI_API_KEY"],          },        },      },    },  },}

appServer.clearEnv yalnızca başlatılan Codex app-server alt sürecini etkiler. OpenClaw yerel başlatma normalleştirmesi sırasında bu listeden CODEX_HOME ve HOME değerlerini kaldırır: CODEX_HOME seçilen ajan veya kullanıcı kapsamına işaret etmeye devam eder ve HOME, alt süreçlerin normal kullanıcı home durumunu kullanabilmesi için miras alınmış kalır.

Dinamik araçlar

Codex dinamik araçları varsayılan olarak searchable yüklemeye geçer. OpenClaw, Codex yerel workspace işlemlerini çoğaltan dinamik araçları sunmaz:

• read
• write
• edit
• apply_patch
• exec
• process
• update_plan

Mesajlaşma, medya, cron, tarayıcı, nodes, gateway, heartbeat_respond ve web_search gibi kalan OpenClaw entegrasyon araçlarının çoğu, openclaw namespace'i altında Codex araç araması üzerinden kullanılabilir. Bu, ilk model bağlamını daha küçük tutar. sessions_yield ve yalnızca message-tool kaynak yanıtları doğrudan kalır çünkü bunlar dönüş kontrol sözleşmeleridir. sessions_spawn, Codex'in yerel spawn_agent yüzeyinin birincil Codex alt ajan yüzeyi kalması için searchable kalır; açık OpenClaw veya ACP delegasyonu ise yine openclaw dinamik araç namespace'i üzerinden kullanılabilir.

codexDynamicToolsLoading: "direct" değerini yalnızca ertelenmiş dinamik araçları arayamayan özel bir Codex app-server'a bağlanırken veya tam araç yükünde hata ayıklarken ayarlayın.

Zaman aşımları

OpenClaw'a ait dinamik araç çağrıları appServer.requestTimeoutMs değerinden bağımsız olarak sınırlandırılır. Her Codex item/tool/call isteği, bu sıradaki ilk kullanılabilir zaman aşımını kullanır:

• Pozitif çağrı başına timeoutMs argümanı.
• image_generate için agents.defaults.imageGenerationModel.timeoutMs.
• Yapılandırılmış zaman aşımı olmayan image_generate için 120 saniyelik görüntü oluşturma varsayılanı.
• Medya anlama image aracı için tools.media.image.timeoutSeconds milisaniyeye dönüştürülür veya 60 saniyelik medya varsayılanı kullanılır. Görüntü anlama için bu, isteğin kendisine uygulanır ve önceki hazırlık çalışmaları tarafından azaltılmaz.
• 90 saniyelik dinamik araç varsayılanı.

Bu watchdog, dış dinamik item/tool/call bütçesidir. Sağlayıcıya özgü istek zaman aşımları bu çağrının içinde çalışır ve kendi zaman aşımı semantiklerini korur. Dinamik araç bütçeleri 600000 ms ile sınırlıdır. Zaman aşımında OpenClaw, desteklendiği yerlerde araç sinyalini iptal eder ve Codex'e başarısız bir dinamik araç yanıtı döndürür; böylece dönüş, oturumu processing durumunda bırakmak yerine devam edebilir.

Codex bir dönüşü kabul ettikten ve OpenClaw dönüş kapsamlı bir app-server isteğine yanıt verdikten sonra, harness Codex'in geçerli dönüşte ilerleme kaydetmesini ve sonunda yerel dönüşü turn/completed ile bitirmesini bekler. App-server appServer.turnCompletionIdleTimeoutMs süresince sessiz kalırsa, OpenClaw en iyi çabayla Codex dönüşünü keser, tanılama zaman aşımı kaydeder ve takip sohbet mesajlarının eski bir yerel dönüşün arkasında kuyruğa girmemesi için OpenClaw oturum şeridini serbest bırakır.

Aynı tur için çoğu terminal olmayan bildirim bu kısa izleme zamanlayıcısını devre dışı bırakır çünkü Codex turun hâlâ canlı olduğunu kanıtlamıştır. Araç devirleri daha uzun bir araç sonrası boşta kalma bütçesi kullanır: OpenClaw bir item/tool/call yanıtı döndürdükten sonra, commandExecution gibi yerel araç öğeleri tamamlandıktan sonra, ham custom_tool_call_output tamamlanmalarından sonra ve araç sonrası ham asistan ilerlemesi, ham akıl yürütme tamamlanmaları veya akıl yürütme ilerlemesinden sonra. Koruma, yapılandırıldığında appServer.postToolRawAssistantCompletionIdleTimeoutMs değerini kullanır ve aksi halde varsayılan olarak beş dakikaya ayarlanır. Aynı araç sonrası bütçesi, Codex bir sonraki geçerli tur olayını yayımlamadan önceki sessiz sentez penceresi için ilerleme izleme zamanlayıcısını da uzatır. Akıl yürütme tamamlanmaları, commentary agentMessage tamamlanmaları ve araç öncesi ham akıl yürütme veya asistan ilerlemesini otomatik bir nihai yanıt izleyebilir; bu nedenle bunlar oturum hattını hemen serbest bırakmak yerine ilerleme sonrası yanıt korumasını kullanır. Yalnızca nihai/commentary olmayan tamamlanmış agentMessage öğeleri ve araç öncesi ham asistan tamamlanmaları asistan çıktısı serbest bırakmasını kurar: Codex daha sonra turn/completed olmadan sessiz kalırsa OpenClaw en iyi çabayla yerel turu keser ve oturum hattını serbest bırakır. Asistan, araç, etkin öğe veya yan etki kanıtı olmayan tur tamamlama boşta kalma zaman aşımları dahil, yeniden oynatmaya uygun stdio uygulama sunucusu hataları yeni bir uygulama sunucusu denemesinde bir kez yeniden denenir. Güvenli olmayan zaman aşımları yine de takılmış uygulama sunucusu istemcisini emekliye ayırır ve OpenClaw oturum hattını serbest bırakır. Ayrıca eski yerel iş parçacığı bağını otomatik yeniden oynatmak yerine temizler. Tamamlama izleme zaman aşımları Codex’e özgü zaman aşımı metni gösterir: yeniden oynatmaya uygun durumlar yanıtın eksik olabileceğini söylerken, güvenli olmayan durumlar kullanıcıya yeniden denemeden önce geçerli durumu doğrulamasını söyler. Herkese açık zaman aşımı tanıları, son uygulama sunucusu bildirim yöntemi, ham asistan yanıt öğesi kimliği/türü/rolü, etkin istek/öğe sayıları ve kurulmuş izleme durumu gibi yapısal alanlar içerir. Son bildirim ham bir asistan yanıt öğesiyse, sınırlı bir asistan metni önizlemesi de içerir. Ham prompt veya araç içeriği içermezler.

Model keşfi

Varsayılan olarak Codex Plugin, kullanılabilir modeller için uygulama sunucusuna sorar. Model kullanılabilirliği Codex uygulama sunucusuna aittir; bu nedenle liste, OpenClaw paketlenen @openai/codex sürümünü yükselttiğinde veya bir dağıtım appServer.command değerini farklı bir Codex ikilisine yönlendirdiğinde değişebilir. Kullanılabilirlik hesap kapsamlı da olabilir. Bu harness ve hesap için canlı kataloğu görmek üzere çalışan bir Gateway üzerinde /codex models kullanın.

Keşif başarısız olursa veya zaman aşımına uğrarsa OpenClaw şunlar için paketlenmiş bir yedek katalog kullanır:

• GPT-5.5
• GPT-5.4 mini

Geçerli paketlenmiş harness @openai/codex 0.142.5 sürümüdür. Bu paketlenmiş uygulama sunucusuna yapılan bir model/list yoklaması şu herkese açık seçici satırlarını döndürdü:

Gizli modeller, dahili veya özelleşmiş akışlar için uygulama sunucusu kataloğu tarafından döndürülebilir, ancak bunlar normal model seçici seçenekleri değildir.

Keşfi plugins.entries.codex.config.discovery altında ayarlayın:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          discovery: {            enabled: true,            timeoutMs: 2500,          },        },      },    },  },}

Başlatmanın Codex’i yoklamasını önlemek ve yalnızca yedek kataloğu kullanmak istediğinizde keşfi devre dışı bırakın:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          discovery: {            enabled: false,          },        },      },    },  },}

Çalışma alanı bootstrap dosyaları

Codex, yerel proje dokümanı keşfi aracılığıyla AGENTS.md dosyasını kendisi işler. OpenClaw sentetik Codex proje dokümanı dosyaları yazmaz veya persona dosyaları için Codex yedek dosya adlarına bağlı değildir; çünkü Codex yedekleri yalnızca AGENTS.md eksik olduğunda uygulanır.

OpenClaw çalışma alanı eşitliği için Codex harness diğer bootstrap dosyalarını çözer. SOUL.md, IDENTITY.md, TOOLS.md ve USER.md, etkin aracı, kullanılabilir çalışma alanı rehberliğini ve kullanıcı profilini tanımladıkları için OpenClaw Codex geliştirici talimatları olarak iletilir. Kompakt OpenClaw Skills listesi, tur kapsamlı iş birliği geliştirici talimatları olarak iletilir. HEARTBEAT.md içeriği enjekte edilmez; heartbeat turları, dosya mevcut ve boş değil olduğunda dosyayı okumak için iş birliği modu işaretçisi alır. Yapılandırılmış aracı çalışma alanından gelen MEMORY.md içeriği, bu çalışma alanı için bellek araçları kullanılabilir olduğunda yerel Codex tur girdisine yapıştırılmaz; mevcut olduğunda harness, tur kapsamlı iş birliği geliştirici talimatlarına küçük bir çalışma alanı belleği işaretçisi ekler ve kalıcı bellek ilgili olduğunda Codex memory_search veya memory_get kullanmalıdır. Araçlar devre dışıysa, bellek arama kullanılamıyorsa veya etkin çalışma alanı aracı bellek çalışma alanından farklıysa, MEMORY.md normal sınırlı tur bağlamı yolunu kullanır. BOOTSTRAP.md mevcut olduğunda OpenClaw tur girdisi referans bağlamı olarak iletilir.

Ortam geçersiz kılmaları

Ortam geçersiz kılmaları yerel test için kullanılabilir kalır:

• OPENCLAW_CODEX_APP_SERVER_BIN
• OPENCLAW_CODEX_APP_SERVER_ARGS
• OPENCLAW_CODEX_APP_SERVER_MODE=yolo|guardian
• OPENCLAW_CODEX_APP_SERVER_APPROVAL_POLICY
• OPENCLAW_CODEX_APP_SERVER_SANDBOX

OPENCLAW_CODEX_APP_SERVER_BIN, appServer.command ayarlanmamış olduğunda yönetilen ikiliyi atlar.

OPENCLAW_CODEX_APP_SERVER_GUARDIAN=1 kaldırıldı. Bunun yerine plugins.entries.codex.config.appServer.mode: "guardian" kullanın veya tek seferlik yerel test için OPENCLAW_CODEX_APP_SERVER_MODE=guardian kullanın. Tekrarlanabilir dağıtımlar için yapılandırma tercih edilir; çünkü Plugin davranışını Codex harness kurulumunun geri kalanıyla aynı gözden geçirilmiş dosyada tutar.

İlgili

• Codex harness
• Codex harness çalışma zamanı
• Yerel Codex Plugin’leri
• Codex Computer Use
• OpenAI sağlayıcısı
• Yapılandırma referansı