Нативные плагины Codex

​

Требования

• Средой выполнения агента должна быть встроенная среда выполнения Codex.
• plugins.entries.codex.enabled имеет значение true.
• plugins.entries.codex.config.codexPlugins.enabled имеет значение true.
• Целевой app-server Codex должен видеть ожидаемый перечень маркетплейсов, плагинов и приложений.
• Миграция поддерживает только плагины openai-curated, которые были обнаружены как установленные из исходного кода в исходном домашнем каталоге Codex.
• Для настроенных вручную плагинов workspace-directory требуется app-server Codex, в котором plugin/list принимает marketplaceKinds, а сводки рабочих пространств без пути включают remotePluginId. Плагин уже должен быть установлен и включён, а принадлежащие ему приложения должны быть доступны в app/list.

​

Быстрый старт

openclaw migrate codex --dry-run

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

openclaw migrate apply codex --yes

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

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

​

Управление плагинами из чата

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

​

Как работает настройка встроенных плагинов

• Во время планирования OpenClaw читает сведения исходного Codex plugin/read и проверяет, что учётная запись исходного app-server Codex является учётной записью с подпиской ChatGPT. Если учётная запись отсутствует или не относится к ChatGPT, плагины на базе приложений пропускаются с причиной codex_subscription_required.
• По умолчанию при миграции пропускается исходный вызов app/list: плагины исходного кода на базе приложений, прошедшие проверку учётной записи, планируются без проверки доступности исходных приложений, а при транспортных сбоях поиска учётной записи они пропускаются с причиной codex_account_unavailable.
• При использовании --verify-plugin-apps миграция получает новый снимок исходного app/list и требует, чтобы каждое принадлежащее плагину приложение присутствовало, было включено и доступно до планирования встроенной активации. В этом случае транспортные сбои поиска учётной записи приводят к переходу к проверке перечня исходных приложений, а не к немедленному пропуску.

​

Границы поддержки V1

• Для миграции подходят только плагины openai-curated, уже установленные в перечне исходного app-server Codex.
• Среда выполнения также поддерживает явные элементы workspace-directory в сборках app-server, где plugin/list реализует marketplaceKinds и возвращает remotePluginId для сводок рабочих пространств без пути. Эти элементы должны использовать точный summary.id с указанием маркетплейса и уже быть установленными, включёнными и доступными для приложений. Отклонённый запрос списка рабочего пространства приводит к существующей диагностике marketplace_missing для каждого плагина; при отсутствии сведений о маркетплейсе, плагине, подробностях или приложении приложение рабочего пространства не предоставляется. Курируемый перечень из запроса списка по умолчанию остаётся доступным.
• Плагины исходного кода на базе приложений должны пройти проверку подписки во время миграции. --verify-plugin-apps добавляет проверку перечня исходных приложений. Учётные записи, не прошедшие проверку подписки, а в режиме проверки — недоступные, отключённые или отсутствующие исходные приложения и сбои обновления перечня приложений, отображаются как пропущенные элементы для ручной обработки, а не как включённые элементы конфигурации. Плагины с нечитаемыми сведениями пропускаются до проверки перечня приложений.
• Миграция записывает явные сущности плагинов (marketplaceName и pluginName); локальные пути кеша marketplacePath не записываются.
• codexPlugins.enabled — единственный глобальный переключатель включения; подстановочного знака или ключа конфигурации plugins["*"], который предоставляет произвольные полномочия на установку, не существует.
• Некурируемые маркетплейсы, кешированные пакеты плагинов, обработчики и файлы конфигурации Codex сохраняются в отчёте о миграции для ручной проверки, а не активируются автоматически. Среда выполнения принимает настроенные вручную элементы workspace-directory; другие маркетплейсы по-прежнему не поддерживаются.

​

Перечень приложений и владение

• При проверке исходной миграции используются исходный домашний каталог Codex и параметры запуска. Она выполняется только с --verify-plugin-apps и принудительно запускает новый обход исходного app/list для этого сеанса планирования.
• При построении конфигурации приложений потока целевая среда выполнения использует сущность app-server Codex целевого агента. Активация курируемого плагина аннулирует соответствующий ключ целевого кеша, а затем принудительно обновляет его после plugin/install. При настройке workspace-directory этот путь активации никогда не выполняется.

​

Приложения подключённой учётной записи

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

​

Конфигурация приложений потока

​

Политика деструктивных действий

• Глобальное значение allow_destructive_actions по умолчанию равно true.
• Значение allow_destructive_actions отдельного плагина переопределяет глобальную политику для этого плагина.
• false: OpenClaw возвращает детерминированный отказ.
• true: OpenClaw автоматически принимает только безопасные схемы, которые может преобразовать в ответ об одобрении, например в логическое поле одобрения.
• "auto": OpenClaw предоставляет Codex доступ к деструктивным действиям плагинов, а затем преобразует запросы одобрения MCP с подтвержденным владением в одобрения плагинов OpenClaw перед возвратом ответа об одобрении Codex.
• "ask": OpenClaw использует тот же механизм контроля записи и деструктивных действий Codex, что и "auto", перед запуском потока удаляет постоянные переопределения одобрения Codex для отдельных инструментов приложения и предлагает только однократное одобрение или отказ, чтобы постоянные одобрения не могли подавлять последующие запросы для действий записи. Для каждого разрешенного приложения, использующего "ask", OpenClaw выбирает для него обработчик проверки одобрений человеком Codex, чтобы Codex отправлял свои запросы одобрения в OpenClaw; другие приложения и одобрения потока, не связанные с приложениями, сохраняют настроенные обработчик проверки и политику.
• При отсутствии идентификатора плагина, неоднозначном владении, отсутствии или несовпадении идентификатора хода либо небезопасной схеме запроса выполняется отказ без запроса пользователю.

​

Устранение неполадок

​

См. также

• Среда выполнения Codex
• Справочник по среде выполнения Codex
• Среда исполнения среды выполнения Codex
• Справочник по конфигурации
• CLI миграции