Ana içeriğe atla
Yerel Codex plugin desteği, Codex modundaki bir OpenClaw agent’ının OpenClaw dönüşünü işleyen aynı Codex thread’i içinde Codex app-server’ın kendi app ve plugin yeteneklerini kullanmasını sağlar. OpenClaw, Codex plugin’lerini yapay codex_plugin_* OpenClaw dinamik araçlarına çevirmez. Plugin çağrıları yerel Codex transcript’inde kalır ve app destekli MCP yürütmesinin sahibi Codex app-server’dır. Bu sayfayı, temel Codex harness çalıştıktan sonra kullanın.

​
Gereksinimler

  • Seçilen OpenClaw agent runtime’ı yerel Codex harness olmalıdır.
  • plugins.entries.codex.enabled true olmalıdır.
  • plugins.entries.codex.config.codexPlugins.enabled true olmalıdır.
  • V1 yalnızca migration’ın kaynak Codex home içinde kaynak olarak kurulmuş gözlemlediği openai-curated plugin’lerini destekler.
  • Hedef Codex app-server’ın beklenen marketplace, plugin ve app envanterini görebilmesi gerekir.
codexPlugins; OpenClaw çalıştırmaları, normal OpenAI provider çalıştırmaları, ACP conversation bağlamaları veya diğer harness’lar üzerinde etkili değildir, çünkü bu yollar yerel apps config ile Codex app-server thread’leri oluşturmaz. OpenAI tarafındaki Codex erişimi, app kullanılabilirliği ve workspace app/plugin denetimleri, oturum açılmış Codex hesabından gelir. OpenAI hesabı ve admin modeli için bkz. ChatGPT planınızla Codex kullanma.

​
Hızlı başlangıç

Kaynak Codex home’dan migration’ı önizleyin: 
openclaw migrate codex --dry-run
Migration’ın yerel plugin etkinleştirmesini planlamadan önce kaynak app erişilebilirliğini denetlemesini istediğinizde katı kaynak app doğrulamasını kullanın: 
openclaw migrate codex --dry-run --verify-plugin-apps
Plan doğru göründüğünde migration’ı uygulayın: 
openclaw migrate apply codex --yes
Migration, uygun plugin’ler için açık codexPlugins girdileri yazar ve seçilen plugin’ler için Codex app-server plugin/install çağrısı yapar. Tipik bir migration uygulanmış config şöyle görünür: 
{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          codexPlugins: {
            enabled: true,
            allow_destructive_actions: true,
            plugins: {
              "google-calendar": {
                enabled: true,
                marketplaceName: "openai-curated",
                pluginName: "google-calendar",
              },
            },
          },
        },
      },
    },
  },
}
codexPlugins değiştirildikten sonra yeni Codex conversation’ları güncellenmiş app kümesini otomatik olarak alır. Geçerli conversation’ı yenilemek için /new veya /reset kullanın. Plugin etkinleştirme veya devre dışı bırakma değişiklikleri için gateway’i yeniden başlatmak gerekmez.

​
Chat’ten plugin’leri yönetin

Codex harness’ı çalıştırdığınız aynı chat’ten yapılandırılmış yerel Codex plugin’lerini incelemek veya değiştirmek istediğinizde /codex plugins kullanın: 
/codex plugins
/codex plugins list
/codex plugins disable google-calendar
/codex plugins enable google-calendar
/codex plugins, /codex plugins list için bir alias’tır. Liste çıktısı, plugins.entries.codex.config.codexPlugins.plugins içinden yapılandırılmış plugin anahtarlarını, açık/kapalı durumunu, Codex plugin adını ve marketplace’i gösterir. enable ve disable yalnızca ~/.openclaw/openclaw.json konumundaki OpenClaw config’e yazar; ~/.codex/config.toml dosyasını düzenlemez veya yeni Codex plugin’leri kurmaz. Plugin durumunu yalnızca owner veya operator.admin scope’una sahip bir gateway client değiştirebilir. Yapılandırılmış bir plugin’i etkinleştirmek, global codexPlugins.enabled anahtarını da açar. Plugin, migration auth_required döndürdüğü için devre dışı yazıldıysa, OpenClaw’da etkinleştirmeden önce app’i Codex’te yeniden yetkilendirin.

​
Yerel plugin kurulumu nasıl çalışır

Entegrasyonun üç ayrı durumu vardır:
  • Kurulu: Codex, hedef app-server runtime’ında yerel plugin bundle’a sahiptir.
  • Etkin: OpenClaw config, plugin’i Codex harness dönüşleri için kullanılabilir yapmaya isteklidir.
  • Erişilebilir: Codex app-server, plugin’in app girdilerinin etkin hesap için kullanılabilir olduğunu ve migration uygulanmış plugin kimliğine eşlenebildiğini onaylar.
Migration, kalıcı kurulum/uygunluk adımıdır. Planlama sırasında OpenClaw, kaynak Codex plugin/read ayrıntılarını okur ve kaynak Codex app-server hesap yanıtının bir ChatGPT abonelik hesabı olduğunu denetler. ChatGPT olmayan veya eksik hesap yanıtları, app destekli plugin’leri codex_subscription_required ile atlar. Varsayılan olarak migration kaynak app/list çağrısı yapmaz; hesap geçidini geçen app destekli kaynak plugin’ler, kaynak app erişilebilirlik doğrulaması olmadan planlanır ve hesap arama transport hataları codex_account_unavailable ile atlanır. --verify-plugin-apps ile migration yeni bir kaynak app/list anlık görüntüsü alır ve yerel etkinleştirmeyi planlamadan önce sahip olunan her app’in mevcut, etkin ve erişilebilir olmasını gerektirir. Bu modda, hesap arama transport hataları kaynak app envanteri geçidine düşer. Runtime app envanteri, migration sonrası hedef oturum erişilebilirlik denetimidir. Ardından Codex harness oturum kurulumu, etkin ve erişilebilir plugin app’leri için kısıtlayıcı bir thread app config hesaplar. Thread app config, OpenClaw bir Codex harness oturumu kurduğunda veya eski bir Codex thread bağlamasını değiştirdiğinde hesaplanır. Her dönüşte yeniden hesaplanmaz; bu nedenle /codex plugins enable ve /codex plugins disable yeni Codex conversation’larını etkiler. Geçerli conversation’ın güncellenmiş app kümesini alması gerektiğinde /new veya /reset kullanın.

​
V1 destek sınırı

V1 bilinçli olarak dardır:
  • Yalnızca kaynak Codex app-server envanterinde zaten kurulu olan openai-curated plugin’leri migration’a uygundur.
  • App destekli kaynak plugin’ler, migration zamanındaki abonelik geçidini geçmelidir. --verify-plugin-apps kaynak app envanteri geçidini ekler. Abonelik geçidine takılan hesaplar ve doğrulama modunda erişilemeyen, devre dışı, eksik kaynak app’ler veya kaynak app envanteri yenileme hataları, etkin config girdileri yerine atlanmış manuel öğeler olarak raporlanır. Okunamayan plugin ayrıntıları, kaynak app envanteri geçidinden önce atlanır.
  • Migration, marketplaceName ve pluginName ile açık plugin kimlikleri yazar; yerel marketplacePath cache yolları yazmaz.
  • codexPlugins.enabled global etkinleştirme anahtarıdır.
  • plugins["*"] wildcard’ı ve keyfi kurulum yetkisi veren bir config anahtarı yoktur.
  • Desteklenmeyen marketplace’ler, cache’lenmiş plugin bundle’ları, hook’lar ve Codex config dosyaları manuel inceleme için migration raporunda korunur.

​
App envanteri ve sahiplik

OpenClaw, Codex app envanterini app-server app/list üzerinden okur, bir saat cache’ler ve eski veya eksik girdileri asenkron olarak yeniler. Cache yalnızca bellektedir; CLI veya gateway yeniden başlatıldığında düşer ve OpenClaw bunu bir sonraki app/list okumasından yeniden oluşturur. Migration ve runtime ayrı cache anahtarları kullanır:
  • Kaynak migration doğrulaması, kaynak Codex home’u ve kaynak app-server başlatma seçeneklerini kullanır. Bu yalnızca --verify-plugin-apps ayarlandığında çalışır ve o planlama çalıştırması için yeni bir kaynak app/list dolaşımını zorunlu kılar.
  • Hedef runtime kurulumu, Codex thread app config’i oluştururken hedef agent’ın Codex app-server kimliğini kullanır. Plugin etkinleştirme, bu hedef cache anahtarını geçersiz kılar ve ardından plugin/install sonrasında onu zorla yeniler.
Bir plugin app’i yalnızca OpenClaw onu kararlı sahiplik üzerinden migration uygulanmış plugin’e geri eşleyebildiğinde gösterilir:
  • plugin ayrıntısından tam app id
  • bilinen MCP server adı
  • benzersiz kararlı metadata
Yalnızca görünen adla eşleşen veya belirsiz sahiplik, bir sonraki envanter yenilemesi sahipliği kanıtlayana kadar hariç tutulur.

​
Thread app config

OpenClaw, Codex thread’i için kısıtlayıcı bir config.apps patch’i enjekte eder: _default devre dışıdır ve yalnızca etkin migration uygulanmış plugin’lerin sahibi olduğu app’ler etkinleştirilir. OpenClaw, app düzeyi destructive_enabled değerini etkili global veya plugin başına allow_destructive_actions politikasından ayarlar ve Codex’in yerel app tool annotation’larından destructive tool metadata’sını uygulamasına izin verir. true, "auto" ve "ask" destructive_enabled: true olarak ayarlar; false bunu false yapar. _default app config’i open_world_enabled: false ile devre dışı bırakılır. Etkin plugin app’leri open_world_enabled: true ile yayımlanır; OpenClaw ayrı bir plugin open-world policy knob’u sunmaz ve plugin başına destructive tool-name deny list’leri tutmaz. Tool approval modu, plugin app’leri için varsayılan olarak otomatiktir; böylece destructive olmayan okuma araçları aynı thread approval UI olmadan çalışabilir. Destructive araçlar, her app’in destructive_enabled politikası tarafından denetlenmeye devam eder.

​
Destructive action policy

Destructive plugin elicitation’larına migration uygulanmış Codex plugin’leri için varsayılan olarak izin verilir; güvenli olmayan schema’lar ve belirsiz sahiplik ise yine fail closed olur:
  • Global allow_destructive_actions varsayılan olarak true olur.
  • Plugin başına allow_destructive_actions, o plugin için global politikayı geçersiz kılar.
  • Politika false olduğunda OpenClaw deterministik bir ret döndürür.
  • Politika true olduğunda OpenClaw yalnızca boolean approve field gibi bir approval response’a eşleyebildiği güvenli schema’ları otomatik kabul eder.
  • Politika "auto" olduğunda OpenClaw, destructive plugin action’larını Codex’e gösterir ancak sahipliği kanıtlanmış MCP approval elicitation’larını Codex approval response’u döndürmeden önce OpenClaw plugin approval’larına dönüştürür.
  • Politika "ask" olduğunda OpenClaw "auto" ile aynı Codex yazma/destructive gating’i kullanır, thread başlamadan önce app için kalıcı Codex araç başına approval override’larını temizler ve kalıcı approval’ların daha sonraki write-action prompt’larını bastıramaması için yalnızca tek seferlik approval veya denial sunar.
  • "ask" kullanan her kabul edilmiş app için OpenClaw, Codex’in approval elicitation’larını OpenClaw’a göndermesi amacıyla o app için Codex’in human approvals reviewer’ını seçer. Diğer app’ler ve app olmayan thread approval’ları yapılandırılmış reviewer ve politikalarını korur.
  • Eksik plugin kimliği, belirsiz sahiplik, eksik turn id, yanlış turn id veya güvenli olmayan elicitation schema’sı, prompt göstermek yerine reddeder.

​
Sorun giderme

auth_required: migration plugin’i kurdu, ancak app’lerinden birinin hâlâ authentication’a ihtiyacı var. Açık plugin girdisi, siz yeniden yetkilendirip etkinleştirene kadar devre dışı yazılır. app_inaccessible, app_disabled veya app_missing: migration plugin’i kurmadı çünkü kaynak Codex app envanteri, --verify-plugin-apps ayarlıyken sahip olunan tüm app’leri mevcut, etkin ve erişilebilir olarak göstermedi. App’i Codex’te yeniden yetkilendirin veya etkinleştirin, ardından migration’ı --verify-plugin-apps ile yeniden çalıştırın. app_inventory_unavailable: migration plugin’i kurmadı çünkü katı kaynak app doğrulaması istendi ve kaynak Codex app envanteri yenilemesi başarısız oldu. Kaynak Codex app-server erişimini düzeltin veya daha hızlı hesap geçitli planı kabul ediyorsanız --verify-plugin-apps olmadan yeniden deneyin. codex_subscription_required: migration app destekli plugin’i kurmadı çünkü kaynak Codex app-server hesabı bir ChatGPT abonelik hesabıyla oturum açmamıştı. Codex app’te abonelik auth ile oturum açın, ardından migration’ı yeniden çalıştırın. codex_account_unavailable: migration app destekli plugin’i kurmadı çünkü kaynak Codex app-server hesabı okunamadı. Kaynak Codex app-server auth’unu düzeltin veya hesap araması başarısız olduğunda uygunluğu kaynak app envanterinin belirlemesini istiyorsanız --verify-plugin-apps ile yeniden çalıştırın. marketplace_missing veya plugin_missing: hedef Codex app-server, beklenen openai-curated marketplace’i veya plugin’i göremiyor. Migration’ı hedef runtime’a karşı yeniden çalıştırın veya Codex app-server plugin durumunu inceleyin. app_inventory_missing veya app_inventory_stale: app readiness boş veya eski bir cache’ten geldi. OpenClaw asenkron yenileme zamanlar ve sahiplik ile readiness bilinene kadar plugin app’lerini hariç tutar. app_ownership_ambiguous: app envanteri yalnızca görünen ada göre eşleşti, bu yüzden app Codex thread’ine gösterilmez. Yapılandırma değişti ancak ajan Plugin öğesini göremiyor: yapılandırılmış durumu doğrulamak için /codex plugins list kullanın, ardından /new veya /reset kullanın. Mevcut Codex iş parçacığı bağlamaları, OpenClaw yeni bir harness oturumu kurana veya güncelliğini yitirmiş bir bağlamayı değiştirene kadar başladıkları uygulama yapılandırmasını korur. Yıkıcı eylem reddedilir: genel ve Plugin başına allow_destructive_actions değerlerini denetleyin. İlke true, "auto" veya "ask" olsa bile, güvenli olmayan elicitation şemaları ve belirsiz Plugin kimliği yine de kapalı varsayımla başarısız olur.

​
İlgili