Yerel Codex Plugin'leri

Yerel Codex Plugin desteği, Codex modundaki bir OpenClaw aracısının, OpenClaw turunu işleyen aynı Codex iş parçacığı içinde Codex app-server'ın kendi uygulama ve Plugin yeteneklerini kullanmasını sağlar.

OpenClaw, Codex Plugin'lerini sentetik codex_plugin_* OpenClaw dinamik araçlarına çevirmez. Plugin çağrıları yerel Codex transkriptinde kalır ve uygulama 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 aracı çalışma zamanı 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, geçişin kaynak Codex ana dizininde kaynak olarak yüklü olduğunu gözlemlediği openai-curated Plugin'lerini destekler.
• Hedef Codex app-server, beklenen marketplace, Plugin ve uygulama envanterini görebilmelidir.

codexPlugins, PI çalıştırmaları, normal OpenAI sağlayıcı çalıştırmaları, ACP konuşma bağlamaları veya diğer harness'lar üzerinde etkili değildir; çünkü bu yollar yerel apps yapılandırmasıyla Codex app-server iş parçacıkları oluşturmaz.

# Hızlı Başlangıç

Kaynak Codex ana dizininden geçişi önizleyin:

openclaw migrate codex --dry-run

Geçişin yerel Plugin etkinleştirmeyi planlamadan önce kaynak uygulama erişilebilirliğini denetlemesini istediğinizde katı kaynak uygulama doğrulaması kullanın:

openclaw migrate codex --dry-run --verify-plugin-apps

Plan doğru göründüğünde geçişi uygulayın:

openclaw migrate apply codex --yes

Geçiş, 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 geçirilmiş yapılandırma şö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, gelecekteki Codex harness oturumlarının güncellenmiş uygulama kümesiyle başlaması için /new, /reset kullanın veya Gateway'i yeniden başlatın.

# Yerel Plugin kurulumu nasıl çalışır?

Entegrasyonun üç ayrı durumu vardır:

• Yüklü: Codex, hedef app-server çalışma zamanında yerel Plugin paketine sahiptir.
• Etkin: OpenClaw yapılandırması, Plugin'i Codex harness turları için kullanılabilir yapmaya isteklidir.
• Erişilebilir: Codex app-server, Plugin'in uygulama girdilerinin etkin hesap için kullanılabilir olduğunu ve geçirilmiş Plugin kimliğine eşlenebildiğini doğrular.

Geçiş, 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ı, uygulama destekli Plugin'leri codex_subscription_required ile atlar. Varsayılan olarak geçiş kaynak app/list çağrısı yapmaz; hesap kapısından geçen uygulama destekli kaynak Plugin'ler, kaynak uygulama erişilebilirliği doğrulaması olmadan planlanır ve hesap arama taşıma hataları codex_account_unavailable ile atlanır. --verify-plugin-apps ile geçiş yeni bir kaynak app/list anlık görüntüsü alır ve yerel etkinleştirmeyi planlamadan önce sahip olunan her uygulamanın mevcut, etkin ve erişilebilir olmasını gerektirir. Bu modda hesap arama taşıma hataları kaynak uygulama envanteri kapısına düşer. Çalışma zamanı uygulama envanteri, geçişten sonraki hedef oturum erişilebilirliği denetimidir. Codex harness oturum kurulumu daha sonra etkin ve erişilebilir Plugin uygulamaları için kısıtlayıcı bir iş parçacığı uygulama yapılandırması hesaplar.

İş parçacığı uygulama yapılandırması, OpenClaw bir Codex harness oturumu kurduğunda veya bayat bir Codex iş parçacığı bağlamasını değiştirdiğinde hesaplanır. Her turda yeniden hesaplanmaz.

# V1 destek sınırı

V1 bilinçli olarak dar tutulmuştur:

• Yalnızca kaynak Codex app-server envanterinde zaten yüklü olan openai-curated Plugin'leri geçişe uygundur.
• Uygulama destekli kaynak Plugin'ler geçiş zamanı abonelik kapısından geçmelidir. --verify-plugin-apps kaynak uygulama envanteri kapısını ekler. Abonelik kapısına takılan hesaplar ve doğrulama modunda erişilemeyen, devre dışı, eksik kaynak uygulamalar veya kaynak uygulama envanteri yenileme hataları, etkin yapılandırma girdileri yerine atlanmış manuel öğeler olarak bildirilir. Okunamayan Plugin ayrıntıları kaynak uygulama envanteri kapısından önce atlanır.
• Geçiş, marketplaceName ve pluginName ile açık Plugin kimlikleri yazar; yerel marketplacePath önbellek yolları yazmaz.
• codexPlugins.enabled genel etkinleştirme anahtarıdır.
• plugins["*"] joker karakteri ve rastgele kurulum yetkisi veren bir yapılandırma anahtarı yoktur.
• Desteklenmeyen marketplace'ler, önbelleğe alınmış Plugin paketleri, hook'lar ve Codex yapılandırma dosyaları manuel inceleme için geçiş raporunda korunur.

# Uygulama envanteri ve sahiplik

OpenClaw, Codex uygulama envanterini app-server app/list üzerinden okur, bir saat boyunca önbelleğe alır ve bayat ya da eksik girdileri asenkron olarak yeniler. Önbellek yalnızca bellektedir; CLI veya Gateway yeniden başlatıldığında düşer ve OpenClaw onu sonraki app/list okumasından yeniden oluşturur.

Geçiş ve çalışma zamanı ayrı önbellek anahtarları kullanır:

• Kaynak geçiş doğrulaması, kaynak Codex ana dizinini 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 geçişini zorunlu kılar.
• Hedef çalışma zamanı kurulumu, Codex iş parçacığı uygulama yapılandırmasını oluştururken hedef aracının Codex app-server kimliğini kullanır. Plugin etkinleştirme bu hedef önbellek anahtarını geçersiz kılar ve ardından plugin/install sonrasında zorla yeniler.

Bir Plugin uygulaması yalnızca OpenClaw onu kararlı sahiplik üzerinden geçirilmiş Plugin'e geri eşleyebildiğinde açığa çıkarılır:

• Plugin ayrıntısından tam uygulama kimliği
• bilinen MCP sunucu adı
• benzersiz kararlı metadata

Yalnızca görünen ada dayalı veya belirsiz sahiplik, sonraki envanter yenilemesi sahipliği kanıtlayana kadar dışlanır.

# İş parçacığı uygulama yapılandırması

OpenClaw, Codex iş parçacığı için kısıtlayıcı bir config.apps yaması enjekte eder: _default devre dışıdır ve yalnızca etkin geçirilmiş Plugin'lerin sahip olduğu uygulamalar etkinleştirilir.

OpenClaw, uygulama düzeyi destructive_enabled değerini etkili genel veya Plugin başına allow_destructive_actions politikasından ayarlar ve Codex'in yerel uygulama aracı açıklamalarından yıkıcı araç metadata'sını uygulamasına izin verir. _default uygulama yapılandırması open_world_enabled: false ile devre dışı bırakılır. Etkin Plugin uygulamaları open_world_enabled: true ile yayılır; OpenClaw ayrı bir Plugin açık dünya politika düğmesi sunmaz ve Plugin başına yıkıcı araç adı engelleme listeleri tutmaz.

Araç onay modu, Plugin uygulamaları için varsayılan olarak otomatiktir; böylece yıkıcı olmayan okuma araçları aynı iş parçacığında onay kullanıcı arayüzü olmadan çalışabilir. Yıkıcı araçlar her uygulamanın destructive_enabled politikası tarafından denetlenmeye devam eder.

# Yıkıcı işlem politikası

Geçirilmiş Codex Plugin'leri için yıkıcı Plugin istemleri varsayılan olarak izinlidir; güvenli olmayan şemalar ve belirsiz sahiplik ise yine kapalı başarısız olur:

• Genel allow_destructive_actions varsayılan olarak true değerindedir.
• Plugin başına allow_destructive_actions, o Plugin için genel politikayı geçersiz kılar.
• Politika false olduğunda OpenClaw deterministik bir ret döndürür.
• Politika true olduğunda OpenClaw yalnızca bir onay yanıtına eşleyebildiği güvenli şemaları otomatik kabul eder; örneğin boolean approve alanı gibi.
• Eksik Plugin kimliği, belirsiz sahiplik, eksik tur kimliği, yanlış tur kimliği veya güvenli olmayan istem şeması, kullanıcıya sormak yerine reddedilir.

# Sorun giderme

auth_required: geçiş Plugin'i yükledi, ancak uygulamalarından biri hâlâ kimlik doğrulaması gerektiriyor. Açık Plugin girdisi, yeniden yetkilendirip etkinleştirene kadar devre dışı yazılır.

app_inaccessible, app_disabled veya app_missing: geçiş Plugin'i yüklemedi; çünkü kaynak Codex uygulama envanteri, --verify-plugin-apps ayarlanmışken sahip olunan tüm uygulamaları mevcut, etkin ve erişilebilir olarak göstermedi. Codex'te uygulamayı yeniden yetkilendirin veya etkinleştirin, ardından geçişi --verify-plugin-apps ile yeniden çalıştırın.

app_inventory_unavailable: geçiş Plugin'i yüklemedi; çünkü katı kaynak uygulama doğrulaması istenmişti ve kaynak Codex uygulama envanteri yenilemesi başarısız oldu. Kaynak Codex app-server erişimini düzeltin veya daha hızlı hesap kapılı planı kabul ediyorsanız --verify-plugin-apps olmadan tekrar deneyin.

codex_subscription_required: geçiş uygulama destekli Plugin'i yüklemedi; çünkü kaynak Codex app-server hesabı bir ChatGPT abonelik hesabıyla oturum açmış değildi. Codex uygulamasında abonelik kimlik doğrulamasıyla oturum açın, ardından geçişi yeniden çalıştırın.

codex_account_unavailable: geçiş uygulama destekli Plugin'i yüklemedi; çünkü kaynak Codex app-server hesabı okunamadı. Kaynak Codex app-server kimlik doğrulamasını düzeltin veya hesap araması başarısız olduğunda uygunluğu kaynak uygulama 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. Geçişi hedef çalışma zamanına karşı yeniden çalıştırın ya da Codex app-server Plugin durumunu inceleyin.

app_inventory_missing veya app_inventory_stale: uygulama hazır olma durumu boş veya bayat bir önbellekten geldi. OpenClaw asenkron bir yenileme zamanlar ve sahiplik ile hazır olma durumu bilinene kadar Plugin uygulamalarını dışlar.

app_ownership_ambiguous: uygulama envanteri yalnızca görünen adla eşleşti, bu nedenle uygulama Codex iş parçacığına açığa çıkarılmaz.

Yapılandırma değişti ancak aracı Plugin'i göremiyor: /new, /reset kullanın veya Gateway'i yeniden başlatın. Mevcut Codex iş parçacığı bağlamaları, OpenClaw yeni bir harness oturumu kurana veya bayat bir bağlamayı değiştirene kadar başladıkları uygulama yapılandırmasını korur.

Yıkıcı işlem reddediliyor: genel ve Plugin başına allow_destructive_actions değerlerini denetleyin. Politika true olduğunda bile güvenli olmayan istem şemaları ve belirsiz Plugin kimliği kapalı başarısız olur.

# İlgili

• Codex harness
• Codex harness referansı
• Codex harness çalışma zamanı
• Yapılandırma referansı
• Geçiş CLI