From b5a0a988507c710e6bbcfafd2eacd0bdf3410f8c Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Tue, 5 May 2026 00:08:21 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/plugins/codex-harness.md | 839 ++++++++++++++++--------------- 1 file changed, 438 insertions(+), 401 deletions(-) diff --git a/docs/uk/plugins/codex-harness.md b/docs/uk/plugins/codex-harness.md index 7bfba0df8..261619148 100644 --- a/docs/uk/plugins/codex-harness.md +++ b/docs/uk/plugins/codex-harness.md @@ -1,46 +1,63 @@ --- read_when: - - Ви хочете використовувати комплектну обв’язку app-server Codex - - Вам потрібні приклади конфігурації середовища Codex - - Ви хочете, щоб розгортання лише з Codex завершувалися помилкою замість переходу на PI -summary: Запускайте ходи вбудованого агента OpenClaw через постачану в комплекті обв’язку Codex app-server + - Ви хочете використовувати вбудовану обв’язку app-server для Codex + - Вам потрібні приклади конфігурації обв’язки Codex + - Ви хочете, щоб розгортання лише з Codex завершувалися з помилкою, а не поверталися до PI +summary: Запускайте ходи вбудованого агента OpenClaw через комплектну обв’язку app-server Codex title: Обв’язка Codex x-i18n: - generated_at: "2026-05-03T17:03:25Z" + generated_at: "2026-05-05T00:05:32Z" model: gpt-5.5 provider: openai - source_hash: f5187e54e2dc94e511c0243227f741d3486669f595c2b15cf239b1c03ea466c8 + source_hash: 76302351e7e162e858dd6e3cffca84b3fd54497dd060104da9f90fe4c1a33f9b source_path: plugins/codex-harness.md workflow: 16 --- -Вбудований Plugin `codex` дає OpenClaw змогу запускати вбудовані ходи агента через app-server Codex замість вбудованого каркаса PI. +Вбудований plugin `codex` дає OpenClaw змогу запускати вбудовані ходи агента через +app-server Codex замість вбудованої обв’язки PI. -Використовуйте це, коли хочете, щоб Codex керував низькорівневою сесією агента: виявленням моделей, нативним відновленням треду, нативною Compaction і виконанням на app-server. OpenClaw і далі керує каналами чату, файлами сесій, вибором моделі, інструментами, схваленнями, доставкою медіа та видимим дзеркалом транскрипту. +Використовуйте це, коли хочете, щоб Codex керував низькорівневою сесією агента: виявленням +моделей, нативним відновленням потоку, нативним ущільненням і виконанням через app-server. +OpenClaw і далі відповідає за канали чату, файли сесій, вибір моделі, інструменти, +схвалення, доставку медіа та видиме дзеркало транскрипту. -Коли хід вихідного чату виконується через каркас Codex, видимі відповіді типово використовують інструмент OpenClaw `message`, якщо розгортання явно не налаштувало `messages.visibleReplies`. Агент усе ще може завершити свій хід Codex приватно; він публікує повідомлення в канал лише тоді, коли викликає `message(action="send")`. Установіть `messages.visibleReplies: "automatic"`, щоб зберегти фінальні відповіді прямого чату на застарілому шляху автоматичної доставки. +Коли хід із вихідного чату виконується через обв’язку Codex, видимі відповіді за замовчуванням +йдуть через інструмент OpenClaw `message`, якщо розгортання явно не налаштувало +`messages.visibleReplies`. Агент усе ще може завершити свій хід Codex приватно; +він публікує в канал лише тоді, коли викликає `message(action="send")`. Установіть +`messages.visibleReplies: "automatic"`, щоб залишити фінальні відповіді прямого чату на +застарілому автоматичному шляху доставки. -Ходи Codex Heartbeat також типово отримують інструмент `heartbeat_respond`, щоб агент міг записати, чи має пробудження залишитися тихим, чи сповістити, не кодувавши цей потік керування у фінальному тексті. +Ходи Heartbeat Codex також за замовчуванням отримують інструмент `heartbeat_respond`, щоб +агент міг записати, чи пробудження має лишатися тихим або сповіщати, не кодувавши +цей потік керування у фінальному тексті. -Спеціальні для Heartbeat настанови щодо ініціативності надсилаються як інструкція розробника режиму співпраці Codex на самому ході Heartbeat. Звичайні ходи чату відновлюють режим Codex Default замість того, щоб нести філософію Heartbeat у своєму звичайному runtime prompt. +Специфічні для Heartbeat настанови щодо ініціативи надсилаються як інструкція розробника +режиму співпраці Codex у самому ході Heartbeat. Звичайні ходи чату відновлюють +режим Codex Default замість того, щоб нести філософію Heartbeat у своєму звичайному +runtime-промпті. Якщо ви намагаєтеся зорієнтуватися, почніть з -[Середовища виконання агентів](/uk/concepts/agent-runtimes). Коротко: -`openai/gpt-5.5` — це посилання на модель, `codex` — середовище виконання, а Telegram, -Discord, Slack або інший канал залишається поверхнею комунікації. +[Середовищ виконання агентів](/uk/concepts/agent-runtimes). Коротка версія: +`openai/gpt-5.5` — це посилання на модель, `codex` — runtime, а Telegram, +Discord, Slack або інший канал лишається поверхнею комунікації. ## Швидка конфігурація -Більшість користувачів, які хочуть "Codex в OpenClaw", хочуть саме цей маршрут: увійти з підпискою ChatGPT/Codex, а потім запускати вбудовані ходи агента через нативне середовище виконання app-server Codex. Посилання на модель усе одно залишається канонічним як -`openai/gpt-*`; автентифікація підписки надходить з облікового запису/профілю Codex, а не з префікса моделі `openai-codex/*`. +Більшість користувачів, які хочуть "Codex в OpenClaw", мають на увазі цей маршрут: увійти з +передплатою ChatGPT/Codex, а потім запускати вбудовані ходи агента через нативний +runtime app-server Codex. Посилання на модель усе одно лишається канонічним як +`openai/gpt-*`; автентифікація передплати походить з облікового запису/профілю Codex, а не +з префікса моделі `openai-codex/*`. -Спочатку увійдіть через Codex OAuth, якщо ще не зробили цього: +Спочатку увійдіть через Codex OAuth, якщо ще цього не зробили: ```bash openclaw models auth login --provider openai-codex ``` -Потім увімкніть вбудований Plugin `codex` і примусово задайте середовище виконання Codex: +Потім увімкніть вбудований plugin `codex` і примусово задайте runtime Codex: ```json5 { @@ -62,7 +79,7 @@ openclaw models auth login --provider openai-codex } ``` -Якщо ваша конфігурація використовує `plugins.allow`, додайте туди також `codex`: +Якщо ваша конфігурація використовує `plugins.allow`, також додайте туди `codex`: ```json5 { @@ -77,34 +94,39 @@ openclaw models auth login --provider openai-codex } ``` -Не використовуйте `openai-codex/gpt-*`, коли маєте на увазі нативне середовище виконання Codex. Цей префікс є явним маршрутом "Codex OAuth через PI". Зміни конфігурації застосовуються до нових або скинутих сесій; наявні сесії зберігають своє записане середовище виконання. +Не використовуйте `openai-codex/gpt-*`, коли маєте на увазі нативний runtime Codex. Цей префікс +є явним маршрутом "Codex OAuth через PI". Зміни конфігурації застосовуються до нових або +скинутих сесій; наявні сесії зберігають записаний runtime. -## Що змінює цей Plugin +## Що змінює цей plugin -Вбудований Plugin `codex` додає кілька окремих можливостей: +Вбудований plugin `codex` додає кілька окремих можливостей: -| Можливість | Як ви її використовуєте | Що вона робить | +| Можливість | Як ви її використовуєте | Що вона робить | | --------------------------------- | --------------------------------------------------- | ----------------------------------------------------------------------------- | -| Нативне вбудоване середовище виконання | `agentRuntime.id: "codex"` | Запускає вбудовані ходи агента OpenClaw через app-server Codex. | -| Нативні команди керування чатом | `/codex bind`, `/codex resume`, `/codex steer`, ... | Прив'язує треди app-server Codex до розмови в месенджері та керує ними. | -| Провайдер/каталог app-server Codex | внутрішні компоненти `codex`, доступні через каркас | Дає середовищу виконання змогу виявляти й перевіряти моделі app-server. | -| Шлях розуміння медіа Codex | шляхи сумісності моделей зображень `codex/*` | Запускає обмежені ходи app-server Codex для підтримуваних моделей розуміння зображень. | -| Нативний ретранслятор хуків | хуки Plugin навколо нативних подій Codex | Дає OpenClaw змогу спостерігати/блокувати підтримувані нативні події інструментів/фіналізації Codex. | +| Нативний вбудований runtime | `agentRuntime.id: "codex"` | Запускає вбудовані ходи агента OpenClaw через app-server Codex. | +| Нативні команди керування чатом | `/codex bind`, `/codex resume`, `/codex steer`, ... | Прив’язує та керує потоками app-server Codex із розмови в месенджері. | +| Провайдер/каталог app-server Codex | внутрішні механізми `codex`, відкриті через обв’язку | Дає runtime змогу виявляти й перевіряти моделі app-server. | +| Шлях розуміння медіа Codex | шляхи сумісності моделей зображень `codex/*` | Запускає обмежені ходи app-server Codex для підтримуваних моделей розуміння зображень. | +| Нативний ретранслятор hook | hook-и Plugin навколо нативних подій Codex | Дає OpenClaw змогу спостерігати/блокувати підтримувані нативні події інструментів/фіналізації Codex. | Увімкнення Plugin робить ці можливості доступними. Воно **не**: - починає використовувати Codex для кожної моделі OpenAI -- перетворює посилання на моделі `openai-codex/*` на нативне середовище виконання +- перетворює посилання на моделі `openai-codex/*` на нативний runtime - робить ACP/acpx типовим шляхом Codex -- перемикає на льоту наявні сесії, які вже записали середовище виконання PI -- замінює доставку каналів OpenClaw, файли сесій, сховище профілів автентифікації або +- миттєво перемикає наявні сесії, які вже записали runtime PI +- замінює доставку каналами OpenClaw, файли сесій, сховище профілів автентифікації або маршрутизацію повідомлень -Той самий Plugin також володіє нативною поверхнею команд керування чатом `/codex`. Якщо -Plugin увімкнено і користувач просить прив'язати, відновити, спрямувати, зупинити або перевірити треди Codex з чату, агенти мають віддавати перевагу `/codex ...` над ACP. ACP залишається явним запасним варіантом, коли користувач просить ACP/acpx або тестує адаптер ACP Codex. +Цей самий plugin також володіє нативною поверхнею команд керування чатом `/codex`. Якщо +plugin увімкнено й користувач просить прив’язати, відновити, скерувати, зупинити або перевірити +потоки Codex із чату, агенти мають віддавати перевагу `/codex ...` над ACP. ACP лишається +явним запасним варіантом, коли користувач просить ACP/acpx або тестує адаптер ACP +Codex. -Нативні ходи Codex зберігають хуки Plugin OpenClaw як публічний шар сумісності. -Це внутрішньопроцесні хуки OpenClaw, а не командні хуки Codex `hooks.json`: +Нативні ходи Codex зберігають hook-и Plugin OpenClaw як публічний шар сумісності. +Це внутрішньопроцесні hook-и OpenClaw, а не command hook-и Codex `hooks.json`: - `before_prompt_build` - `before_compaction`, `after_compaction` @@ -114,157 +136,170 @@ Plugin увімкнено і користувач просить прив'яза - `before_agent_finalize` через ретранслятор Codex `Stop` - `agent_end` -Plugins також можуть реєструвати нейтральне до середовища виконання проміжне ПЗ результатів інструментів, щоб переписувати динамічні результати інструментів OpenClaw після того, як OpenClaw виконає інструмент, і до того, як результат буде повернено Codex. Це окремо від публічного хука Plugin `tool_result_persist`, який перетворює записи результатів інструментів транскрипту, що належать OpenClaw. +Plugins також можуть реєструвати нейтральне до runtime проміжне ПЗ результатів інструментів, щоб переписувати +динамічні результати інструментів OpenClaw після того, як OpenClaw виконує інструмент, і до того, як +результат повертається до Codex. Це окремо від публічного hook-а Plugin +`tool_result_persist`, який перетворює записи результатів інструментів у транскрипті, що належать OpenClaw. -Щодо семантики самих хуків Plugin див. [Хуки Plugin](/uk/plugins/hooks) -і [Поведінка захисту Plugin](/uk/tools/plugin). +Семантику самих hook-ів Plugin див. у [hook-и Plugin](/uk/plugins/hooks) +та [Поведінка захисту Plugin](/uk/tools/plugin). -Каркас типово вимкнено. Нові конфігурації мають залишати посилання на моделі OpenAI канонічними як `openai/gpt-*` і явно задавати -`agentRuntime.id: "codex"` або `OPENCLAW_AGENT_RUNTIME=codex`, коли потрібне нативне виконання app-server. Застарілі посилання на моделі `codex/*` усе ще автоматично вибирають каркас для сумісності, але застарілі префікси провайдерів, підкріплені середовищем виконання, не показуються як звичайні варіанти моделі/провайдера. +Обв’язка вимкнена за замовчуванням. Нові конфігурації мають зберігати посилання на моделі OpenAI +канонічними як `openai/gpt-*` і явно задавати +`agentRuntime.id: "codex"` або `OPENCLAW_AGENT_RUNTIME=codex`, коли їм +потрібне нативне виконання app-server. Застарілі посилання на моделі `codex/*` усе ще автоматично вибирають +обв’язку для сумісності, але застарілі префікси провайдерів, підкріплені runtime, +не показуються як звичайні варіанти моделі/провайдера. -Якщо Plugin `codex` увімкнено, але основна модель усе ще -`openai-codex/*`, `openclaw doctor` попереджає замість зміни маршруту. Це -навмисно: `openai-codex/*` залишається шляхом Codex OAuth/підписки через PI, а -нативне виконання app-server залишається явним вибором середовища виконання. +Якщо plugin `codex` увімкнено, але основна модель усе ще +`openai-codex/*`, `openclaw doctor` попереджає замість того, щоб змінювати маршрут. Це +навмисно: `openai-codex/*` лишається шляхом PI Codex OAuth/передплати, а +нативне виконання app-server лишається явним вибором runtime. ## Карта маршрутів Скористайтеся цією таблицею перед зміною конфігурації: -| Бажана поведінка | Посилання на модель | Конфігурація середовища виконання | Маршрут автентифікації/профілю | Очікувана мітка статусу | +| Бажана поведінка | Посилання на модель | Конфігурація runtime | Маршрут автентифікації/профілю | Очікувана мітка статусу | | ---------------------------------------------------- | -------------------------- | -------------------------------------- | ---------------------------- | ------------------------------ | -| Підписка ChatGPT/Codex з нативним середовищем виконання Codex | `openai/gpt-*` | `agentRuntime.id: "codex"` | Codex OAuth або обліковий запис Codex | `Runtime: OpenAI Codex` | -| OpenAI API через звичайний runner OpenClaw | `openai/gpt-*` | пропущено або `runtime: "pi"` | ключ OpenAI API | `Runtime: OpenClaw Pi Default` | -| Підписка ChatGPT/Codex через PI | `openai-codex/gpt-*` | пропущено або `runtime: "pi"` | провайдер OpenAI Codex OAuth | `Runtime: OpenClaw Pi Default` | -| Змішані провайдери з консервативним автоматичним режимом | посилання, специфічні для провайдера | `agentRuntime.id: "auto"` | За вибраним провайдером | Залежить від вибраного середовища виконання | -| Явна сесія адаптера Codex ACP | залежить від prompt/моделі ACP | `sessions_spawn` з `runtime: "acp"` | автентифікація бекенду ACP | статус завдання/сесії ACP | +| Передплата ChatGPT/Codex із нативним runtime Codex | `openai/gpt-*` | `agentRuntime.id: "codex"` | Codex OAuth або обліковий запис Codex | `Runtime: OpenAI Codex` | +| OpenAI API через звичайний runner OpenClaw | `openai/gpt-*` | пропущено або `runtime: "pi"` | ключ OpenAI API | `Runtime: OpenClaw Pi Default` | +| Передплата ChatGPT/Codex через PI | `openai-codex/gpt-*` | пропущено або `runtime: "pi"` | провайдер OpenAI Codex OAuth | `Runtime: OpenClaw Pi Default` | +| Змішані провайдери з консервативним автоматичним режимом | посилання, специфічні для провайдера | `agentRuntime.id: "auto"` | За вибраним провайдером | Залежить від вибраного runtime | +| Явна сесія адаптера Codex ACP | залежить від промпта/моделі ACP | `sessions_spawn` з `runtime: "acp"` | автентифікація backend ACP | статус завдання/сесії ACP | -Важливий поділ — провайдер проти середовища виконання: +Важливий поділ — між провайдером і runtime: - `openai-codex/*` відповідає на питання "який маршрут провайдера/автентифікації має використовувати PI?" -- `agentRuntime.id: "codex"` відповідає на питання "який цикл має виконати цей +- `agentRuntime.id: "codex"` відповідає на питання "який цикл має виконувати цей вбудований хід?" -- `/codex ...` відповідає на питання "до якої нативної розмови Codex цей чат має прив'язатися - або якою керувати?" -- ACP відповідає на питання "який зовнішній процес каркаса має запускати acpx?" +- `/codex ...` відповідає на питання "яку нативну розмову Codex має прив’язати + або контролювати цей чат?" +- ACP відповідає на питання "який зовнішній процес обв’язки має запускати acpx?" ## Виберіть правильний префікс моделі -Маршрути сімейства OpenAI залежать від префікса. Для поширеного налаштування з підпискою плюс -нативним середовищем виконання Codex використовуйте `openai/*` з `agentRuntime.id: "codex"`. +Маршрути родини OpenAI залежать від префікса. Для поширеної конфігурації передплати плюс +нативний runtime Codex використовуйте `openai/*` з `agentRuntime.id: "codex"`. Використовуйте `openai-codex/*` лише тоді, коли навмисно хочете Codex OAuth через PI: -| Посилання на модель | Шлях середовища виконання | Коли використовувати | +| Посилання на модель | Шлях runtime | Коли використовувати | | --------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------- | -| `openai/gpt-5.4` | провайдер OpenAI через plumbing OpenClaw/PI | Потрібен поточний прямий доступ до OpenAI Platform API з `OPENAI_API_KEY`. | -| `openai-codex/gpt-5.5` | OpenAI Codex OAuth через OpenClaw/PI | Потрібна автентифікація підписки ChatGPT/Codex з типовим runner PI. | -| `openai/gpt-5.5` + `agentRuntime.id: "codex"` | каркас app-server Codex | Потрібна автентифікація підписки ChatGPT/Codex з нативним виконанням Codex. | +| `openai/gpt-5.4` | провайдер OpenAI через обв’язку OpenClaw/PI | Вам потрібен поточний прямий доступ до OpenAI Platform API з `OPENAI_API_KEY`. | +| `openai-codex/gpt-5.5` | OpenAI Codex OAuth через OpenClaw/PI | Вам потрібна автентифікація передплати ChatGPT/Codex зі стандартним runner PI. | +| `openai/gpt-5.5` + `agentRuntime.id: "codex"` | обв’язка app-server Codex | Вам потрібна автентифікація передплати ChatGPT/Codex із нативним виконанням Codex. | -GPT-5.5 може з'являтися як на маршрутах прямого API-ключа OpenAI, так і на маршрутах підписки Codex, -коли ваш обліковий запис надає їх. Використовуйте `openai/gpt-5.5` з каркасом app-server Codex -для нативного середовища виконання Codex, `openai-codex/gpt-5.5` для PI OAuth або -`openai/gpt-5.5` без перевизначення середовища виконання Codex для прямого трафіку API-ключа. +GPT-5.5 може з’являтися як на прямих маршрутах OpenAI API-ключа, так і на маршрутах передплати Codex, +коли ваш обліковий запис їх відкриває. Використовуйте `openai/gpt-5.5` з обв’язкою app-server +Codex для нативного runtime Codex, `openai-codex/gpt-5.5` для PI OAuth або +`openai/gpt-5.5` без перевизначення runtime Codex для прямого трафіку API-ключа. -Застарілі посилання `codex/gpt-*` залишаються прийнятими як псевдоніми сумісності. Міграція сумісності doctor переписує застарілі основні посилання середовища виконання на канонічні посилання на моделі й записує політику середовища виконання окремо, тоді як застарілі посилання лише для резерву залишаються без змін, бо середовище виконання налаштовується для всього контейнера агента. -Нові конфігурації PI Codex OAuth мають використовувати `openai-codex/gpt-*`; нові конфігурації нативного каркаса app-server мають використовувати `openai/gpt-*` плюс +Застарілі посилання `codex/gpt-*` лишаються прийнятими як псевдоніми сумісності. Міграція сумісності +Doctor переписує застарілі основні посилання runtime на канонічні посилання на моделі +та записує політику runtime окремо, тоді як лише fallback-застарілі посилання +лишаються без змін, бо runtime налаштовується для всього контейнера агента. +Нові конфігурації PI Codex OAuth мають використовувати `openai-codex/gpt-*`; нові конфігурації нативної +обв’язки app-server мають використовувати `openai/gpt-*` плюс `agentRuntime.id: "codex"`. `agents.defaults.imageModel` дотримується того самого поділу префіксів. Використовуйте `openai-codex/gpt-*`, коли розуміння зображень має виконуватися через шлях провайдера OpenAI -Codex OAuth. Використовуйте `codex/gpt-*`, коли розуміння зображень має виконуватися через обмежений хід app-server Codex. Модель app-server Codex повинна -оголошувати підтримку введення зображень; текстові моделі Codex зазнають невдачі до початку медіаходу. +Codex OAuth. Використовуйте `codex/gpt-*`, коли розуміння зображень має виконуватися +через обмежений хід app-server Codex. Модель app-server Codex має +оголошувати підтримку вхідних зображень; текстові моделі Codex завершаються помилкою до того, як медіа-хід +почнеться. -Використовуйте `/status`, щоб підтвердити ефективний каркас для поточної сесії. Якщо вибір несподіваний, увімкніть debug logging для підсистеми `agents/harness` -і перегляньте структурований запис `agent harness selected` Gateway. Він -містить вибраний id каркаса, причину вибору, політику середовища виконання/резерву і, -в режимі `auto`, результат підтримки кожного кандидата Plugin. +Використовуйте `/status`, щоб підтвердити ефективну обв’язку для поточної сесії. Якщо +вибір несподіваний, увімкніть debug-логування для підсистеми `agents/harness` +і перегляньте структурований запис Gateway `agent harness selected`. Він +містить вибраний ідентифікатор обв’язки, причину вибору, політику runtime/fallback, а +в режимі `auto` — результат підтримки кожного кандидата Plugin. ### Що означають попередження doctor -`openclaw doctor` попереджає, коли істинні всі ці умови: +`openclaw doctor` попереджає, коли всі ці умови істинні: -- вбудований Plugin `codex` увімкнено або дозволено +- вбудований plugin `codex` увімкнено або дозволено - основна модель агента — `openai-codex/*` -- ефективне середовище виконання цього агента не є `codex` +- ефективний runtime цього агента не `codex` -Це попередження існує тому, що користувачі часто очікують, що "Plugin Codex увімкнено" означає -"нативне середовище виконання app-server Codex." OpenClaw не робить такого переходу. Попередження +Це попередження існує, бо користувачі часто очікують, що "plugin Codex увімкнено" означає +"нативний runtime app-server Codex." OpenClaw не робить такого переходу. Попередження означає: -- **Змін не потрібно**, якщо ви мали на увазі ChatGPT/Codex OAuth через PI. -- Змініть модель на `openai/` і встановіть - `agentRuntime.id: "codex"`, якщо ви мали на увазі нативне виконання app-server. -- Наявні сесії все ще потребують `/new` або `/reset` після зміни середовища виконання, - бо прив'язки середовища виконання сесії є липкими. +- **Жодних змін не потрібно**, якщо ви мали на увазі ChatGPT/Codex OAuth через PI. +- Змініть модель на `openai/` і задайте + `agentRuntime.id: "codex"`, якщо ви мали на увазі нативне виконання + app-server. +- Наявним сесіям усе одно потрібні `/new` або `/reset` після зміни runtime, + бо прив’язки runtime сесії липкі. -Вибір каркаса не є керуванням живою сесією. Коли виконується вбудований хід, -OpenClaw записує вибраний id каркаса в цій сесії та продовжує використовувати його для -пізніших ходів у тій самій сесії id. Змініть конфігурацію `agentRuntime` або -`OPENCLAW_AGENT_RUNTIME`, коли хочете, щоб майбутні сесії використовували інший каркас; +Вибір обв’язки не є живим керуванням сесією. Коли виконується вбудований хід, +OpenClaw записує вибраний ідентифікатор обв’язки в цій сесії та продовжує використовувати його для +подальших ходів у тому самому ідентифікаторі сесії. Змініть конфігурацію `agentRuntime` або +`OPENCLAW_AGENT_RUNTIME`, коли хочете, щоб майбутні сесії використовували іншу обв’язку; використовуйте `/new` або `/reset`, щоб почати свіжу сесію перед перемиканням наявної -розмови між PI і Codex. Це уникає повторного програвання одного транскрипту через +розмови між PI і Codex. Це запобігає відтворенню одного транскрипту через дві несумісні нативні системи сесій. -Застарілі сеанси, створені до закріплень harness, вважаються PI-закріпленими, -щойно мають історію transcript. Використайте `/new` або `/reset`, щоб увімкнути +Застарілі сеанси, створені до закріплень harness, вважаються закріпленими за PI, щойно +вони мають історію стенограми. Використайте `/new` або `/reset`, щоб увімкнути Codex для цієї розмови після зміни конфігурації. -`/status` показує фактичний runtime моделі. Стандартний PI harness відображається як -`Runtime: OpenClaw Pi Default`, а harness сервера застосунку Codex - як +`/status` показує ефективний runtime моделі. Стандартний harness PI відображається як +`Runtime: OpenClaw Pi Default`, а harness сервера застосунку Codex відображається як `Runtime: OpenAI Codex`. ## Вимоги - OpenClaw із доступним вбудованим Plugin `codex`. -- Сервер застосунку Codex `0.125.0` або новіший. Вбудований Plugin за замовчуванням - керує сумісним бінарним файлом сервера застосунку Codex, тому локальні команди - `codex` у `PATH` не впливають на звичайний запуск harness. -- Автентифікація Codex, доступна процесу сервера застосунку або мосту - автентифікації Codex в OpenClaw. Локальні запуски сервера застосунку використовують - керований OpenClaw домашній каталог Codex для кожного агента й ізольований дочірній - `HOME`, тому за замовчуванням вони не читають ваш особистий обліковий запис - `~/.codex`, Skills, plugins, конфігурацію, стан thread або нативні +- Сервер застосунку Codex `0.125.0` або новіший. Вбудований Plugin стандартно керує сумісним + бінарним файлом сервера застосунку Codex, тому локальні команди `codex` у `PATH` + не впливають на звичайний запуск harness. +- Автентифікація Codex, доступна процесу сервера застосунку або мосту автентифікації Codex + в OpenClaw. Локальні запуски сервера застосунку використовують керований OpenClaw домашній каталог Codex для кожного + агента та ізольований дочірній `HOME`, тому стандартно вони не читають ваш особистий + обліковий запис `~/.codex`, skills, plugins, конфігурацію, стан потоків або нативні `$HOME/.agents/skills`. -Plugin блокує старіші або неверсіоновані handshakes сервера застосунку. Це утримує +Plugin блокує застарілі або неверсіоновані рукостискання сервера застосунку. Це утримує OpenClaw на поверхні протоколу, з якою його було протестовано. -Для live- і Docker-smoke-тестів автентифікація зазвичай надходить з облікового запису -Codex CLI або профілю автентифікації OpenClaw `openai-codex`. Локальні запуски -stdio-сервера застосунку також можуть повертатися до `CODEX_API_KEY` / -`OPENAI_API_KEY`, коли обліковий запис відсутній. +Для live- і Docker-smoke-тестів автентифікація зазвичай надходить з облікового запису Codex CLI +або профілю автентифікації OpenClaw `openai-codex`. Локальні запуски сервера застосунку stdio +також можуть повернутися до `CODEX_API_KEY` / `OPENAI_API_KEY`, коли обліковий запис відсутній. -## Файли початкового завантаження робочої області +## Файли початкового налаштування робочого простору -Codex сам обробляє `AGENTS.md` через нативне виявлення проєктної документації. OpenClaw -не записує синтетичні проєктні файли документації Codex і не залежить від запасних -імен файлів Codex для файлів persona, оскільки fallback Codex застосовуються лише тоді, -коли бракує `AGENTS.md`. +Codex сам обробляє `AGENTS.md` через нативне виявлення документації проєкту. OpenClaw +не записує синтетичні файли документації проєкту Codex і не залежить від резервних +імен файлів Codex для persona-файлів, оскільки резервні варіанти Codex застосовуються лише тоді, коли +`AGENTS.md` відсутній. -Для паритету робочої області OpenClaw harness Codex розв'язує інші файли початкового -завантаження (`SOUL.md`, `TOOLS.md`, `IDENTITY.md`, `USER.md`, `HEARTBEAT.md`, -`BOOTSTRAP.md` і `MEMORY.md`, коли вони наявні) і передає їх через інструкції -конфігурації Codex у `thread/start` і `thread/resume`. Це зберігає `SOUL.md` і -пов'язаний контекст persona/профілю робочої області видимими без дублювання -`AGENTS.md`. +Для паритету робочого простору OpenClaw harness Codex розв’язує інші файли початкового налаштування +(`SOUL.md`, `TOOLS.md`, `IDENTITY.md`, `USER.md`, `HEARTBEAT.md`, +`BOOTSTRAP.md` і `MEMORY.md`, коли вони наявні) та передає їх через інструкції конфігурації Codex +під час `thread/start` і `thread/resume`. Це зберігає +`SOUL.md` і пов’язаний контекст persona/профілю робочого простору видимими без +дублювання `AGENTS.md`. -## Додайте Codex поруч з іншими моделями +## Додавання Codex поряд з іншими моделями -Не встановлюйте `agentRuntime.id: "codex"` глобально, якщо той самий агент має вільно -перемикатися між Codex і моделями провайдерів не Codex. Примусовий runtime застосовується -до кожного вбудованого turn для цього агента або сеансу. Якщо вибрати модель Anthropic, -коли цей runtime примусовий, OpenClaw усе одно намагається використати harness Codex і -завершує роботу закритою помилкою замість того, щоб тихо маршрутизувати цей turn через PI. +Не встановлюйте `agentRuntime.id: "codex"` глобально, якщо той самий агент має вільно перемикатися +між моделями провайдерів Codex і не-Codex. Примусовий runtime застосовується до кожного +вбудованого ходу для цього агента або сеансу. Якщо ви виберете модель Anthropic, коли +цей runtime примусово ввімкнений, OpenClaw усе одно спробує harness Codex і завершиться закрито, +замість того щоб непомітно маршрутизувати цей хід через PI. -Натомість використайте одну з цих форм: +Натомість використайте один із цих варіантів: - Розмістіть Codex на окремому агенті з `agentRuntime.id: "codex"`. -- Залиште стандартного агента на `agentRuntime.id: "auto"` і PI fallback для звичайного - змішаного використання провайдерів. -- Використовуйте застарілі посилання `codex/*` лише для сумісності. Нові конфігурації - мають віддавати перевагу `openai/*` плюс явній політиці runtime Codex. +- Залиште стандартного агента на `agentRuntime.id: "auto"` і резервний PI для звичайного змішаного + використання провайдерів. +- Використовуйте застарілі посилання `codex/*` лише для сумісності. Нові конфігурації мають надавати перевагу + `openai/*` плюс явній політиці runtime Codex. -Наприклад, це залишає стандартного агента на звичайному автоматичному виборі й +Наприклад, це залишає стандартного агента на звичайному автоматичному виборі та додає окремого агента Codex: ```json5 @@ -301,12 +336,12 @@ Codex сам обробляє `AGENTS.md` через нативне виявле } ``` -З цією формою: +З такою структурою: -- Стандартний агент `main` використовує звичайний шлях провайдера і fallback PI-сумісності. +- Стандартний агент `main` використовує звичайний шлях провайдера та резервну сумісність PI. - Агент `codex` використовує harness сервера застосунку Codex. -- Якщо Codex відсутній або не підтримується для агента `codex`, turn завершується - помилкою замість тихого використання PI. +- Якщо Codex відсутній або не підтримується для агента `codex`, хід завершується помилкою, + а не тихо використовує PI. ## Маршрутизація команд агента @@ -314,25 +349,25 @@ Codex сам обробляє `AGENTS.md` через нативне виявле | Користувач просить... | Агент має використати... | | ------------------------------------------------------ | ------------------------------------------------ | -| "Прив'язати цей чат до Codex" | `/codex bind` | -| "Відновити thread Codex `` тут" | `/codex resume ` | -| "Показати threads Codex" | `/codex threads` | -| "Подати звіт у підтримку про невдалий запуск Codex" | `/diagnostics [note]` | -| "Надіслати відгук Codex лише для цього вкладеного thread" | `/codex diagnostics [note]` | -| "Використати мою підписку ChatGPT/Codex з runtime Codex" | `openai/*` плюс `agentRuntime.id: "codex"` | -| "Використати мою підписку ChatGPT/Codex через PI" | посилання моделей `openai-codex/*` | +| "Прив’язати цей чат до Codex" | `/codex bind` | +| "Відновити потік Codex `` тут" | `/codex resume ` | +| "Показати потоки Codex" | `/codex threads` | +| "Подати звіт підтримки про невдалий запуск Codex" | `/diagnostics [note]` | +| "Надіслати лише відгук Codex для цього вкладеного потоку" | `/codex diagnostics [note]` | +| "Використати мою підписку ChatGPT/Codex із runtime Codex" | `openai/*` плюс `agentRuntime.id: "codex"` | +| "Використати мою підписку ChatGPT/Codex через PI" | посилання на моделі `openai-codex/*` | | "Запустити Codex через ACP/acpx" | ACP `sessions_spawn({ runtime: "acp", ... })` | -| "Запустити Claude Code/Gemini/OpenCode/Cursor у thread" | ACP/acpx, не `/codex` і не нативні sub-agents | +| "Запустити Claude Code/Gemini/OpenCode/Cursor у потоці" | ACP/acpx, не `/codex` і не нативні субагенти | OpenClaw рекламує агентам настанови щодо створення ACP лише тоді, коли ACP увімкнено, -доступно для dispatch і підкріплено завантаженим runtime backend. Якщо ACP недоступний, -системний prompt і plugin skills не мають навчати агента маршрутизації ACP. +доступний для диспетчеризації та підтриманий завантаженим бекендом runtime. Якщо ACP недоступний, +системний prompt і skills Plugin не мають навчати агента маршрутизації ACP. ## Розгортання лише з Codex -Примусово використовуйте harness Codex, коли потрібно довести, що кожен вбудований turn -агента використовує Codex. Явні plugin runtimes завершуються закритою помилкою і ніколи -не повторюються тихо через PI: +Примусово використовуйте harness Codex, коли потрібно довести, що кожен вбудований хід агента +використовує Codex. Явні runtime Plugin завершуються закрито й ніколи непомітно не повторюються +через PI: ```json5 { @@ -347,18 +382,18 @@ OpenClaw рекламує агентам настанови щодо створ } ``` -Перевизначення через середовище: +Перевизначення середовища: ```bash OPENCLAW_AGENT_RUNTIME=codex openclaw gateway run ``` -Коли Codex примусовий, OpenClaw рано завершується помилкою, якщо Plugin Codex вимкнено, -сервер застосунку занадто старий або сервер застосунку не може запуститися. +Коли Codex примусово ввімкнено, OpenClaw завершується рано, якщо Plugin Codex вимкнено, якщо +сервер застосунку надто старий або якщо сервер застосунку не може запуститися. ## Codex для окремого агента -Можна зробити одного агента лише Codex, тоді як стандартний агент зберігає звичайний +Ви можете зробити одного агента лише Codex, тоді як стандартний агент зберігає звичайний автовибір: ```json5 @@ -388,22 +423,21 @@ OPENCLAW_AGENT_RUNTIME=codex openclaw gateway run } ``` -Використовуйте звичайні команди сеансу, щоб перемикати агентів і моделі. `/new` створює -свіжий сеанс OpenClaw, а harness Codex створює або відновлює свій sidecar thread сервера -застосунку за потреби. `/reset` очищає прив'язку сеансу OpenClaw для цього thread і -дозволяє наступному turn знову визначити harness із поточної конфігурації. +Використовуйте звичайні команди сеансу, щоб перемикати агентів і моделі. `/new` створює свіжий +сеанс OpenClaw, а harness Codex створює або відновлює свій супровідний потік сервера застосунку +за потреби. `/reset` очищує прив’язку сеансу OpenClaw для цього потоку +та дозволяє наступному ходу знову визначити harness з поточної конфігурації. ## Виявлення моделей -За замовчуванням Plugin Codex запитує в сервера застосунку доступні моделі. Якщо -виявлення зазнає невдачі або спливає час очікування, він використовує вбудований -fallback-каталог для: +Стандартно Plugin Codex запитує у сервера застосунку доступні моделі. Якщо +виявлення не вдається або спливає час очікування, він використовує вбудований резервний каталог для: - GPT-5.5 - GPT-5.4 mini - GPT-5.2 -Можна налаштувати виявлення в `plugins.entries.codex.config.discovery`: +Ви можете налаштувати виявлення в `plugins.entries.codex.config.discovery`: ```json5 { @@ -423,8 +457,8 @@ fallback-каталог для: } ``` -Вимкніть виявлення, коли потрібно, щоб запуск не зондував Codex і тримався -fallback-каталогу: +Вимкніть виявлення, коли хочете, щоб запуск уникав перевірки Codex і дотримувався +резервного каталогу: ```json5 { @@ -443,27 +477,26 @@ fallback-каталогу: } ``` -## Підключення й політика сервера застосунку +## Підключення та політика сервера застосунку -За замовчуванням Plugin запускає керований OpenClaw бінарний файл Codex локально з: +Стандартно Plugin запускає керований OpenClaw бінарний файл Codex локально з: ```bash codex app-server --listen stdio:// ``` -Керований бінарний файл постачається з пакетом Plugin `codex`. Це утримує версію -сервера застосунку прив'язаною до вбудованого Plugin, а не до будь-якого окремого -Codex CLI, який випадково встановлено локально. Установлюйте `appServer.command` лише -тоді, коли навмисно хочете запускати інший виконуваний файл. +Керований бінарний файл постачається з пакетом Plugin `codex`. Це зберігає +версію сервера застосунку прив’язаною до вбудованого Plugin, а не до будь-якого окремого +Codex CLI, який випадково встановлено локально. Встановлюйте `appServer.command` лише тоді, +коли ви навмисно хочете запустити інший виконуваний файл. -За замовчуванням OpenClaw запускає локальні сеанси harness Codex у режимі YOLO: +Стандартно OpenClaw запускає локальні сеанси harness Codex у режимі YOLO: `approvalPolicy: "never"`, `approvalsReviewer: "user"` і -`sandbox: "danger-full-access"`. Це довірена позиція локального оператора, що -використовується для автономних heartbeats: Codex може використовувати інструменти -shell і мережі, не зупиняючись на нативних prompts схвалення, на які ніхто не зможе -відповісти. +`sandbox: "danger-full-access"`. Це довірена позиція локального оператора, яку використовують +для автономних Heartbeat: Codex може використовувати shell- і мережеві інструменти без +зупинки на нативних запитах схвалення, на які нікому відповісти. -Щоб увімкнути схвалення Codex із перевіркою guardian, установіть `appServer.mode: +Щоб увімкнути схвалення Codex із перевіркою guardian, встановіть `appServer.mode: "guardian"`: ```json5 @@ -484,21 +517,21 @@ shell і мережі, не зупиняючись на нативних prompts } ``` -Режим Guardian використовує нативний шлях автоматичного перегляду схвалень Codex. Коли -Codex просить залишити sandbox, писати поза робочою областю або додати дозволи, як-от -доступ до мережі, Codex маршрутизує цей запит на схвалення нативному reviewer замість -людського prompt. Reviewer застосовує фреймворк ризику Codex і схвалює або відхиляє -конкретний запит. Використовуйте Guardian, коли потрібні суворіші запобіжники, ніж у -режимі YOLO, але агенти без нагляду все одно мають просуватися вперед. +Режим Guardian використовує нативний шлях автоматичної перевірки схвалень Codex. Коли Codex просить +вийти з sandbox, записати за межами робочого простору або додати дозволи, наприклад мережевий +доступ, Codex маршрутизує цей запит схвалення до нативного рецензента, а не до +людського prompt. Рецензент застосовує систему оцінки ризиків Codex і схвалює або відхиляє +конкретний запит. Використовуйте Guardian, коли потрібно більше запобіжників, ніж у режимі YOLO, +але агентам без нагляду все одно потрібно просуватися вперед. Пресет `guardian` розгортається в `approvalPolicy: "on-request"`, `approvalsReviewer: "auto_review"` і `sandbox: "workspace-write"`. -Окремі поля політики все ще перевизначають `mode`, тому розширені розгортання можуть -поєднувати пресет із явними виборами. Старіше значення reviewer `guardian_subagent` +Окремі поля політики все ще перевизначають `mode`, тому розширені розгортання можуть поєднувати +пресет з явними виборами. Старіше значення рецензента `guardian_subagent` досі приймається як псевдонім сумісності, але нові конфігурації мають використовувати `auto_review`. -Для вже запущеного сервера застосунку використовуйте WebSocket-транспорт: +Для вже запущеного сервера застосунку використовуйте транспорт WebSocket: ```json5 { @@ -520,46 +553,46 @@ Codex просить залишити sandbox, писати поза робоч } ``` -Запуски stdio-сервера застосунку за замовчуванням успадковують середовище процесу -OpenClaw, але OpenClaw володіє мостом облікового запису сервера застосунку Codex і -встановлює `CODEX_HOME` та `HOME` у каталоги для кожного агента під станом OpenClaw -цього агента. Власний завантажувач Skills Codex читає `$CODEX_HOME/skills` і -`$HOME/.agents/skills`, тому обидва значення ізольовані для локальних запусків сервера -застосунку. Це утримує Codex-native Skills, plugins, конфігурацію, облікові записи та -стан thread у межах агента OpenClaw замість витоку з особистого домашнього каталогу -Codex CLI оператора. +Запуски сервера застосунку stdio стандартно успадковують середовище процесу OpenClaw, +але OpenClaw володіє мостом облікового запису сервера застосунку Codex і встановлює як +`CODEX_HOME`, так і `HOME` у каталоги окремого агента під станом OpenClaw +цього агента. Власний завантажувач skills Codex читає `$CODEX_HOME/skills` і +`$HOME/.agents/skills`, тому обидва значення ізольовані для локальних запусків сервера застосунку. +Це зберігає нативні для Codex skills, plugins, конфігурацію, облікові записи та стан потоків +у межах агента OpenClaw, замість витікання з особистого домашнього каталогу Codex CLI +оператора. -Plugins OpenClaw і знімки Skills OpenClaw і надалі проходять через власний реєстр -plugins і завантажувач Skills OpenClaw. Особисті активи Codex CLI не проходять. Якщо у -вас є корисні Skills або plugins Codex CLI, які мають стати частиною агента OpenClaw, -явно інвентаризуйте їх: +Plugins OpenClaw і знімки skills OpenClaw усе ще проходять через власний реєстр +Plugin і завантажувач skills OpenClaw. Особисті ресурси Codex CLI не проходять. Якщо у вас є +корисні skills або plugins Codex CLI, які мають стати частиною агента OpenClaw, +проінвентаризуйте їх явно: ```bash openclaw migrate codex --dry-run openclaw migrate apply codex --yes ``` -Провайдер міграції Codex копіює Skills у поточну робочу область агента OpenClaw. -Нативні plugins, hooks і файли конфігурації Codex звітуються або архівуються для -ручного перегляду замість автоматичної активації, оскільки вони можуть виконувати -команди, відкривати MCP-сервери або містити облікові дані. +Провайдер міграції Codex копіює skills у поточний робочий простір агента OpenClaw. +Нативні plugins, hooks і файли конфігурації Codex звітуються або архівуються +для ручного перегляду, а не активуються автоматично, оскільки вони можуть +виконувати команди, надавати MCP-сервери або містити облікові дані. Автентифікація вибирається в такому порядку: 1. Явний профіль автентифікації OpenClaw Codex для агента. 2. Наявний обліковий запис сервера застосунку в домашньому каталозі Codex цього агента. -3. Лише для локальних запусків stdio-сервера застосунку: `CODEX_API_KEY`, потім - `OPENAI_API_KEY`, коли обліковий запис сервера застосунку відсутній, а автентифікація - OpenAI усе ще потрібна. +3. Лише для локальних запусків сервера застосунку stdio: `CODEX_API_KEY`, потім + `OPENAI_API_KEY`, коли обліковий запис сервера застосунку відсутній, а автентифікація OpenAI + усе ще потрібна. -Коли OpenClaw бачить профіль автентифікації Codex у стилі підписки ChatGPT, він вилучає -`CODEX_API_KEY` і `OPENAI_API_KEY` зі створеного дочірнього процесу Codex. Це зберігає -API-ключі рівня Gateway доступними для embeddings або прямих моделей OpenAI, не -змушуючи нативні turns сервера застосунку Codex випадково тарифікуватися через API. -Явні профілі API-ключів Codex і локальний fallback stdio env-key використовують login -сервера застосунку замість успадкованого env дочірнього процесу. Підключення WebSocket -до сервера застосунку не отримують fallback API-ключів env Gateway; використовуйте -явний профіль автентифікації або власний обліковий запис віддаленого сервера застосунку. +Коли OpenClaw бачить профіль автентифікації Codex у стилі підписки ChatGPT, він видаляє +`CODEX_API_KEY` і `OPENAI_API_KEY` зі створеного дочірнього процесу Codex. Це +зберігає API-ключі рівня Gateway доступними для embeddings або прямих моделей OpenAI, +не змушуючи нативні ходи сервера застосунку Codex випадково оплачуватися через API. +Явні профілі API-ключів Codex і локальний резервний stdio env-key використовують вхід сервера застосунку +замість успадкованого середовища дочірнього процесу. Підключення до сервера застосунку WebSocket +не отримують резервний API-ключ середовища Gateway; використовуйте явний профіль автентифікації або +власний обліковий запис віддаленого сервера застосунку. Якщо розгортанню потрібна додаткова ізоляція середовища, додайте ці змінні до `appServer.clearEnv`: @@ -584,48 +617,48 @@ API-ключі рівня Gateway доступними для embeddings або `appServer.clearEnv` впливає лише на породжений дочірній процес app-server Codex. Динамічні інструменти Codex за замовчуванням використовують профіль `native-first`. У цьому режимі -OpenClaw не відкриває динамічні інструменти, що дублюють нативні для Codex операції -з робочою областю: `read`, `write`, `edit`, `apply_patch`, `exec`, `process` і -`update_plan`. Інтеграційні інструменти OpenClaw, як-от обмін повідомленнями, сеанси, медіа, -cron, браузер, вузли, gateway, `heartbeat_respond` і `web_search`, залишаються +OpenClaw не надає динамічні інструменти, які дублюють нативні для Codex операції з робочим простором: +`read`, `write`, `edit`, `apply_patch`, `exec`, `process` і +`update_plan`. Інтеграційні інструменти OpenClaw, як-от messaging, sessions, media, +cron, browser, nodes, gateway, `heartbeat_respond` і `web_search`, залишаються доступними. -Підтримувані поля верхнього рівня Plugin Codex: +Підтримувані поля Plugin Codex верхнього рівня: -| Поле | За замовчуванням | Значення | -| -------------------------- | ---------------- | ------------------------------------------------------------------------------------------------ | -| `codexDynamicToolsProfile` | `"native-first"` | Використовуйте `"openclaw-compat"`, щоб відкрити повний набір динамічних інструментів OpenClaw для app-server Codex. | -| `codexDynamicToolsExclude` | `[]` | Додаткові назви динамічних інструментів OpenClaw, які слід вилучити з ходів app-server Codex. | +| Поле | Типово | Значення | +| -------------------------- | ---------------- | ----------------------------------------------------------------------------------------- | +| `codexDynamicToolsProfile` | `"native-first"` | Використовуйте `"openclaw-compat"`, щоб надати app-server Codex повний набір динамічних інструментів OpenClaw. | +| `codexDynamicToolsExclude` | `[]` | Додаткові назви динамічних інструментів OpenClaw, які слід пропускати в ходах app-server Codex. | Підтримувані поля `appServer`: -| Поле | За замовчуванням | Значення | +| Поле | Типово | Значення | | ------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `transport` | `"stdio"` | `"stdio"` породжує Codex; `"websocket"` підключається до `url`. | -| `command` | керований бінарний файл Codex | Виконуваний файл для транспорту stdio. Залиште невстановленим, щоб використовувати керований бінарний файл; задавайте лише для явного перевизначення. | -| `args` | `["app-server", "--listen", "stdio://"]` | Аргументи для транспорту stdio. | -| `url` | не встановлено | URL app-server WebSocket. | -| `authToken` | не встановлено | Bearer-токен для транспорту WebSocket. | -| `headers` | `{}` | Додаткові заголовки WebSocket. | -| `clearEnv` | `[]` | Додаткові назви змінних середовища, вилучені з породженого процесу stdio app-server після того, як OpenClaw побудує успадковане середовище. `CODEX_HOME` і `HOME` зарезервовані для локальної ізоляції Codex для кожного агента в OpenClaw. | -| `requestTimeoutMs` | `60000` | Час очікування для викликів площини керування app-server. | +| `transport` | `"stdio"` | `"stdio"` запускає Codex; `"websocket"` підключається до `url`. | +| `command` | керований бінарний файл Codex | Виконуваний файл для транспорту stdio. Залиште незаданим, щоб використовувати керований бінарний файл; задавайте лише для явного перевизначення. | +| `args` | `["app-server", "--listen", "stdio://"]` | Аргументи для транспорту stdio. | +| `url` | не задано | URL app-server WebSocket. | +| `authToken` | не задано | Bearer-токен для транспорту WebSocket. | +| `headers` | `{}` | Додаткові заголовки WebSocket. | +| `clearEnv` | `[]` | Додаткові назви змінних середовища, вилучені з породженого процесу stdio app-server після того, як OpenClaw сформує успадковане середовище. `CODEX_HOME` і `HOME` зарезервовані для ізоляції Codex на рівні агента OpenClaw під час локальних запусків. | +| `requestTimeoutMs` | `60000` | Таймаут для викликів площини керування app-server. | | `mode` | `"yolo"` | Попереднє налаштування для виконання YOLO або виконання з перевіркою guardian. | | `approvalPolicy` | `"never"` | Нативна політика схвалень Codex, яку надсилають під час start/resume/turn потоку. | | `sandbox` | `"danger-full-access"` | Нативний режим пісочниці Codex, який надсилають під час start/resume потоку. | -| `approvalsReviewer` | `"user"` | Використовуйте `"auto_review"`, щоб Codex перевіряв нативні запити схвалення. `guardian_subagent` залишається застарілим псевдонімом. | -| `serviceTier` | не встановлено | Необов’язковий рівень сервісу app-server Codex: `"fast"`, `"flex"` або `null`. Недійсні застарілі значення ігноруються. | +| `approvalsReviewer` | `"user"` | Використовуйте `"auto_review"`, щоб дозволити Codex перевіряти нативні запити на схвалення. `guardian_subagent` залишається застарілим псевдонімом. | +| `serviceTier` | не задано | Необов’язковий рівень сервісу app-server Codex: `"fast"`, `"flex"` або `null`. Недійсні застарілі значення ігноруються. | Виклики динамічних інструментів, що належать OpenClaw, обмежуються незалежно від `appServer.requestTimeoutMs`: кожен запит Codex `item/tool/call` має отримати -відповідь OpenClaw протягом 30 секунд. У разі тайм-ауту OpenClaw перериває сигнал +відповідь OpenClaw протягом 30 секунд. У разі таймауту OpenClaw перериває сигнал інструмента там, де це підтримується, і повертає Codex невдалу відповідь динамічного інструмента, щоб -хід міг продовжитися замість того, щоб залишити сеанс у стані `processing`. +хід міг продовжитися, а не залишати сеанс у стані `processing`. -Після того як OpenClaw відповідає на запит app-server в межах ходу Codex, обв’язка -також очікує, що Codex завершить нативний хід через `turn/completed`. Якщо -app-server мовчить 60 секунд після цієї відповіді, OpenClaw у режимі best-effort -перериває хід Codex, записує діагностичний тайм-аут і звільняє смугу сеансу -OpenClaw, щоб наступні повідомлення чату не ставали в чергу за застарілим +Після того як OpenClaw відповідає на запит app-server Codex, обмежений ходом, +harness також очікує, що Codex завершить нативний хід через `turn/completed`. Якщо +app-server не подає ознак активності протягом 60 секунд після цієї відповіді, OpenClaw з найкращим можливим зусиллям +перериває хід Codex, записує діагностичний таймаут і звільняє +смугу сеансу OpenClaw, щоб наступні повідомлення чату не ставали в чергу за застарілим нативним ходом. Перевизначення середовища залишаються доступними для локального тестування: @@ -637,18 +670,18 @@ OpenClaw, щоб наступні повідомлення чату не ста - `OPENCLAW_CODEX_APP_SERVER_SANDBOX` `OPENCLAW_CODEX_APP_SERVER_BIN` обходить керований бінарний файл, коли -`appServer.command` не встановлено. +`appServer.command` не задано. `OPENCLAW_CODEX_APP_SERVER_GUARDIAN=1` було вилучено. Натомість використовуйте `plugins.entries.codex.config.appServer.mode: "guardian"` або -`OPENCLAW_CODEX_APP_SERVER_MODE=guardian` для разового локального тестування. Конфігурація -є кращою для повторюваних розгортань, бо тримає поведінку Plugin у тому самому -переглянутому файлі, що й решту налаштування обв’язки Codex. +`OPENCLAW_CODEX_APP_SERVER_MODE=guardian` для одноразового локального тестування. Конфігурації +надається перевага для відтворюваних розгортань, оскільки вона зберігає поведінку Plugin у +тому самому перевіреному файлі, що й решта налаштування harness Codex. ## Використання комп’ютера -Використання комп’ютера описано в окремому посібнику з налаштування: -[Використання комп’ютера в Codex](/uk/plugins/codex-computer-use). +Computer Use описано в окремому посібнику з налаштування: +[Codex Computer Use](/uk/plugins/codex-computer-use). Коротко: OpenClaw не вбудовує застосунок керування робочим столом і не виконує дії на робочому столі самостійно. Він готує app-server Codex, перевіряє, що @@ -657,8 +690,8 @@ MCP-сервер `computer-use` доступний, а потім дозволя Для прямого доступу до драйвера TryCua поза потоком marketplace Codex зареєструйте `cua-driver mcp` за допомогою `openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'`. -Див. [Використання комп’ютера в Codex](/uk/plugins/codex-computer-use), щоб зрозуміти різницю -між використанням комп’ютера, яким керує Codex, і прямою реєстрацією MCP. +Див. [Codex Computer Use](/uk/plugins/codex-computer-use), щоб зрозуміти різницю +між Computer Use, яким володіє Codex, і прямою реєстрацією MCP. Мінімальна конфігурація: @@ -694,23 +727,23 @@ MCP-сервер `computer-use` доступний, а потім дозволя - `/codex computer-use install --source ` - `/codex computer-use install --marketplace-path ` -Використання комп’ютера специфічне для macOS і може потребувати локальних дозволів ОС, перш ніж +Computer Use є специфічним для macOS і може вимагати локальних дозволів ОС, перш ніж MCP-сервер Codex зможе керувати застосунками. Якщо `computerUse.enabled` має значення true, а MCP -сервер недоступний, ходи в режимі Codex завершуються помилкою до запуску потоку замість того, щоб -непомітно виконуватися без нативних інструментів використання комп’ютера. Див. -[Використання комп’ютера в Codex](/uk/plugins/codex-computer-use) щодо варіантів marketplace, -обмежень віддаленого каталогу, причин стану та усунення несправностей. +server недоступний, ходи в режимі Codex завершуються помилкою до запуску потоку, замість того щоб +тихо виконуватися без нативних інструментів Computer Use. Див. +[Codex Computer Use](/uk/plugins/codex-computer-use) щодо варіантів marketplace, +обмежень віддаленого каталогу, причин стану та усунення неполадок. Коли `computerUse.autoInstall` має значення true, OpenClaw може зареєструвати стандартний вбудований marketplace Codex Desktop з `/Applications/Codex.app/Contents/Resources/plugins/openai-bundled`, якщо Codex ще не виявив локальний marketplace. Використовуйте `/new` або `/reset` після -зміни runtime або конфігурації використання комп’ютера, щоб наявні сеанси не зберігали старе -прив’язування PI або потоку Codex. +зміни конфігурації runtime або Computer Use, щоб наявні сеанси не зберігали стару +прив’язку PI або потоку Codex. ## Поширені рецепти -Локальний Codex із транспортом stdio за замовчуванням: +Локальний Codex із типовим транспортом stdio: ```json5 { @@ -724,7 +757,7 @@ MCP-сервер Codex зможе керувати застосунками. Я } ``` -Валідація обв’язки лише Codex: +Перевірка harness лише для Codex: ```json5 { @@ -746,7 +779,7 @@ MCP-сервер Codex зможе керувати застосунками. Я } ``` -Схвалення Codex із перевіркою guardian: +Схвалення Codex з перевіркою guardian: ```json5 { @@ -791,275 +824,279 @@ MCP-сервер Codex зможе керувати застосунками. Я } ``` -Перемикання моделей залишається під керуванням OpenClaw. Коли сеанс OpenClaw приєднано -до наявного потоку Codex, наступний хід знову надсилає поточно вибрану +Перемикання моделей залишається під контролем OpenClaw. Коли сеанс OpenClaw прикріплено +до наявного потоку Codex, наступний хід знову надсилає поточно вибрані модель OpenAI, провайдера, політику схвалень, пісочницю та рівень сервісу до app-server. Перемикання з `openai/gpt-5.5` на `openai/gpt-5.2` зберігає -прив’язування потоку, але просить Codex продовжити з нововибраною моделлю. +прив’язку потоку, але просить Codex продовжити з новою вибраною моделлю. ## Команда Codex -Вбудований Plugin реєструє `/codex` як авторизовану slash-команду. Вона -універсальна й працює в будь-якому каналі, що підтримує текстові команди OpenClaw. +Вбудований Plugin реєструє `/codex` як авторизовану slash-команду. Вона є +універсальною та працює на будь-якому каналі, що підтримує текстові команди OpenClaw. Поширені форми: -- `/codex status` показує поточне підключення до app-server, моделі, обліковий запис, обмеження швидкості, MCP-сервери та Skills. -- `/codex models` перелічує поточні моделі app-server Codex. +- `/codex status` показує активне з’єднання із сервером застосунку, моделі, обліковий запис, ліміти частоти, MCP-сервери та Skills. +- `/codex models` перелічує доступні моделі сервера застосунку Codex. - `/codex threads [filter]` перелічує нещодавні потоки Codex. - `/codex resume ` приєднує поточний сеанс OpenClaw до наявного потоку Codex. -- `/codex compact` просить app-server Codex стиснути приєднаний потік. -- `/codex review` запускає нативну перевірку Codex для приєднаного потоку. +- `/codex compact` просить сервер застосунку Codex виконати Compaction приєднаного потоку. +- `/codex review` запускає нативний огляд Codex для приєднаного потоку. - `/codex diagnostics [note]` запитує підтвердження перед надсиланням діагностичного відгуку Codex для приєднаного потоку. - `/codex computer-use status` перевіряє налаштований Plugin Computer Use і MCP-сервер. -- `/codex computer-use install` установлює налаштований Plugin Computer Use і перезавантажує MCP-сервери. -- `/codex account` показує стан облікового запису й обмежень швидкості. -- `/codex mcp` перелічує стан MCP-серверів app-server Codex. -- `/codex skills` перелічує Skills app-server Codex. +- `/codex computer-use install` встановлює налаштований Plugin Computer Use і перезавантажує MCP-сервери. +- `/codex account` показує стан облікового запису та лімітів частоти. +- `/codex mcp` перелічує стан MCP-серверів сервера застосунку Codex. +- `/codex skills` перелічує Skills сервера застосунку Codex. + +Коли Codex повідомляє про помилку ліміту використання, OpenClaw додає наступний +час скидання сервера застосунку, якщо Codex його надав. Використовуйте `/codex account` у тій самій +розмові, щоб переглянути поточний обліковий запис і вікна лімітів частоти. ### Типовий робочий процес налагодження -Коли агент на базі Codex робить щось неочікуване в Telegram, Discord, Slack, +Коли агент на базі Codex робить щось неочікуване в Telegram, Discord, Slack або іншому каналі, почніть із розмови, де сталася проблема: -1. Запустіть `/diagnostics bad tool choice after image upload` або іншу коротку нотатку, - яка описує те, що ви побачили. -2. Один раз схваліть запит діагностики. Схвалення створює локальний діагностичний - zip-файл Gateway і, оскільки сеанс використовує Codex harness, також +1. Виконайте `/diagnostics bad tool choice after image upload` або додайте іншу коротку нотатку, + яка описує побачене. +2. Підтвердьте запит діагностики один раз. Підтвердження створює локальний діагностичний zip Gateway + і, оскільки сеанс використовує середовище Codex, також надсилає відповідний пакет відгуку Codex на сервери OpenAI. -3. Скопіюйте завершену відповідь діагностики у звіт про помилку або тред підтримки. - Вона містить шлях до локального пакета, підсумок приватності, ідентифікатори сеансів OpenClaw, +3. Скопіюйте завершену відповідь діагностики у звіт про помилку або потік підтримки. + Вона містить шлях до локального пакета, зведення приватності, ідентифікатори сеансів OpenClaw, ідентифікатори потоків Codex і рядок `Inspect locally` для кожного потоку Codex. 4. Якщо ви хочете самостійно налагодити запуск, виконайте надруковану команду `Inspect locally` у терміналі. Вона має вигляд `codex resume ` і відкриває нативний потік Codex, щоб ви могли переглянути розмову, продовжити її локально або запитати Codex, чому він вибрав певний інструмент чи план. -Використовуйте `/codex diagnostics [note]` лише тоді, коли вам спеціально потрібне -завантаження відгуку Codex для поточного приєднаного потоку без повного -діагностичного пакета Gateway OpenClaw. Для більшості звітів підтримки `/diagnostics [note]` є -кращою початковою точкою, бо поєднує локальний стан Gateway і ідентифікатори потоків Codex -в одній відповіді. Повну модель приватності та поведінку в групових чатах дивіться в -[Експорті діагностики](/uk/gateway/diagnostics). +Використовуйте `/codex diagnostics [note]` лише тоді, коли вам потрібне саме завантаження +відгуку Codex для поточного приєднаного потоку без повного діагностичного пакета +Gateway OpenClaw. Для більшості звітів підтримки `/diagnostics [note]` є +кращою відправною точкою, бо він пов’язує локальний стан Gateway і +ідентифікатори потоків Codex в одній відповіді. Див. [Експорт діагностики](/uk/gateway/diagnostics) +для повної моделі приватності та поведінки в групових чатах. Ядро OpenClaw також надає доступну лише власнику команду `/diagnostics [note]` як загальну -команду діагностики Gateway. Її запит на схвалення показує вступ про конфіденційні дані, +діагностичну команду Gateway. Її запит підтвердження показує вступ про чутливі дані, посилається на [Експорт діагностики](/uk/gateway/diagnostics) і щоразу запитує -`openclaw gateway diagnostics export --json` через явне схвалення виконання. -Не схвалюйте діагностику правилом allow-all. Після схвалення -OpenClaw надсилає придатний для вставлення звіт зі шляхом до локального пакета та підсумком -маніфесту. Коли активний сеанс OpenClaw використовує Codex harness, це -саме схвалення також дозволяє надсилати відповідні пакети відгуку Codex на -сервери OpenAI. Запит на схвалення повідомляє, що відгук Codex буде надіслано, але -не перелічує ідентифікатори сеансів або потоків Codex до схвалення. +`openclaw gateway diagnostics export --json` через явне підтвердження виконання. +Не підтверджуйте діагностику правилом allow-all. Після підтвердження +OpenClaw надсилає звіт, придатний для вставлення, зі шляхом до локального пакета та зведенням +маніфесту. Коли активний сеанс OpenClaw використовує середовище Codex, це +саме підтвердження також дозволяє надсилати відповідні пакети відгуку Codex на +сервери OpenAI. Запит підтвердження повідомляє, що відгук Codex буде надіслано, але +не перелічує ідентифікатори сеансів або потоків Codex до підтвердження. -Якщо `/diagnostics` викликає власник у груповому чаті, OpenClaw залишає +Якщо `/diagnostics` викликає власник у груповому чаті, OpenClaw зберігає спільний канал чистим: група отримує лише коротке сповіщення, тоді як -вступ діагностики, запити на схвалення й ідентифікатори сеансів/потоків Codex надсилаються -власнику через приватний маршрут схвалення. Якщо приватного маршруту до власника немає, +вступ діагностики, запити підтвердження та ідентифікатори сеансів/потоків Codex надсилаються +власнику через приватний маршрут підтвердження. Якщо приватного маршруту власника немає, OpenClaw відхиляє груповий запит і просить власника виконати його з DM. -Схвалене завантаження Codex викликає `feedback/upload` app-server Codex і просить -app-server включити журнали для кожного переліченого потоку та породжених підпотоків Codex, -коли вони доступні. Завантаження проходить через звичайний шлях відгуку Codex на сервери OpenAI; -якщо відгук Codex вимкнено в цьому app-server, команда повертає -помилку app-server. Завершена відповідь діагностики перелічує канали, -ідентифікатори сеансів OpenClaw, ідентифікатори потоків Codex і локальні команди -`codex resume ` для потоків, які було надіслано. Якщо ви відхилите або проігноруєте схвалення, +Підтверджене завантаження Codex викликає `feedback/upload` сервера застосунку Codex і просить +сервер застосунку додати журнали для кожного переліченого потоку та породжених підпотоків Codex, +коли вони доступні. Завантаження проходить звичайним шляхом відгуку Codex на сервери OpenAI; +якщо відгук Codex вимкнено на цьому сервері застосунку, команда повертає +помилку сервера застосунку. Завершена відповідь діагностики перелічує канали, +ідентифікатори сеансів OpenClaw, ідентифікатори потоків Codex і локальні команди `codex resume ` +для потоків, які було надіслано. Якщо ви відхилите або проігноруєте підтвердження, OpenClaw не друкує ці ідентифікатори Codex. Це завантаження не замінює локальний експорт діагностики Gateway. -`/codex resume` записує той самий sidecar-файл прив’язки, який harness використовує для +`/codex resume` записує той самий допоміжний файл прив’язки, який середовище використовує для звичайних ходів. У наступному повідомленні OpenClaw відновлює цей потік Codex, передає -поточну вибрану модель OpenClaw в app-server і залишає розширену історію +поточну вибрану модель OpenClaw до сервера застосунку й залишає розширену історію увімкненою. ### Перегляд потоку Codex із CLI Найшвидший спосіб зрозуміти невдалий запуск Codex часто полягає в тому, щоб відкрити нативний потік Codex -напряму: +безпосередньо: ```sh codex resume ``` -Використовуйте це, коли помітили помилку в розмові каналу й хочете переглянути +Використовуйте це, коли помічаєте помилку в розмові каналу й хочете переглянути проблемний сеанс Codex, продовжити його локально або запитати Codex, чому він зробив -певний вибір інструмента чи міркування. Найпростіший шлях зазвичай такий: спочатку запустіть -`/diagnostics [note]`; після схвалення завершений звіт перелічить -кожен потік Codex і надрукує команду `Inspect locally`, наприклад +певний вибір інструмента чи міркування. Найпростіший шлях зазвичай — спочатку виконати +`/diagnostics [note]`: після вашого підтвердження завершений звіт перелічує +кожен потік Codex і друкує команду `Inspect locally`, наприклад `codex resume `. Ви можете скопіювати цю команду безпосередньо в термінал. -Ви також можете отримати ідентифікатор потоку з `/codex binding` для поточного чату або -`/codex threads [filter]` для нещодавніх потоків app-server Codex, а потім виконати ту саму +Також можна отримати ідентифікатор потоку з `/codex binding` для поточного чату або +`/codex threads [filter]` для нещодавніх потоків сервера застосунку Codex, а потім виконати ту саму команду `codex resume` у своїй оболонці. -Поверхня команд потребує app-server Codex `0.125.0` або новішого. Окремі -методи керування повідомляються як `unsupported by this Codex app-server`, якщо -майбутній або власний app-server не надає цей метод JSON-RPC. +Поверхня команд вимагає сервер застосунку Codex `0.125.0` або новіший. Окремі +методи керування позначаються як `unsupported by this Codex app-server`, якщо +майбутній або користувацький сервер застосунку не надає цей метод JSON-RPC. ## Межі хуків -Codex harness має три рівні хуків: +Середовище Codex має три рівні хуків: | Рівень | Власник | Призначення | | ------------------------------------- | ------------------------ | ------------------------------------------------------------------ | -| Хуки Plugin OpenClaw | OpenClaw | Сумісність продукту/Plugin між harness Pi та Codex. | -| Проміжне ПЗ розширення app-server Codex | Вбудовані plugins OpenClaw | Поведінка адаптера для кожного ходу навколо динамічних інструментів OpenClaw. | -| Нативні хуки Codex | Codex | Низькорівневий життєвий цикл Codex і політика нативних інструментів із конфігурації Codex. | +| Хуки Plugin OpenClaw | OpenClaw | Сумісність продукту/Plugin між середовищами PI і Codex. | +| Проміжне ПЗ розширення сервера застосунку Codex | Вбудовані plugins OpenClaw | Поведінка адаптера на кожен хід навколо динамічних інструментів OpenClaw. | +| Нативні хуки Codex | Codex | Низькорівневий життєвий цикл Codex і нативна політика інструментів із конфігурації Codex. | OpenClaw не використовує проєктні або глобальні файли Codex `hooks.json` для маршрутизації поведінки Plugin OpenClaw. Для підтримуваного моста нативних інструментів і дозволів -OpenClaw впроваджує конфігурацію Codex для кожного потоку для `PreToolUse`, `PostToolUse`, +OpenClaw впроваджує конфігурацію Codex на рівні потоку для `PreToolUse`, `PostToolUse`, `PermissionRequest` і `Stop`. Інші хуки Codex, як-от `SessionStart` і -`UserPromptSubmit`, залишаються елементами керування рівня Codex; вони не надаються як +`UserPromptSubmit`, залишаються засобами керування рівня Codex; вони не відкриті як хуки Plugin OpenClaw у контракті v1. Для динамічних інструментів OpenClaw OpenClaw виконує інструмент після того, як Codex запитує виклик, тому OpenClaw запускає поведінку Plugin і проміжного ПЗ, якою він володіє, в -адаптері harness. Для нативних інструментів Codex канонічним записом інструмента володіє Codex. -OpenClaw може віддзеркалювати вибрані події, але не може переписати нативний потік Codex, -якщо Codex не надає цю операцію через app-server або зворотні виклики нативних хуків. +адаптері середовища. Для нативних інструментів Codex Codex володіє канонічним записом інструмента. +OpenClaw може дзеркалити вибрані події, але не може переписати нативний потік Codex, +якщо Codex не надає цю операцію через сервер застосунку або нативні зворотні виклики хуків. -Проєкції Compaction і життєвого циклу LLM надходять зі сповіщень app-server Codex +Проєкції Compaction і життєвого циклу LLM походять зі сповіщень сервера застосунку Codex і стану адаптера OpenClaw, а не з нативних команд хуків Codex. Події OpenClaw `before_compaction`, `after_compaction`, `llm_input` і `llm_output` є спостереженнями рівня адаптера, а не побайтовими знімками -внутрішнього запиту Codex або корисного навантаження Compaction. +внутрішнього запиту або корисного навантаження Compaction Codex. -Нативні сповіщення app-server Codex `hook/started` і `hook/completed` -проєктуються як події агента `codex_app_server.hook` для траєкторії та налагодження. +Нативні сповіщення сервера застосунку Codex `hook/started` і `hook/completed` +проєктуються як агентські події `codex_app_server.hook` для траєкторії та налагодження. Вони не викликають хуки Plugin OpenClaw. ## Контракт підтримки V1 -Режим Codex — це не PI з іншим викликом моделі під ним. Codex володіє більшою частиною +Режим Codex — це не PI з іншим викликом моделі під капотом. Codex володіє більшою частиною нативного циклу моделі, а OpenClaw адаптує свої поверхні Plugin і сеансів навколо цієї межі. Підтримується в середовищі виконання Codex v1: -| Поверхня | Підтримка | Чому | +| Поверхня | Підтримка | Чому | | --------------------------------------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Цикл моделі OpenAI через Codex | Підтримується | app-server Codex володіє ходом OpenAI, відновленням нативного потоку та продовженням нативних інструментів. | -| Маршрутизація й доставлення каналів OpenClaw | Підтримується | Telegram, Discord, Slack, WhatsApp, iMessage та інші канали залишаються поза середовищем виконання моделі. | +| Цикл моделі OpenAI через Codex | Підтримується | Сервер застосунку Codex володіє ходом OpenAI, відновленням нативного потоку та продовженням нативного інструмента. | +| Маршрутизація та доставка каналів OpenClaw | Підтримується | Telegram, Discord, Slack, WhatsApp, iMessage та інші канали залишаються поза середовищем виконання моделі. | | Динамічні інструменти OpenClaw | Підтримується | Codex просить OpenClaw виконати ці інструменти, тому OpenClaw залишається в шляху виконання. | -| Plugins підказок і контексту | Підтримується | OpenClaw будує накладки підказок і проєктує контекст у хід Codex перед запуском або відновленням потоку. | -| Життєвий цикл рушія контексту | Підтримується | Збирання, поглинання або обслуговування після ходу, а також координація Compaction рушія контексту виконуються для ходів Codex. | +| Plugins підказок і контексту | Підтримується | OpenClaw створює накладки підказок і проєктує контекст у хід Codex перед запуском або відновленням потоку. | +| Життєвий цикл рушія контексту | Підтримується | Збирання, приймання або обслуговування після ходу та координація Compaction рушія контексту виконуються для ходів Codex. | | Хуки динамічних інструментів | Підтримується | `before_tool_call`, `after_tool_call` і проміжне ПЗ результатів інструментів виконуються навколо динамічних інструментів, якими володіє OpenClaw. | -| Хуки життєвого циклу | Підтримується як спостереження адаптера | `llm_input`, `llm_output`, `agent_end`, `before_compaction` і `after_compaction` спрацьовують із чесними корисними навантаженнями режиму Codex. | -| Шлюз перегляду фінальної відповіді | Підтримується через ретранслятор нативних хуків | Codex `Stop` ретранслюється в `before_agent_finalize`; `revise` просить Codex виконати ще один прохід моделі перед фіналізацією. | -| Блокування або спостереження нативних shell, patch і MCP | Підтримується через ретранслятор нативних хуків | Codex `PreToolUse` і `PostToolUse` ретранслюються для зафіксованих нативних поверхонь інструментів, включно з корисними навантаженнями MCP в app-server Codex `0.125.0` або новішому. Блокування підтримується; переписування аргументів — ні. | -| Нативна політика дозволів | Підтримується через ретранслятор нативних хуків | Codex `PermissionRequest` може маршрутизуватися через політику OpenClaw там, де середовище виконання це надає. Якщо OpenClaw не повертає рішення, Codex продовжує через свій звичайний шлях guardian або схвалення користувача. | -| Захоплення траєкторії app-server | Підтримується | OpenClaw записує запит, який він надіслав app-server, і сповіщення app-server, які отримує. | +| Хуки життєвого циклу | Підтримуються як спостереження адаптера | `llm_input`, `llm_output`, `agent_end`, `before_compaction` і `after_compaction` спрацьовують із чесними корисними навантаженнями режиму Codex. | +| Шлюз перегляду фінальної відповіді | Підтримується через нативну ретрансляцію хуків | Codex `Stop` ретранслюється до `before_agent_finalize`; `revise` просить Codex виконати ще один прохід моделі перед фіналізацією. | +| Блокування або спостереження нативної оболонки, patch і MCP | Підтримується через нативну ретрансляцію хуків | Codex `PreToolUse` і `PostToolUse` ретранслюються для закріплених поверхонь нативних інструментів, зокрема MCP-навантажень на сервері застосунку Codex `0.125.0` або новішому. Блокування підтримується; переписування аргументів — ні. | +| Нативна політика дозволів | Підтримується через нативну ретрансляцію хуків | Codex `PermissionRequest` може маршрутизуватися через політику OpenClaw там, де середовище виконання це надає. Якщо OpenClaw не повертає рішення, Codex продовжує через свій звичайний guardian або шлях підтвердження користувача. | +| Захоплення траєкторії сервера застосунку | Підтримується | OpenClaw записує запит, який він надіслав серверу застосунку, і сповіщення сервера застосунку, які отримує. | Не підтримується в середовищі виконання Codex v1: -| Поверхня | Межа V1 | Майбутній шлях | -| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | -| Мутація аргументів нативного інструмента | Нативні pre-tool hooks Codex можуть блокувати, але OpenClaw не переписує аргументи нативних інструментів Codex. | Потребує підтримки Codex hook/schema для заміни вхідних даних інструмента. | -| Редагована нативна історія transcript Codex | Codex володіє канонічною нативною історією thread. OpenClaw володіє дзеркалом і може проєктувати майбутній контекст, але не має мутувати непідтримувані internals. | Додати явні API app-server Codex, якщо потрібна операція над нативним thread. | -| `tool_result_persist` для нативних записів інструментів Codex | Цей hook трансформує записи transcript, якими володіє OpenClaw, а не нативні записи інструментів Codex. | Можна було б дзеркалити трансформовані записи, але канонічне переписування потребує підтримки Codex. | -| Розширені нативні метадані Compaction | OpenClaw спостерігає початок і завершення Compaction, але не отримує стабільного списку збереженого/відкинутого, різниці токенів або payload підсумку. | Потребує багатших подій Compaction від Codex. | -| Втручання в Compaction | Поточні hooks Compaction OpenClaw у режимі Codex мають рівень сповіщень. | Додати pre/post hooks Compaction Codex, якщо plugins мають накладати вето або переписувати нативну Compaction. | -| Побайтне захоплення запиту до API моделі | OpenClaw може захоплювати запити app-server і сповіщення, але ядро Codex внутрішньо формує фінальний запит до OpenAI API. | Потребує події трасування запиту моделі Codex або debug API. | +| Поверхня | Межа V1 | Майбутній шлях | +| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------- | +| Мутація аргументів нативного інструмента | Нативні передінструментальні хуки Codex можуть блокувати, але OpenClaw не переписує аргументи нативних інструментів Codex. | Потребує підтримки хуків/схем Codex для заміни вхідних даних інструмента. | +| Редагована нативна історія транскрипту Codex | Codex володіє канонічною нативною історією потоку. OpenClaw володіє дзеркалом і може проєктувати майбутній контекст, але не повинен змінювати непідтримувані внутрішні механізми. | Додати явні API сервера застосунку Codex, якщо потрібне хірургічне редагування нативного потоку. | +| `tool_result_persist` для нативних записів інструментів Codex | Цей хук трансформує записи транскрипту, якими володіє OpenClaw, а не нативні записи інструментів Codex. | Можна дзеркалити трансформовані записи, але канонічне переписування потребує підтримки Codex. | +| Розширені нативні метадані Compaction | OpenClaw спостерігає початок і завершення Compaction, але не отримує стабільний список збереженого/відкинутого, дельту токенів або корисне навантаження підсумку. | Потребує багатших подій Compaction від Codex. | +| Втручання в Compaction | Поточні хуки Compaction OpenClaw у режимі Codex працюють на рівні сповіщень. | Додати хуки Codex до/після Compaction, якщо Plugin потрібно забороняти або переписувати нативну Compaction. | +| Побайтове захоплення запиту до API моделі | OpenClaw може захоплювати запити й сповіщення сервера застосунку, але ядро Codex внутрішньо формує фінальний запит до OpenAI API. | Потребує події трасування запиту моделі Codex або API налагодження. | ## Інструменти, медіа та Compaction -Codex harness змінює лише низькорівневий вбудований виконавець агента. +Обв'язка Codex змінює лише низькорівневий вбудований виконавець агента. -OpenClaw і далі формує список інструментів і отримує динамічні результати інструментів від -harness. Текст, зображення, відео, музика, TTS, схвалення та вивід messaging-tool -і далі проходять через звичайний шлях доставки OpenClaw. +OpenClaw і надалі формує список інструментів та отримує динамічні результати інструментів від +обв'язки. Текст, зображення, відео, музика, TTS, схвалення та вивід інструментів повідомлень +далі проходять звичайним шляхом доставки OpenClaw. -Нативний hook relay навмисно є узагальненим, але контракт підтримки v1 +Нативний ретранслятор хуків навмисно є узагальненим, але контракт підтримки v1 обмежений нативними шляхами інструментів і дозволів Codex, які тестує OpenClaw. У -runtime Codex це включає payloads shell, patch і MCP `PreToolUse`, +середовищі виконання Codex це включає корисні навантаження shell, patch і MCP `PreToolUse`, `PostToolUse` та `PermissionRequest`. Не припускайте, що кожна майбутня -подія hook Codex є поверхнею plugin OpenClaw, доки runtime contract не назве -її. +подія хуків Codex є поверхнею OpenClaw Plugin, доки контракт середовища виконання +не назве її. -Для `PermissionRequest` OpenClaw повертає явні рішення allow або deny лише тоді, -коли це вирішує policy. Результат без рішення не є allow. Codex трактує його як відсутність -рішення hook і переходить до власного guardian або шляху схвалення користувачем. +Для `PermissionRequest` OpenClaw повертає явні рішення дозволити або заборонити +лише тоді, коли це вирішує політика. Результат без рішення не є дозволом. Codex трактує його як відсутність +рішення хука й переходить до власного захисника або шляху схвалення користувачем. -Еліситації схвалення MCP-інструментів Codex маршрутизуються через потік -схвалення plugin OpenClaw, коли Codex позначає `_meta.codex_approval_kind` як +Запити на схвалення інструментів Codex MCP маршрутизуються через потік +схвалення Plugin OpenClaw, коли Codex позначає `_meta.codex_approval_kind` як `"mcp_tool_call"`. Підказки Codex `request_user_input` надсилаються назад до -початкового чату, а наступне повідомлення follow-up у черзі відповідає на цей нативний -server request замість того, щоб спрямовуватися як додатковий контекст. Інші запити еліситації MCP -і далі fail closed. +початкового чату, а наступне повідомлення-відповідь у черзі відповідає на цей нативний +запит сервера замість того, щоб спрямовуватися як додатковий контекст. Інші запити +MCP elicitation і надалі завершуються закрито. -Керування чергою активного запуску відображається на `turn/steer` app-server Codex. Із +Спрямування черги активного запуску відображається на `turn/steer` сервера застосунку Codex. З типовим `messages.queue.mode: "steer"` OpenClaw групує повідомлення чату в черзі -протягом налаштованого тихого вікна та надсилає їх як один запит `turn/steer` у -порядку надходження. Застарілий режим `queue` надсилає окремі запити `turn/steer`. Codex -review і ручні ходи Compaction можуть відхиляти керування тим самим ходом; у такому разі -OpenClaw використовує чергу followup, коли вибраний режим дозволяє fallback. Див. -[Черга керування](/uk/concepts/queue-steering). +протягом налаштованого тихого вікна й надсилає їх як один запит `turn/steer` у +порядку надходження. Застарілий режим `queue` надсилає окремі запити `turn/steer`. Ходи +перегляду Codex і ручної Compaction можуть відхиляти спрямування в межах того самого ходу; у такому разі +OpenClaw використовує чергу подальших повідомлень, коли вибраний режим дозволяє резервний варіант. Див. +[Черга спрямування](/uk/concepts/queue-steering). -Коли вибрана модель використовує Codex harness, нативна Compaction thread -делегується app-server Codex. OpenClaw зберігає дзеркало transcript для історії -каналу, пошуку, `/new`, `/reset` і майбутнього перемикання моделі або harness. Дзеркало -містить запит користувача, фінальний текст assistant і легкі записи reasoning або plan Codex, -коли app-server їх емітує. Наразі OpenClaw записує лише сигнали початку та -завершення нативної Compaction. Він ще не надає зрозумілого для людини -підсумку Compaction або аудитовного списку записів, які Codex +Коли вибрана модель використовує обв'язку Codex, нативна Compaction потоку +делегується серверу застосунку Codex. OpenClaw зберігає дзеркало транскрипту для історії +каналу, пошуку, `/new`, `/reset` і майбутнього перемикання моделі або обв'язки. Дзеркало +містить запит користувача, фінальний текст асистента та легковагові записи +міркувань або плану Codex, коли сервер застосунку їх випускає. Наразі OpenClaw лише +записує сигнали початку та завершення нативної Compaction. Він ще не надає +людинозрозумілий підсумок Compaction або придатний до аудиту список записів, які Codex зберіг після Compaction. -Оскільки Codex володіє канонічним нативним thread, `tool_result_persist` наразі не -переписує записи нативних результатів інструментів Codex. Він застосовується лише тоді, коли -OpenClaw записує результат інструмента transcript сесії, яким володіє OpenClaw. +Оскільки Codex володіє канонічним нативним потоком, `tool_result_persist` наразі не +переписує нативні записи результатів інструментів Codex. Він застосовується лише тоді, коли +OpenClaw записує результат інструмента транскрипту сесії, яким володіє OpenClaw. -Генерація медіа не потребує PI. Зображення, відео, музика, PDF, TTS і розуміння -медіа й далі використовують відповідні налаштування provider/model, як-от +Генерація медіа не потребує PI. Зображення, відео, музика, PDF, TTS і розуміння медіа +і надалі використовують відповідні налаштування провайдера/моделі, як-от `agents.defaults.imageGenerationModel`, `videoGenerationModel`, `pdfModel` і `messages.tts`. ## Усунення несправностей -**Codex не з’являється як звичайний provider `/model`:** це очікувано для +**Codex не відображається як звичайний провайдер `/model`:** це очікувано для нових конфігурацій. Виберіть модель `openai/gpt-*` з -`agentRuntime.id: "codex"` (або застарілий ref `codex/*`), увімкніть +`agentRuntime.id: "codex"` (або застаріле посилання `codex/*`), увімкніть `plugins.entries.codex.enabled` і перевірте, чи `plugins.allow` не виключає `codex`. **OpenClaw використовує PI замість Codex:** `agentRuntime.id: "auto"` усе ще може використовувати PI як -compatibility backend, коли жоден Codex harness не заявляє запуск. Установіть -`agentRuntime.id: "codex"`, щоб примусово вибрати Codex під час тестування. Примусовий -runtime Codex завершується помилкою замість fallback до PI. Щойно app-server Codex -вибрано, його помилки відображаються напряму. +бекенд сумісності, коли жодна обв'язка Codex не приймає запуск. Установіть +`agentRuntime.id: "codex"`, щоб примусово вибрати Codex під час тестування. Примусове +середовище виконання Codex завершується помилкою замість повернення до PI. Після вибору сервера застосунку Codex +його помилки відображаються напряму. -**app-server відхилено:** оновіть Codex, щоб app-server handshake -повідомляв версію `0.125.0` або новішу. Prereleases тієї самої версії або версії з суфіксом build, -як-от `0.125.0-alpha.2` чи `0.125.0+custom`, відхиляються, бо -стабільна мінімальна версія протоколу `0.125.0` — це те, що тестує OpenClaw. +**Сервер застосунку відхилено:** оновіть Codex, щоб handshake сервера застосунку +повідомляв версію `0.125.0` або новішу. Попередні випуски тієї самої версії або версії із суфіксом збірки, +як-от `0.125.0-alpha.2` або `0.125.0+custom`, відхиляються, бо стабільний +порог протоколу `0.125.0` є тим, що тестує OpenClaw. **Виявлення моделей повільне:** зменште `plugins.entries.codex.config.discovery.timeoutMs` -або вимкніть discovery. +або вимкніть виявлення. -**WebSocket transport одразу завершується помилкою:** перевірте `appServer.url`, `authToken` -і те, що віддалений app-server використовує ту саму версію протоколу app-server Codex. +**Транспорт WebSocket одразу завершується помилкою:** перевірте `appServer.url`, `authToken` +і те, що віддалений сервер застосунку використовує ту саму версію протоколу сервера застосунку Codex. **Модель не Codex використовує PI:** це очікувано, якщо ви не примусили -`agentRuntime.id: "codex"` для цього агента або не вибрали застарілий -ref `codex/*`. Звичайні `openai/gpt-*` та refs інших providers залишаються на своєму звичайному -шляху provider у режимі `auto`. Якщо ви примусово встановлюєте `agentRuntime.id: "codex"`, кожен вбудований -хід для цього агента має бути OpenAI-моделлю, підтримуваною Codex. +`agentRuntime.id: "codex"` для цього агента або не вибрали застаріле +посилання `codex/*`. Звичайні `openai/gpt-*` та посилання інших провайдерів залишаються на своєму звичайному +шляху провайдера в режимі `auto`. Якщо ви примусово задаєте `agentRuntime.id: "codex"`, кожен вбудований +хід для цього агента має бути моделлю OpenAI, яку підтримує Codex. **Computer Use встановлено, але інструменти не запускаються:** перевірте -`/codex computer-use status` у новій сесії. Якщо інструмент повідомляє -`Native hook relay unavailable`, використайте `/new` або `/reset`; якщо проблема не зникає, перезапустіть -gateway, щоб очистити застарілі нативні реєстрації hook. Якщо `computer-use.list_apps` +`/codex computer-use status` із нової сесії. Якщо інструмент повідомляє +`Native hook relay unavailable`, використайте `/new` або `/reset`; якщо це не зникає, перезапустіть +Gateway, щоб очистити застарілі реєстрації нативних хуків. Якщо `computer-use.list_apps` перевищує час очікування, перезапустіть Codex Computer Use або Codex Desktop і повторіть спробу. -## Пов’язане +## Пов'язане -- [Plugins агентного harness](/uk/plugins/sdk-agent-harness) -- [Runtimes агентів](/uk/concepts/agent-runtimes) -- [Providers моделей](/uk/concepts/model-providers) -- [Provider OpenAI](/uk/providers/openai) -- [Статус](/uk/cli/status) -- [Hooks plugins](/uk/plugins/hooks) +- [Плагіни обв'язки агента](/uk/plugins/sdk-agent-harness) +- [Середовища виконання агента](/uk/concepts/agent-runtimes) +- [Провайдери моделей](/uk/concepts/model-providers) +- [Провайдер OpenAI](/uk/providers/openai) +- [Стан](/uk/cli/status) +- [Хуки Plugin](/uk/plugins/hooks) - [Довідник конфігурації](/uk/gateway/configuration-reference) - [Тестування](/uk/help/testing-live#live-codex-app-server-harness-smoke)