Нативні plugins Codex

Підтримка нативних плагінів Codex дає змогу агенту OpenClaw у режимі Codex використовувати власні можливості застосунків і плагінів сервера застосунків Codex у тому самому потоці Codex, який обробляє хід OpenClaw.

OpenClaw не перетворює плагіни Codex на синтетичні динамічні інструменти OpenClaw codex_plugin_*. Виклики плагінів залишаються в нативному транскрипті Codex, а сервер застосунків Codex керує виконанням MCP, підтриманим застосунком.

Використовуйте цю сторінку після того, як базовий harness Codex запрацює.

Вимоги

• Вибране середовище виконання агента 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.

Швидкий старт

Попередньо перегляньте міграцію з вихідного домашнього каталогу Codex:

openclaw migrate codex --dry-run

Використовуйте сувору перевірку вихідного застосунку, коли потрібно, щоб міграція перевірила доступність вихідного застосунку перед плануванням активації нативного плагіна:

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

Застосуйте міграцію, коли план виглядає правильно:

openclaw migrate apply codex --yes

Міграція записує явні записи codexPlugins для придатних плагінів і викликає plugin/install сервера застосунків Codex для вибраних плагінів. Типова мігрована конфігурація має такий вигляд:

{  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:

/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
• Довідник обв’язки Codex
• Середовище виконання обв’язки Codex
• Довідник конфігурації
• Міграція CLI