Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Вбудована підтримка плагінів Codex дає змогу агенту OpenClaw у режимі Codex використовувати власні можливості застосунків і плагінів app-server Codex у тому самому потоці Codex, який обробляє хід OpenClaw. OpenClaw не перетворює плагіни Codex на синтетичні динамічні інструменти OpenClaw codex_plugin_*. Виклики плагінів залишаються у вбудованому транскрипті Codex, а Codex app-server відповідає за виконання MCP, підтримане застосунком. Використовуйте цю сторінку після того, як базовий harness Codex працює.

​
Вимоги

  • Вибране середовище виконання агента OpenClaw має бути вбудованим harness Codex.
  • plugins.entries.codex.enabled має бути true.
  • plugins.entries.codex.config.codexPlugins.enabled має бути true.
  • V1 підтримує лише плагіни openai-curated, які міграція виявила як встановлені з джерела у вихідному домашньому каталозі Codex.
  • Цільовий Codex app-server має бачити очікуваний маркетплейс, плагін та інвентар застосунків.
codexPlugins не впливає на запуски PI, звичайні запуски провайдера OpenAI, прив’язки розмов ACP або інші harness, оскільки ці шляхи не створюють потоки Codex app-server із вбудованою конфігурацією apps.

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

Попередньо перегляньте міграцію з вихідного домашнього каталогу Codex: 
openclaw migrate codex --dry-run
Застосуйте міграцію, коли план виглядає правильно: 
openclaw migrate apply codex --yes
Міграція записує явні записи codexPlugins для придатних плагінів і викликає plugin/install Codex app-server для вибраних плагінів. Типова перенесена конфігурація виглядає так: 
{
  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 використайте /new, /reset або перезапустіть gateway, щоб майбутні сеанси harness Codex запускалися з оновленим набором застосунків.

​
Як працює налаштування вбудованих плагінів

Інтеграція має три окремі стани:
  • Встановлено: Codex має локальний пакет плагіна в цільовому середовищі виконання app-server.
  • Увімкнено: конфігурація OpenClaw дозволяє зробити плагін доступним для ходів harness Codex.
  • Доступно: Codex app-server підтверджує, що записи застосунків плагіна доступні для активного облікового запису й можуть бути зіставлені з перенесеною ідентичністю плагіна.
Міграція є постійним кроком встановлення та визначення придатності. Інвентар застосунків під час виконання є перевіркою доступності. Потім налаштування сеансу harness Codex обчислює обмежувальну конфігурацію застосунків потоку для ввімкнених і доступних застосунків плагінів. Конфігурація застосунків потоку обчислюється, коли OpenClaw встановлює сеанс harness Codex або замінює застарілу прив’язку потоку Codex. Вона не переобчислюється на кожному ході.

​
Межі підтримки V1

V1 навмисно вузька:
  • Лише плагіни openai-curated, які вже були встановлені в інвентарі вихідного Codex app-server, придатні для міграції.
  • Міграція записує явні ідентичності плагінів із marketplaceName і pluginName; вона не записує локальні шляхи кешу marketplacePath.
  • codexPlugins.enabled є глобальним перемикачем увімкнення.
  • Немає wildcard plugins["*"] і немає ключа конфігурації, який надає довільні повноваження встановлення.
  • Непідтримувані маркетплейси, кешовані пакети плагінів, hooks і файли конфігурації Codex зберігаються у звіті міграції для ручного перегляду.

​
Інвентар застосунків і власність

OpenClaw читає інвентар застосунків Codex через app/list app-server, кешує його на одну годину й асинхронно оновлює застарілі або відсутні записи. Застосунок плагіна показується лише тоді, коли OpenClaw може зіставити його назад із перенесеним плагіном через стабільну власність:
  • точний id застосунку з деталей плагіна
  • відома назва сервера MCP
  • унікальні стабільні метадані
Власність лише за відображуваною назвою або неоднозначна власність виключається, доки наступне оновлення інвентарю не підтвердить власність.

​
Конфігурація застосунків потоку

OpenClaw вставляє обмежувальний патч config.apps для потоку Codex: _default вимкнено, і ввімкнено лише застосунки, що належать увімкненим перенесеним плагінам. OpenClaw задає destructive_enabled на рівні застосунку з ефективної глобальної або індивідуальної політики allow_destructive_actions для плагіна й дозволяє Codex застосовувати метадані руйнівних інструментів із його вбудованих анотацій інструментів застосунку. Конфігурація застосунку _default вимкнена з open_world_enabled: false. Увімкнені застосунки плагінів виводяться з open_world_enabled: true; OpenClaw не надає окремого регулятора політики відкритого світу для плагінів і не підтримує індивідуальні списки заборон назв руйнівних інструментів для плагінів. Режим схвалення інструментів за замовчуванням автоматичний для застосунків плагінів, щоб неруйнівні інструменти читання могли виконуватися без UI схвалення в тому самому потоці. Руйнівні інструменти й надалі контролюються політикою destructive_enabled кожного застосунку.

​
Політика руйнівних дій

Руйнівні elicitation плагінів за замовчуванням дозволені для перенесених плагінів Codex, тоді як небезпечні схеми та неоднозначна власність усе одно закриваються відмовою:
  • Глобальне значення allow_destructive_actions за замовчуванням дорівнює true.
  • Індивідуальне значення allow_destructive_actions для плагіна перевизначає глобальну політику для цього плагіна.
  • Коли політика має значення false, OpenClaw повертає детерміновану відмову.
  • Коли політика має значення true, OpenClaw автоматично приймає лише безпечні схеми, які може зіставити з відповіддю схвалення, наприклад булеве поле approve.
  • Відсутня ідентичність плагіна, неоднозначна власність, відсутній id ходу, неправильний id ходу або небезпечна схема elicitation призводять до відмови замість запиту підтвердження.

​
Усунення несправностей

auth_required: міграція встановила плагін, але один із його застосунків усе ще потребує автентифікації. Явний запис плагіна записується вимкненим, доки ви не авторизуєте його повторно й не ввімкнете. marketplace_missing або plugin_missing: цільовий Codex app-server не бачить очікуваний маркетплейс або плагін openai-curated. Повторно запустіть міграцію для цільового середовища виконання або перевірте статус плагіна Codex app-server. app_inventory_missing або app_inventory_stale: готовність застосунку надійшла з порожнього або застарілого кешу. OpenClaw планує асинхронне оновлення й виключає застосунки плагінів, доки власність і готовність не стануть відомими. app_ownership_ambiguous: інвентар застосунків збігся лише за відображуваною назвою, тому застосунок не показується потоку Codex. Конфігурацію змінено, але агент не бачить плагін: використайте /new, /reset або перезапустіть gateway. Наявні прив’язки потоків Codex зберігають конфігурацію застосунків, з якою вони стартували, доки OpenClaw не встановить новий сеанс harness або не замінить застарілу прив’язку. Руйнівну дію відхилено: перевірте глобальне та індивідуальні значення allow_destructive_actions для плагінів. Навіть коли політика має значення true, небезпечні схеми elicitation і неоднозначна ідентичність плагіна все одно закриваються відмовою.

​
Пов’язане