From 2ec21f33d1f07e2ded49da322e6fd83d4b827c53 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Fri, 10 Apr 2026 21:46:13 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/plugins/codex-harness.md | 264 ++++++++++++++++++++----------- 1 file changed, 174 insertions(+), 90 deletions(-) diff --git a/docs/uk/plugins/codex-harness.md b/docs/uk/plugins/codex-harness.md index 6aab734e4..cd9e83d69 100644 --- a/docs/uk/plugins/codex-harness.md +++ b/docs/uk/plugins/codex-harness.md @@ -1,65 +1,66 @@ --- read_when: - - Ви хочете використовувати вбудований каркас app-server Codex - - Вам потрібні посилання на моделі Codex і приклади конфігурації - - Ви хочете вимкнути резервний перехід на PI для розгортань лише з Codex -summary: Запускайте вбудовані ходи агента OpenClaw через вбудований каркас app-server Codex -title: Каркас Codex Harness + - Ви хочете використовувати вбудований harness app-server Codex + - Вам потрібні посилання на модель Codex і приклади конфігурації + - Ви хочете вимкнути резервний перехід на Pi для розгортань лише з Codex +summary: Запускайте вбудовані ходи агента OpenClaw через вбудований harness app-server Codex +title: Harness Codex x-i18n: - generated_at: "2026-04-10T21:20:36Z" + generated_at: "2026-04-10T21:45:23Z" model: gpt-5.4 provider: openai - source_hash: 7ba7e0eeb264f846a66a927baf6ded83438a7b4a3df86ee9fe562105f5bb05aa + source_hash: 93aa65d08b8ffd39625d21c054856edb75a1e12d66fc7c6fae343fe398abab8b source_path: plugins/codex-harness.md workflow: 15 --- -# Каркас Codex +# Harness Codex -Вбудований плагін `codex` дозволяє OpenClaw запускати вбудовані ходи агента через -app-server Codex замість вбудованого каркаса PI. +Вбудований плагін `codex` дає OpenClaw змогу запускати вбудовані ходи агента через +app-server Codex замість вбудованого harness Pi. Використовуйте це, коли хочете, щоб Codex керував низькорівневою сесією агента: виявленням -моделей, нативним відновленням потоку, нативним ущільненням і виконанням app-server. -OpenClaw, як і раніше, керує каналами чату, файлами сесій, вибором моделі, інструментами, +моделей, нативним відновленням нитки, нативною компакцією та виконанням через app-server. +OpenClaw і далі керує каналами чату, файлами сесій, вибором моделі, інструментами, погодженнями, доставкою медіа та видимим дзеркалом транскрипту. -Каркас вимкнено за замовчуванням. Він вибирається лише тоді, коли плагін `codex` +Harness вимкнено за замовчуванням. Його вибирають лише тоді, коли плагін `codex` увімкнено і визначена модель є моделлю `codex/*`, або коли ви явно примусово задаєте `embeddedHarness.runtime: "codex"` чи `OPENCLAW_AGENT_RUNTIME=codex`. -Якщо ви ніколи не налаштовуєте `codex/*`, наявні запуск PI, OpenAI, Anthropic, Gemini, local +Якщо ви взагалі не налаштовуєте `codex/*`, наявні запуски PI, OpenAI, Anthropic, Gemini, local і custom-provider зберігають поточну поведінку. ## Виберіть правильний префікс моделі OpenClaw має окремі маршрути для доступу у форматі OpenAI та Codex: -| Посилання на модель | Шлях виконання | Використовуйте, коли | +| Посилання на модель | Шлях середовища виконання | Використовуйте, коли | | --------------------- | ------------------------------------------- | ------------------------------------------------------------------------ | -| `openai/gpt-5.4` | Провайдер OpenAI через інфраструктуру OpenClaw/PI | Ви хочете прямий доступ до OpenAI Platform API з `OPENAI_API_KEY`. | -| `openai-codex/gpt-5.4` | Провайдер OpenAI Codex OAuth через PI | Ви хочете ChatGPT/Codex OAuth без каркаса app-server Codex. | -| `codex/gpt-5.4` | Вбудований провайдер Codex плюс каркас Codex | Ви хочете нативне виконання app-server Codex для вбудованого ходу агента. | +| `openai/gpt-5.4` | Провайдер OpenAI через механізми OpenClaw/PI | Ви хочете прямий доступ до API OpenAI Platform за допомогою `OPENAI_API_KEY`. | +| `openai-codex/gpt-5.4` | Провайдер OpenAI Codex OAuth через PI | Ви хочете ChatGPT/Codex OAuth без harness app-server Codex. | +| `codex/gpt-5.4` | Вбудований провайдер Codex плюс harness Codex | Ви хочете нативне виконання через app-server Codex для вбудованого ходу агента. | -Каркас Codex обробляє лише посилання на моделі `codex/*`. Наявні посилання `openai/*`, +Harness Codex працює лише з посиланнями на моделі `codex/*`. Наявні посилання `openai/*`, `openai-codex/*`, Anthropic, Gemini, xAI, local і custom provider зберігають свої звичайні шляхи. ## Вимоги - OpenClaw із доступним вбудованим плагіном `codex`. -- App-server Codex `0.118.0` або новіший. +- App-server Codex версії `0.118.0` або новішої. - Автентифікація Codex, доступна для процесу app-server. -Плагін блокує старіші або неверсійовані узгодження app-server. Це зберігає -роботу OpenClaw на поверхні протоколу, з якою його було протестовано. +Плагін блокує старіші або безверсійні handshake app-server. Це дає змогу +OpenClaw працювати лише з тією поверхнею протоколу, з якою його було протестовано. -Для живих і Docker smoke-тестів автентифікація зазвичай надходить із `OPENAI_API_KEY`, а також -необов’язкових файлів Codex CLI, таких як `~/.codex/auth.json` і -`~/.codex/config.toml`. Використовуйте ті самі облікові дані автентифікації, що й ваш локальний app-server Codex. +Для live- і Docker smoke-тестів автентифікація зазвичай надходить з `OPENAI_API_KEY`, а також +із необов’язкових файлів CLI Codex, таких як `~/.codex/auth.json` і +`~/.codex/config.toml`. Використовуйте ті самі матеріали автентифікації, що й ваш локальний +app-server Codex. ## Мінімальна конфігурація -Використовуйте `codex/gpt-5.4`, увімкніть вбудований плагін і примусово задайте каркас `codex`: +Використовуйте `codex/gpt-5.4`, увімкніть вбудований плагін і примусово задайте harness `codex`: ```json5 { @@ -82,7 +83,7 @@ OpenClaw має окремі маршрути для доступу у форм } ``` -Якщо у вашій конфігурації використовується `plugins.allow`, також включіть туди `codex`: +Якщо у вашій конфігурації використовується `plugins.allow`, додайте туди також `codex`: ```json5 { @@ -97,13 +98,13 @@ OpenClaw має окремі маршрути для доступу у форм } ``` -Установлення `agents.defaults.model` або моделі агента на `codex/` також +Налаштування `agents.defaults.model` або моделі агента на `codex/` також автоматично вмикає вбудований плагін `codex`. Явний запис плагіна все одно корисний у спільних конфігураціях, оскільки робить намір розгортання очевидним. ## Додайте Codex без заміни інших моделей -Залишайте `runtime: "auto"`, коли хочете використовувати Codex для моделей `codex/*`, а PI — для +Залишайте `runtime: "auto"`, якщо хочете використовувати Codex для моделей `codex/*` і PI для всього іншого: ```json5 @@ -136,17 +137,17 @@ OpenClaw має окремі маршрути для доступу у форм } ``` -За такої форми: +У такій конфігурації: -- `/model codex` або `/model codex/gpt-5.4` використовує каркас app-server Codex. +- `/model codex` або `/model codex/gpt-5.4` використовує harness app-server Codex. - `/model gpt` або `/model openai/gpt-5.4` використовує шлях провайдера OpenAI. - `/model opus` використовує шлях провайдера Anthropic. -- Якщо вибрано не-Codex модель, PI залишається каркасом сумісності. +- Якщо вибрано не-Codex модель, PI залишається harness сумісності. ## Розгортання лише з Codex -Вимкніть резервний перехід на PI, коли потрібно довести, що кожен вбудований хід агента використовує -каркас Codex: +Вимкніть резервний перехід на Pi, якщо вам потрібно довести, що кожен вбудований хід агента використовує +harness Codex: ```json5 { @@ -170,13 +171,13 @@ OPENCLAW_AGENT_HARNESS_FALLBACK=none \ openclaw gateway run ``` -Коли резервний перехід вимкнено, OpenClaw завершується з помилкою на ранньому етапі, якщо плагін Codex вимкнено, -запитувана модель не є посиланням `codex/*`, app-server надто старий або +Якщо резервний перехід вимкнено, OpenClaw завершує роботу з помилкою на ранньому етапі, якщо плагін Codex вимкнено, +запитана модель не є посиланням `codex/*`, app-server надто старий або app-server не може запуститися. ## Codex для окремого агента -Ви можете зробити один агент лише з Codex, тоді як агент за замовчуванням зберігатиме звичайний +Ви можете зробити один агент лише для Codex, тоді як типовий агент зберігатиме звичайний автовибір: ```json5 @@ -208,14 +209,14 @@ app-server не може запуститися. } ``` -Використовуйте звичайні команди сесії, щоб перемикати агентів і моделі. `/new` створює нову -сесію OpenClaw, а каркас Codex створює або відновлює свій допоміжний потік app-server -за потреби. `/reset` очищає прив’язку сесії OpenClaw для цього потоку. +Використовуйте звичайні команди сесії для перемикання агентів і моделей. `/new` створює нову +сесію OpenClaw, а harness Codex створює або відновлює власну sidecar-нитку +app-server за потреби. `/reset` очищає прив’язку сесії OpenClaw для цієї нитки. ## Виявлення моделей -За замовчуванням плагін Codex запитує доступні моделі в app-server. Якщо -виявлення завершується помилкою або перевищує час очікування, використовується вбудований резервний каталог: +За замовчуванням плагін Codex запитує app-server про доступні моделі. Якщо +виявлення не вдається або перевищує час очікування, він використовує вбудований резервний каталог: - `codex/gpt-5.4` - `codex/gpt-5.4-mini` @@ -241,7 +242,7 @@ app-server не може запуститися. } ``` -Вимкніть виявлення, коли хочете, щоб під час запуску не виконувалася перевірка Codex і використовувався +Вимкніть виявлення, якщо хочете, щоб під час запуску не виконувалась перевірка Codex і використовувався лише резервний каталог: ```json5 @@ -261,15 +262,15 @@ app-server не може запуститися. } ``` -## Підключення до app-server і політика +## Підключення app-server і політика -За замовчуванням плагін запускає Codex локально за допомогою: +За замовчуванням плагін локально запускає Codex так: ```bash codex app-server --listen stdio:// ``` -Ви можете зберегти це значення за замовчуванням і лише налаштувати нативну політику Codex: +Ви можете зберегти це значення за замовчуванням і налаштувати лише нативну політику Codex: ```json5 { @@ -314,22 +315,22 @@ codex app-server --listen stdio:// Підтримувані поля `appServer`: -| Поле | Типове значення | Значення | -| ------------------- | ----------------------------------------- | ------------------------------------------------------------------------ | -| `transport` | `"stdio"` | `"stdio"` запускає Codex; `"websocket"` підключається до `url`. | -| `command` | `"codex"` | Виконуваний файл для транспорту stdio. | -| `args` | `["app-server", "--listen", "stdio://"]` | Аргументи для транспорту stdio. | -| `url` | не задано | URL WebSocket app-server. | -| `authToken` | не задано | Bearer-токен для транспорту WebSocket. | -| `headers` | `{}` | Додаткові заголовки WebSocket. | -| `requestTimeoutMs` | `60000` | Час очікування для викликів площини керування app-server. | -| `approvalPolicy` | `"never"` | Нативна політика погодження Codex, що надсилається на старт/відновлення/хід потоку. | -| `sandbox` | `"workspace-write"` | Нативний режим sandbox Codex, що надсилається на старт/відновлення потоку. | -| `approvalsReviewer` | `"user"` | Використовуйте `"guardian_subagent"`, щоб дозволити guardian Codex переглядати нативні погодження. | -| `serviceTier` | не задано | Необов’язковий рівень сервісу Codex, наприклад `"priority"`. | +| Поле | За замовчуванням | Значення | +| ------------------- | ----------------------------------------- | ------------------------------------------------------------------------- | +| `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. | +| `requestTimeoutMs` | `60000` | Час очікування для викликів control-plane app-server. | +| `approvalPolicy` | `"never"` | Нативна політика погодження Codex, що надсилається під час старту/відновлення/ходу нитки. | +| `sandbox` | `"workspace-write"` | Нативний режим sandbox Codex, що надсилається під час старту/відновлення нитки. | +| `approvalsReviewer` | `"user"` | Використовуйте `"guardian_subagent"`, щоб guardian Codex перевіряв нативні погодження. | +| `serviceTier` | не задано | Необов’язковий рівень сервісу Codex, наприклад `"priority"`. | Старі змінні середовища все ще працюють як резервні значення для локального тестування, коли -відповідне поле конфігурації не задано: +відповідне поле конфігурації не задане: - `OPENCLAW_CODEX_APP_SERVER_BIN` - `OPENCLAW_CODEX_APP_SERVER_ARGS` @@ -337,70 +338,153 @@ codex app-server --listen stdio:// - `OPENCLAW_CODEX_APP_SERVER_SANDBOX` - `OPENCLAW_CODEX_APP_SERVER_GUARDIAN=1` -Для відтворюваних розгортань перевага надається конфігурації. +Для відтворюваних розгортань перевагу слід надавати конфігурації. + +## Типові рецепти + +Локальний Codex зі стандартним транспортом stdio: + +```json5 +{ + plugins: { + entries: { + codex: { + enabled: true, + }, + }, + }, +} +``` + +Перевірка harness лише з Codex із вимкненим резервним переходом на Pi: + +```json5 +{ + embeddedHarness: { + fallback: "none", + }, + plugins: { + entries: { + codex: { + enabled: true, + }, + }, + }, +} +``` + +Погодження Codex із перевіркою guardian: + +```json5 +{ + plugins: { + entries: { + codex: { + enabled: true, + config: { + appServer: { + approvalPolicy: "on-request", + approvalsReviewer: "guardian_subagent", + sandbox: "workspace-write", + }, + }, + }, + }, + }, +} +``` + +Віддалений app-server із явними заголовками: + +```json5 +{ + plugins: { + entries: { + codex: { + enabled: true, + config: { + appServer: { + transport: "websocket", + url: "ws://gateway-host:39175", + headers: { + "X-OpenClaw-Agent": "main", + }, + }, + }, + }, + }, + }, +} +``` + +Перемикання моделей і далі контролюється OpenClaw. Коли сесію OpenClaw приєднано +до наявної нитки Codex, наступний хід знову надсилає до +app-server поточну вибрану модель `codex/*`, провайдера, політику погодження, sandbox і service tier. +Перемикання з `codex/gpt-5.4` на `codex/gpt-5.2` зберігає прив’язку +нитки, але просить Codex продовжити роботу з новою вибраною моделлю. ## Команда Codex -Вбудований плагін реєструє `/codex` як авторизовану slash-команду. Вона -універсальна і працює в будь-якому каналі, який підтримує текстові команди OpenClaw. +Вбудований плагін реєструє `/codex` як авторизовану slash-команду. Вона є +універсальною і працює в будь-якому каналі, що підтримує текстові команди OpenClaw. Поширені форми: - `/codex status` показує живе підключення до app-server, моделі, обліковий запис, ліміти швидкості, MCP-сервери та Skills. - `/codex models` показує список живих моделей app-server Codex. -- `/codex threads [filter]` показує список нещодавніх потоків Codex. -- `/codex resume ` прив’язує поточну сесію OpenClaw до наявного потоку Codex. -- `/codex compact` просить app-server Codex ущільнити прив’язаний потік. -- `/codex review` запускає нативну перевірку Codex для прив’язаного потоку. +- `/codex threads [filter]` показує список нещодавніх ниток Codex. +- `/codex resume ` приєднує поточну сесію OpenClaw до наявної нитки Codex. +- `/codex compact` просить app-server Codex стиснути приєднану нитку. +- `/codex review` запускає нативну перевірку Codex для приєднаної нитки. - `/codex account` показує стан облікового запису та лімітів швидкості. -- `/codex mcp` показує стан MCP-серверів app-server Codex. +- `/codex mcp` показує список станів MCP-серверів app-server Codex. - `/codex skills` показує список Skills app-server Codex. -`/codex resume` записує той самий файл допоміжної прив’язки, який каркас використовує для -звичайних ходів. У наступному повідомленні OpenClaw відновлює цей потік Codex, передає -поточну вибрану модель OpenClaw `codex/*` до app-server і залишає розширену -історію ввімкненою. +`/codex resume` записує той самий файл sidecar-прив’язки, який harness використовує для +звичайних ходів. У наступному повідомленні OpenClaw відновлює цю нитку Codex, передає +поточну вибрану модель OpenClaw `codex/*` до app-server і зберігає +увімкнену розширену історію. -## Інструменти, медіа та ущільнення +## Інструменти, медіа та компакція -Каркас Codex змінює лише низькорівневий виконавець вбудованого агента. +Harness Codex змінює лише низькорівневий виконавець вбудованого агента. -OpenClaw, як і раніше, формує список інструментів і отримує динамічні результати інструментів від -каркаса. Текст, зображення, відео, музика, TTS, погодження та вивід інструментів обміну повідомленнями -продовжують проходити через звичайний шлях доставки OpenClaw. +OpenClaw і далі формує список інструментів і отримує динамічні результати інструментів від +harness. Текст, зображення, відео, музика, TTS, погодження та вивід інструментів повідомлень +і далі проходять через звичайний шлях доставки OpenClaw. -Коли вибрана модель використовує каркас Codex, нативне ущільнення потоку +Коли вибрана модель використовує harness Codex, нативна компакція нитки делегується app-server Codex. OpenClaw зберігає дзеркало транскрипту для історії каналу, -пошуку, `/new`, `/reset` і майбутнього перемикання моделі або каркаса. +пошуку, `/new`, `/reset` і майбутнього перемикання моделі або harness. -Генерація медіа не потребує PI. Генерація зображень, відео, музики, PDF, TTS та -розуміння медіа й далі використовують відповідні налаштування провайдера/моделі, такі як +Генерація медіа не потребує PI. Генерація зображень, відео, музики, PDF, TTS і +аналіз медіа й далі використовують відповідні налаштування провайдера/моделі, як-от `agents.defaults.imageGenerationModel`, `videoGenerationModel`, `pdfModel` і `messages.tts`. -## Усунення несправностей +## Усунення проблем **Codex не з’являється в `/model`:** увімкніть `plugins.entries.codex.enabled`, задайте посилання на модель `codex/*` або перевірте, чи `plugins.allow` не виключає `codex`. -**OpenClaw переходить на PI:** задайте `embeddedHarness.fallback: "none"` або +**OpenClaw переходить на резервний Pi:** задайте `embeddedHarness.fallback: "none"` або `OPENCLAW_AGENT_HARNESS_FALLBACK=none` під час тестування. -**App-server відхиляється:** оновіть Codex, щоб узгодження app-server -повідомляло версію `0.118.0` або новішу. +**App-server відхиляється:** оновіть Codex, щоб handshake app-server +повідомляв версію `0.118.0` або новішу. **Виявлення моделей повільне:** зменште `plugins.entries.codex.config.discovery.timeoutMs` або вимкніть виявлення. -**Транспорт WebSocket одразу завершується помилкою:** перевірте `appServer.url`, `authToken` +**Транспорт WebSocket одразу завершується з помилкою:** перевірте `appServer.url`, `authToken` і те, що віддалений app-server підтримує ту саму версію протоколу app-server Codex. -**Модель не Codex використовує PI:** це очікувано. Каркас Codex обробляє лише -посилання на моделі `codex/*`. +**Не-Codex модель використовує PI:** це очікувано. Harness Codex працює лише з +посиланнями на моделі `codex/*`. -## Пов’язане +## Пов’язано -- [Плагіни каркаса агента](/uk/plugins/sdk-agent-harness) +- [Плагіни harness агента](/uk/plugins/sdk-agent-harness) - [Провайдери моделей](/uk/concepts/model-providers) - [Довідник із конфігурації](/uk/gateway/configuration-reference) - [Тестування](/uk/help/testing#live-codex-app-server-harness-smoke)