--- read_when: - Ви хочете, щоб агенти OpenClaw у режимі Codex використовували нативні Plugin Codex - Ви мігруєте встановлені з джерела curated-плагіни Codex від OpenAI - Ви усуваєте неполадки з codexPlugins, інвентаризацією застосунків, руйнівними діями або діагностикою застосунків Plugin summary: Налаштуйте перенесені нативні Codex plugins для агентів OpenClaw у режимі Codex title: Нативні plugins Codex x-i18n: generated_at: "2026-07-02T01:13:37Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 11a883137ba89936cf564a45b22c9e76097af669e2ef6c70c8c710bb2b79d3c0 source_path: plugins/codex-native-plugins.md workflow: 16 --- Підтримка нативних плагінів Codex дає змогу агенту OpenClaw у режимі Codex використовувати власні можливості застосунків і плагінів сервера застосунків Codex у тому самому потоці Codex, який обробляє хід OpenClaw. OpenClaw не перетворює плагіни Codex на синтетичні динамічні інструменти OpenClaw `codex_plugin_*`. Виклики плагінів залишаються в нативному транскрипті Codex, а сервер застосунків Codex керує виконанням MCP, підтриманим застосунком. Використовуйте цю сторінку після того, як базовий [harness Codex](/uk/plugins/codex-harness) запрацює. ## Вимоги - Вибране середовище виконання агента OpenClaw має бути нативним harness Codex. - `plugins.entries.codex.enabled` має бути true. - `plugins.entries.codex.config.codexPlugins.enabled` має бути true. - V1 підтримує лише плагіни `openai-curated`, які міграція виявила як встановлені з вихідного коду у вихідному домашньому каталозі Codex. - Цільовий сервер застосунків Codex має бачити очікуваний маркетплейс, плагін та інвентар застосунків. `codexPlugins` не впливає на запуски OpenClaw, звичайні запуски провайдера OpenAI, прив’язки розмов ACP або інші harness, оскільки ці шляхи не створюють потоки сервера застосунків Codex із нативною конфігурацією `apps`. Доступ до Codex на боці OpenAI, доступність застосунків і керування застосунками/плагінами робочого простору надходять з облікового запису Codex, у який виконано вхід. Про обліковий запис OpenAI та модель адміністрування див. [Використання Codex із вашим планом ChatGPT](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan). ## Швидкий старт Попередньо перегляньте міграцію з вихідного домашнього каталогу Codex: ```bash openclaw migrate codex --dry-run ``` Використовуйте сувору перевірку вихідного застосунку, коли потрібно, щоб міграція перевірила доступність вихідного застосунку перед плануванням активації нативного плагіна: ```bash openclaw migrate codex --dry-run --verify-plugin-apps ``` Застосуйте міграцію, коли план виглядає правильно: ```bash openclaw migrate apply codex --yes ``` Міграція записує явні записи `codexPlugins` для придатних плагінів і викликає `plugin/install` сервера застосунків Codex для вибраних плагінів. Типова мігрована конфігурація має такий вигляд: ```json5 { 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` нові розмови Codex автоматично підхоплюють оновлений набір застосунків. Використовуйте `/new` або `/reset`, щоб оновити поточну розмову. Перезапуск gateway не потрібен для змін увімкнення або вимкнення плагінів. ## Керування плагінами з чату Використовуйте `/codex plugins`, коли потрібно переглянути або змінити налаштовані нативні плагіни Codex з того самого чату, де ви працюєте з harness Codex: ```text /codex plugins /codex plugins list /codex plugins disable google-calendar /codex plugins enable google-calendar ``` `/codex plugins` є псевдонімом для `/codex plugins list`. Вивід списку показує налаштовані ключі плагінів, стан увімкнено/вимкнено, назву плагіна Codex і маркетплейс із `plugins.entries.codex.config.codexPlugins.plugins`. `enable` і `disable` записують лише в конфігурацію OpenClaw за шляхом `~/.openclaw/openclaw.json`; вони не редагують `~/.codex/config.toml` і не встановлюють нові плагіни Codex. Змінювати стан плагіна може лише власник або клієнт gateway зі scope `operator.admin`. Увімкнення налаштованого плагіна також вмикає глобальний перемикач `codexPlugins.enabled`. Якщо плагін було записано вимкненим через те, що міграція повернула `auth_required`, повторно авторизуйте застосунок у Codex перед увімкненням його в OpenClaw. ## Як працює налаштування нативних плагінів Інтеграція має три окремі стани: - Встановлено: Codex має локальний пакет плагіна в цільовому середовищі виконання сервера застосунків. - Увімкнено: конфігурація OpenClaw дозволяє зробити плагін доступним для ходів harness Codex. - Доступно: сервер застосунків Codex підтверджує, що записи застосунків плагіна доступні для активного облікового запису й можуть бути зіставлені з мігрованою ідентичністю плагіна. Міграція є довговічним кроком встановлення/перевірки придатності. Під час планування OpenClaw читає деталі `plugin/read` вихідного Codex і перевіряє, що відповідь облікового запису вихідного сервера застосунків Codex є обліковим записом із підпискою ChatGPT. Відповіді без ChatGPT або відсутні відповіді облікового запису пропускають плагіни, підтримані застосунком, із `codex_subscription_required`. За замовчуванням міграція не викликає вихідний `app/list`; підтримані застосунком вихідні плагіни, які проходять перевірку облікового запису, плануються без перевірки доступності вихідного застосунку, а транспортні помилки пошуку облікового запису пропускаються з `codex_account_unavailable`. З `--verify-plugin-apps` міграція робить свіжий знімок вихідного `app/list` і вимагає, щоб кожен належний застосунок був наявний, увімкнений і доступний перед плануванням нативної активації. У цьому режимі транспортні помилки пошуку облікового запису переходять до перевірки інвентарю вихідних застосунків. Інвентар застосунків середовища виконання є перевіркою доступності цільового сеансу після міграції. Потім налаштування сеансу harness Codex обчислює обмежувальну конфігурацію застосунків потоку для увімкнених і доступних застосунків плагіна. Конфігурація застосунків потоку обчислюється, коли OpenClaw встановлює сеанс harness Codex або замінює застарілу прив’язку потоку Codex. Вона не переобчислюється на кожному ході, тому `/codex plugins enable` і `/codex plugins disable` впливають на нові розмови Codex. Використовуйте `/new` або `/reset`, коли поточна розмова має підхопити оновлений набір застосунків. ## Межа підтримки V1 V1 навмисно вузька: - Лише плагіни `openai-curated`, які вже були встановлені в інвентарі вихідного сервера застосунків Codex, придатні для міграції. - Підтримані застосунком вихідні плагіни мають пройти перевірку підписки під час міграції. `--verify-plugin-apps` додає перевірку інвентарю вихідних застосунків. Облікові записи, обмежені підпискою, а в режимі перевірки також недоступні, вимкнені, відсутні вихідні застосунки або помилки оновлення інвентарю вихідних застосунків повідомляються як пропущені ручні елементи замість увімкнених записів конфігурації. Нечитабельні деталі плагіна пропускаються перед перевіркою інвентарю вихідних застосунків. - Міграція записує явні ідентичності плагінів із `marketplaceName` і `pluginName`; вона не записує локальні шляхи кешу `marketplacePath`. - `codexPlugins.enabled` є глобальним перемикачем увімкнення. - Немає wildcard `plugins["*"]` і немає ключа конфігурації, який надає довільні повноваження на встановлення. - Непідтримувані маркетплейси, кешовані пакети плагінів, хуки та файли конфігурації Codex зберігаються у звіті міграції для ручного перегляду. ## Інвентар застосунків і власність OpenClaw читає інвентар застосунків Codex через `app/list` сервера застосунків, кешує його на одну годину й асинхронно оновлює застарілі або відсутні записи. Кеш існує лише в пам’яті; перезапуск CLI або gateway скидає його, і OpenClaw перебудовує його з наступного читання `app/list`. Міграція та середовище виконання використовують окремі ключі кешу: - Перевірка вихідної міграції використовує вихідний домашній каталог Codex і параметри запуску вихідного сервера застосунків. Це виконується лише коли встановлено `--verify-plugin-apps`, і примусово запускає свіжий обхід вихідного `app/list` для цього запуску планування. - Налаштування цільового середовища виконання використовує ідентичність сервера застосунків Codex цільового агента, коли будує конфігурацію застосунків потоку Codex. Активація плагіна інвалідовує цей цільовий ключ кешу, а потім примусово оновлює його після `plugin/install`. Застосунок плагіна відкривається лише тоді, коли OpenClaw може зіставити його назад із мігрованим плагіном через стабільну власність: - точний id застосунку з деталей плагіна - відома назва сервера MCP - унікальні стабільні метадані Власність лише за відображуваною назвою або неоднозначна власність виключається, доки наступне оновлення інвентарю не підтвердить власність. ## Конфігурація застосунків потоку OpenClaw впроваджує обмежувальний patch `config.apps` для потоку Codex: `_default` вимкнено, і ввімкнено лише застосунки, що належать увімкненим мігрованим плагінам. OpenClaw встановлює `destructive_enabled` на рівні застосунку з ефективної глобальної або поплагінної політики `allow_destructive_actions` і дозволяє Codex застосовувати метадані деструктивних інструментів зі своїх нативних анотацій інструментів застосунку. `true`, `"auto"` і `"ask"` встановлюють `destructive_enabled: true`; `false` встановлює false. Конфігурація застосунку `_default` вимкнена з `open_world_enabled: false`. Увімкнені застосунки плагінів виводяться з `open_world_enabled: true`; OpenClaw не відкриває окремий перемикач політики open-world для плагіна й не підтримує поплагінні списки заборони назв деструктивних інструментів. Режим затвердження інструментів за замовчуванням автоматичний для застосунків плагінів, щоб недеструктивні інструменти читання могли виконуватися без UI затвердження в тому самому потоці. Деструктивні інструменти залишаються під контролем політики `destructive_enabled` кожного застосунку. ## Політика деструктивних дій Деструктивні elicitation плагінів дозволені за замовчуванням для мігрованих плагінів Codex, тоді як небезпечні схеми й неоднозначна власність усе одно fail closed: - Глобальне значення `allow_destructive_actions` за замовчуванням дорівнює `true`. - Поплагінне `allow_destructive_actions` перевизначає глобальну політику для цього плагіна. - Коли політика дорівнює `false`, OpenClaw повертає детерміновану відмову. - Коли політика дорівнює `true`, OpenClaw автоматично приймає лише безпечні схеми, які може зіставити з відповіддю затвердження, наприклад булевим полем approve. - Коли політика дорівнює `"auto"`, OpenClaw відкриває деструктивні дії плагінів для Codex, але перетворює підтверджені за власністю MCP elicitation затвердження на затвердження плагінів OpenClaw перед поверненням відповіді затвердження Codex. - Коли політика дорівнює `"ask"`, OpenClaw використовує те саме блокування запису/деструктивних дій Codex, що й `"auto"`, очищає довговічні перевизначення затверджень Codex для кожного інструмента застосунку перед запуском потоку й пропонує лише одноразове затвердження або відхилення, щоб довговічні затвердження не могли придушити подальші запити дій запису. - Для кожного допущеного застосунку, який використовує `"ask"`, OpenClaw вибирає reviewer людських затверджень Codex для цього застосунку, щоб Codex надсилав свої elicitation затвердження до OpenClaw. Інші застосунки й затвердження потоку, не пов’язані із застосунками, зберігають налаштованого reviewer і політику. - Відсутня ідентичність плагіна, неоднозначна власність, відсутній id ходу, неправильний id ходу або небезпечна схема elicitation призводять до відмови замість запиту. ## Усунення неполадок **`auth_required`:** міграція встановила плагін, але один із його застосунків усе ще потребує автентифікації. Явний запис плагіна записується вимкненим, доки ви не авторизуєте його повторно й не ввімкнете. **`app_inaccessible`, `app_disabled` або `app_missing`:** міграція не встановила плагін, тому що інвентар вихідних застосунків Codex не показав усі належні застосунки як наявні, увімкнені й доступні, коли було встановлено `--verify-plugin-apps`. Повторно авторизуйте або ввімкніть застосунок у Codex, а потім повторно запустіть міграцію з `--verify-plugin-apps`. **`app_inventory_unavailable`:** міграція не встановила плагін, тому що було запитано сувору перевірку вихідного застосунку, а оновлення інвентарю вихідних застосунків Codex завершилося невдало. Виправте доступ до вихідного сервера застосунків Codex або повторіть без `--verify-plugin-apps`, якщо приймаєте швидший план із перевіркою облікового запису. **`codex_subscription_required`:** міграція не встановила підтриманий застосунком плагін, тому що обліковий запис вихідного сервера застосунків Codex не був увійдений з обліковим записом підписки ChatGPT. Увійдіть у застосунок Codex з автентифікацією підписки, а потім повторно запустіть міграцію. **`codex_account_unavailable`:** міграція не встановила підтриманий застосунком плагін, тому що обліковий запис вихідного сервера застосунків Codex не вдалося прочитати. Виправте автентифікацію вихідного сервера застосунків Codex або повторно запустіть з `--verify-plugin-apps`, якщо хочете, щоб інвентар вихідних застосунків визначав придатність, коли пошук облікового запису не вдається. **`marketplace_missing` або `plugin_missing`:** цільовий сервер застосунків Codex не бачить очікуваний маркетплейс або плагін `openai-curated`. Повторно запустіть міграцію проти цільового середовища виконання або перевірте стан плагіна сервера застосунків Codex. **`app_inventory_missing` або `app_inventory_stale`:** готовність застосунку надійшла з порожнього або застарілого кешу. OpenClaw планує асинхронне оновлення й виключає застосунки плагінів, доки власність і готовність не стануть відомими. **`app_ownership_ambiguous`:** інвентар застосунків збігся лише за відображуваною назвою, тому застосунок не відкривається для потоку Codex. **Конфіг змінено, але агент не бачить Plugin:** використайте `/codex plugins list`, щоб підтвердити налаштований стан, потім використайте `/new` або `/reset`. Наявні прив’язки потоків Codex зберігають конфіг застосунку, з яким вони були запущені, доки OpenClaw не встановить нову сесію обв’язки або не замінить застарілу прив’язку. **Деструктивну дію відхилено:** перевірте глобальні та окремі для кожного Plugin значення `allow_destructive_actions`. Навіть коли політика має значення true, `"auto"` або `"ask"`, небезпечні схеми запиту та неоднозначна ідентичність Plugin усе одно безпечно відхиляються. ## Пов’язане - [Обв’язка Codex](/uk/plugins/codex-harness) - [Довідник обв’язки Codex](/uk/plugins/codex-harness-reference) - [Середовище виконання обв’язки Codex](/uk/plugins/codex-harness-runtime) - [Довідник конфігурації](/uk/gateway/configuration-reference#codex-harness-plugin-config) - [Міграція CLI](/uk/cli/migrate)