From 0ef7c08fc3005945be978d1a61912c383941b0bc Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Wed, 29 Apr 2026 18:49:30 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/plugins/codex-harness.md | 813 ++++++++++++++++--------------- 1 file changed, 413 insertions(+), 400 deletions(-) diff --git a/docs/uk/plugins/codex-harness.md b/docs/uk/plugins/codex-harness.md index 329a73e2b..25b291bf3 100644 --- a/docs/uk/plugins/codex-harness.md +++ b/docs/uk/plugins/codex-harness.md @@ -1,57 +1,57 @@ --- read_when: - - Ви хочете використовувати вбудовану обгортку app-server Codex - - Вам потрібні приклади конфігурації обв’язки Codex - - Ви хочете, щоб розгортання лише з Codex завершувалися помилкою замість резервного переходу до Pi -summary: Запускайте ходи вбудованого агента OpenClaw через комплектний стенд Codex app-server + - Ви хочете використовувати вбудовану обв’язку app-server Codex + - Вам потрібні приклади конфігурації середовища виконання Codex + - Ви хочете, щоб розгортання лише з Codex завершувалися помилкою замість резервного переходу до PI +summary: Запускайте ходи вбудованого агента OpenClaw через комплектну обв’язку сервера застосунку Codex title: Обв’язка Codex x-i18n: - generated_at: "2026-04-29T17:18:18Z" + generated_at: "2026-04-29T18:46:47Z" model: gpt-5.5 provider: openai - source_hash: 4799d5d5c81d431e47e1f0af7fb408320c577b0a2900833e0b244e5987734f1c + source_hash: a8eba5cb48c94fe38392d85c9d5c79a7829a2fa7eaba81715f4449d39d7d0dea source_path: plugins/codex-harness.md workflow: 16 --- -Пакетний Plugin `codex` дає OpenClaw змогу запускати вбудовані ходи агента через -Codex app-server замість вбудованої обв’язки PI. +Вбудований Plugin `codex` дає OpenClaw змогу запускати вбудовані ходи агента через +сервер застосунку Codex замість вбудованого PI harness. -Використовуйте це, коли хочете, щоб Codex керував низькорівневою сесією агента: виявленням -моделей, нативним відновленням потоків, нативною Compaction і виконанням через app-server. -OpenClaw і далі відповідає за канали чату, файли сесій, вибір моделі, інструменти, -схвалення, доставлення медіа та видиме дзеркало транскрипту. +Використовуйте це, коли хочете, щоб Codex керував низькорівневим сеансом агента: виявленням +моделі, нативним відновленням потоку, нативною Compaction і виконанням на сервері застосунку. +OpenClaw і далі керує каналами чату, файлами сеансів, вибором моделі, інструментами, +схваленнями, доставленням медіа та видимим дзеркалом транскрипту. -Якщо ви намагаєтеся зорієнтуватися, почніть з +Якщо ви намагаєтеся зорієнтуватися, почніть із [Середовищ виконання агентів](/uk/concepts/agent-runtimes). Коротко: `openai/gpt-5.5` — це посилання на модель, `codex` — середовище виконання, а Telegram, -Discord, Slack або інший канал залишається поверхнею комунікації. +Discord, Slack або інший канал лишається поверхнею комунікації. ## Що змінює цей Plugin -Пакетний Plugin `codex` додає кілька окремих можливостей: +Вбудований Plugin `codex` додає кілька окремих можливостей: -| Можливість | Як ви її використовуєте | Що вона робить | -| -------------------------------- | ---------------------------------------------------- | ---------------------------------------------------------------------------- | -| Нативне вбудоване середовище виконання | `agentRuntime.id: "codex"` | Запускає вбудовані ходи агента OpenClaw через Codex app-server. | -| Нативні команди керування чатом | `/codex bind`, `/codex resume`, `/codex steer`, ... | Прив’язує потоки Codex app-server до розмови в месенджері й керує ними. | -| Провайдер/каталог Codex app-server | внутрішні механізми `codex`, доступні через обв’язку | Дає середовищу виконання змогу виявляти й перевіряти моделі app-server. | -| Шлях розуміння медіа Codex | шляхи сумісності моделей зображень `codex/*` | Запускає обмежені ходи Codex app-server для підтримуваних моделей розуміння зображень. | -| Нативна передача хуків | Хуки Plugin навколо нативних подій Codex | Дає OpenClaw змогу спостерігати/блокувати підтримувані нативні події інструментів/фіналізації Codex. | +| Можливість | Як ви її використовуєте | Що вона робить | +| --------------------------------- | --------------------------------------------------- | ----------------------------------------------------------------------------- | +| Нативне вбудоване середовище виконання | `agentRuntime.id: "codex"` | Запускає вбудовані ходи агента OpenClaw через сервер застосунку Codex. | +| Нативні команди керування чатом | `/codex bind`, `/codex resume`, `/codex steer`, ... | Прив’язує потоки сервера застосунку Codex до розмови в месенджері та керує ними. | +| Провайдер/каталог сервера застосунку Codex | внутрішні компоненти `codex`, доступні через harness | Дає середовищу виконання змогу виявляти й перевіряти моделі сервера застосунку. | +| Шлях розуміння медіа Codex | шляхи сумісності моделей зображень `codex/*` | Запускає обмежені ходи сервера застосунку Codex для підтримуваних моделей розуміння зображень. | +| Нативна ретрансляція хуків | Хуки Plugin навколо нативних подій Codex | Дає OpenClaw змогу спостерігати/блокувати підтримувані нативні події інструментів/завершення Codex. | Увімкнення Plugin робить ці можливості доступними. Воно **не**: - починає використовувати Codex для кожної моделі OpenAI -- перетворює посилання на моделі `openai-codex/*` у нативне середовище виконання -- робить ACP/acpx типовим шляхом Codex -- гаряче перемикає наявні сесії, у яких уже записано середовище виконання PI -- замінює доставлення каналів OpenClaw, файли сесій, сховище auth-профілів або +- перетворює посилання на моделі `openai-codex/*` на нативне середовище виконання +- робить ACP/acpx стандартним шляхом Codex +- гаряче перемикає наявні сеанси, у яких уже записано середовище виконання PI +- замінює доставлення через канали OpenClaw, файли сеансів, сховище auth-профілів або маршрутизацію повідомлень -Цей самий Plugin також відповідає за нативну поверхню команд керування чатом `/codex`. Якщо -Plugin увімкнено і користувач просить прив’язати, відновити, спрямувати, зупинити або переглянути -потоки Codex із чату, агенти мають надавати перевагу `/codex ...` замість ACP. ACP залишається -явним запасним варіантом, коли користувач просить ACP/acpx або тестує адаптер ACP +Той самий Plugin також відповідає за нативну поверхню команд керування чатом `/codex`. Якщо +Plugin увімкнено і користувач просить прив’язати, відновити, скерувати, зупинити або перевірити +потоки Codex із чату, агенти мають надавати перевагу `/codex ...` замість ACP. ACP лишається +явним запасним варіантом, коли користувач просить ACP/acpx або тестує ACP-адаптер Codex. Нативні ходи Codex зберігають хуки Plugin OpenClaw як публічний шар сумісності. @@ -62,141 +62,141 @@ Codex. - `llm_input`, `llm_output` - `before_tool_call`, `after_tool_call` - `before_message_write` для дзеркальних записів транскрипту -- `before_agent_finalize` через передачу Codex `Stop` +- `before_agent_finalize` через ретрансляцію Codex `Stop` - `agent_end` Plugins також можуть реєструвати нейтральне до середовища виконання проміжне ПЗ результатів інструментів, щоб переписувати -динамічні результати інструментів OpenClaw після того, як OpenClaw виконає інструмент, і до того, як -результат повернеться до Codex. Це окремо від публічного -хука Plugin `tool_result_persist`, який перетворює записи результатів інструментів транскрипту, -що належать OpenClaw. +динамічні результати інструментів OpenClaw після того, як OpenClaw виконає інструмент, і перед тим, як +результат буде повернено в Codex. Це окремо від публічного хука Plugin +`tool_result_persist`, який перетворює записи результатів інструментів у транскрипті, що належать OpenClaw. Семантику самих хуків Plugin див. у [Хуках Plugin](/uk/plugins/hooks) -і [Поведінці захисту Plugin](/uk/tools/plugin). +та [Поведінці захисту Plugin](/uk/tools/plugin). -Обв’язку типово вимкнено. Нові конфігурації мають зберігати посилання на моделі OpenAI +Harness вимкнений за замовчуванням. Нові конфігурації мають залишати посилання на моделі OpenAI канонічними як `openai/gpt-*` і явно примусово задавати `agentRuntime.id: "codex"` або `OPENCLAW_AGENT_RUNTIME=codex`, коли вони -потребують нативного виконання через app-server. Застарілі посилання на моделі `codex/*` і далі автоматично вибирають -обв’язку для сумісності, але застарілі префікси провайдера, підтримані середовищем виконання, -не показуються як звичайні варіанти моделі/провайдера. +потребують нативного виконання на сервері застосунку. Застарілі посилання на моделі `codex/*` і далі автоматично вибирають +harness для сумісності, але застарілі префікси провайдерів, підтримані середовищем виконання, не +показуються як звичайні варіанти моделі/провайдера. -Якщо Plugin `codex` увімкнено, але основна модель усе ще -`openai-codex/*`, `openclaw doctor` попереджає замість зміни маршруту. Це -навмисно: `openai-codex/*` залишається шляхом OAuth/підписки PI Codex, а -нативне виконання через app-server залишається явним вибором середовища виконання. +Якщо Plugin `codex` увімкнено, але основна модель досі +`openai-codex/*`, `openclaw doctor` попереджає замість того, щоб змінювати маршрут. Це +навмисно: `openai-codex/*` лишається шляхом PI для Codex OAuth/підписки, а +нативне виконання на сервері застосунку лишається явним вибором середовища виконання. -## Карта маршрутів +## Мапа маршрутів Використовуйте цю таблицю перед зміною конфігурації: -| Бажана поведінка | Посилання на модель | Конфігурація середовища виконання | Вимога до Plugin | Очікувана мітка статусу | -| ------------------------------------------- | -------------------------- | ---------------------------------------- | ---------------------------- | ------------------------------- | -| OpenAI API через звичайний runner OpenClaw | `openai/gpt-*` | пропущено або `runtime: "pi"` | Провайдер OpenAI | `Runtime: OpenClaw Pi Default` | -| OAuth/підписка Codex через PI | `openai-codex/gpt-*` | пропущено або `runtime: "pi"` | Провайдер OpenAI Codex OAuth | `Runtime: OpenClaw Pi Default` | -| Нативні вбудовані ходи Codex app-server | `openai/gpt-*` | `agentRuntime.id: "codex"` | Plugin `codex` | `Runtime: OpenAI Codex` | -| Змішані провайдери з консервативним автоматичним режимом | посилання, специфічні для провайдера | `agentRuntime.id: "auto"` | Необов’язкові середовища виконання Plugin | Залежить від вибраного середовища виконання | -| Явна сесія адаптера Codex ACP | залежить від prompt/model ACP | `sessions_spawn` з `runtime: "acp"` | справний backend `acpx` | Статус завдання/сесії ACP | +| Бажана поведінка | Посилання на модель | Конфігурація середовища виконання | Вимога до Plugin | Очікувана мітка стану | +| ------------------------------------------- | -------------------------- | -------------------------------------- | --------------------------- | ------------------------------ | +| OpenAI API через звичайний runner OpenClaw | `openai/gpt-*` | пропущено або `runtime: "pi"` | Провайдер OpenAI | `Runtime: OpenClaw Pi Default` | +| Codex OAuth/підписка через PI | `openai-codex/gpt-*` | пропущено або `runtime: "pi"` | Провайдер OpenAI Codex OAuth | `Runtime: OpenClaw Pi Default` | +| Нативні вбудовані ходи сервера застосунку Codex | `openai/gpt-*` | `agentRuntime.id: "codex"` | Plugin `codex` | `Runtime: OpenAI Codex` | +| Змішані провайдери з консервативним автоматичним режимом | посилання, специфічні для провайдера | `agentRuntime.id: "auto"` | Опційні середовища виконання Plugin | Залежить від вибраного середовища виконання | +| Явний сеанс ACP-адаптера Codex | залежить від ACP prompt/model | `sessions_spawn` з `runtime: "acp"` | справний backend `acpx` | Стан завдання/сеансу ACP | -Важливий поділ — провайдер проти середовища виконання: +Важливий поділ — між провайдером і середовищем виконання: - `openai-codex/*` відповідає на запитання «який маршрут провайдера/auth має використовувати PI?» - `agentRuntime.id: "codex"` відповідає на запитання «який цикл має виконати цей вбудований хід?» -- `/codex ...` відповідає на запитання «яку нативну розмову Codex має прив’язати - або контролювати цей чат?» -- ACP відповідає на запитання «який зовнішній процес обв’язки має запустити acpx?» +- `/codex ...` відповідає на запитання «яку нативну розмову Codex цей чат має + прив’язати або контролювати?» +- ACP відповідає на запитання «який зовнішній процес harness має запустити acpx?» ## Виберіть правильний префікс моделі Маршрути сімейства OpenAI залежать від префікса. Використовуйте `openai-codex/*`, коли хочете -OAuth Codex через PI; використовуйте `openai/*`, коли хочете прямий доступ до OpenAI API або -коли примусово використовуєте нативну обв’язку Codex app-server: +Codex OAuth через PI; використовуйте `openai/*`, коли хочете прямий доступ до OpenAI API або +коли примусово задаєте нативний harness сервера застосунку Codex: -| Посилання на модель | Шлях середовища виконання | Коли використовувати | -| --------------------------------------------- | -------------------------------------------- | -------------------------------------------------------------------------- | -| `openai/gpt-5.4` | Провайдер OpenAI через plumbing OpenClaw/PI | Вам потрібен поточний прямий доступ до OpenAI Platform API з `OPENAI_API_KEY`. | -| `openai-codex/gpt-5.5` | OpenAI Codex OAuth через OpenClaw/PI | Вам потрібна auth підписки ChatGPT/Codex з типовим runner PI. | -| `openai/gpt-5.5` + `agentRuntime.id: "codex"` | Обв’язка Codex app-server | Вам потрібне нативне виконання Codex app-server для вбудованого ходу агента. | +| Посилання на модель | Шлях середовища виконання | Коли використовувати | +| --------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------- | +| `openai/gpt-5.4` | Провайдер OpenAI через OpenClaw/PI plumbing | Ви хочете поточний прямий доступ до OpenAI Platform API з `OPENAI_API_KEY`. | +| `openai-codex/gpt-5.5` | OpenAI Codex OAuth через OpenClaw/PI | Ви хочете auth підписки ChatGPT/Codex зі стандартним PI runner. | +| `openai/gpt-5.5` + `agentRuntime.id: "codex"` | Harness сервера застосунку Codex | Ви хочете нативне виконання на сервері застосунку Codex для вбудованого ходу агента. | GPT-5.5 наразі доступна в OpenClaw лише через підписку/OAuth. Використовуйте -`openai-codex/gpt-5.5` для PI OAuth або `openai/gpt-5.5` з обв’язкою Codex -app-server. Прямий доступ через API key для `openai/gpt-5.5` підтримується -після того, як OpenAI увімкне GPT-5.5 у публічному API. +`openai-codex/gpt-5.5` для PI OAuth або `openai/gpt-5.5` з harness сервера +застосунку Codex. Прямий доступ через API-ключ для `openai/gpt-5.5` підтримується, +щойно OpenAI увімкне GPT-5.5 у публічному API. -Застарілі посилання `codex/gpt-*` і далі приймаються як псевдоніми сумісності. Міграція -сумісності doctor переписує застарілі посилання основного середовища виконання на канонічні посилання -моделей і записує політику середовища виконання окремо, тоді як застарілі посилання лише для запасного варіанта -залишаються без змін, бо середовище виконання налаштовується для всього контейнера агента. -Нові конфігурації PI Codex OAuth мають використовувати `openai-codex/gpt-*`; нові конфігурації нативної -обв’язки app-server мають використовувати `openai/gpt-*` плюс +Застарілі посилання `codex/gpt-*` і далі приймаються як псевдоніми сумісності. Міграція сумісності Doctor +переписує застарілі основні посилання середовища виконання на канонічні посилання на моделі +та записує політику середовища виконання окремо, тоді як застарілі посилання лише для fallback +лишаються без змін, бо середовище виконання налаштовується для всього контейнера агента. +Нові конфігурації PI Codex OAuth мають використовувати `openai-codex/gpt-*`; нові конфігурації нативного +harness сервера застосунку мають використовувати `openai/gpt-*` плюс `agentRuntime.id: "codex"`. -`agents.defaults.imageModel` дотримується того самого поділу префіксів. Використовуйте +`agents.defaults.imageModel` дотримується того самого поділу за префіксами. Використовуйте `openai-codex/gpt-*`, коли розуміння зображень має виконуватися через шлях провайдера OpenAI Codex OAuth. Використовуйте `codex/gpt-*`, коли розуміння зображень має виконуватися -через обмежений хід Codex app-server. Модель Codex app-server має -оголошувати підтримку введення зображень; текстові моделі Codex завершуються помилкою до початку медіаходу. +через обмежений хід сервера застосунку Codex. Модель сервера застосунку Codex має +оголошувати підтримку вводу зображень; текстові моделі Codex завершуються помилкою ще до початку +медіа-ходу. -Використовуйте `/status`, щоб підтвердити фактичну обв’язку для поточної сесії. Якщо -вибір несподіваний, увімкніть debug-логування для підсистеми `agents/harness` -і перегляньте структурований запис Gateway `agent harness selected`. Він -містить вибраний ідентифікатор обв’язки, причину вибору, політику середовища виконання/запасного варіанта, а +Використовуйте `/status`, щоб підтвердити фактичний harness для поточного сеансу. Якщо +вибір неочікуваний, увімкніть debug-журналювання для підсистеми `agents/harness` +і перевірте структурований запис gateway `agent harness selected`. Він +містить вибраний id harness, причину вибору, політику середовища виконання/fallback, а в режимі `auto` — результат підтримки кожного кандидата Plugin. ### Що означають попередження doctor -`openclaw doctor` попереджає, коли виконуються всі ці умови: +`openclaw doctor` попереджає, коли всі ці умови істинні: -- пакетний Plugin `codex` увімкнено або дозволено +- вбудований Plugin `codex` увімкнено або дозволено - основна модель агента — `openai-codex/*` -- фактичне середовище виконання цього агента — не `codex` +- фактичне середовище виконання цього агента не `codex` Це попередження існує, бо користувачі часто очікують, що «Plugin Codex увімкнено» означає -«нативне середовище виконання Codex app-server». OpenClaw не робить такого стрибка. Попередження +«нативне середовище виконання сервера застосунку Codex». OpenClaw не робить такого переходу. Попередження означає: -- **Зміна не потрібна**, якщо ви мали на меті ChatGPT/Codex OAuth через PI. -- Змініть модель на `openai/` і встановіть - `agentRuntime.id: "codex"`, якщо ви мали на меті нативне виконання - app-server. -- Наявні сесії все ще потребують `/new` або `/reset` після зміни середовища виконання, - бо закріплення середовища виконання сесії є липкими. +- **Змін не потрібно**, якщо ви мали на увазі ChatGPT/Codex OAuth через PI. +- Змініть модель на `openai/` і задайте + `agentRuntime.id: "codex"`, якщо ви мали на увазі нативне виконання + на сервері застосунку. +- Наявним сеансам після зміни середовища виконання все одно потрібні `/new` або `/reset`, + бо прив’язки середовища виконання сеансу є липкими. -Вибір обв’язки не є live-керуванням сесією. Коли виконується вбудований хід, -OpenClaw записує вибраний ідентифікатор обв’язки в цю сесію й продовжує використовувати його для -наступних ходів у тому самому ідентифікаторі сесії. Змініть конфігурацію `agentRuntime` або -`OPENCLAW_AGENT_RUNTIME`, коли хочете, щоб майбутні сесії використовували іншу обв’язку; -використовуйте `/new` або `/reset`, щоб почати свіжу сесію перед перемиканням наявної -розмови між PI і Codex. Це запобігає повторному відтворенню одного транскрипту через -дві несумісні нативні системи сесій. +Вибір harness не є керуванням живим сеансом. Коли виконується вбудований хід, +OpenClaw записує id вибраного harness у цьому сеансі й продовжує використовувати його для +подальших ходів у межах того самого id сеансу. Змініть конфігурацію `agentRuntime` або +`OPENCLAW_AGENT_RUNTIME`, коли хочете, щоб майбутні сеанси використовували інший harness; +використовуйте `/new` або `/reset`, щоб почати свіжий сеанс перед перемиканням наявної +розмови між PI і Codex. Це запобігає повторному програванню одного транскрипту через +дві несумісні нативні системи сеансів. -Застарілі сесії, створені до закріплення обв’язок, вважаються закріпленими за PI, щойно вони -мають історію транскрипту. Використовуйте `/new` або `/reset`, щоб перевести цю розмову в +Застарілі сеанси, створені до появи прив’язок harness, вважаються прив’язаними до PI, щойно вони +мають історію транскрипту. Використовуйте `/new` або `/reset`, щоб перевести цю розмову на Codex після зміни конфігурації. -`/status` показує фактичне середовище виконання моделі. Типова обв’язка PI відображається як -`Runtime: OpenClaw Pi Default`, а обв’язка Codex app-server відображається як +`/status` показує фактичне середовище виконання моделі. Стандартний PI harness відображається як +`Runtime: OpenClaw Pi Default`, а harness сервера застосунку Codex відображається як `Runtime: OpenAI Codex`. ## Вимоги -- OpenClaw з доступним пакетним Plugin `codex`. -- Codex app-server `0.125.0` або новіший. Пакетний Plugin типово керує сумісним - бінарним файлом Codex app-server, тому локальні команди `codex` у `PATH` не - впливають на звичайний запуск обв’язки. -- Auth Codex, доступна процесу app-server або auth-мосту Codex в OpenClaw. +- OpenClaw з доступним вбудованим Plugin `codex`. +- Сервер застосунку Codex `0.125.0` або новіший. Вбудований Plugin за замовчуванням керує сумісним + бінарним файлом сервера застосунку Codex, тому локальні команди `codex` у `PATH` не + впливають на звичайний запуск harness. +- Codex auth, доступний процесу сервера застосунку або auth-мосту Codex в OpenClaw. -Plugin блокує старіші або неверсіоновані handshakes app-server. Це утримує -OpenClaw на поверхні протоколу, проти якої його було протестовано. +Plugin блокує старіші або неверсіоновані рукостискання сервера застосунку. Це утримує +OpenClaw на поверхні протоколу, з якою його протестовано. -Для live- і Docker smoke tests auth зазвичай надходить з облікового запису Codex CLI -або auth-профілю OpenClaw `openai-codex`. Локальні запуски stdio app-server також можуть -відступати до `CODEX_API_KEY` / `OPENAI_API_KEY`, коли облікового запису немає. +Для live- і Docker smoke-тестів auth зазвичай надходить з облікового запису Codex CLI +або auth-профілю OpenClaw `openai-codex`. Локальні stdio-запуски сервера застосунку також можуть +відступати до `CODEX_API_KEY` / `OPENAI_API_KEY`, коли обліковий запис відсутній. ## Мінімальна конфігурація -Використовуйте `openai/gpt-5.5`, увімкніть пакетний Plugin і примусово задайте обв’язку `codex`: +Використайте `openai/gpt-5.5`, увімкніть вбудований Plugin і примусово задайте harness `codex`: ```json5 { @@ -218,7 +218,7 @@ OpenClaw на поверхні протоколу, проти якої його } ``` -Якщо ваша конфігурація використовує `plugins.allow`, також додайте туди `codex`: +Якщо ваша конфігурація використовує `plugins.allow`, додайте туди й `codex`: ```json5 { @@ -234,27 +234,27 @@ OpenClaw на поверхні протоколу, проти якої його ``` Застарілі конфігурації, які задають `agents.defaults.model` або модель агента як -`codex/`, усе ще автоматично вмикають пакетний Plugin `codex`. Нові конфігурації мають +`codex/`, і далі автоматично вмикають вбудований Plugin `codex`. Нові конфігурації мають надавати перевагу `openai/` плюс явному запису `agentRuntime` вище. ## Додайте Codex поряд з іншими моделями Не задавайте `agentRuntime.id: "codex"` глобально, якщо той самий агент має вільно перемикатися -між моделями провайдерів Codex і не-Codex. Примусове середовище виконання застосовується до кожного -вбудованого ходу для цього агента або сесії. Якщо вибрати модель Anthropic, коли -це середовище виконання примусове, OpenClaw усе одно спробує обв’язку Codex і завершиться закритою помилкою, +між Codex і моделями не-Codex провайдерів. Примусове середовище виконання застосовується до кожного +вбудованого ходу для цього агента або сеансу. Якщо ви виберете модель Anthropic, коли +це середовище виконання примусово задане, OpenClaw усе одно спробує harness Codex і закриється з помилкою, замість того щоб тихо маршрутизувати цей хід через PI. Використовуйте натомість одну з цих форм: -- Розмістіть Codex на виділеному агенті з `agentRuntime.id: "codex"`. -- Залиште агент за замовчуванням на `agentRuntime.id: "auto"` і PI fallback для звичайного змішаного +- Розмістіть Codex на окремому агенті з `agentRuntime.id: "codex"`. +- Залиште стандартного агента на `agentRuntime.id: "auto"` і PI fallback для звичайного змішаного використання провайдерів. -- Використовуйте застарілі посилання `codex/*` лише для сумісності. Нові конфіги мають віддавати перевагу - `openai/*` плюс явній політиці runtime Codex. +- Використовуйте застарілі посилання `codex/*` лише для сумісності. Нові конфігурації мають надавати перевагу + `openai/*` плюс явній політиці середовища виконання Codex. -Наприклад, це залишає агент за замовчуванням на звичайному автоматичному виборі та -додає окремий агент Codex: +Наприклад, це залишає стандартного агента на звичайному автоматичному виборі та +додає окремого агента Codex: ```json5 { @@ -291,10 +291,10 @@ OpenClaw на поверхні протоколу, проти якої його } ``` -З цією формою: +З такою формою: -- Агент `main` за замовчуванням використовує звичайний шлях провайдера та fallback сумісності з PI. -- Агент `codex` використовує app-server harness Codex. +- Стандартний агент `main` використовує звичайний шлях провайдера та PI compatibility fallback. +- Агент `codex` використовує обв’язку сервера застосунку Codex. - Якщо Codex відсутній або не підтримується для агента `codex`, хід завершується помилкою замість тихого використання PI. @@ -302,26 +302,27 @@ OpenClaw на поверхні протоколу, проти якої його Агенти мають маршрутизувати запити користувача за наміром, а не лише за словом "Codex": -| Користувач просить... | Агент має використати... | -| ---------------------------------------------------------- | ------------------------------------------------ | -| "Прив’язати цей чат до Codex" | `/codex bind` | -| "Відновити thread Codex `` тут" | `/codex resume ` | -| "Показати threads Codex" | `/codex threads` | -| "Подати звіт у підтримку про невдалий запуск Codex" | `/diagnostics [note]` | -| "Надіслати відгук Codex лише для цього прикріпленого thread" | `/codex diagnostics [note]` | -| "Використовувати Codex як runtime для цього агента" | зміна конфігу на `agentRuntime.id` | +| Користувач просить... | Агент має використовувати... | +| -------------------------------------------------------- | ------------------------------------------------ | +| "Прив’язати цей чат до Codex" | `/codex bind` | +| "Відновити тут потік Codex ``" | `/codex resume ` | +| "Показати потоки Codex" | `/codex threads` | +| "Подати звіт у підтримку щодо невдалого запуску Codex" | `/diagnostics [note]` | +| "Надіслати відгук Codex лише для цього вкладеного потоку" | `/codex diagnostics [note]` | +| "Використовувати Codex як середовище виконання для цього агента" | зміна конфігурації `agentRuntime.id` | | "Використовувати мою підписку ChatGPT/Codex зі звичайним OpenClaw" | посилання на моделі `openai-codex/*` | -| "Запустити Codex через ACP/acpx" | ACP `sessions_spawn({ runtime: "acp", ... })` | -| "Запустити Claude Code/Gemini/OpenCode/Cursor у thread" | ACP/acpx, не `/codex` і не нативні sub-agents | +| "Запустити Codex через ACP/acpx" | ACP `sessions_spawn({ runtime: "acp", ... })` | +| "Запустити Claude Code/Gemini/OpenCode/Cursor у потоці" | ACP/acpx, не `/codex` і не нативні підагенти | -OpenClaw рекламує агентам підказки щодо spawn ACP лише тоді, коли ACP увімкнено, -доступний для dispatch і підкріплений завантаженим runtime backend. Якщо ACP недоступний, -system prompt і plugin skills не мають навчати агента маршрутизації ACP. +OpenClaw рекламує агентам інструкції щодо запуску ACP лише тоді, коли ACP увімкнено, +доступний для диспетчеризації та підкріплений завантаженим бекендом середовища виконання. Якщо ACP недоступний, +системний prompt і Skills Plugin не мають навчати агента маршрутизації +ACP. ## Розгортання лише з Codex -Примусово використовуйте harness Codex, коли потрібно довести, що кожен вбудований хід агента -використовує Codex. Явні runtimes plugin за замовчуванням не мають PI fallback, тому +Примусово використовуйте обв’язку Codex, коли потрібно довести, що кожен вбудований хід агента +використовує Codex. Явні середовища виконання Plugin типово не мають PI fallback, тому `fallback: "none"` необов’язковий, але часто корисний як документація: ```json5 @@ -338,20 +339,20 @@ system prompt і plugin skills не мають навчати агента ма } ``` -Перевизначення через середовище: +Перевизначення середовищем: ```bash OPENCLAW_AGENT_RUNTIME=codex openclaw gateway run ``` -Коли Codex примусово увімкнено, OpenClaw завершується рано, якщо plugin Codex вимкнено, якщо -app-server застарий або якщо app-server не може запуститися. Встановлюйте -`OPENCLAW_AGENT_HARNESS_FALLBACK=pi` лише тоді, коли ви навмисно хочете, щоб PI обробляв -відсутній вибір harness. +Коли Codex примусово увімкнено, OpenClaw завершується рано, якщо Plugin Codex вимкнено, якщо +сервер застосунку занадто старий або якщо сервер застосунку не може запуститися. Установіть +`OPENCLAW_AGENT_HARNESS_FALLBACK=pi` лише якщо ви навмисно хочете, щоб PI обробляв +відсутній вибір обв’язки. ## Codex для окремого агента -Можна зробити одного агента лише Codex, тоді як агент за замовчуванням зберігає звичайний +Можна зробити одного агента лише для Codex, тоді як стандартний агент зберігає звичайний автовибір: ```json5 @@ -383,21 +384,21 @@ app-server застарий або якщо app-server не може запус } ``` -Використовуйте звичайні команди сеансу, щоб перемикати агентів і моделі. `/new` створює новий -сеанс OpenClaw, а harness Codex створює або відновлює свій sidecar thread app-server -за потреби. `/reset` очищає прив’язку сеансу OpenClaw для цього thread -і дає наступному ходу знову визначити harness із поточного конфігу. +Використовуйте звичайні команди сесії, щоб перемикати агентів і моделі. `/new` створює нову +сесію OpenClaw, а обв’язка Codex створює або відновлює свій допоміжний потік сервера застосунку +за потреби. `/reset` очищає прив’язку сесії OpenClaw для цього потоку +і дає наступному ходу знову визначити обв’язку з поточної конфігурації. ## Виявлення моделей -За замовчуванням plugin Codex запитує app-server про доступні моделі. Якщо -виявлення завершується помилкою або перевищує час очікування, використовується вбудований fallback catalog для: +Типово Plugin Codex запитує у сервера застосунку доступні моделі. Якщо +виявлення завершується помилкою або перевищує час очікування, використовується вбудований резервний каталог для: - GPT-5.5 - GPT-5.4 mini - GPT-5.2 -Виявлення можна налаштувати в `plugins.entries.codex.config.discovery`: +Можна налаштувати виявлення в `plugins.entries.codex.config.discovery`: ```json5 { @@ -417,8 +418,8 @@ app-server застарий або якщо app-server не може запус } ``` -Вимкніть виявлення, коли хочете, щоб запуск уникав зондування Codex і дотримувався -fallback catalog: +Вимкніть виявлення, коли хочете, щоб запуск уникав зондування Codex і використовував лише +резервний каталог: ```json5 { @@ -437,27 +438,27 @@ fallback catalog: } ``` -## Підключення app-server і політика +## Підключення сервера застосунку та політика -За замовчуванням plugin запускає керований OpenClaw бінарник Codex локально з: +Типово Plugin запускає керований OpenClaw двійковий файл Codex локально з: ```bash codex app-server --listen stdio:// ``` -Керований бінарник оголошено як вбудовану залежність runtime plugin і підготовлено -разом з рештою залежностей plugin `codex`. Це прив’язує версію app-server -до вбудованого plugin, а не до будь-якого окремого Codex CLI, який випадково -встановлено локально. Встановлюйте `appServer.command` лише тоді, коли ви +Керований двійковий файл оголошено як залежність середовища виконання вбудованого Plugin і підготовлено +разом з рештою залежностей Plugin `codex`. Це прив’язує версію сервера застосунку +до вбудованого Plugin, а не до будь-якого окремого Codex CLI, +який випадково встановлено локально. Установлюйте `appServer.command` лише тоді, коли навмисно хочете запустити інший виконуваний файл. -За замовчуванням OpenClaw запускає локальні сеанси harness Codex у режимі YOLO: +Типово OpenClaw запускає локальні сесії обв’язки Codex у режимі YOLO: `approvalPolicy: "never"`, `approvalsReviewer: "user"` і -`sandbox: "danger-full-access"`. Це довірена позиція локального оператора, яку використовують -для автономних heartbeats: Codex може використовувати shell і мережеві інструменти без -зупинки на нативних запитах схвалення, на які нікому відповісти. +`sandbox: "danger-full-access"`. Це довірена локальна операторська позиція, яку використовують +для автономних Heartbeat: Codex може використовувати інструменти shell і мережі без +зупинки на нативних запитах на схвалення, на які ніхто не може відповісти. -Щоб увімкнути схвалення Codex із перевіркою guardian, встановіть `appServer.mode: +Щоб увімкнути перевірені guardian схвалення Codex, установіть `appServer.mode: "guardian"`: ```json5 @@ -478,21 +479,21 @@ codex app-server --listen stdio:// } ``` -Режим Guardian використовує нативний шлях схвалення Codex з автоматичною перевіркою. Коли Codex просить -вийти із sandbox, записати поза workspace або додати дозволи, як-от мережевий -доступ, Codex маршрутизує цей запит схвалення до нативного reviewer замість -людського prompt. Reviewer застосовує risk framework Codex і схвалює або відхиляє -конкретний запит. Використовуйте Guardian, коли потрібні суворіші guardrails, ніж у режимі YOLO, -але все одно потрібно, щоб unattended agents просувалися вперед. +Режим Guardian використовує нативний шлях автоматичної перевірки схвалень Codex. Коли Codex просить +вийти з пісочниці, записати поза робочою областю або додати дозволи, як-от мережевий +доступ, Codex маршрутизує цей запит на схвалення нативному рецензенту замість +людського prompt. Рецензент застосовує рамку оцінки ризику Codex і схвалює або відхиляє +конкретний запит. Використовуйте Guardian, коли потрібні сильніші запобіжники, ніж у режимі YOLO, +але все ще потрібно, щоб unattended агенти просувалися далі. Пресет `guardian` розгортається в `approvalPolicy: "on-request"`, `approvalsReviewer: "auto_review"` і `sandbox: "workspace-write"`. Окремі поля політики все ще перевизначають `mode`, тому розширені розгортання можуть поєднувати -пресет із явними виборами. Старіше значення reviewer `guardian_subagent` -досі приймається як alias сумісності, але нові конфіги мають використовувати +пресет з явними виборами. Старіше значення рецензента `guardian_subagent` +досі приймається як псевдонім сумісності, але нові конфігурації мають використовувати `auto_review`. -Для вже запущеного app-server використовуйте транспорт WebSocket: +Для вже запущеного сервера застосунку використовуйте транспорт WebSocket: ```json5 { @@ -514,24 +515,24 @@ codex app-server --listen stdio:// } ``` -Запуски stdio app-server за замовчуванням успадковують process environment OpenClaw, -але OpenClaw володіє account bridge app-server Codex. Auth вибирається в такому +Запуски сервера застосунку через stdio типово успадковують середовище процесу OpenClaw, +але OpenClaw володіє мостом облікового запису сервера застосунку Codex. Auth вибирається в такому порядку: -1. Явний профіль auth OpenClaw Codex для агента. -2. Наявний обліковий запис app-server, наприклад локальний вхід Codex CLI ChatGPT. -3. Лише для локальних запусків stdio app-server: `CODEX_API_KEY`, потім - `OPENAI_API_KEY`, коли немає облікового запису app-server і auth OpenAI - все ще потрібна. +1. Явний профіль Auth OpenClaw Codex для агента. +2. Наявний обліковий запис сервера застосунку, наприклад локальний вхід Codex CLI ChatGPT. +3. Лише для локальних запусків сервера застосунку через stdio: `CODEX_API_KEY`, потім + `OPENAI_API_KEY`, коли немає облікового запису сервера застосунку, а OpenAI auth + усе ще потрібний. -Коли OpenClaw бачить профіль auth Codex у стилі підписки ChatGPT, він вилучає -`CODEX_API_KEY` і `OPENAI_API_KEY` зі створеного дочірнього процесу Codex. Це -залишає API keys рівня Gateway доступними для embeddings або прямих моделей OpenAI -без випадкового billing нативних ходів Codex app-server через API. -Явні профілі Codex API-key і fallback локального stdio env-key використовують login app-server -замість успадкованого env дочірнього процесу. Підключення WebSocket app-server -не отримують fallback API-key env Gateway; використовуйте явний профіль auth або -власний обліковий запис віддаленого app-server. +Коли OpenClaw бачить профіль Auth Codex у стилі підписки ChatGPT, він вилучає +`CODEX_API_KEY` і `OPENAI_API_KEY` із породженого дочірнього процесу Codex. Це +залишає API-ключі рівня Gateway доступними для embeddings або прямих моделей OpenAI +без випадкового виставлення рахунків за нативні ходи сервера застосунку Codex через API. +Явні профілі API-ключа Codex і локальний stdio env-key fallback використовують вхід сервера застосунку +замість успадкованого середовища дочірнього процесу. Підключення до сервера застосунку через WebSocket +не отримують Gateway env API-key fallback; використовуйте явний профіль Auth або +власний обліковий запис віддаленого сервера застосунку. Якщо розгортанню потрібна додаткова ізоляція середовища, додайте ці змінні до `appServer.clearEnv`: @@ -553,31 +554,39 @@ codex app-server --listen stdio:// } ``` -`appServer.clearEnv` впливає лише на створений дочірній процес Codex app-server. +`appServer.clearEnv` впливає лише на породжений дочірній процес сервера застосунку 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 сформує успадковане середовище. | -| `requestTimeoutMs` | `60000` | Тайм-аут для викликів площини керування app-server. | -| `mode` | `"yolo"` | Пресет для виконання YOLO або виконання з перевіркою guardian. | -| `approvalPolicy` | `"never"` | Власна політика схвалень Codex, що надсилається під час запуску/відновлення/ходу потоку. | -| `sandbox` | `"danger-full-access"` | Власний режим пісочниці Codex, що надсилається під час запуску/відновлення потоку. | -| `approvalsReviewer` | `"user"` | Використовуйте `"auto_review"`, щоб дозволити Codex перевіряти власні запити на схвалення. `guardian_subagent` залишається застарілим псевдонімом. | -| `serviceTier` | не задано | Необов’язковий рівень сервісу app-server Codex: `"fast"`, `"flex"` або `null`. Недійсні застарілі значення ігноруються. | +| `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 сформує успадковане середовище. | +| `requestTimeoutMs` | `60000` | Тайм-аут для викликів площини керування app-server. | +| `mode` | `"yolo"` | Пресет для виконання YOLO або виконання з перевіркою guardian. | +| `approvalPolicy` | `"never"` | Нативна політика схвалень Codex, що надсилається до запуску/відновлення потоку/turn. | +| `sandbox` | `"danger-full-access"` | Нативний режим пісочниці Codex, що надсилається до запуску/відновлення потоку. | +| `approvalsReviewer` | `"user"` | Використовуйте `"auto_review"`, щоб дозволити Codex перевіряти нативні запити схвалення. `guardian_subagent` залишається застарілим псевдонімом. | +| `serviceTier` | не задано | Необов’язковий рівень сервісу Codex app-server: `"fast"`, `"flex"` або `null`. Недійсні застарілі значення ігноруються. | -Динамічні виклики інструментів, якими володіє OpenClaw, обмежуються незалежно від +Динамічні виклики інструментів, які належать OpenClaw, обмежуються незалежно від `appServer.requestTimeoutMs`: кожен запит Codex `item/tool/call` має отримати -відповідь OpenClaw протягом 30 секунд. У разі тайм-ауту OpenClaw перериває сигнал -інструмента там, де це підтримується, і повертає Codex невдалу відповідь динамічного інструмента, щоб -хід міг продовжитися, а сесія не залишалася в стані `processing`. +відповідь OpenClaw протягом 30 секунд. У разі тайм-ауту OpenClaw перериває +сигнал інструмента там, де це підтримується, і повертає невдалу відповідь +динамічного інструмента до Codex, щоб turn міг продовжитися, а не залишати +сесію в стані `processing`. + +Після того як OpenClaw відповідає на запит app-server у межах turn Codex, harness +також очікує, що Codex завершить нативний turn через `turn/completed`. Якщо +app-server мовчить 60 секунд після цієї відповіді, OpenClaw у режимі best-effort +перериває turn Codex, записує діагностичний тайм-аут і звільняє смугу сесії +OpenClaw, щоб наступні повідомлення чату не ставали в чергу за застарілим +нативним turn. Перевизначення середовища залишаються доступними для локального тестування: @@ -592,24 +601,24 @@ codex app-server --listen stdio:// `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, перевіряє, що -MCP-сервер `computer-use` доступний, а потім дозволяє Codex обробляти власні -виклики інструментів MCP під час ходів у режимі Codex. +Коротко: OpenClaw не постачає desktop-control app і не виконує дії робочого +стола самостійно. Він готує Codex app-server, перевіряє, що MCP-сервер +`computer-use` доступний, а потім дозволяє Codex обробляти нативні виклики MCP +інструментів під час turn у режимі Codex. -Для прямого доступу до драйвера TryCua поза потоком marketplace Codex зареєструйте -`cua-driver mcp` за допомогою `openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'`. -Див. [Використання комп’ютера Codex](/uk/plugins/codex-computer-use), щоб зрозуміти різницю -між використанням комп’ютера, яким володіє Codex, і прямою реєстрацією MCP. +Для прямого доступу до драйвера TryCua поза потоком marketplace Codex +зареєструйте `cua-driver mcp` через `openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'`. +Див. [Codex Computer Use](/uk/plugins/codex-computer-use), щоб зрозуміти різницю +між Computer Use, яким керує Codex, і прямою реєстрацією MCP. Мінімальна конфігурація: @@ -646,19 +655,20 @@ MCP-сервер `computer-use` доступний, а потім дозволя - `/codex computer-use install --source ` - `/codex computer-use install --marketplace-path ` -Використання комп’ютера є специфічним для macOS і може вимагати локальних дозволів ОС, перш ніж -MCP-сервер Codex зможе керувати програмами. Якщо `computerUse.enabled` має значення true, а MCP -сервер недоступний, ходи в режимі Codex завершуються помилкою до запуску потоку, замість того щоб -тихо виконуватися без власних інструментів використання комп’ютера. Див. -[Використання комп’ютера Codex](/uk/plugins/codex-computer-use) щодо варіантів marketplace, -обмежень віддаленого каталогу, причин статусу та усунення несправностей. +Computer Use специфічний для macOS і може вимагати локальних дозволів ОС, перш +ніж MCP-сервер Codex зможе керувати застосунками. Якщо `computerUse.enabled` +дорівнює true, а MCP-сервер недоступний, turn у режимі Codex завершується +помилкою до запуску потоку, а не непомітно виконується без нативних інструментів +Computer Use. Див. [Codex Computer Use](/uk/plugins/codex-computer-use) щодо +варіантів marketplace, обмежень віддаленого каталогу, причин статусу та +усунення несправностей. -Коли `computerUse.autoInstall` має значення true, OpenClaw може зареєструвати стандартний -вбудований marketplace Codex Desktop з +Коли `computerUse.autoInstall` дорівнює true, OpenClaw може зареєструвати +стандартний bundled marketplace Codex Desktop із `/Applications/Codex.app/Contents/Resources/plugins/openai-bundled`, якщо Codex ще не виявив локальний marketplace. Використовуйте `/new` або `/reset` після -зміни конфігурації runtime або використання комп’ютера, щоб наявні сесії не зберігали старе -прив’язування PI або потоку Codex. +зміни runtime або конфігурації Computer Use, щоб наявні сесії не зберігали +старе прив’язування PI або потоку Codex. ## Поширені рецепти @@ -676,7 +686,7 @@ MCP-сервер Codex зможе керувати програмами. Якщ } ``` -Валідація обв’язки лише Codex: +Перевірка harness лише для Codex: ```json5 { @@ -698,7 +708,7 @@ MCP-сервер Codex зможе керувати програмами. Якщ } ``` -Схвалення Codex з перевіркою guardian: +Схвалення Codex із перевіркою guardian: ```json5 { @@ -743,269 +753,272 @@ MCP-сервер Codex зможе керувати програмами. Якщ } ``` -Перемикання моделей залишається під керуванням OpenClaw. Коли сесія OpenClaw прикріплена -до наявного потоку Codex, наступний хід знову надсилає до app-server поточно вибрану -модель OpenAI, провайдера, політику схвалень, пісочницю та рівень сервісу. -Перемикання з `openai/gpt-5.5` на `openai/gpt-5.2` зберігає -прив’язування потоку, але просить Codex продовжити з новою вибраною моделлю. +Перемикання моделі залишається під керуванням OpenClaw. Коли сесію OpenClaw +прикріплено до наявного потоку Codex, наступний turn знову надсилає поточно +вибрану модель OpenAI, провайдера, політику схвалення, пісочницю та рівень +сервісу до app-server. Перемикання з `openai/gpt-5.5` на `openai/gpt-5.2` +зберігає прив’язування потоку, але просить Codex продовжити з новообраною +моделлю. ## Команда Codex -Вбудований plugin реєструє `/codex` як авторизовану slash-команду. Вона є -загальною та працює в будь-якому каналі, що підтримує текстові команди OpenClaw. +Bundled Plugin реєструє `/codex` як авторизовану slash-команду. Вона +універсальна й працює в будь-якому каналі, що підтримує текстові команди +OpenClaw. Поширені форми: -- `/codex status` показує активне підключення app-server, моделі, обліковий запис, ліміти швидкості, MCP-сервери та Skills. -- `/codex models` перелічує активні моделі app-server Codex. +- `/codex status` показує live-підключення app-server, моделі, обліковий запис, rate limits, MCP-сервери та Skills. +- `/codex models` перелічує live-моделі Codex app-server. - `/codex threads [filter]` перелічує нещодавні потоки Codex. - `/codex resume ` прикріплює поточну сесію OpenClaw до наявного потоку Codex. -- `/codex compact` просить app-server Codex ущільнити прикріплений потік. -- `/codex review` запускає власну перевірку Codex для прикріпленого потоку. +- `/codex compact` просить Codex app-server ущільнити прикріплений потік. +- `/codex review` запускає нативний review Codex для прикріпленого потоку. - `/codex diagnostics [note]` запитує підтвердження перед надсиланням діагностичного feedback Codex для прикріпленого потоку. -- `/codex computer-use status` перевіряє налаштований plugin використання комп’ютера та MCP-сервер. -- `/codex computer-use install` встановлює налаштований plugin використання комп’ютера та перезавантажує MCP-сервери. -- `/codex account` показує стан облікового запису та лімітів швидкості. -- `/codex mcp` перелічує стан MCP-серверів app-server Codex. -- `/codex skills` перелічує Skills app-server Codex. +- `/codex computer-use status` перевіряє налаштований Plugin Computer Use і MCP-сервер. +- `/codex computer-use install` встановлює налаштований Plugin Computer Use і перезавантажує MCP-сервери. +- `/codex account` показує стан облікового запису та rate-limit. +- `/codex mcp` перелічує статус MCP-серверів Codex app-server. +- `/codex skills` перелічує Skills Codex app-server. ### Поширений робочий процес налагодження Коли агент на базі Codex робить щось неочікуване в Telegram, Discord, Slack або іншому каналі, почніть із розмови, де сталася проблема: -1. Виконайте `/diagnostics bad tool choice after image upload` або іншу коротку нотатку, - яка описує побачене. -2. Один раз схваліть діагностичний запит. Схвалення створює локальний діагностичний zip Gateway - і, оскільки сесія використовує обв’язку Codex, також - надсилає відповідний пакет feedback Codex на сервери OpenAI. -3. Скопіюйте завершену діагностичну відповідь у звіт про помилку або support thread. - Вона містить локальний шлях до пакета, зведення конфіденційності, ідентифікатори сесій OpenClaw, - ідентифікатори потоків Codex і рядок `Inspect locally` для кожного потоку Codex. -4. Якщо ви хочете самостійно налагодити запуск, виконайте надруковану команду `Inspect locally` - у терміналі. Вона має вигляд `codex resume ` і відкриває - власний потік Codex, щоб ви могли переглянути розмову, продовжити її локально - або запитати Codex, чому він вибрав певний інструмент чи план. +1. Запустіть `/diagnostics bad tool choice after image upload` або іншу коротку нотатку, + що описує побачене. +2. Один раз схваліть запит діагностики. Схвалення створює локальний + діагностичний zip Gateway і, оскільки сесія використовує harness Codex, також + надсилає відповідний feedback bundle Codex на сервери OpenAI. +3. Скопіюйте завершену відповідь діагностики до bug report або support thread. + Вона містить локальний шлях до bundle, підсумок приватності, ідентифікатори + сесії OpenClaw, ідентифікатори потоків Codex і рядок `Inspect locally` для + кожного потоку Codex. +4. Якщо ви хочете самостійно налагодити запуск, виконайте надруковану команду + `Inspect locally` у терміналі. Вона має вигляд `codex resume ` і + відкриває нативний потік Codex, щоб ви могли оглянути розмову, продовжити її + локально або запитати Codex, чому він вибрав певний інструмент чи план. -Використовуйте `/codex diagnostics [note]` лише тоді, коли вам спеціально потрібне завантаження -feedback Codex для поточного прикріпленого потоку без повного діагностичного пакета -Gateway OpenClaw. Для більшості звітів у підтримку `/diagnostics [note]` є -кращою відправною точкою, бо він пов’язує локальний стан Gateway та ідентифікатори потоків Codex -в одній відповіді. Див. [Експорт діагностики](/uk/gateway/diagnostics) -щодо повної моделі конфіденційності та поведінки в груповому чаті. +Використовуйте `/codex diagnostics [note]` лише тоді, коли вам спеціально +потрібне завантаження feedback Codex для поточно прикріпленого потоку без +повного діагностичного bundle OpenClaw Gateway. Для більшості support reports +`/diagnostics [note]` є кращою відправною точкою, оскільки він пов’язує +локальний стан Gateway та ідентифікатори потоків Codex в одній відповіді. Див. +[Експорт діагностики](/uk/gateway/diagnostics) щодо повної моделі приватності та +поведінки групових чатів. -Ядро OpenClaw також надає доступну лише власнику команду `/diagnostics [note]` як загальну -діагностичну команду Gateway. Її запит на схвалення показує преамбулу про конфіденційні дані, -посилається на [Експорт діагностики](/uk/gateway/diagnostics) і щоразу запитує -`openclaw gateway diagnostics export --json` через явне exec-схвалення. -Не схвалюйте діагностику правилом allow-all. Після схвалення -OpenClaw надсилає придатний для вставлення звіт із локальним шляхом до пакета та -зведенням маніфесту. Коли активна сесія OpenClaw використовує обв’язку Codex, це -саме схвалення також дозволяє надсилати відповідні пакети feedback Codex на -сервери OpenAI. У запиті на схвалення зазначено, що feedback Codex буде надіслано, але -до схвалення він не перелічує ідентифікатори сесій або потоків Codex. +Core OpenClaw також надає owner-only `/diagnostics [note]` як загальну команду +діагностики Gateway. Її запит схвалення показує преамбулу про чутливі дані, +посилання на [Експорт діагностики](/uk/gateway/diagnostics) і щоразу запитує +`openclaw gateway diagnostics export --json` через явне exec-схвалення. Не +схвалюйте діагностику правилом allow-all. Після схвалення OpenClaw надсилає +звіт, який можна вставити, з локальним шляхом до bundle і підсумком manifest. +Коли активна сесія OpenClaw використовує harness Codex, це саме схвалення також +дозволяє надсилати відповідні feedback bundles Codex на сервери OpenAI. У +запиті схвалення вказано, що feedback Codex буде надіслано, але він не перелічує +ідентифікатори сесії чи потоків Codex до схвалення. -Якщо `/diagnostics` викликає власник у груповому чаті, OpenClaw зберігає -спільний канал чистим: група отримує лише коротке повідомлення, тоді як -діагностична преамбула, запити на схвалення та ідентифікатори сесій/потоків Codex надсилаються -власнику через приватний маршрут схвалення. Якщо приватного маршруту власника немає, -OpenClaw відхиляє груповий запит і просить власника виконати його з DM. +Якщо `/diagnostics` викликає owner у груповому чаті, OpenClaw тримає спільний +канал чистим: група отримує лише коротке сповіщення, тоді як діагностична +преамбула, запити схвалення та ідентифікатори сесії/потоку Codex надсилаються +owner через приватний маршрут схвалення. Якщо приватного маршруту owner немає, +OpenClaw відхиляє груповий запит і просить owner запустити його з DM. -Схвалені виклики завантаження Codex викликають `feedback/upload` сервера застосунку Codex і просять -сервер застосунку включити журнали для кожного переліченого треду та породжених підтредів Codex, -коли вони доступні. Завантаження проходить через звичайний шлях зворотного зв’язку Codex до серверів OpenAI; якщо зворотний зв’язок Codex вимкнено на цьому сервері застосунку, команда повертає -помилку сервера застосунку. Завершена діагностична відповідь перелічує канали, -ідентифікатори сесій OpenClaw, ідентифікатори тредів Codex і локальні команди -`codex resume ` для тредів, які було надіслано. Якщо ви відхилите або проігноруєте схвалення, +Затверджений виклик завантаження Codex викликає `feedback/upload` app-server Codex і просить +app-server включити журнали для кожного вказаного потоку та породжених підпотоків Codex, +коли вони доступні. Завантаження проходить звичайним шляхом зворотного зв’язку Codex до серверів OpenAI; +якщо зворотний зв’язок Codex вимкнено в цьому app-server, команда повертає +помилку app-server. Завершена відповідь діагностики перелічує канали, +ідентифікатори сесій OpenClaw, ідентифікатори потоків Codex і локальні команди +`codex resume ` для потоків, які було надіслано. Якщо ви відхилите або проігноруєте підтвердження, OpenClaw не виводить ці ідентифікатори Codex. Це завантаження не замінює локальний експорт діагностики Gateway. -`/codex resume` записує той самий супровідний файл прив’язки, який тестовий harness використовує для -звичайних ходів. У наступному повідомленні OpenClaw відновлює цей тред Codex, передає -поточну вибрану модель OpenClaw у сервер застосунку й залишає розширену історію +`/codex resume` записує той самий супровідний файл прив’язки, який harness використовує для +звичайних ходів. У наступному повідомленні OpenClaw відновлює цей потік Codex, передає +поточну вибрану модель OpenClaw до app-server і залишає розширену історію увімкненою. -### Перегляньте тред Codex із CLI +### Перевірити потік Codex із CLI -Найшвидший спосіб зрозуміти невдалий запуск Codex часто полягає в тому, щоб відкрити нативний тред Codex -безпосередньо: +Найшвидший спосіб зрозуміти невдалий запуск Codex часто полягає в тому, щоб відкрити нативний потік Codex +напряму: ```sh codex resume ``` -Використовуйте це, коли помічаєте помилку в розмові каналу й хочете переглянути +Використовуйте це, коли помічаєте помилку в розмові каналу й хочете перевірити проблемну сесію Codex, продовжити її локально або запитати Codex, чому він зробив -певний вибір інструмента чи міркування. Найпростіший шлях зазвичай — спершу запустити -`/diagnostics [note]`: після схвалення завершений звіт перелічить -кожен тред Codex і виведе команду `Inspect locally`, наприклад +певний вибір інструмента чи міркування. Найпростіший шлях зазвичай такий: +спочатку виконати `/diagnostics [note]`: після вашого підтвердження завершений звіт перелічує +кожен потік Codex і друкує команду `Inspect locally`, наприклад `codex resume `. Ви можете скопіювати цю команду безпосередньо в термінал. -Ви також можете отримати ідентифікатор треду з `/codex binding` для поточного чату або -`/codex threads [filter]` для нещодавніх тредів сервера застосунку Codex, а потім виконати ту саму +Ви також можете отримати ідентифікатор потоку з `/codex binding` для поточного чату або +`/codex threads [filter]` для нещодавніх потоків app-server Codex, а потім виконати ту саму команду `codex resume` у своїй оболонці. -Поверхня команд потребує сервера застосунку Codex `0.125.0` або новішого. Окремі +Поверхня команд потребує app-server Codex версії `0.125.0` або новішої. Окремі методи керування повідомляються як `unsupported by this Codex app-server`, якщо -майбутній або користувацький сервер застосунку не надає цей метод JSON-RPC. +майбутній або користувацький app-server не надає цей метод JSON-RPC. ## Межі хуків -Harness Codex має три рівні хуків: +Harness Codex має три шари хуків: -| Рівень | Власник | Призначення | -| ------------------------------------- | ------------------------ | ------------------------------------------------------------------ | -| Хуки Plugin OpenClaw | OpenClaw | Сумісність продукту/Plugin між harness Pi та Codex. | -| Middleware розширень сервера застосунку Codex | Комплектні plugins OpenClaw | Поведінка адаптера для кожного ходу навколо динамічних інструментів OpenClaw. | -| Нативні хуки Codex | Codex | Низькорівневий життєвий цикл Codex і нативна політика інструментів із конфігурації Codex. | +| Шар | Власник | Призначення | +| ------------------------------------ | ------------------------ | ------------------------------------------------------------------ | +| Хуки плагінів OpenClaw | OpenClaw | Сумісність продукту/плагінів у harness Pi та Codex. | +| Middleware розширень app-server Codex | Вбудовані плагіни OpenClaw | Поведінка адаптера для кожного ходу навколо динамічних інструментів OpenClaw. | +| Нативні хуки Codex | Codex | Низькорівневий життєвий цикл Codex і нативна політика інструментів із конфігурації Codex. | OpenClaw не використовує проєктні або глобальні файли Codex `hooks.json` для маршрутизації -поведінки Plugin OpenClaw. Для підтримуваного мосту нативних інструментів і дозволів -OpenClaw ін’єктує конфігурацію Codex для кожного треду для `PreToolUse`, `PostToolUse`, +поведінки плагінів OpenClaw. Для підтримуваного мосту нативних інструментів і дозволів +OpenClaw інжектує конфігурацію Codex на рівні потоку для `PreToolUse`, `PostToolUse`, `PermissionRequest` і `Stop`. Інші хуки Codex, як-от `SessionStart` і -`UserPromptSubmit`, залишаються засобами керування рівня Codex; вони не надаються як -хуки Plugin OpenClaw у контракті v1. +`UserPromptSubmit`, залишаються елементами керування рівня Codex; вони не надаються як +хуки плагінів OpenClaw у контракті v1. -Для динамічних інструментів OpenClaw OpenClaw виконує інструмент після того, як Codex попросить -виклик, тож OpenClaw запускає поведінку Plugin і middleware, якими він володіє, в -адаптері harness. Для нативних інструментів Codex саме Codex володіє канонічним записом інструмента. -OpenClaw може дзеркалити вибрані події, але не може переписувати нативний тред Codex, -якщо Codex не надає цю операцію через сервер застосунку або callback-функції нативних хуків. +Для динамічних інструментів OpenClaw OpenClaw виконує інструмент після того, як Codex просить +виклик, тому OpenClaw запускає поведінку плагінів і middleware, якою він володіє, в +адаптері harness. Для нативних інструментів Codex володіє канонічним записом інструмента. +OpenClaw може віддзеркалювати вибрані події, але не може переписати нативний потік Codex, +якщо Codex не надає цю операцію через app-server або callback-и нативних хуків. -Проєкції життєвого циклу Compaction і LLM надходять зі сповіщень сервера застосунку Codex +Проєкції Compaction і життєвого циклу LLM надходять із сповіщень app-server Codex і стану адаптера OpenClaw, а не з команд нативних хуків Codex. Події OpenClaw `before_compaction`, `after_compaction`, `llm_input` і -`llm_output` є спостереженнями рівня адаптера, а не побайтовими знімками -внутрішнього запиту Codex або payload Compaction. +`llm_output` є спостереженнями рівня адаптера, а не побайтовими захопленнями +внутрішнього запиту Codex або payload-ів Compaction. -Нативні сповіщення сервера застосунку Codex `hook/started` і `hook/completed` +Нативні сповіщення app-server Codex `hook/started` і `hook/completed` проєктуються як події агента `codex_app_server.hook` для траєкторії та налагодження. -Вони не викликають хуки Plugin OpenClaw. +Вони не викликають хуки плагінів OpenClaw. ## Контракт підтримки V1 -Режим Codex — це не Pi з іншим викликом моделі під ним. Codex володіє більшою частиною -нативного циклу моделі, а OpenClaw адаптує свої поверхні Plugin і сесій +Режим Codex — це не Pi з іншим викликом моделі під капотом. Codex володіє більшою частиною +нативного циклу моделі, а OpenClaw адаптує свої поверхні плагінів і сесій навколо цієї межі. Підтримується в runtime Codex v1: -| Поверхня | Підтримка | Чому | -| --------------------------------------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Цикл моделі OpenAI через Codex | Підтримується | Сервер застосунку Codex володіє ходом OpenAI, відновленням нативного треду й продовженням нативного інструмента. | -| Маршрутизація та доставка каналів OpenClaw | Підтримується | Telegram, Discord, Slack, WhatsApp, iMessage та інші канали залишаються поза runtime моделі. | -| Динамічні інструменти OpenClaw | Підтримується | Codex просить OpenClaw виконати ці інструменти, тож OpenClaw залишається в шляху виконання. | -| Plugins підказок і контексту | Підтримується | OpenClaw будує накладки підказок і проєктує контекст у хід Codex перед запуском або відновленням треду. | -| Життєвий цикл рушія контексту | Підтримується | Збирання, поглинання або обслуговування після ходу та координація Compaction рушія контексту виконуються для ходів Codex. | -| Хуки динамічних інструментів | Підтримується | `before_tool_call`, `after_tool_call` і middleware результатів інструментів виконуються навколо динамічних інструментів, якими володіє OpenClaw. | -| Хуки життєвого циклу | Підтримуються як спостереження адаптера | `llm_input`, `llm_output`, `agent_end`, `before_compaction` і `after_compaction` спрацьовують із чесними payload режиму Codex. | -| Шлюз ревізії фінальної відповіді | Підтримується через ретрансляцію нативного хука | Codex `Stop` ретранслюється до `before_agent_finalize`; `revise` просить Codex виконати ще один прохід моделі перед фіналізацією. | -| Блокування або спостереження нативних shell, patch і MCP | Підтримується через ретрансляцію нативного хука | Codex `PreToolUse` і `PostToolUse` ретранслюються для зафіксованих нативних поверхонь інструментів, включно з payload MCP на сервері застосунку Codex `0.125.0` або новішому. Блокування підтримується; переписування аргументів — ні. | -| Нативна політика дозволів | Підтримується через ретрансляцію нативного хука | Codex `PermissionRequest` може маршрутизуватися через політику OpenClaw там, де runtime це надає. Якщо OpenClaw не повертає рішення, Codex продовжує через свій звичайний шлях guardian або схвалення користувача. | -| Захоплення траєкторії сервера застосунку | Підтримується | OpenClaw записує запит, який він надіслав серверу застосунку, і сповіщення сервера застосунку, які отримує. | +| Поверхня | Підтримка | Чому | +| -------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Цикл моделі OpenAI через Codex | Підтримується | app-server Codex володіє ходом OpenAI, відновленням нативного потоку та продовженням нативних інструментів. | +| Маршрутизація й доставка каналів OpenClaw | Підтримується | Telegram, Discord, Slack, WhatsApp, iMessage та інші канали залишаються поза runtime моделі. | +| Динамічні інструменти OpenClaw | Підтримується | Codex просить OpenClaw виконати ці інструменти, тому OpenClaw залишається на шляху виконання. | +| Плагіни prompt-ів і контексту | Підтримується | OpenClaw будує накладення prompt-ів і проєктує контекст у хід Codex перед запуском або відновленням потоку. | +| Життєвий цикл рушія контексту | Підтримується | Збирання, ingest або післяходове обслуговування, а також координація Compaction рушія контексту виконуються для ходів Codex. | +| Хуки динамічних інструментів | Підтримується | `before_tool_call`, `after_tool_call` і middleware результатів інструментів виконуються навколо динамічних інструментів, якими володіє OpenClaw. | +| Хуки життєвого циклу | Підтримуються як спостереження адаптера | `llm_input`, `llm_output`, `agent_end`, `before_compaction` і `after_compaction` спрацьовують із чесними payload-ами режиму Codex. | +| Шлюз перегляду фінальної відповіді | Підтримується через relay нативних хуків | Codex `Stop` передається до `before_agent_finalize`; `revise` просить Codex виконати ще один прохід моделі перед фіналізацією. | +| Нативні shell, patch і MCP: блокування або спостереження | Підтримується через relay нативних хуків | Codex `PreToolUse` і `PostToolUse` передаються для зафіксованих нативних поверхонь інструментів, включно з payload-ами MCP на app-server Codex `0.125.0` або новішому. Блокування підтримується; переписування аргументів — ні. | +| Нативна політика дозволів | Підтримується через relay нативних хуків | Codex `PermissionRequest` може маршрутизуватися через політику OpenClaw там, де runtime це надає. Якщо OpenClaw не повертає рішення, Codex продовжує через свій звичайний шлях guardian або підтвердження користувача. | +| Захоплення траєкторії app-server | Підтримується | OpenClaw записує запит, який він надіслав до app-server, і сповіщення app-server, які він отримує. | Не підтримується в runtime Codex v1: -| Поверхня | Межа V1 | Майбутній шлях | -| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | -| Мутація аргументів нативного інструмента | Нативні pre-tool хуки Codex можуть блокувати, але OpenClaw не переписує аргументи нативних інструментів Codex. | Потребує підтримки хуків/схеми Codex для заміни вхідних даних інструмента. | -| Редагована історія нативного transcript Codex | Codex володіє канонічною історією нативного треду. OpenClaw володіє дзеркалом і може проєктувати майбутній контекст, але не повинен мутувати непідтримувані внутрішні дані. | Додати явні API сервера застосунку Codex, якщо потрібна хірургія нативного треду. | -| `tool_result_persist` для записів нативних інструментів Codex | Цей хук трансформує записи transcript, якими володіє OpenClaw, а не записи нативних інструментів Codex. | Можна дзеркалити трансформовані записи, але канонічне переписування потребує підтримки Codex. | -| Розширені нативні метадані Compaction | OpenClaw спостерігає початок і завершення Compaction, але не отримує стабільний список збереженого/відкинутого, дельту токенів або payload підсумку. | Потрібні багатші події Compaction Codex. | -| Втручання в Compaction | Поточні хуки Compaction OpenClaw у режимі Codex мають рівень сповіщень. | Додати хуки Codex pre/post Compaction, якщо plugins мають накладати вето або переписувати нативну Compaction. | -| Побайтове захоплення API-запиту моделі | OpenClaw може захоплювати запити до сервера застосунку та сповіщення, але ядро Codex будує фінальний API-запит OpenAI внутрішньо. | Потрібна подія трасування запиту моделі Codex або API налагодження. | +| Поверхня | Межа V1 | Майбутній шлях | +| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | +| Мутація аргументів нативних інструментів | Нативні pre-tool хуки Codex можуть блокувати, але OpenClaw не переписує аргументи нативних інструментів Codex. | Потребує підтримки хуків/схеми Codex для заміни вхідних даних інструмента. | +| Редагована історія нативного transcript Codex | Codex володіє канонічною історією нативного потоку. OpenClaw володіє дзеркалом і може проєктувати майбутній контекст, але не має мутувати непідтримувані внутрішні дані. | Додати явні API app-server Codex, якщо потрібна хірургія нативного потоку. | +| `tool_result_persist` для записів нативних інструментів Codex | Цей хук трансформує записи transcript, якими володіє OpenClaw, а не записи нативних інструментів Codex. | Можна віддзеркалювати трансформовані записи, але канонічне переписування потребує підтримки Codex. | +| Розширені нативні метадані Compaction | OpenClaw спостерігає початок і завершення Compaction, але не отримує стабільний список залишеного/відкинутого, дельту токенів або payload підсумку. | Потребує багатших подій Compaction Codex. | +| Втручання в Compaction | Поточні хуки Compaction OpenClaw у режимі Codex мають рівень сповіщень. | Додати pre/post хуки Compaction Codex, якщо плагінам потрібно накладати вето або переписувати нативну Compaction. | +| Побайтове захоплення API-запиту моделі | OpenClaw може захоплювати запити й сповіщення app-server, але ядро Codex внутрішньо будує фінальний API-запит OpenAI. | Потребує події трасування запиту моделі Codex або debug API. | ## Інструменти, медіа та Compaction Harness Codex змінює лише низькорівневий вбудований виконавець агента. OpenClaw і далі будує список інструментів і отримує результати динамічних інструментів від -harness. Текст, зображення, відео, музика, TTS, схвалення та вивід інструментів обміну повідомленнями -і далі проходять через звичайний шлях доставки OpenClaw. +harness. Текст, зображення, відео, музика, TTS, підтвердження та вивід messaging-tool +продовжують проходити звичайним шляхом доставки OpenClaw. -Ретрансляція нативного хука навмисно є універсальною, але контракт підтримки v1 +Relay нативних хуків навмисно є загальним, але контракт підтримки v1 обмежений шляхами нативних інструментів і дозволів Codex, які тестує OpenClaw. У -runtime Codex це включає payload shell, patch і MCP `PreToolUse`, +runtime Codex це включає payload-и shell, patch і MCP `PreToolUse`, `PostToolUse` і `PermissionRequest`. Не припускайте, що кожна майбутня -подія хука Codex є поверхнею Plugin OpenClaw, доки контракт runtime не назве -її. +подія хуків Codex є поверхнею плагінів OpenClaw, доки контракт runtime +не назве її. -Для `PermissionRequest` OpenClaw повертає явні рішення дозволити або відхилити -лише тоді, коли це вирішує політика. Результат без рішення не є дозволом. Codex трактує його як відсутність -рішення хука й переходить до власного шляху guardian або схвалення користувача. +Для `PermissionRequest` OpenClaw повертає явні рішення allow або deny лише +коли політика ухвалює рішення. Результат без рішення не є allow. Codex трактує його як +відсутність рішення хуку й переходить до власного шляху guardian або підтвердження користувача. -Запити схвалення інструментів MCP Codex маршрутизуються через потік схвалення Plugin -OpenClaw, коли Codex позначає `_meta.codex_approval_kind` як -`"mcp_tool_call"`. Підказки Codex `request_user_input` надсилаються назад до -початкового чату, а наступне поставлене в чергу подальше повідомлення відповідає на цей нативний -запит сервера замість того, щоб спрямовуватися як додатковий контекст. Інші запити elicitation MCP -і далі завершуються закритою відмовою. +Запити на підтвердження інструментів Codex MCP маршрутизуються через потік +підтверджень плагінів OpenClaw, коли Codex позначає `_meta.codex_approval_kind` як +`"mcp_tool_call"`. Prompt-и Codex `request_user_input` надсилаються назад до +початкового чату, а наступне повідомлення-відповідь у черзі відповідає на цей нативний +запит сервера замість того, щоб спрямовуватися як додатковий контекст. Інші запити elicitation +MCP і далі завершуються закритою відмовою. -Коли вибрана модель використовує Codex harness, нативна Compaction потоку -делегується Codex app-server. OpenClaw зберігає дзеркало транскрипту для історії -каналу, пошуку, `/new`, `/reset` і майбутнього перемикання моделі або harness. Дзеркало -містить запит користувача, фінальний текст асистента та легкі записи міркувань -або плану Codex, коли app-server їх видає. Нині OpenClaw лише записує сигнали -початку й завершення нативної Compaction. Він ще не надає людиночитного -підсумку Compaction або придатного для аудиту списку записів, які Codex +Коли вибрана модель використовує обв’язку Codex, нативну Compaction потоку +делеговано Codex app-server. OpenClaw зберігає дзеркало транскрипта для історії +каналу, пошуку, `/new`, `/reset` і майбутнього перемикання моделі або обв’язки. Дзеркало +містить підказку користувача, фінальний текст асистента й полегшені записи +міркувань або плану Codex, коли app-server їх видає. Наразі OpenClaw лише +записує сигнали початку й завершення нативної Compaction. Він ще не надає +людинозрозумілий підсумок Compaction або придатний для аудиту список записів, які Codex зберіг після Compaction. -Оскільки Codex володіє канонічним нативним потоком, `tool_result_persist` зараз -не перезаписує записи результатів інструментів, нативні для Codex. Він застосовується -лише тоді, коли OpenClaw записує результат інструмента в транскрипт сесії, -яким володіє OpenClaw. +Оскільки Codex володіє канонічним нативним потоком, `tool_result_persist` наразі не +перезаписує Codex-нативні записи результатів інструментів. Він застосовується лише тоді, коли +OpenClaw записує результат інструмента транскрипта сеансу, що належить OpenClaw. -Генерація медіа не потребує PI. Зображення, відео, музика, PDF, TTS і -розуміння медіа й надалі використовують відповідні налаштування провайдера/моделі, -такі як `agents.defaults.imageGenerationModel`, `videoGenerationModel`, `pdfModel` і +Генерація медіа не потребує PI. Зображення, відео, музика, PDF, TTS і розуміння медіа +надалі використовують відповідні налаштування провайдера/моделі, як-от +`agents.defaults.imageGenerationModel`, `videoGenerationModel`, `pdfModel` і `messages.tts`. ## Усунення несправностей -**Codex не відображається як звичайний провайдер `/model`:** це очікувано для +**Codex не з’являється як звичайний провайдер `/model`:** це очікувано для нових конфігурацій. Виберіть модель `openai/gpt-*` з `agentRuntime.id: "codex"` (або застаріле посилання `codex/*`), увімкніть `plugins.entries.codex.enabled` і перевірте, чи `plugins.allow` не виключає `codex`. -**OpenClaw використовує PI замість Codex:** `agentRuntime.id: "auto"` усе ще може використовувати PI як -бекенд сумісності, коли жоден Codex harness не бере запуск на себе. Установіть -`agentRuntime.id: "codex"`, щоб примусово вибрати Codex під час тестування. -Примусове середовище виконання Codex тепер завершується помилкою замість -відкату до PI, якщо ви явно не встановите `agentRuntime.fallback: "pi"`. Після -вибору Codex app-server його помилки відображаються напряму без додаткової -конфігурації відкату. +**OpenClaw використовує PI замість Codex:** `agentRuntime.id: "auto"` все ще може використовувати PI як +сумісний бекенд, коли жодна обв’язка Codex не приймає виконання. Установіть +`agentRuntime.id: "codex"`, щоб примусово вибрати Codex під час тестування. Примусово +заданий runtime Codex тепер завершується помилкою замість повернення до PI, якщо ви +явно не встановили `agentRuntime.fallback: "pi"`. Після вибору Codex app-server +його помилки передаються напряму без додаткової конфігурації fallback. **app-server відхилено:** оновіть Codex, щоб handshake app-server -повідомляв версію `0.125.0` або новішу. Попередні випуски тієї самої версії або версії із суфіксом збірки, -як-от `0.125.0-alpha.2` чи `0.125.0+custom`, відхиляються, оскільки -стабільний мінімум протоколу `0.125.0` — це те, що тестує OpenClaw. +повідомляв версію `0.125.0` або новішу. Пререлізи тієї самої версії або версії із суфіксом збірки, +як-от `0.125.0-alpha.2` чи `0.125.0+custom`, відхиляються, оскільки стабільний +мінімальний рівень протоколу `0.125.0` є тим, що тестує OpenClaw. **Виявлення моделей повільне:** зменште `plugins.entries.codex.config.discovery.timeoutMs` або вимкніть виявлення. -**Транспорт WebSocket одразу завершується помилкою:** перевірте `appServer.url`, `authToken`, -а також те, що віддалений app-server використовує ту саму версію протоколу Codex app-server. +**Транспорт WebSocket одразу дає збій:** перевірте `appServer.url`, `authToken` +і те, що віддалений app-server підтримує ту саму версію протоколу Codex app-server. **Модель не Codex використовує PI:** це очікувано, якщо ви не примусили -`agentRuntime.id: "codex"` для цього агента або не вибрали застаріле -посилання `codex/*`. Звичайні `openai/gpt-*` та інші посилання провайдерів залишаються на своєму звичайному -шляху провайдера в режимі `auto`. Якщо ви примусово встановите `agentRuntime.id: "codex"`, кожен вбудований +`agentRuntime.id: "codex"` для цього агента або не вибрали застаріле посилання +`codex/*`. Звичайні `openai/gpt-*` та інші посилання провайдерів залишаються на своєму нормальному +шляху провайдера в режимі `auto`. Якщо ви примусово задаєте `agentRuntime.id: "codex"`, кожен вбудований хід для цього агента має бути підтримуваною Codex моделлю OpenAI. -**Computer Use установлено, але інструменти не запускаються:** перевірте -`/codex computer-use status` з нової сесії. Якщо інструмент повідомляє -`Native hook relay unavailable`, використайте `/new` або `/reset`; якщо це зберігається, перезапустіть -Gateway, щоб очистити застарілі реєстрації нативних hooks. Якщо `computer-use.list_apps` -завершується за тайм-аутом, перезапустіть Codex Computer Use або Codex Desktop і повторіть спробу. +**Computer Use встановлено, але інструменти не запускаються:** перевірте +`/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) -- [Середовища виконання агентів](/uk/concepts/agent-runtimes) +- [Плагіни обв’язки агента](/uk/plugins/sdk-agent-harness) +- [Runtime агента](/uk/concepts/agent-runtimes) - [Провайдери моделей](/uk/concepts/model-providers) - [Провайдер OpenAI](/uk/providers/openai) -- [Стан](/uk/cli/status) -- [Plugin hooks](/uk/plugins/hooks) +- [Статус](/uk/cli/status) +- [Хуки Plugin](/uk/plugins/hooks) - [Довідник конфігурації](/uk/gateway/configuration-reference) - [Тестування](/uk/help/testing-live#live-codex-app-server-harness-smoke)