Natywne pluginy Codex

Natywna obsługa pluginów Codex pozwala agentowi OpenClaw działającemu w trybie Codex korzystać z własnych funkcji aplikacji i pluginów serwera aplikacji Codex w ramach tego samego wątku Codex, który obsługuje turę OpenClaw. Wywołania pluginów pozostają w natywnym transkrypcie Codex; serwer aplikacji Codex odpowiada za wykonywanie MCP oparte na aplikacjach. OpenClaw nie przekształca pluginów Codex w syntetyczne narzędzia dynamiczne OpenClaw codex_plugin_*.

Skorzystaj z tej strony, gdy podstawowy mechanizm Codex już działa.

Wymagania

• Środowiskiem uruchomieniowym agenta musi być natywny mechanizm Codex.
• plugins.entries.codex.enabled ma wartość true.
• plugins.entries.codex.config.codexPlugins.enabled ma wartość true.
• Docelowy serwer aplikacji Codex ma dostęp do oczekiwanego katalogu marketplace oraz wykazu pluginów i aplikacji.
• Migracja obsługuje tylko pluginy openai-curated, które wykryła jako zainstalowane ze źródła w źródłowym katalogu domowym Codex.
• Ręcznie skonfigurowane pluginy workspace-directory wymagają serwera aplikacji Codex, którego plugin/list akceptuje marketplaceKinds i którego bezścieżkowe podsumowania przestrzeni roboczej zawierają remotePluginId. Plugin musi być już zainstalowany i włączony, a należące do niego aplikacje muszą być dostępne w app/list.

codexPlugins nie ma wpływu na uruchomienia z dostawcą OpenClaw, powiązania konwersacji ACP ani inne mechanizmy, ponieważ te ścieżki nigdy nie tworzą wątków serwera aplikacji Codex z natywną konfiguracją apps.

Konto Codex po stronie OpenAI, dostępność aplikacji oraz mechanizmy kontroli aplikacji i pluginów w przestrzeni roboczej wynikają z zalogowanego konta Codex. Informacje o modelu kont i administracji OpenAI zawiera strona Korzystanie z Codex w ramach planu ChatGPT.

Szybki start

Wyświetl podgląd migracji ze źródłowego katalogu domowego Codex:

openclaw migrate codex --dry-run

Dodaj --verify-plugin-apps, aby podczas migracji wywołać źródłowe app/list i przed zaplanowaniem natywnej aktywacji wymagać obecności, włączenia i dostępności każdej należącej do pluginu aplikacji:

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

Zastosuj migrację, gdy plan wygląda prawidłowo:

openclaw migrate apply codex --yes

Migracja zapisuje jawne wpisy codexPlugins dla kwalifikujących się pluginów i wywołuje plugin/install serwera aplikacji Codex dla wybranych pluginów. Konfiguracja po migracji wygląda następująco:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          codexPlugins: {            enabled: true,            allow_destructive_actions: true,            plugins: {              "google-calendar": {                enabled: true,                marketplaceName: "openai-curated",                pluginName: "google-calendar",              },            },          },        },      },    },  },}

Migracja pozostaje ograniczona do openai-curated. Aby użyć istniejącego pluginu workspace-directory, dodaj go ręcznie, używając dokładnego identyfikatora summary.id z kwalifikatorem marketplace zwróconego przez plugin/list. Jeśli na przykład Codex zwróci example-plugin@workspace-directory, skonfiguruj tę pełną wartość zamiast jego nazwy wyświetlanej:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          codexPlugins: {            enabled: true,            plugins: {              "example-plugin": {                enabled: true,                marketplaceName: "workspace-directory",                pluginName: "example-plugin@workspace-directory",              },            },          },        },      },    },  },}

OpenClaw nie wywołuje plugin/install ani nie rozpoczyna uwierzytelniania pluginu workspace-directory. Zainstaluj i włącz go oraz uwierzytelnij w Codex przed dodaniem lub włączeniem zasad OpenClaw. OpenClaw pozostawia aplikacje ukryte, gdy odpowiedź nie zawiera dokładnego marketplace, identyfikatora pluginu, identyfikatora szczegółów lub dowodu gotowości aplikacji. Jeśli Codex odrzuci jawne żądanie plugin/list dla przestrzeni roboczej, OpenClaw zgłosi marketplace_missing dla każdego włączonego pluginu przestrzeni roboczej i pozostawi dostępne wszystkie niezależnie wykryte pluginy z wyselekcjonowanego katalogu.

Po zmianie codexPlugins nowe konwersacje Codex automatycznie używają zaktualizowanego zestawu aplikacji. Uruchom /new lub /reset, aby odświeżyć bieżącą konwersację. Zmiany włączenia lub wyłączenia pluginów nie wymagają ponownego uruchomienia Gateway.

Zarządzanie pluginami z poziomu czatu

/codex plugins sprawdza lub zmienia skonfigurowane natywne pluginy Codex z poziomu tego samego czatu, w którym obsługujesz mechanizm Codex:

/codex plugins/codex plugins list/codex plugins disable google-calendar/codex plugins enable google-calendar

/codex plugins jest aliasem polecenia /codex plugins list. Lista przedstawia klucz każdego skonfigurowanego pluginu, jego stan włączenia, nazwę pluginu Codex oraz marketplace z plugins.entries.codex.config.codexPlugins.plugins.

Polecenia enable/disable zapisują zmiany wyłącznie w ~/.openclaw/openclaw.json; nigdy nie modyfikują ~/.codex/config.toml ani nie instalują nowych pluginów Codex. Może je uruchamiać wyłącznie właściciel lub klient Gateway z zakresem operator.admin.

Włączenie skonfigurowanego pluginu aktywuje również globalny przełącznik codexPlugins.enabled. Jeśli plugin z wyselekcjonowanego katalogu został zapisany jako wyłączony, ponieważ migracja zwróciła auth_required, przed włączeniem go w OpenClaw ponownie autoryzuj aplikację w Codex. W przypadku wpisu workspace-directory włączenie go w tym miejscu zmienia wyłącznie zasady OpenClaw; plugin i aplikacja muszą już być aktywne w Codex.

Jak działa natywna konfiguracja pluginów

Integracja śledzi trzy stany:

W przypadku pluginów openai-curated migracja stanowi trwały etap instalacji i kwalifikacji:

• Podczas planowania OpenClaw odczytuje szczegóły ze źródłowego plugin/read Codex i sprawdza, czy konto źródłowego serwera aplikacji Codex jest kontem z subskrypcją ChatGPT. Odpowiedź wskazująca konto inne niż ChatGPT lub brak konta powoduje pominięcie pluginów opartych na aplikacjach z kodem codex_subscription_required.
• Domyślnie migracja pomija źródłowe wywołanie app/list: źródłowe pluginy oparte na aplikacjach, które przejdą kontrolę konta, są planowane bez weryfikacji dostępności aplikacji źródłowych, a błędy transportu podczas wyszukiwania konta powodują pominięcie z kodem codex_account_unavailable.
• Z opcją --verify-plugin-apps migracja pobiera świeży obraz źródłowego app/list i przed zaplanowaniem natywnej aktywacji wymaga obecności, włączenia i dostępności każdej należącej do pluginu aplikacji. Błędy transportu podczas wyszukiwania konta przechodzą wtedy do kontroli źródłowego wykazu aplikacji, zamiast powodować natychmiastowe pominięcie.

W przypadku pluginów workspace-directory konfiguracja odbywa się poza OpenClaw. OpenClaw wysyła zapytania do tego marketplace tylko wtedy, gdy skonfigurowano co najmniej jeden włączony wpis przestrzeni roboczej, rozpoznaje każdy plugin na podstawie dokładnego summary.id i ponownie wykorzystuje istniejące kontrole własności z plugin/read oraz gotowości z app/list. Plugin niezainstalowany, wyłączony, niedostępny lub nieuwierzytelniony nie udostępnia żadnych aplikacji; OpenClaw nie próbuje go instalować ani uwierzytelniać.

Wykaz aplikacji środowiska uruchomieniowego służy do sprawdzania dostępności sesji docelowej zarówno dla zmigrowanych pluginów z wyselekcjonowanego katalogu, jak i ręcznie skonfigurowanych pluginów przestrzeni roboczej. Podczas konfigurowania sesji mechanizm Codex wyznacza restrykcyjną konfigurację aplikacji wątku na podstawie włączonych i dostępnych aplikacji pluginów; nie jest ona wyznaczana ponownie przy każdej turze, dlatego /codex plugins enable/disable wpływa tylko na nowe konwersacje Codex. Aby zastosować zmianę w bieżącej konwersacji, użyj /new lub /reset.

Zakres obsługi wersji V1

• Do migracji kwalifikują się wyłącznie pluginy openai-curated, które są już zainstalowane w wykazie źródłowego serwera aplikacji Codex.
• Środowisko uruchomieniowe obsługuje również jawne wpisy workspace-directory w kompilacjach serwera aplikacji, w których plugin/list implementuje marketplaceKinds i zwraca remotePluginId dla bezścieżkowych podsumowań przestrzeni roboczej. Wpisy te muszą używać dokładnego summary.id z kwalifikatorem marketplace oraz muszą być już zainstalowane, włączone i dostępne dla aplikacji. Odrzucone żądanie listy przestrzeni roboczej powoduje wygenerowanie istniejącej diagnostyki marketplace_missing dla każdego pluginu; brak dowodu marketplace, pluginu, szczegółów lub aplikacji nie udostępnia żadnej aplikacji przestrzeni roboczej. Wykaz z wyselekcjonowanego katalogu uzyskany z domyślnego żądania listy pozostaje dostępny.
• Źródłowe pluginy oparte na aplikacjach muszą przejść kontrolę subskrypcji podczas migracji. Opcja --verify-plugin-apps dodaje kontrolę źródłowego wykazu aplikacji. Konta niespełniające wymagań subskrypcji, a w trybie weryfikacji także niedostępne, wyłączone lub brakujące aplikacje źródłowe oraz niepowodzenia odświeżania wykazu aplikacji, są zgłaszane jako pominięte elementy wymagające ręcznej obsługi zamiast włączonych wpisów konfiguracji. Nieczytelne szczegóły pluginu są pomijane przed kontrolą wykazu aplikacji.
• Migracja zapisuje jawne tożsamości pluginów (marketplaceName i pluginName); nie zapisuje lokalnych ścieżek pamięci podręcznej marketplacePath.
• codexPlugins.enabled jest jedynym globalnym przełącznikiem włączającym; nie istnieje symbol wieloznaczny plugins["*"] ani klucz konfiguracji przyznający dowolne uprawnienia do instalacji.
• Marketplace inne niż wyselekcjonowane, pakiety pluginów w pamięci podręcznej, hooki i pliki konfiguracyjne Codex są zachowywane w raporcie migracji do ręcznego przeglądu, a nie automatycznie aktywowane. Środowisko uruchomieniowe akceptuje ręcznie skonfigurowane wpisy workspace-directory; pozostałe marketplace nie są obsługiwane.

Wykaz aplikacji i własność

OpenClaw odczytuje wykaz aplikacji Codex przez app/list serwera aplikacji, przechowuje go w pamięci podręcznej przez godzinę oraz asynchronicznie odświeża nieaktualne lub brakujące wpisy. Pamięć podręczna działa lokalnie dla procesu; ponowne uruchomienie CLI lub Gateway ją usuwa, a OpenClaw odbudowuje ją przy następnym odczycie app/list.

Migracja i środowisko uruchomieniowe używają oddzielnych kluczy pamięci podręcznej:

• Weryfikacja migracji źródłowej używa źródłowego katalogu domowego Codex i opcji uruchamiania. Działa wyłącznie z opcją --verify-plugin-apps i wymusza świeże przejście źródłowego app/list dla danego przebiegu planowania.
• Konfiguracja docelowego środowiska uruchomieniowego używa tożsamości serwera aplikacji Codex docelowego agenta podczas tworzenia konfiguracji aplikacji wątku. Aktywacja pluginu z wyselekcjonowanego katalogu unieważnia ten docelowy klucz pamięci podręcznej, a następnie wymusza jego odświeżenie po plugin/install. Konfiguracja workspace-directory nigdy nie uruchamia tej ścieżki aktywacji.

Aplikacja pluginu jest udostępniana tylko wtedy, gdy OpenClaw może przypisać ją z powrotem do skonfigurowanego pluginu na podstawie stabilnej własności: dokładnego identyfikatora aplikacji ze szczegółów pluginu, znanej nazwy serwera MCP lub unikalnych stabilnych metadanych. Własność oparta wyłącznie na nazwie wyświetlanej lub niejednoznaczna jest wykluczana do czasu, gdy kolejne odświeżenie wykazu potwierdzi własność.

Aplikacje połączonego konta

Agenci obsługiwani przez właściciela mogą włączyć wszystkie aplikacje już połączone z ich kontem Codex bez wymagania odpowiadającego im pakietu pluginu:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          codexPlugins: {            enabled: true,            allow_all_plugins: true,            allow_destructive_actions: "auto",          },        },      },    },  },}

allow_all_plugins: true pobiera pełny obraz app/list podczas tworzenia nowego natywnego wątku Codex i dopuszcza wyłącznie aplikacje oznaczone jako dostępne dla danego konta. Nie instaluje, nie uwierzytelnia ani nie włącza aplikacji globalnie. Istniejące wątki zachowują utrwalony zestaw aplikacji; użyj /new, /reset lub uruchom ponownie Gateway, aby uwzględnić nowo połączone lub odwołane aplikacje.

Aplikacje konta dziedziczą globalną wartość codexPlugins.allow_destructive_actions, która akceptuje true, false, "auto" lub "ask". Jawne zasady dla poszczególnych pluginów zastępują zasady globalne dla pokrywających się identyfikatorów aplikacji. Błędy wykazu powodują bezpieczną odmowę zamiast użycia nieograniczonej wartości domyślnej.

Konfiguracja aplikacji wątku

OpenClaw wstrzykuje restrykcyjną poprawkę config.apps dla wątku Codex: _default jest wyłączone, a włączone są tylko aplikacje należące do włączonych, skonfigurowanych pluginów lub dostępne aplikacje konta dopuszczone przez allow_all_plugins.

Wartość destructive_enabled każdej aplikacji wynika z obowiązującej globalnej lub przypisanej do pluginu polityki allow_destructive_actions; wartości true, "auto" i "ask" ustawiają destructive_enabled: true, natomiast false ustawia ją na false. Codex nadal egzekwuje metadane narzędzi destrukcyjnych pochodzące z natywnych adnotacji narzędzi aplikacji. _default jest wyłączone z ustawieniem open_world_enabled: false; włączone aplikacje pluginów otrzymują open_world_enabled: true. OpenClaw nie udostępnia osobnego ustawienia polityki otwartego świata na poziomie pluginu ani nie utrzymuje list zabronionych nazw narzędzi destrukcyjnych dla poszczególnych pluginów.

Tryb zatwierdzania narzędzi domyślnie działa automatycznie dla dopuszczonych aplikacji, dzięki czemu niedestrukcyjne narzędzia odczytu działają bez monitu o zatwierdzenie w tym samym wątku. Narzędzia destrukcyjne pozostają kontrolowane przez politykę destructive_enabled każdej aplikacji.

Polityka działań destrukcyjnych

Destrukcyjne żądania dodatkowych danych przez pluginy są domyślnie dozwolone dla skonfigurowanych pluginów Codex, natomiast niebezpieczne schematy i niejednoznaczna własność powodują bezpieczną odmowę:

• Globalne ustawienie allow_destructive_actions ma domyślnie wartość true.
• Ustawienie allow_destructive_actions przypisane do pluginu zastępuje politykę globalną dla tego pluginu.
• false: OpenClaw zwraca deterministyczną odmowę.
• true: OpenClaw automatycznie akceptuje tylko bezpieczne schematy, które może odwzorować na odpowiedź zatwierdzającą, na przykład logiczne pole zatwierdzenia.
• "auto": OpenClaw udostępnia destrukcyjne działania pluginu systemowi Codex, a następnie przekształca żądania zatwierdzenia MCP o potwierdzonej własności w zatwierdzenia pluginu OpenClaw przed zwróceniem odpowiedzi zatwierdzającej Codex.
• "ask": OpenClaw stosuje te same mechanizmy kontroli zapisu i działań destrukcyjnych Codex co w przypadku "auto", usuwa trwałe nadpisania zatwierdzeń Codex dla poszczególnych narzędzi aplikacji przed rozpoczęciem wątku oraz oferuje wyłącznie jednorazowe zatwierdzenie lub odmowę, dzięki czemu trwałe zatwierdzenia nie mogą wyłączyć późniejszych monitów dotyczących działań zapisu. Dla każdej dopuszczonej aplikacji używającej "ask" OpenClaw wybiera dla niej recenzenta zatwierdzeń przez człowieka w Codex, aby Codex wysyłał swoje żądania zatwierdzenia do OpenClaw; inne aplikacje oraz zatwierdzenia wątku niezwiązane z aplikacjami zachowują skonfigurowanego recenzenta i politykę.
• Brak tożsamości pluginu, niejednoznaczna własność, brakujący lub niezgodny identyfikator tury albo niebezpieczny schemat żądania skutkuje odmową zamiast wyświetlenia monitu.

Rozwiązywanie problemów

Plugin przestrzeni roboczej jest zainstalowany, ale niewidoczny: upewnij się, że wynik plugin/list dla przestrzeni roboczej zgłasza dokładnie skonfigurowany identyfikator jako zainstalowany i włączony, a następnie upewnij się, że app/list zgłasza każdą aplikację należącą do pluginu jako dostępną dla tego samego konta Codex. OpenClaw może włączyć dostępną aplikację dla wątku nawet wtedy, gdy spis konta zgłasza ją obecnie jako wyłączoną. Jeśli ten stan zmieniono po zapisaniu spisu aplikacji w pamięci podręcznej Gateway, poczekaj na cogodzinne odświeżenie pamięci podręcznej lub uruchom ponownie Gateway, a następnie użyj /new lub /reset. OpenClaw nie naprawia ani nie uwierzytelnia pluginów przestrzeni roboczej. Jeśli jawne żądanie listy przestrzeni roboczej zostanie odrzucone, każdy włączony wpis przestrzeni roboczej zgłosi marketplace_missing; niezwiązane z nim wyselekcjonowane wpisy nadal będą przetwarzane na podstawie domyślnej odpowiedzi listy.

W przypadku plugin_detail_unavailable podsumowanie przestrzeni roboczej bez ścieżki musi zawierać remotePluginId; OpenClaw utrzymuje aplikacje należące do pluginu w ukryciu, gdy ten selektor lub wynik późniejszego wywołania plugin/read jest niedostępny. W przypadku plugin_activation_failed wyselekcjonowane pluginy mogą zgłaszać błąd Marketplace, uwierzytelniania lub odświeżania po instalacji. Plugin przestrzeni roboczej zgłasza ten kod, gdy nie jest jeszcze aktywny; zainstaluj, włącz i uwierzytelnij go poza OpenClaw.

Konfiguracja została zmieniona, ale agent nie widzi pluginu: uruchom /codex plugins list, aby potwierdzić skonfigurowany stan, a następnie użyj /new lub /reset. Istniejące powiązania wątku Codex zachowują konfigurację aplikacji, z którą zostały uruchomione, dopóki OpenClaw nie ustanowi nowej sesji środowiska wykonawczego lub nie zastąpi nieaktualnego powiązania.

Działanie destrukcyjne zostało odrzucone: sprawdź globalne i przypisane do pluginu wartości allow_destructive_actions. Nawet przy wartości true, "auto" lub "ask" niebezpieczne schematy żądań i niejednoznaczna tożsamość pluginu nadal powodują bezpieczną odmowę.

Powiązane materiały

• Środowisko wykonawcze Codex
• Dokumentacja referencyjna środowiska wykonawczego Codex
• Środowisko uruchomieniowe mechanizmu Codex
• Dokumentacja referencyjna konfiguracji
• CLI migracji