Plugin guides
Codex çalışma çerçevesi
Resmî codex plugin'i, yerleşik OpenClaw koşum takımı yerine Codex
app-server üzerinden gömülü OpenAI ajan turlarını çalıştırır. Düşük seviyeli
ajan oturumunu Codex yönetir: yerel iş parçacığı sürdürme, yerel araç devamı,
yerel Compaction ve app-server yürütmesi. OpenClaw ise sohbet kanallarını,
oturum dosyalarını, model seçimini, OpenClaw dinamik araçlarını, onayları,
medya teslimini ve görünür transkript yansısını yönetmeye devam eder.
openai/gpt-5.6-sol gibi standart OpenAI model başvurularını kullanın. Eski
Codex GPT başvurularını yapılandırmayın; OpenAI ajan kimlik doğrulama sırasını
auth.order.openai altında belirleyin. Eski Codex kimlik doğrulama profili
kimlikleri ve eski Codex kimlik doğrulama sırası girdileri
openclaw doctor --fix tarafından onarılır.
Sağlayıcı/model çalışma zamanı ilkesi ayarlanmamışken veya auto iken, yalnızca openai/* öneki
bu koşum takımını hiçbir zaman seçmez. OpenAI, yalnızca istek için yazılmış
bir geçersiz kılma bulunmayan tam bir resmî HTTPS Platform Responses veya
ChatGPT Responses rotasında Codex'i örtük olarak seçebilir. Bkz.
OpenAI örtük ajan çalışma zamanı.
Platform ile ChatGPT yönlendirmesi bilinmeden önce kimlik doğrulamayı Codex
yönetiyorsa OpenClaw yine de her aday rotanın Codex uyumluluğunu bildirmesini
gerektirir. Yalnızca yerel kimlik doğrulama sahipliği bu rota denetimini hiçbir
zaman atlamaz.
Etkin bir OpenClaw korumalı alanı olmadığında OpenClaw, Codex app-server iş
parçacıklarını Codex yerel kod modu etkin şekilde başlatır (yalnızca kod modu
varsayılan olarak kapalı kalır); böylece yerel çalışma alanı/kod yetenekleri,
app-server item/tool/call köprüsü üzerinden yönlendirilen OpenClaw dinamik
araçlarıyla birlikte kullanılabilir. Etkin bir OpenClaw korumalı alanı veya
kısıtlı araç ilkesi, deneysel korumalı alan exec-server yolunu açıkça
etkinleştirmediğiniz sürece yerel kod modunu tamamen devre dışı bırakır.
Varsayılan tools.exec.host: "auto" ile ve etkin bir OpenClaw korumalı alanı
olmadığında Codex, eşleştirilmiş Node'larda komut çalıştırmak için
node_exec ve node_process araçlarını da alır. Yerel kabuk Codex app-server
ana makinesinde ve çalışma alanında kalır (varsayılan stdio dağıtımında
Gateway'e yereldir); node_exec, ada veya kimliğe göre bir Node seçer
ve OpenClaw'ın Node onay ilkesini yürürlükte tutar. Sonlu bir çalışma zamanı
izin listesi yerel Kod Modu'nu devre dışı bırakır ve turu yürütme ortamı
olmadan bırakırsa OpenClaw, bunun yerine doğrudan ve korumalı alan olmadan
yürütme için ilke filtreli exec ve process araçlarını kullanılabilir
tutar.
Codex'e özgü bu özellik, farklı bir exec girdi biçimiyle genel
OpenClaw çalıştırmaları için isteğe bağlı bir QuickJS-WASI çalışma zamanı olan
OpenClaw kod modundan ayrıdır. Daha geniş
model/sağlayıcı/çalışma zamanı ayrımı için
Ajan çalışma zamanları ile başlayın:
openai/gpt-5.6-sol model başvurusudur, codex çalışma zamanıdır;
Telegram, Discord, Slack veya başka bir kanal ise iletişim yüzeyidir.
Gereksinimler
- Resmî
@openclaw/codexplugin'i kurulu olmalıdır. Yapılandırmanız bir izin listesi kullanıyorsaplugins.allowiçinecodexekleyin. - Codex app-server
0.143.0veya daha yeni olmalıdır. Plugin varsayılan olarak uyumlu bir ikili dosyayı yönetir; dolayısıylaPATHüzerindeki bircodexkomutu normal başlatmayı etkilemez. openclaw models auth login --provider openaiüzerinden Codex kimlik doğrulaması, ajanın Codex ana dizininde önceden bulunan bir app-server hesabı veya açık bir Codex API anahtarı kimlik doğrulama profili gereklidir.
Kimlik doğrulama önceliği, ortam yalıtımı, özel app-server komutları, model keşfi ve yapılandırma alanlarının tam listesi için Codex koşum takımı başvurusuna bakın.
Hızlı başlangıç
Resmî plugin'i kurun, ardından Codex OAuth ile oturum açın:
openclaw plugins install @openclaw/codexopenclaw models auth login --provider openaicodex plugin'ini etkinleştirin ve bir OpenAI ajan modeli seçin:
{ plugins: { entries: { codex: { enabled: true, }, }, }, agents: { defaults: { model: "openai/gpt-5.6-sol", }, },}Yapılandırmanız plugins.allow kullanıyorsa codex öğesini de
buraya ekleyin:
{ plugins: { allow: ["codex"], entries: { codex: { enabled: true, }, }, },}Plugin yapılandırmasını değiştirdikten sonra Gateway'i yeniden başlatın. Bir
sohbetin zaten oturumu varsa sonraki turun koşum takımını güncel
yapılandırmadan çözümlemesi için önce /new veya
/reset çalıştırın.
İş parçacıklarını Codex Desktop ve CLI ile paylaşma
Varsayılan appServer.homeScope: "agent", her OpenClaw ajanını operatörün yerel Codex
durumundan yalıtır. Bir sahibin Codex Desktop ve Codex CLI tarafından
gösterilen aynı yerel iş parçacıklarını inceleyip yönetebilmesi için kullanıcı
Codex ana dizinini etkinleştirin:
{ plugins: { entries: { codex: { enabled: true, config: { appServer: { homeScope: "user", }, }, }, }, },}Kullanıcı ana dizini modu, yerel yönetilen bir stdio işlemini veya paylaşılan
Unix soketi aktarımını destekler. Ayarlanmışsa $CODEX_HOME, aksi
durumda ~/.codex kullanır; buna söz konusu ana dizinin yerel Codex
kimlik doğrulaması, yapılandırması, plugin'leri ve iş parçacığı deposu dahildir.
OpenClaw bu app-server'a bir OpenClaw kimlik doğrulama profili eklemez.
Sahip turları codex_threads aracını edinir: yerel iş parçacıklarını
listeleme, arama, okuma, çatallama, yeniden adlandırma, arşivleme ve geri
yükleme. Bir iş parçacığını OpenClaw'da sürdürmek için çatallayın; çatal,
mevcut OpenClaw oturumuna bağlanır ve diğer yerel Codex istemcileri tarafından
görünür kalır. Arşivleme, iş parçacığının başka bir yerde kapalı olduğunun
açıkça onaylanmasını gerektirir. Gözetim de etkinse transkript alanları ve
değişiklikler için ilgili supervision.allowRawTranscripts veya supervision.allowWriteControls
etkinleştirmesi gerekir.
Aynı iş parçacığını bağımsız yönetilen stdio App Server'lar üzerinden eşzamanlı olarak sürdürmeyin veya yazmayın. Codex, canlı yazıcıları ayrı işlemler arasında değil, tek bir App Server içinde koordine eder. Çatallama, sıradan kullanıcı ana dizini stdio oturumlarının güvenle birlikte var olmasını sağlar.
Yalnızca appServer.homeScope: "user" filo kataloğunu denetlemez. Yerel oturum keşfi
plugin etkinken etkinleştirilir; Codex'i devre dışı bırakmadan OpenClaw kenar
çubuğundan kaldırmak için sessionCatalog.enabled: false ayarını kullanın. Katalog ayrı
bir gözetim bağlantısı kullanır; açık appServer bağlantı ayarları
olmadığında sıradan koşum takımı ajan kapsamlı kalırken bu bağlantı varsayılan
olarak yönetilen kullanıcı ana dizini stdio kullanır. Açık
appServer ayarları her iki yol tarafından da dikkate alınır.
Sıradan koşum takımının da yerel durumu paylaşması gerektiğinde yukarıdaki gibi
homeScope: "user" ayarını açıkça belirleyin.
Codex oturumlarını gözetme
Aynı codex plugin'i, Gateway bilgisayarındaki ve bu özelliğin
etkinleştirildiği eşleştirilmiş Node'lardaki arşivlenmemiş Codex oturumlarını
listeleyebilir. Depolanmış veya boşta olan Gateway'e yerel bir oturum, kalıcı
durumdaki sınırlı kullanıcı ve asistan geçmişini yansıtan, modele kilitli bir
Sohbet oluşturabilir. Özel bağlaması yerel anlık görüntü, standart dal ve
sonraki turlar için gözetim bağlantısını kullanırken sıradan Codex oturumları
ajan kapsamlı kalır. İlk standart başlatma, Codex'in anlık görüntü çatalı için
döndürdüğü model ve sağlayıcıyı tam olarak kullanır. Sonraki sürdürmeler seçimi
Codex'in yerel yapılandırmasına bırakır; dış OpenClaw modeli ve geri dönüş
zinciri hiçbir zaman bunun yerini almaz. Depolanmış ve boşta olan satırlar,
başka bir çalıştırıcı bulunmadığı açıkça onaylandıktan sonra arşivlenebilir.
Etkin kaynaklar dal oluşturamaz veya arşivlenemez; mevcut gözetimli bir Sohbet
yine de açılabilir. Eşleştirilmiş Node oturumları yalnızca meta veri olarak
kalır.
Kurulum, dallanma kuralları, eşleştirilmiş Node sınırları, meta veri gösterimi ve sorun giderme için Codex oturumlarını gözetme sayfasına bakın.
Yapılandırma
| Gereksinim | Ayar | Konum |
|---|---|---|
| Koşum takımını etkinleştirme | plugins.entries.codex.enabled: true |
OpenClaw yapılandırması |
| Yerel Codex oturum keşfini gizleme | plugins.entries.codex.config.sessionCatalog.enabled: false |
Codex plugin yapılandırması |
| İzin listesindeki plugin kurulumunu koruma | plugins.allow içine codex ekleyin |
OpenClaw yapılandırması |
| Uygun OpenAI turlarının Codex'i örtük kullanmasına izin verme | Tam resmî HTTPS Responses/ChatGPT rotası, istek için yazılmış geçersiz kılma yok, çalışma zamanı ayarlanmamış/auto |
OpenAI sağlayıcı/model yapılandırması |
| ChatGPT/Codex OAuth ile oturum açma | openclaw models auth login --provider openai |
CLI kimlik doğrulama profili |
| Codex çalıştırmaları için API anahtarı yedeği ekleme | auth.order.openai içinde abonelik kimlik doğrulamasından sonra listelenen openai:* API anahtarı profili |
CLI kimlik doğrulama profili + OpenClaw yapılandırması |
| Codex kullanılamadığında kapalı durumda başarısız olma | Sağlayıcı veya model agentRuntime.id: "codex" |
OpenClaw model/sağlayıcı yapılandırması |
| Doğrudan OpenAI API trafiği kullanma | Normal OpenAI kimlik doğrulamasıyla sağlayıcı veya model agentRuntime.id: "openclaw" |
OpenClaw model/sağlayıcı yapılandırması |
| App-server davranışını ayarlama | plugins.entries.codex.config.appServer.* |
Codex plugin yapılandırması |
| Yerel Codex plugin uygulamalarını etkinleştirme | plugins.entries.codex.config.codexPlugins.* |
Codex plugin yapılandırması |
| Codex Computer Use'ı etkinleştirme | plugins.entries.codex.config.computerUse.* |
Codex plugin yapılandırması |
Abonelik öncelikli/API anahtarı yedekli sıralama için
auth.order.openai tercih edin. Mevcut eski Codex kimlik doğrulama profili
kimlikleri ve eski Codex kimlik doğrulama sırası yalnızca doctor tarafından
işlenen eski durumdur; yeni eski Codex GPT başvuruları yazmayın.
{ auth: { order: { openai: ["openai:[email protected]", "openai:api-key-backup"], }, },}Codex uyumlu etkin bir rota için yukarıdaki her iki profil de aynı Codex çalıştırması için aday olmaya devam eder. Profil sırası çalışma zamanını değil, kimlik bilgilerini seçer. Kimlik doğrulama sırasını değiştirmek özel, Completions, HTTP veya isteğin geçersiz kıldığı bir rotayı Codex uyumlu hâle getirmez.
Compaction
Codex destekli ajanlarda compaction.model veya compaction.provider
ayarlamayın. Codex, yerel app-server iş parçacığı durumu üzerinden Compaction
uygular; bu nedenle OpenClaw çalışma zamanında bu yerel özetleyici geçersiz
kılmalarını yok sayar ve ajan Codex kullandığında openclaw doctor --fix bunları
kaldırır.
Lossless, Codex turları çevresindeki birleştirme, veri alımı ve bakım için bir
bağlam motoru olarak desteklenmeye devam eder ve agents.defaults.compaction.provider üzerinden
değil, plugins.slots.contextEngine: "lossless-claw" ve plugins.entries.lossless-claw.config.summaryModel üzerinden yapılandırılır.
Codex etkin çalışma zamanı olduğunda openclaw doctor --fix, eski
compaction.provider: "lossless-claw" biçimini Lossless bağlam motoru yuvasına taşır; ancak
Compaction'ı yine de yerel Codex yönetir. Yerel app-server koşum takımı,
istem öncesi birleştirme gerektiren bağlam motorlarını destekler;
codex-cli dahil genel CLI arka uçları bu ana makine yeteneğini
sağlamaz.
Codex destekli ajanlarda /compact, bağlı iş parçacığında yerel Codex
app-server Compaction işlemini başlatır. OpenClaw tamamlanmasını beklemez, bir
OpenClaw zaman aşımı uygulamaz, paylaşılan app-server'ı yeniden başlatmaz veya
bir bağlam motoruna ya da herkese açık OpenAI özetleyicisine geri dönmez.
Yerel Codex iş parçacığı bağlaması eksik veya eskiyse komut, Compaction arka
uçlarını sessizce değiştirmek yerine kapalı durumda başarısız olur.
Bu sayfanın geri kalanı dağıtım biçimini, kapalı durumda başarısız olan yönlendirmeyi, koruyucu onay ilkesini, yerel Codex plugin'lerini ve Computer Use'ı ele alır. Seçeneklerin tam listesi, varsayılanlar, numaralandırmalar, keşif, ortam yalıtımı, zaman aşımları ve app-server aktarım alanları için Codex koşum takımı başvurusuna bakın.
Codex çalışma zamanını doğrulama
Codex'i beklediğiniz sohbette /status kullanın. Codex destekli bir OpenAI
ajan turu şunu gösterir:
Çalışma zamanı: OpenAI CodexArdından Codex app-server durumunu kontrol edin:
/codex status/codex models/codex status; app-server bağlantısını, hesabı, hız sınırlarını, MCP
sunucularını ve becerileri bildirir. /codex models, harness ve hesap için
canlı Codex app-server kataloğunu listeler. /status beklenmedikse
Sorun giderme bölümüne bakın.
Yönlendirme ve model seçimi
Sağlayıcı referanslarını ve çalışma zamanı politikasını ayrı tutun:
- Standart OpenAI model seçimi için
openai/gpt-*kullanın. Önek tek başına hiçbir zaman Codex'i seçmez. - Çalışma zamanı ayarlanmamışken veya
autoolduğunda, yalnızca yazılmış bir istek geçersiz kılmasına sahip olmayan tam bir resmî HTTPS Platform Responses veya ChatGPT Responses rotası Codex'i örtük olarak seçebilir. - Yapılandırmada eski Codex GPT referanslarını kullanmayın; eski referansları ve güncelliğini yitirmiş oturum rota sabitlemelerini
onarmak için
openclaw doctor --fixçalıştırın. agentRuntime.id: "codex", uyumlu bir rota için Codex'i hata durumunda kapalı bir gereklilik hâline getirir. Uyumsuz bir etkin rotayı uyumlu hâle getirmez.agentRuntime.id: "openclaw", kasıtlı olduğunda bir sağlayıcıyı veya modeli gömülü OpenClaw çalışma zamanına dahil eder./codex ..., sohbetten yerel Codex app-server konuşmalarını denetler.- ACP/acpx, ayrı bir haricî harness yoludur. Yalnızca kullanıcı ACP/acpx veya haricî bir harness bağdaştırıcısı istediğinde kullanın.
| Kullanıcı amacı | Kullanılacak |
|---|---|
| Geçerli sohbeti bağlamak | /codex bind [thread-id] [--cwd <path>] [--model <model>] [--provider <provider>] |
| Mevcut bir Codex iş parçacığını sürdürmek | /codex resume <thread-id> |
| Codex iş parçacıklarını listelemek veya filtrelemek | /codex threads [filter] |
| Yerel Codex pluginlerini listelemek | /codex plugins list |
| Yapılandırılmış bir yerel Codex pluginini etkinleştirmek veya devre dışı bırakmak | /codex plugins enable <name>, /codex plugins disable <name> |
| Saklanan bir Codex CLI oturumunu eşleştirilmiş Node turu olarak sürdürmek | /codex sessions --host <node> [filter], ardından /codex resume <session-id> --host <node> --bind here |
| Bilgisayarlar arasındaki arşivlenmemiş Codex oturumlarını görüntülemek | Codex denetimini etkinleştirin ve Codex Oturumları bölümünü açın |
| Bağlı iş parçacığının modelini, hızlı modunu veya izinlerini değiştirmek | /codex model <model>, /codex fast [on|off|status], /codex permissions [default|yolo|status] |
| Etkin turu durdurmak veya yönlendirmek | /codex stop, /codex steer <text> |
| Geçerli bağlamayı ayırmak | /codex detach (/codex unbind diğer adıyla) |
| Yalnızca Codex geri bildirimi göndermek | /codex diagnostics [note] |
| Bir ACP/acpx görevi başlatmak | /codex değil, ACP/acpx oturum komutları |
| Kullanım durumu | Yapılandırma | Doğrulama | Notlar |
|---|---|---|---|
| Yerel Codex çalışma zamanına uygun OpenAI rotası | Yazılmış istek geçersiz kılması olmayan tam resmî HTTPS Responses/ChatGPT rotası ve etkin codex plugini |
/status, Runtime: OpenAI Codex gösterir |
Çalışma zamanı ayarlanmamışken/auto olduğunda örtük yol |
| Codex kullanılamıyorsa hata durumunda kapalı kalma | Sağlayıcı veya model agentRuntime.id: "codex" |
Tur, gömülü geri dönüş yerine başarısız olur | Yalnızca Codex kullanılan dağıtımlar için kullanın |
| OpenClaw üzerinden doğrudan OpenAI API anahtarı trafiği | Sağlayıcı veya model agentRuntime.id: "openclaw" ve normal OpenAI kimlik doğrulaması |
/status, OpenClaw çalışma zamanını gösterir |
Yalnızca OpenClaw kullanımı kasıtlı olduğunda kullanın |
| Eski yapılandırma | eski Codex GPT referansları | openclaw doctor --fix bunu yeniden yazar |
Yeni yapılandırmayı bu şekilde yazmayın |
| ACP/acpx Codex bağdaştırıcısı | ACP sessions_spawn({ runtime: "acp" }) |
ACP görev/oturum durumu | Yerel Codex harness'ından ayrıdır |
agents.defaults.imageModel aynı önek ayrımını izler. Normal OpenAI rotası için
openai/gpt-*, yalnızca görüntü anlama işleminin sınırlı bir Codex
app-server turu üzerinden çalışması gerektiğinde ise codex/gpt-*
kullanın. Doctor, eski Codex GPT referanslarını openai/gpt-* olarak
yeniden yazar.
Dağıtım kalıpları
Temel Codex dağıtımı
Etkin resmî HTTPS rotası Codex'i örtük olarak seçmeye uygun bir OpenAI modeli için hızlı başlangıç yapılandırmasını kullanın:
{ plugins: { entries: { codex: { enabled: true, }, }, }, agents: { defaults: { model: "openai/gpt-5.6-sol", }, },}Karma sağlayıcılı dağıtım
Claude'u varsayılan ajan olarak tutun ve adlandırılmış bir Codex ajanı ekleyin:
{ plugins: { entries: { codex: { enabled: true, }, }, }, agents: { defaults: { model: "anthropic/claude-opus-4-6", }, list: [ { id: "main", default: true, model: "anthropic/claude-opus-4-6", }, { id: "codex", name: "Codex", model: "openai/gpt-5.6-sol", }, ], },}main ajanı normal sağlayıcı yolunu kullanır. codex ajanı, etkin OpenAI
rotası uyumlu kaldığında Codex app-server'ı kullanır; bunun hata durumunda
kapalı bir gereklilik olması gerekiyorsa açık model kapsamlı
agentRuntime.id: "codex" ekleyin.
Hata durumunda kapalı Codex dağıtımı
Uygun ve tam resmî bir HTTPS OpenAI rotası, paketlenmiş plugin kullanılabilir olduğunda Codex'e çözümlenebilir. Yazılı bir hata durumunda kapalı kuralı için açık çalışma zamanı politikası ekleyin:
{ models: { providers: { openai: { agentRuntime: { id: "codex", }, }, }, }, agents: { defaults: { model: "openai/gpt-5.6-sol", }, }, plugins: { entries: { codex: { enabled: true, }, }, },}Codex zorunlu tutulduğunda; etkin rota Codex uyumlu olarak bildirilmemişse, plugin devre dışıysa, app-server çok eskiyse veya app-server başlatılamıyorsa OpenClaw erken aşamada başarısız olur.
App-server politikası
Plugin varsayılan olarak OpenClaw'ın yönettiği Codex ikili dosyasını stdio
taşımasıyla yerel olarak başlatır. Yalnızca kasıtlı olarak farklı bir
yürütülebilir dosya çalıştırmak için appServer.command ayarlayın. WebSocket
taşımasını yalnızca başka bir yerde zaten çalışan bir app-server olduğunda
kullanın:
{ plugins: { entries: { codex: { enabled: true, config: { appServer: { transport: "websocket", url: "ws://gateway-host:39175", authToken: "${CODEX_APP_SERVER_TOKEN}", }, }, }, }, },}Yerel stdio app-server oturumları varsayılan olarak güvenilir yerel operatör
duruşunu kullanır: approvalPolicy: "never", approvalsReviewer: "user" ve
sandbox: "danger-full-access". Yerel Codex gereklilikleri bu örtük YOLO duruşuna izin
vermiyorsa OpenClaw bunun yerine izin verilen koruyucu izinlerini seçer.
Oturum için bir OpenClaw korumalı alanı etkin olduğunda OpenClaw, Codex'in
ana makine tarafındaki korumalı alanına güvenmek yerine o tur için Codex'in
yerel Code Mode özelliğini, kullanıcı MCP sunucularını ve uygulama destekli
plugin yürütmesini devre dışı bırakır. Kabuk erişimi bunun yerine normal
exec/process araçları kullanılabildiğinde sandbox_exec ve
sandbox_process gibi OpenClaw korumalı alanı destekli dinamik araçlardan
geçer.
Korumalı alandan kaçışlardan veya ek izinlerden önce Codex yerel otomatik incelemesi için normalleştirilmiş OpenClaw exec modunu kullanın:
{ tools: { exec: { mode: "auto", }, }, plugins: { entries: { codex: { enabled: true, }, }, },}Codex app-server oturumlarında tools.exec.mode: "auto", Codex Guardian tarafından
incelenen onaylarla eşleşir: yerel gereklilikler bu değerlere izin verdiğinde
genellikle approvalPolicy: "on-request", approvalsReviewer: "auto_review" ve
sandbox: "workspace-write". tools.exec.mode: "auto" modunda OpenClaw, eski ve güvenli
olmayan Codex approvalPolicy: "never" veya sandbox: "danger-full-access" geçersiz
kılmalarını korumaz; kasıtlı bir onaysız Codex duruşu için
tools.exec.mode: "full" kullanın. Eski plugins.entries.codex.config.appServer.mode: "guardian" ön ayarı hâlâ
çalışır, ancak tools.exec.mode: "auto" normalleştirilmiş OpenClaw yüzeyidir.
Ana makine exec onayları ve ACPX izinleriyle mod düzeyinde karşılaştırma için İzin modları bölümüne bakın. Tüm app-server alanları, kimlik doğrulama sırası, ortam yalıtımı ve zaman aşımı davranışı için Codex harness referansı bölümüne bakın.
Komutlar ve tanılama
codex plugini, OpenClaw metin komutlarını destekleyen tüm kanallarda
/codex komutunu eğik çizgi komutu olarak kaydeder.
Yerel yürütme ve denetim için bir sahip veya operator.admin Gateway
istemcisi gerekir: iş parçacıklarını bağlama veya sürdürme, turları gönderme
veya durdurma, model, hızlı mod veya izin durumunu değiştirme, sıkıştırma veya
inceleme ve bir bağlamayı ayırma. Diğer yetkili gönderenler; salt okunur
durum, yardım, hesap, model, iş parçacığı, MCP sunucusu, beceri ve bağlama
inceleme komutlarını kullanmaya devam eder.
Yaygın biçimler:
/codex status; app-server bağlantısını, modelleri, hesabı, hız sınırlarını, MCP sunucularını ve becerileri kontrol eder./codex models, canlı Codex app-server modellerini listeler./codex threads [filter], son Codex app-server iş parçacıklarını listeler./codex resume <thread-id>, geçerli OpenClaw oturumunu mevcut bir Codex iş parçacığına bağlar./codex bind [thread-id] [--cwd <path>] [--model <model>] [--provider <provider>], geçerli sohbeti bağlar./codex detach(veya/codex unbind), geçerli bağlamayı ayırır./codex binding, geçerli bağlamayı açıklar./codex stop, etkin turu durdurur;/codex steer <text>ise yönlendirir./codex model <model>,/codex fast [on|off|status]ve/codex permissions [default|yolo|status], konuşma başına durumu değiştirir./codex compact, Codex app-server'dan bağlı iş parçacığını sıkıştırmasını ister./codex review, bağlı iş parçacığı için Codex yerel incelemesini başlatır./codex diagnostics [note], bağlı iş parçacığı için Codex geri bildirimi göndermeden önce sorar./codex account, hesap ve hız sınırı durumunu gösterir./codex mcp, Codex app-server MCP sunucusu durumunu listeler./codex skills, Codex app-server becerilerini listeler./codex plugins list,/codex plugins enable <name>ve/codex plugins disable <name>, yapılandırılmış yerel Codex pluginlerini yönetir./codex computer-use [status|install], Codex Computer Use özelliğini yönetir./codex help, tam komut ağacını listeler.
Çoğu destek bildirimi için hatanın oluştuğu konuşmada /diagnostics [note] ile
başlayın. Bu, tek bir Gateway tanılama raporu oluşturur ve Codex çalışma ortamı
oturumları için ilgili Codex geri bildirim paketini göndermek üzere onay ister.
Gizlilik modeli ve grup sohbeti davranışı için
Tanılama dışa aktarımı bölümüne bakın. /codex diagnostics [note]
komutunu yalnızca tam Gateway tanılama paketi olmadan, o anda bağlı olan iş
parçacığına ait Codex geri bildirimini yüklemek istediğinizde kullanın.
Codex iş parçacıklarını yerel olarak inceleme
Sorunlu bir Codex çalışmasını incelemenin en hızlı yolu çoğunlukla yerel Codex iş parçacığını doğrudan açmaktır:
codex resume <thread-id>İş parçacığı kimliğini tamamlanan /diagnostics yanıtından, /codex binding
veya /codex threads [filter] üzerinden alın.
Yükleme işleyişi ve çalışma zamanı düzeyindeki tanılama sınırları için Codex çalışma ortamı çalışma zamanı bölümüne bakın.
Kimlik doğrulama sırası
Varsayılan aracı başına ana dizinde kimlik doğrulama şu sırayla seçilir:
- Aracı için sıralanmış OpenAI kimlik doğrulama profilleri; tercihen
auth.order.openaialtında. Eski Codex kimlik doğrulama profili kimliklerini ve eski Codex kimlik doğrulama sırasını taşımak içinopenclaw doctor --fixkomutunu çalıştırın. - Uygulama sunucusunun, söz konusu aracının Codex ana dizinindeki mevcut hesabı.
- Yalnızca yerel stdio uygulama sunucusu başlatmaları için, uygulama sunucusu
hesabı yoksa ve OpenAI kimlik doğrulaması hâlâ gerekiyorsa önce
CODEX_API_KEY, ardındanOPENAI_API_KEY.
OpenClaw, ChatGPT aboneliği türünde bir Codex kimlik doğrulama profili
gördüğünde başlatılan alt Codex işleminden CODEX_API_KEY ve
OPENAI_API_KEY değerlerini kaldırır. Bu, Gateway düzeyindeki API anahtarlarını
gömmeler veya doğrudan OpenAI modelleri için kullanılabilir tutarken yerel
Codex uygulama sunucusu dönüşlerinin yanlışlıkla API üzerinden
ücretlendirilmesini önler. Açık Codex API anahtarı profilleri ve yerel stdio
ortam anahtarı geri dönüşü, devralınan alt işlem ortamı yerine uygulama
sunucusu oturum açma mekanizmasını kullanır. WebSocket uygulama sunucusu
bağlantıları Gateway ortamındaki API anahtarı geri dönüşünü almaz; açık bir
kimlik doğrulama profili veya uzak uygulama sunucusunun kendi hesabını kullanın.
Bir abonelik profili Codex kullanım sınırına ulaşırsa OpenClaw, Codex bir
sıfırlama zamanı bildirdiğinde bunu kaydeder ve aynı Codex çalışması için
sıradaki kimlik doğrulama profilini dener. Sıfırlama zamanı geçtiğinde abonelik
profili, seçili openai/gpt-* modeli veya Codex çalışma zamanı
değiştirilmeden yeniden kullanılabilir hâle gelir.
Yerel Codex plugin'leri yapılandırıldığında OpenClaw, plugin'e ait uygulamaları
Codex iş parçacığına sunmadan önce bu plugin'leri bağlı uygulama sunucusu
üzerinden kurar veya yeniler. app/list, uygulama kimlikleri,
erişilebilirlik ve meta veriler için doğruluk kaynağı olmaya devam eder; ancak
iş parçacığı başına etkinleştirme kararının sahibi OpenClaw'dur: ilke,
listelenen erişilebilir bir uygulamaya izin veriyorsa app/list o
uygulamanın şu anda devre dışı olduğunu bildirse bile OpenClaw
thread/start.config.apps[appId].enabled = true gönderir. Bu yol, bilinmeyen kimlikler için uygulama
kurulumu oluşturmaz; OpenClaw yalnızca plugin/install içeren pazar yeri
plugin'lerini etkinleştirir ve ardından envanteri yeniler.
Ortam yalıtımı
OpenClaw, yerel stdio uygulama sunucusu başlatmalarında CODEX_HOME
değerini aracı başına bir dizine ayarlar; böylece Codex yapılandırması,
kimlik doğrulama/hesap dosyaları, plugin önbelleği/verileri ve yerel iş parçacığı
durumu varsayılan olarak operatörün kişisel ~/.codex konumunu
okumaz veya bu konuma yazmaz. OpenClaw normal işlem HOME
değerini korur; Codex çalışması alt işlemleri kullanıcı ana dizini
yapılandırmasını ve belirteçlerini bulmaya devam edebilir ve Codex, paylaşılan
$HOME/.agents/skills ve $HOME/.agents/plugins/marketplace.json girdilerini keşfedebilir.
appServer.homeScope: "user" kullanıldığında OpenClaw bunun yerine yerel kullanıcı Codex
ana dizinini ve mevcut hesabını, bir OpenClaw kimlik doğrulama profili
eklemeden kullanır.
Bir dağıtım ek ortam yalıtımı gerektiriyorsa bu değişkenleri
appServer.clearEnv alanına ekleyin:
{ plugins: { entries: { codex: { enabled: true, config: { appServer: { clearEnv: ["CODEX_API_KEY", "OPENAI_API_KEY"], }, }, }, }, },}appServer.clearEnv yalnızca başlatılan Codex uygulama sunucusu alt işlemini
etkiler. OpenClaw, yerel başlatma normalleştirmesi sırasında
CODEX_HOME ve HOME değerlerini bu listeden kaldırır:
CODEX_HOME seçili aracı veya kullanıcı kapsamını göstermeye devam
eder ve alt işlemlerin normal kullanıcı ana dizini durumunu kullanabilmesi
için HOME devralınmaya devam eder.
Dinamik araçlar ve web araması
Codex dinamik araçları varsayılan olarak searchable yüklemesini
kullanır. OpenClaw normalde Codex'in yerel çalışma alanı işlemlerini yineleyen
dinamik araçları sunmaz: read, write,
edit, apply_patch, exec,
process, update_plan, tool_call,
tool_describe, tool_search ve tool_search_code. Mesajlaşma,
medya, cron, tarayıcı, node'lar, Gateway ve heartbeat_respond gibi kalan
OpenClaw entegrasyon araçlarının çoğu, ilk model bağlamını daha küçük tutmak
için openclaw ad alanı altındaki Codex araç araması üzerinden
kullanılabilir. Kısıtlı dönüş kabuk geri dönüşü; sonlu bir izin listesi yerel
Code Mode'u devre dışı bıraktığında exec ve
process için istisnadır; çalışma zamanı izin listeleri ve
codexDynamicToolsExclude yine geçerlidir.
OpenClaw computer aracı dâhil olmak üzere catalogMode: "direct-only"
olarak işaretlenen araçlar bunun yerine openclaw_direct ad alanını
kullanır. Codex bu ad alanını DirectModelOnly olarak değerlendirir; böylece
bu araçlar, iç içe Code Mode tools.* çağrılarından geçmek yerine
normal ve yalnızca kod modu iş parçacıklarında model tarafından doğrudan
görülebilir kalır.
Arama etkinleştirildiğinde ve yönetilen bir sağlayıcı seçilmediğinde web
araması varsayılan olarak Codex'in barındırılan web_search aracını
kullanır. Yönetilen aramanın yerel etki alanı kısıtlamalarını aşamaması için
yerel barındırılan arama ile OpenClaw'un yönetilen web_search dinamik
aracı birbirini dışlar. OpenClaw; barındırılan arama kullanılamadığında, açıkça
devre dışı bırakıldığında veya seçili bir yönetilen sağlayıcıyla
değiştirildiğinde yönetilen aracı kullanır. OpenClaw, üretim uygulama sunucusu
trafiği kullanıcı tanımlı web ad alanını reddettiği için
Codex'in bağımsız web.run uzantısını devre dışı tutar.
tools.web.search.enabled: false, araçların devre dışı olduğu yalnızca LLM çalışmalarında
olduğu gibi her iki yolu da devre dışı bırakır. Codex, "cached"
değerini bir tercih olarak değerlendirir ve bunu kısıtlanmamış uygulama
sunucusu dönüşleri için canlı harici erişime çözümler. İzin listesinin
aşılamaması için yerel allowedDomains ayarlandığında otomatik yönetilen
geri dönüş kapalı şekilde başarısız olur. Kalıcı etkin arama ilkesi
değişiklikleri, sonraki dönüşten önce bağlı Codex iş parçacığını değiştirir;
dönüş başına geçici kısıtlamalar ise geçici bir kısıtlı iş parçacığı kullanır
ve daha sonra sürdürmek üzere mevcut bağlamayı korur.
sessions_yield ve yalnızca mesaj aracı kaynaklı yanıtlar, bunlar dönüş
denetimi sözleşmeleri olduğu için doğrudan kalır. sessions_spawn
aranabilir kalır; böylece Codex'in yerel spawn_agent özelliği birincil
Codex alt aracı yüzeyi olmaya devam ederken açık OpenClaw veya ACP
yetkilendirmesi openclaw dinamik araç ad alanı üzerinden yine
kullanılabilir. Heartbeat iş birliği talimatları, araç henüz yüklenmemişse
Codex'e bir heartbeat dönüşünü sonlandırmadan önce heartbeat_respond
aramasını söyler.
codexDynamicToolsLoading: "direct" değerini yalnızca ertelenmiş dinamik araçlarda arama
yapamayan özel bir Codex uygulama sunucusuna bağlanırken veya tam araç yükünde
hata ayıklarken ayarlayın.
Yapılandırma alanları
Desteklenen üst düzey Codex plugin alanları:
| Alan | Varsayılan | Anlamı |
|---|---|---|
codexDynamicToolsLoading |
"searchable" |
OpenClaw dinamik araçlarını doğrudan ilk Codex araç bağlamına koymak için "direct" kullanın. |
codexDynamicToolsExclude |
[] |
Codex uygulama sunucusu dönüşlerinde atlanacak ek OpenClaw dinamik araç adları. |
codexPlugins |
devre dışı | Taşınmış, kaynaktan kurulmuş seçkili plugin'ler için yerel Codex plugin/uygulama desteği. |
sessionCatalog |
etkin | Bu Gateway ve uygun eşleştirilmiş node'larda yerel Codex oturumları için kenar çubuğu keşfi. |
supervision |
devre dışı | Aracıya yönelik yerel oturum transkripti ve yazma denetimi ilkesi. |
Desteklenen appServer alanları:
| Alan | Varsayılan | Anlamı |
|---|---|---|
transport |
"stdio" |
"stdio" Codex'i başlatır; açıkça belirtilen "unix" yerel denetim soketine bağlanır; "websocket", url hedefine bağlanır. |
homeScope |
"agent" |
"agent", sıradan donanım durumu verilerini OpenClaw aracısına göre yalıtır. "user", yerel $CODEX_HOME veya ~/.codex öğesini paylaşan, yerel kimlik doğrulamayı kullanan ve yalnızca sahibin iş parçacığı yönetimine izin veren açık bir katılım seçeneğidir. Kullanıcı kapsamı, yerel standart G/Ç veya Unix aktarımını destekler. Ayrı gözetim bağlantısında ayarlanmamış bir değer, standart G/Ç ya da Unix için "user", WebSocket için "agent" olarak çözümlenir. |
command |
yönetilen Codex ikili dosyası | Standart G/Ç aktarımının yürütülebilir dosyası. Yönetilen ikili dosyayı kullanmak için ayarlamadan bırakın; yalnızca açıkça geçersiz kılmak için ayarlayın. |
args |
["app-server", "--listen", "stdio://"] |
Standart G/Ç aktarımının bağımsız değişkenleri. |
url |
ayarlanmamış | WebSocket Uygulama Sunucusu URL'si veya unix:// URL'si. Açıkça belirtilen boş bir Unix yolu, standart kullanıcı ana dizini denetim soketini seçer. |
authToken |
ayarlanmamış | WebSocket aktarımının taşıyıcı belirteci. Değişmez bir dizeyi veya ${CODEX_APP_SERVER_TOKEN} gibi bir SecretInput değerini kabul eder. |
headers |
{} |
Ek WebSocket üstbilgileri. Üstbilgi değerleri, değişmez dizeleri veya örneğin x-codex-client-session-token: "${CODEX_CLIENT_SESSION_TOKEN}" gibi SecretInput değerlerini kabul eder. |
clearEnv |
[] |
OpenClaw devralınan ortamını oluşturduktan sonra başlatılan standart G/Ç uygulama sunucusu işleminden kaldırılan ek ortam değişkeni adları. OpenClaw, yerel başlatmalar için seçilen CODEX_HOME ve devralınan HOME öğelerini korur. |
codeModeOnly |
false |
Codex'in yalnızca kod moduna özgü araç yüzeyine katılın. Sıradan OpenClaw dinamik araçları iç içe tools.* çağrıları üzerinden kullanılabilir durumda kalır; openclaw_direct araçları doğrudan modele görünür kalır. |
remoteWorkspaceRoot |
ayarlanmamış | Uzak Codex uygulama sunucusunun çalışma alanı kökü. Ayarlandığında OpenClaw, çözümlenen OpenClaw çalışma alanından yerel çalışma alanı kökünü çıkarır, bu uzak kök altında geçerli cwd son ekini korur ve Codex'e yalnızca nihai uygulama sunucusu cwd değerini gönderir. cwd, çözümlenen OpenClaw çalışma alanı kökünün dışındaysa OpenClaw, uzak uygulama sunucusuna Gateway'e yerel bir yol göndermek yerine kapalı biçimde başarısız olur. |
requestTimeoutMs |
60000 |
Uygulama sunucusu denetim düzlemi çağrılarının zaman aşımı. |
turnCompletionIdleTimeoutMs |
60000 |
OpenClaw turn/completed beklerken, Codex'in bir turu kabul etmesinden veya tur kapsamındaki bir uygulama sunucusu isteğinden sonraki sessiz süre. |
postToolRawAssistantCompletionIdleTimeoutMs |
300000 |
OpenClaw turn/completed beklerken bir araç devrinden, yerel araç tamamlanmasından, araç sonrası ham asistan ilerlemesinden, ham akıl yürütme tamamlanmasından veya akıl yürütme ilerlemesinden sonra kullanılan tamamlanma-boşta kalma ve ilerleme koruması. Araç sonrası sentezin nihai asistan yayın bütçesinden meşru olarak daha uzun süre sessiz kalabildiği güvenilir veya ağır iş yüklerinde bunu kullanın. |
mode |
yerel Codex gereksinimleri YOLO'ya izin vermediği sürece "yolo" |
YOLO veya koruyucu tarafından incelenen yürütme için ön ayar. danger-full-access, never onayı veya user inceleyicisini içermeyen yerel standart G/Ç gereksinimleri, örtük varsayılanı koruyucu yapar. |
approvalPolicy |
"never" veya izin verilen bir koruyucu onay ilkesi |
İş parçacığını başlatma/sürdürme/tur işlemlerine gönderilen yerel Codex onay ilkesi. Koruyucu varsayılanları, izin verildiğinde "on-request" seçeneğini tercih eder. |
sandbox |
"danger-full-access" veya izin verilen bir koruyucu korumalı alanı |
İş parçacığını başlatma/sürdürme işlemlerine gönderilen yerel Codex korumalı alan modu. Koruyucu varsayılanları, izin verildiğinde "workspace-write", aksi takdirde "read-only" seçeneğini tercih eder. Bir OpenClaw korumalı alanı etkin olduğunda danger-full-access turları, OpenClaw korumalı alanının çıkış ayarından türetilen ağ erişimiyle Codex workspace-write kullanır. |
approvalsReviewer |
"user" veya izin verilen bir koruyucu inceleyici |
İzin verildiğinde Codex'in yerel onay istemlerini incelemesini sağlamak için "auto_review", aksi takdirde guardian_subagent veya user kullanın. guardian_subagent eski bir takma ad olarak kalır. |
serviceTier |
ayarlanmamış | İsteğe bağlı Codex uygulama sunucusu hizmet katmanı. "priority" hızlı mod yönlendirmesini etkinleştirir, "flex" esnek işlemeyi talep eder, null geçersiz kılmayı temizler ve eski "fast", "priority" olarak kabul edilir. |
networkProxy |
devre dışı | Uygulama sunucusu komutları için Codex izin profili ağ özelliğine katılın. OpenClaw, seçilen permissions.<profile>.network yapılandırmasını tanımlar ve sandbox göndermek yerine default_permissions ile seçer. |
experimental.sandboxExecServer |
false |
Yerel Codex yürütmesinin etkin OpenClaw korumalı alanı içinde çalışabilmesi için desteklenen Codex uygulama sunucusuna OpenClaw korumalı alanı destekli bir Codex ortamı kaydeden önizleme katılım seçeneği. |
appServer.networkProxy, Codex korumalı alan
sözleşmesini değiştirdiği için açıkça belirtilir. Etkinleştirildiğinde OpenClaw, oluşturulan
izin profilinin Codex tarafından yönetilen ağ özelliğini 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; yalnızca kararlı bir yerel ad gerektiğinde profileName kullanın.
{ plugins: { entries: { codex: { config: { appServer: { sandbox: "workspace-write", networkProxy: { enabled: true, domains: { "api.openai.com": "allow", "blocked.example.com": "deny", }, unixSockets: { "/tmp/proxy.sock": "allow", "/tmp/blocked.sock": "none", }, allowUpstreamProxy: true, proxyUrl: "http://127.0.0.1:3128", }, }, }, }, }, },}Normal app-server çalışma zamanı danger-full-access olacaksa,
networkProxy seçeneğini etkinleştirmek, oluşturulan izin profili için
çalışma alanı tarzı dosya sistemi erişimini kullanır: Codex tarafından yönetilen
ağ uygulaması korumalı alan ağı olduğundan, tam erişimli bir profil giden trafiği
korumaz. Etki alanı girdileri allow veya deny;
Unix soketi girdileri ise Codex'in allow veya none
değerlerini kullanır.
Dinamik araç çağrısı 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: Codex item/tool/call istekleri varsayılan olarak
90 saniyelik bir OpenClaw gözetim zamanlayıcısı kullanır. Çağrı başına pozitif
bir timeoutMs bağımsız değişkeni, 600000 ms ile sınırlı olmak üzere
söz konusu aracın bütçesini uzatır veya kısaltır. image_generate aracı,
araç çağrısı kendi zaman aşımını sağlamadığında agents.defaults.imageGenerationModel.timeoutMs değerini;
aksi hâlde görüntü oluşturma için varsayılan 120 saniyeyi kullanır. Medya
anlama aracı image, tools.media.image.timeoutSeconds değerini veya medya için
varsayılan 60 saniyeyi kullanır; görüntü anlamada bu zaman aşımı isteğin kendisi
için geçerlidir ve önceki hazırlık çalışmaları nedeniyle azaltılmaz. Zaman aşımı
durumunda OpenClaw, desteklendiği yerlerde araç sinyalini iptal eder ve oturumu
processing durumunda bırakmak yerine turun devam edebilmesi için Codex'e
başarısız bir dinamik araç yanıtı döndürür. Bu gözetim zamanlayıcısı, 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ı anlamlarını korur.
Codex bir turu kabul ettikten ve OpenClaw tur kapsamlı bir app-server isteğine
yanıt verdikten sonra donanım, Codex'in geçerli turda ilerleme kaydetmesini ve
sonunda yerel turu turn/completed ile tamamlamasını bekler. app-server
appServer.turnCompletionIdleTimeoutMs boyunca sessiz kalırsa OpenClaw, Codex turunu elinden
geldiğince keser, tanılama amaçlı bir zaman aşımı kaydeder ve takip eden sohbet
mesajlarının eski bir yerel turun arkasında kuyruğa alınmaması için OpenClaw
oturum hattını serbest bırakır. Aynı turdaki terminal olmayan bildirimlerin çoğu,
Codex turun hâlâ etkin olduğunu kanıtladığı için bu kısa gözetim zamanlayıcısını
devre dışı bırakı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, commandExecution gibi yerel araç
öğeleri tamamlandıktan, ham custom_tool_call_output tamamlamalarından ve araç sonrası
ham asistan ilerlemesi, ham akıl yürütme tamamlamaları veya akıl yürütme
ilerlemesinden sonra. Koruma, yapılandırılmışsa appServer.postToolRawAssistantCompletionIdleTimeoutMs değerini
kullanır; aksi hâlde varsayılan olarak beş dakika kullanır. Aynı bütçe, Codex'in
bir sonraki geçerli tur olayını yayımlamasından önceki sessiz sentez penceresi
için ilerleme gözetim zamanlayıcısını da uzatır. Hız sınırı güncellemeleri gibi
genel app-server bildirimleri, tur boşta kalma ilerlemesini sıfırlamaz. Akıl
yürütme tamamlamalarını, açıklama agentMessage tamamlamalarını ve araç
öncesi ham akıl yürütme veya asistan ilerlemesini otomatik bir nihai yanıt
izleyebileceğinden bunlar oturum hattını hemen serbest bırakmak yerine ilerleme
sonrası yanıt korumasını kullanır.
Yalnızca tamamlanmış nihai/açıklama dışı agentMessage öğeleri ve araç
öncesi ham asistan tamamlamaları asistan çıktısı serbest bırakma mekanizmasını
devreye alır: Codex daha sonra turn/completed olmadan sessiz kalırsa
OpenClaw, yerel turu elinden geldiğince keser ve oturum hattını serbest bırakır.
Başka bir tur gözetimi bu serbest bırakma yarışını kazanırsa OpenClaw; etkin
yerel istek, öğe veya dinamik araç tamamlaması kalmadığında, asistan çıktısı
serbest bırakma mekanizması hâlâ en son tamamlanan öğeye ait olduğunda ve daha
sonraki bir öğe tamamlanmadığında tamamlanmış nihai asistan öğesini yine kabul
eder. Bu, turu yeniden oynatmadan tamamlanmış araç çalışmasından sonraki nihai
yanıtı koruyabilir. Kısmi asistan deltaları, önceki eski yanıtlar ve sonraki boş
tamamlamalar uygun değildir.
Asistan, araç, etkin öğe veya yan etki kanıtı bulunmayan tur tamamlama boşta kalma zaman aşımları dâhil olmak üzere yeniden oynatılması güvenli stdio app-server hataları, yeni bir app-server denemesinde bir kez yeniden denenir. Güvenli olmayan zaman aşımları yine takılı kalan app-server istemcisini kullanımdan kaldırır ve OpenClaw oturum hattını serbest bırakır; ayrıca otomatik olarak yeniden oynatmak yerine eski yerel iş parçacığı bağlamasını temizler. Tamamlama gözetimi zaman aşımları Codex'e özgü zaman aşımı metni gösterir: yeniden oynatılması güvenli durumlar yanıtın eksik olabileceğini belirtirken güvenli olmayan durumlar kullanıcıya yeniden denemeden önce mevcut durumu doğrulamasını söyler. Genel zaman aşımı tanılamaları; son app-server bildirim yöntemi, ham asistan yanıt öğesinin kimliği/türü/rolü, etkin istek/öğe sayıları ve devredeki gözetim 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 istem veya araç içeriğini içermez.
Yerel test ortamı geçersiz kılmaları
OPENCLAW_CODEX_APP_SERVER_BIN,appServer.commandayarlanmamışsa yönetilen ikili dosyayı atlar.OPENCLAW_CODEX_APP_SERVER_ARGSOPENCLAW_CODEX_APP_SERVER_MODE=yolo|guardianOPENCLAW_CODEX_APP_SERVER_APPROVAL_POLICYOPENCLAW_CODEX_APP_SERVER_SANDBOX
OPENCLAW_CODEX_APP_SERVER_GUARDIAN=1 kaldırıldı. Bunun yerine plugins.entries.codex.config.appServer.mode: "guardian" veya tek
seferlik yerel testler için OPENCLAW_CODEX_APP_SERVER_MODE=guardian kullanın. Yapılandırma, Plugin
davranışını Codex donanım kurulumunun geri kalanıyla aynı incelenmiş dosyada
tuttuğundan tekrarlanabilir dağıtımlar için tercih edilir.
Yerel Codex Plugin'leri
Yerel Codex Plugin desteği, OpenClaw donanım turuyla aynı Codex iş parçacığında
Codex app-server'ın kendi uygulama ve Plugin yeteneklerini kullanır. OpenClaw,
Codex Plugin'lerini yapay codex_plugin_* OpenClaw dinamik araçlarına
dönüştürmez.
codexPlugins yalnızca yerel Codex donanımını seçen oturumları etkiler.
Yerleşik donanım çalıştırmaları, normal OpenAI sağlayıcı çalıştırmaları, ACP
konuşma bağlamaları veya diğer donanımlar üzerinde etkisi yoktur.
Taşınmış asgari yapılandırma:
{ plugins: { entries: { codex: { enabled: true, config: { codexPlugins: { enabled: true, allow_destructive_actions: true, plugins: { "google-calendar": { enabled: true, marketplaceName: "openai-curated", pluginName: "google-calendar", }, }, }, }, }, }, },}İş parçacığı uygulama yapılandırması, OpenClaw bir Codex donanım oturumu
oluşturduğunda veya eski bir Codex iş parçacığı bağlamasını değiştirdiğinde
hesaplanır; her turda yeniden hesaplanmaz. codexPlugins değiştirildikten
sonra gelecekteki Codex donanım oturumlarının güncellenmiş uygulama kümesiyle
başlaması için /new, /reset kullanın veya Gateway'i
yeniden başlatın.
Taşıma uygunluğu, uygulama envanteri, yıkıcı eylem politikası, bilgi istemleri ve yerel Plugin tanılamaları için Yerel Codex Plugin'leri bölümüne bakın.
OpenAI tarafındaki uygulama ve Plugin erişimi, oturum açılmış Codex hesabı ve Business ile Enterprise/Edu çalışma alanlarında çalışma alanı uygulama denetimleri tarafından kontrol edilir. OpenAI'ın hesap ve çalışma alanı denetimi genel bakışı için Codex'i ChatGPT planınızla kullanma bölümüne bakın.
Bilgisayar Kullanımı
Bilgisayar Kullanımı için ayrı bir kurulum kılavuzu vardır: Codex Bilgisayar Kullanımı.
Kısaca: OpenClaw, masaüstü denetim uygulamasını paketlemez veya masaüstü
eylemlerini kendisi yürütmez. Codex app-server'ı hazırlar, computer-use
MCP sunucusunun kullanılabilir olduğunu doğrular ve ardından Codex modu
turlarında yerel MCP araç çağrılarının denetimini Codex'e bırakır.
Çalışma zamanı sınırları
Codex donanımı yalnızca düşük seviyeli gömülü aracı yürütücüsünü değiştirir.
- OpenClaw dinamik araçları desteklenir. Codex bu araçları yürütmesini OpenClaw'dan ister; dolayısıyla OpenClaw yürütme yolunda kalır.
- Codex'e özgü kabuk, yama, MCP ve yerel uygulama araçları Codex'e aittir. OpenClaw, desteklenen aktarım üzerinden seçili yerel olayları gözlemleyebilir veya engelleyebilir ancak yerel araç bağımsız değişkenlerini yeniden yazmaz.
- Yerel Compaction Codex'e aittir. OpenClaw; kanal geçmişi,
arama,
/new,/resetve gelecekteki model veya donanım geçişleri için bir transkript yansısı tutar ancak Codex Compaction'ını bir OpenClaw veya bağlam motoru özetleyicisiyle değiştirmez. - Medya oluşturma, medya anlama, TTS, onaylar ve mesajlaşma aracı çıktısı, eşleşen OpenClaw sağlayıcı/model ayarları üzerinden devam eder.
tool_result_persist, Codex'e özgü araç sonucu kayıtlarına değil, OpenClaw'a ait transkript araç sonuçlarına uygulanır.
Kanca katmanları, desteklenen V1 yüzeyleri, yerel izin işleme, kuyruk yönlendirme, Codex geri bildirim yükleme mekanizmaları ve Compaction ayrıntıları için Codex donanım çalışma zamanı bölümüne bakın.
Sorun giderme
Codex normal bir /model sağlayıcısı olarak görünmüyor: yeni
yapılandırmalar için bu beklenen bir durumdur. Bir openai/gpt-* modeli
seçin, plugins.entries.codex.enabled seçeneğini etkinleştirin ve plugins.allow
değerinin codex değerini hariç tutup tutmadığını kontrol edin.
OpenClaw, Codex yerine yerleşik donanımı kullanıyor: etkin rotanın tam olarak
resmî bir HTTPS Platform Responses veya ChatGPT Responses rotası olduğunu,
yazılmış bir istek geçersiz kılması içermediğini ve Codex Plugin'inin kurulup
etkinleştirildiğini doğrulayın. Yalnızca openai/gpt-* ön eki yeterli
değildir. Test sırasında kesin kanıt için sağlayıcı veya model
agentRuntime.id: "codex" değerini ayarlayın; zorunlu Codex, rota veya donanım uyumsuz
olduğunda geri dönüş yapmak yerine başarısız olur.
OpenAI Codex çalışma zamanı API anahtarı yoluna geri dönüyor: modeli, çalışma zamanını, seçilen sağlayıcıyı ve hatayı gösteren, hassas verileri çıkarılmış bir Gateway alıntısı toplayın. Etkilenen iş arkadaşlarından OpenClaw ana bilgisayarlarında bu salt okunur komutu çalıştırmalarını isteyin:
( pattern='openai/gpt-5\.[45]|openai[-]codex|agentRuntime(\.id)?|harnessRuntime|Runtime: OpenAI Codex|legacy OpenAI Codex prefix|resolveSelectedOpenAIRuntimeProvider|candidateProvider[": ]+openai|status[": ]+401|Incorrect API key|No API key|api-key path|API-key path|OAuth' if ls /tmp/openclaw/openclaw-*.log >/dev/null 2>&1; then grep -E -i -n "$pattern" /tmp/openclaw/openclaw-*.log 2>/dev/null || true else journalctl --user -u openclaw-gateway --since today --no-pager 2>/dev/null \ | grep -E -i "$pattern" || true fi) | sed -E \ -e 's/(Authorization: Bearer )[A-Za-z0-9._~+\/-]+/\1[REDACTED]/Ig' \ -e 's/(Bearer )[A-Za-z0-9._~+\/-]+/\1[REDACTED]/Ig' \ -e 's/(api[_ -]?key[=: ]+)[^ ,}"]+/\1[REDACTED]/Ig' \ -e 's/(OPENAI_API_KEY[=: ]+)[^ ,}"]+/\1[REDACTED]/Ig' \ -e 's/sk-[A-Za-z0-9_-]{12,}/sk-[REDACTED]/g' \ -e 's/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/[EMAIL-REDACTED]/g' \ | tail -200Yararlı alıntılar genellikle openai/gpt-5.6-sol veya openai/gpt-5.6-luna,
Runtime: OpenAI Codex, agentRuntime.id veya harnessRuntime,
candidateProvider: "openai" ve bir 401, Incorrect API key veya
No API key sonucu içerir. Düzeltilmiş bir çalıştırma, düz OpenAI API
anahtarı hatası yerine OpenAI OAuth yolunu göstermelidir.
Eski Codex model başvuruları yapılandırmada kalıyor: openclaw doctor --fix
komutunu çalıştırın. Doctor, eski model başvurularını openai/* olarak
yeniden yazar, eski oturum ve tüm aracı kapsayan çalışma zamanı sabitlemelerini
kaldırır ve mevcut kimlik doğrulama profili geçersiz kılmalarını korur.
app-server reddediliyor: Codex app-server 0.143.0 veya daha yeni
bir sürüm kullanın. 0.143.0-alpha.2 veya 0.143.0+custom gibi aynı sürümün
ön sürümleri ya da derleme son eki içeren sürümleri reddedilir; çünkü OpenClaw,
kararlı 0.143.0 protokol alt sınırını test eder.
/codex status bağlanamıyor: codex plugininin
etkinleştirildiğini, bir izin listesi yapılandırılmışsa plugins.allow öğesinin
bu plugini içerdiğini ve tüm özel appServer.command, url, authToken veya
üst bilgilerin geçerli olduğunu denetleyin.
Model keşfi yavaş: plugins.entries.codex.config.discovery.timeoutMs değerini düşürün
veya keşfi devre dışı bırakın.
Bkz. Codex harness başvurusu.
WebSocket aktarımı hemen başarısız oluyor: appServer.url,
authToken ve üst bilgileri denetleyin; ayrıca uzaktaki app-server'ın aynı Codex
app-server protokol sürümünü kullandığından emin olun.
Yerel kabuk veya yama araçları Native hook relay unavailable ile engelleniyor: Codex iş parçacığı, OpenClaw'un artık kayıtlı
tutmadığı bir yerel hook aktarım kimliğini kullanmaya çalışmaya devam ediyor.
Bu, bir ACP arka ucu, sağlayıcı, GitHub veya kabuk komutu
hatası değil, yerel bir Codex hook aktarımı sorunudur. Etkilenen sohbette /new veya /reset ile
yeni bir oturum başlatın, ardından zararsız bir komutu yeniden deneyin. Bu bir kez çalışır ancak sonraki yerel araç
çağrısı yine başarısız olursa /new seçeneğini yalnızca geçici bir çözüm olarak değerlendirin: eski iş parçacıklarının
kaldırılması ve yerel hook kayıtlarının
yeniden oluşturulması için Codex app-server'ı veya OpenClaw Gateway'i yeniden başlattıktan sonra istemi
yeni bir oturuma kopyalayın.
Codex araç çağrıları çok fazla kısa ömürlü hook işlemi oluşturuyor: plugins.entries.codex.config.appServer.loopDetectionPreToolUseRelay: false
değerini ayarlayın
ve gateway'i yeniden başlatın. Bu, yalnızca OpenClaw döngü algılama için kullanılan Codex PreToolUse alt işlemini
ve onun ilke yok işaretçisini devre dışı bırakır. Gerekli
before_tool_call ve güvenilir araç ilkesi aktarımları etkin kalır.
Codex olmayan bir model yerleşik harness'ı kullanıyor: sağlayıcı
veya model çalışma zamanı ilkesi onu başka bir harness'a yönlendirmediği sürece bu beklenen bir durumdur. Sade, OpenAI dışı
sağlayıcı başvuruları auto modunda normal sağlayıcı yollarında kalır.
Computer Use yüklü ancak araçlar çalışmıyor: yeni bir oturumdan
/codex computer-use status öğesini denetleyin. Bir araç
Native hook relay unavailable bildirirse yukarıdaki yerel hook aktarımı kurtarma adımlarını uygulayın.
Bkz. Codex Computer Use.