--- read_when: - Вы хотите, чтобы агенты OpenClaw в режиме Codex использовали нативные плагины Codex - Вы переносите установленные из исходного кода плагины Codex, курируемые OpenAI - Вы настраиваете существующий плагин Codex в каталоге рабочей области - Вы устраняете неполадки с codexPlugins, инвентаризацией приложений, деструктивными действиями или диагностикой приложений плагинов summary: Настройка нативных плагинов Codex для агентов OpenClaw в режиме Codex title: Нативные плагины Codex x-i18n: generated_at: "2026-07-13T18:27:47Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 24 provider: openai source_hash: 0b1cfa39838d4dbd1f33a1e5b7f52faec4b033f9fa98ef5c029003177c2e27e5 source_path: plugins/codex-native-plugins.md workflow: 16 --- Встроенная поддержка плагинов Codex позволяет агенту OpenClaw в режиме Codex использовать собственные возможности приложений и плагинов app-server Codex в том же потоке Codex, который обрабатывает ход OpenClaw. Вызовы плагинов остаются во встроенной расшифровке Codex; app-server Codex управляет выполнением MCP на базе приложений. OpenClaw не преобразует плагины Codex в синтетические динамические инструменты OpenClaw `codex_plugin_*`. Используйте эту страницу после того, как базовая [среда выполнения Codex](/ru/plugins/codex-harness) заработает. ## Требования - Средой выполнения агента должна быть встроенная среда выполнения 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`. `codexPlugins` не влияет на запуски через провайдер OpenClaw, привязки разговоров ACP или другие среды выполнения, поскольку эти пути никогда не создают потоки app-server 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 ``` Добавьте `--verify-plugin-apps`, чтобы при миграции вызывался исходный `app/list`, а перед планированием встроенной активации проверялось, что каждое принадлежащее плагину приложение присутствует, включено и доступно: ```bash openclaw migrate codex --dry-run --verify-plugin-apps ``` Примените миграцию, когда план будет выглядеть правильно: ```bash openclaw migrate apply codex --yes ``` Миграция записывает явные элементы `codexPlugins` для подходящих плагинов и вызывает `plugin/install` app-server 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", }, }, }, }, }, }, }, } ``` Миграция по-прежнему ограничена `openai-curated`. Чтобы использовать существующий плагин `workspace-directory`, добавьте его вручную с точным идентификатором `summary.id` с указанием маркетплейса, возвращённым `plugin/list`. Например, если Codex возвращает `example-plugin@workspace-directory`, укажите это полное значение вместо отображаемого имени: ```json5 { plugins: { entries: { codex: { enabled: true, config: { codexPlugins: { enabled: true, plugins: { "example-plugin": { enabled: true, marketplaceName: "workspace-directory", pluginName: "example-plugin@workspace-directory", }, }, }, }, }, }, }, } ``` OpenClaw не вызывает `plugin/install` и не запускает аутентификацию для плагина `workspace-directory`. Установите и включите его, а также пройдите аутентификацию в Codex, прежде чем добавлять или включать политику OpenClaw. OpenClaw сохраняет приложения скрытыми, если в ответе отсутствуют точные сведения о маркетплейсе, идентификаторе плагина, идентификаторе подробностей или готовности приложения. Если Codex отклоняет явный запрос рабочего пространства `plugin/list`, OpenClaw сообщает `marketplace_missing` для каждого включённого плагина рабочего пространства и сохраняет доступность независимо обнаруженных курируемых плагинов. После изменения `codexPlugins` новые разговоры Codex автоматически получают обновлённый набор приложений. Выполните `/new` или `/reset`, чтобы обновить текущий разговор. Для изменений включения или отключения плагинов перезапуск Gateway не требуется. ## Управление плагинами из чата `/codex plugins` проверяет или изменяет настроенные встроенные плагины Codex из того же чата, где вы работаете со средой выполнения 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.json`; они никогда не изменяют `~/.codex/config.toml` и не устанавливают новые плагины Codex. Запускать их может только владелец или клиент Gateway с областью доступа `operator.admin`. Включение настроенного плагина также активирует глобальный переключатель `codexPlugins.enabled`. Если курируемый плагин был записан отключённым, поскольку миграция вернула `auth_required`, повторно авторизуйте приложение в Codex, прежде чем включать его в OpenClaw. Для элемента `workspace-directory` включение здесь изменяет только политику OpenClaw; плагин и приложение уже должны быть активны в Codex. ## Как работает настройка встроенных плагинов Интеграция отслеживает три состояния: | Состояние | Значение | | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | Установлен | Codex содержит пакет плагина в целевой среде выполнения app-server. | | Включён | Codex сообщает, что плагин включён, а конфигурация OpenClaw разрешает его для ходов среды выполнения Codex. | | Доступен | App-server Codex подтверждает, что элементы приложений плагина доступны активной учётной записи и соответствуют настроенной сущности плагина. | Для плагинов `openai-curated` миграция является постоянным этапом установки и проверки соответствия требованиям: - Во время планирования OpenClaw читает сведения исходного Codex `plugin/read` и проверяет, что учётная запись исходного app-server Codex является учётной записью с подпиской ChatGPT. Если учётная запись отсутствует или не относится к ChatGPT, плагины на базе приложений пропускаются с причиной `codex_subscription_required`. - По умолчанию при миграции пропускается исходный вызов `app/list`: плагины исходного кода на базе приложений, прошедшие проверку учётной записи, планируются без проверки доступности исходных приложений, а при транспортных сбоях поиска учётной записи они пропускаются с причиной `codex_account_unavailable`. - При использовании `--verify-plugin-apps` миграция получает новый снимок исходного `app/list` и требует, чтобы каждое принадлежащее плагину приложение присутствовало, было включено и доступно до планирования встроенной активации. В этом случае транспортные сбои поиска учётной записи приводят к переходу к проверке перечня исходных приложений, а не к немедленному пропуску. Для плагинов `workspace-directory` настройка выполняется вне OpenClaw. OpenClaw запрашивает этот маркетплейс только при наличии хотя бы одного настроенного и включённого элемента рабочего пространства, разрешает каждый плагин по точному `summary.id` и повторно использует существующие проверки владения `plugin/read` и готовности `app/list`. Неустановленный, отключённый, недоступный плагин или плагин без пройденной аутентификации не предоставляет приложений; OpenClaw не пытается выполнить установку или аутентификацию. Перечень приложений среды выполнения служит проверкой доступности целевого сеанса как для мигрированных курируемых плагинов, так и для настроенных вручную плагинов рабочего пространства. При настройке сеанса среды выполнения Codex вычисляется ограничительная конфигурация приложений потока на основе включённых и доступных приложений плагинов; она не вычисляется заново при каждом ходе, поэтому `/codex plugins enable`/`disable` влияют только на новые разговоры Codex. Используйте `/new` или `/reset`, чтобы применить изменение в текущем разговоре. ## Границы поддержки 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`; другие маркетплейсы по-прежнему не поддерживаются. ## Перечень приложений и владение OpenClaw читает перечень приложений Codex через `app/list` app-server, кеширует его в памяти на один час и асинхронно обновляет устаревшие или отсутствующие элементы. Кеш действует только в рамках процесса; перезапуск CLI или Gateway очищает его, и OpenClaw создаёт его заново при следующем чтении `app/list`. Миграция и среда выполнения используют разные ключи кеша: - При проверке исходной миграции используются исходный домашний каталог Codex и параметры запуска. Она выполняется только с `--verify-plugin-apps` и принудительно запускает новый обход исходного `app/list` для этого сеанса планирования. - При построении конфигурации приложений потока целевая среда выполнения использует сущность app-server Codex целевого агента. Активация курируемого плагина аннулирует соответствующий ключ целевого кеша, а затем принудительно обновляет его после `plugin/install`. При настройке `workspace-directory` этот путь активации никогда не выполняется. Приложение плагина предоставляется только тогда, когда OpenClaw может сопоставить его с настроенным плагином посредством стабильного владения: точного идентификатора приложения из сведений о плагине, известного имени сервера MCP или уникальных стабильных метаданных. Владение, основанное только на отображаемом имени или неоднозначных данных, исключается до следующего обновления перечня, подтверждающего владение. ## Приложения подключённой учётной записи Агенты, управляемые владельцем, могут разрешить все приложения, уже подключённые к их учётной записи Codex, без необходимости в соответствующем пакете плагина: ```json5 { plugins: { entries: { codex: { enabled: true, config: { codexPlugins: { enabled: true, allow_all_plugins: true, allow_destructive_actions: "auto", }, }, }, }, }, } ``` `allow_all_plugins: true` получает полный снимок `app/list` при создании нового встроенного потока Codex и допускает только приложения, отмеченные как доступные этой учётной записи. Он не устанавливает приложения, не выполняет их аутентификацию и не включает их глобально. Существующие потоки сохраняют свой постоянный набор приложений; используйте `/new`, `/reset` или перезапустите Gateway, чтобы применить изменения, связанные с недавно подключёнными или отозванными приложениями. Приложения учетной записи наследуют глобальное значение `codexPlugins.allow_destructive_actions`, которое принимает `true`, `false`, `"auto"` или `"ask"`. Явная политика для отдельного плагина переопределяет глобальную политику для совпадающих идентификаторов приложений. При сбоях инвентаризации доступ блокируется вместо возврата к неограниченной политике по умолчанию. ## Конфигурация приложений потока OpenClaw внедряет ограничивающее исправление `config.apps` для потока Codex: `_default` отключен, а включены только приложения, принадлежащие включенным настроенным плагинам, или доступные приложения учетной записи, разрешенные политикой `allow_all_plugins`. Значение `destructive_enabled` каждого приложения определяется эффективной глобальной политикой `allow_destructive_actions` или политикой отдельного плагина; `true`, `"auto"` и `"ask"` задают `destructive_enabled: true`, а `false` задает значение `false`. Codex по-прежнему применяет метаданные деструктивных инструментов из собственных аннотаций инструментов приложения. `_default` отключается с помощью `open_world_enabled: false`; приложения включенных плагинов получают `open_world_enabled: true`. OpenClaw не предоставляет отдельного параметра политики открытого мира на уровне плагина и не поддерживает отдельные для каждого плагина списки запрещенных имен деструктивных инструментов. Для разрешенных приложений по умолчанию используется автоматический режим одобрения инструментов, поэтому недеструктивные инструменты чтения выполняются без запроса одобрения в том же потоке. Деструктивные инструменты остаются под управлением политики `destructive_enabled` каждого приложения. ## Политика деструктивных действий Деструктивные запросы плагинов по умолчанию разрешены для настроенных плагинов Codex, тогда как небезопасные схемы и неоднозначное владение приводят к блокировке: - Глобальное значение `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; другие приложения и одобрения потока, не связанные с приложениями, сохраняют настроенные обработчик проверки и политику. - При отсутствии идентификатора плагина, неоднозначном владении, отсутствии или несовпадении идентификатора хода либо небезопасной схеме запроса выполняется отказ без запроса пользователю. ## Устранение неполадок | Код | Значение | Исправление | | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- | | `auth_required` | При миграции плагин был установлен, но одному из его приложений по-прежнему требуется аутентификация. Запись создается отключенной до повторной авторизации. | Повторно авторизуйте приложение в Codex, затем включите плагин в OpenClaw. | | `app_inaccessible`, `app_disabled`, `app_missing` | При `--verify-plugin-apps` исходная инвентаризация приложений Codex не показала, что все принадлежащие плагину приложения присутствуют, включены и доступны. | Повторно авторизуйте или включите приложение в 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` | Маркетплейс или точный плагин недоступны; явный запрос каталога рабочего пространства мог быть отклонен; приложения рабочего пространства блокируются. | Проверьте описанные ниже совместимый контракт сервера приложений и точный идентификатор. | | `plugin_detail_unavailable` | OpenClaw не удалось прочитать сведения о владении плагином. | Проверьте ответы `plugin/list` и `plugin/read` целевого сервера приложений. | | `plugin_disabled` | Codex сообщает, что плагин установлен, но отключен. | Активация курируемого плагина может исправить это состояние; перед повторной попыткой включите плагин рабочего пространства в Codex. | | `plugin_activation_failed` | Активация плагина не завершена. | Используйте приложенную диагностику, чтобы различить сбои маркетплейса, аутентификации, обновления или готовности рабочего пространства. | | `app_inventory_missing`, `app_inventory_stale` | Состояние готовности приложения было получено из пустого или устаревшего кеша. | OpenClaw автоматически планирует асинхронное обновление; приложения плагина остаются исключенными, пока владение и готовность не будут известны. | | `app_ownership_ambiguous` | Инвентаризация приложений нашла совпадение только по отображаемому имени. | Приложение остается скрытым от потока Codex, пока последующее обновление не подтвердит владение. | **Плагин рабочего пространства установлен, но не отображается:** убедитесь, что результат рабочего пространства `plugin/list` сообщает точный настроенный идентификатор как установленный и включенный, а затем убедитесь, что `app/list` сообщает о доступности каждого принадлежащего плагину приложения для той же учетной записи Codex. OpenClaw может включить доступное приложение для потока, даже если инвентаризация учетной записи в настоящий момент сообщает, что это приложение отключено. Если вы изменили это состояние после кеширования Gateway инвентаризации приложений, дождитесь обновления кеша через один час или перезапустите Gateway, а затем используйте `/new` или `/reset`. OpenClaw не восстанавливает и не аутентифицирует плагины рабочего пространства. Если явный запрос списка рабочего пространства отклонен, каждая включенная запись рабочего пространства сообщает `marketplace_missing`; обработка не связанных с ними курируемых записей продолжается на основе ответа со списком по умолчанию. Для `plugin_detail_unavailable` сводка рабочего пространства без пути должна включать `remotePluginId`; OpenClaw сохраняет принадлежащие плагину приложения скрытыми, если этот селектор или последующий результат `plugin/read` недоступен. Для `plugin_activation_failed` курируемые плагины могут сообщать о сбое маркетплейса, аутентификации или обновления после установки. Плагин рабочего пространства сообщает этот код, если он еще не активен; установите, включите и аутентифицируйте его вне OpenClaw. **Конфигурация изменена, но агент не видит плагин:** выполните `/codex plugins list`, чтобы подтвердить настроенное состояние, затем `/new` или `/reset`. Существующие привязки потоков Codex сохраняют конфигурацию приложений, с которой они были запущены, пока OpenClaw не создаст новый сеанс среды выполнения или не заменит устаревшую привязку. **Деструктивное действие отклоняется:** проверьте глобальное значение и значения отдельных плагинов `allow_destructive_actions`. Даже при `true`, `"auto"` или `"ask"` небезопасные схемы запросов и неоднозначная идентификация плагина по-прежнему приводят к блокировке. ## См. также - [Среда выполнения Codex](/ru/plugins/codex-harness) - [Справочник по среде выполнения Codex](/ru/plugins/codex-harness-reference) - [Среда исполнения среды выполнения Codex](/ru/plugins/codex-harness-runtime) - [Справочник по конфигурации](/ru/gateway/configuration-reference#codex-harness-plugin-config) - [CLI миграции](/ru/cli/migrate)