chore(i18n): refresh uk translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-10 21:46:13 +00:00
parent 22d261ba5e
commit 2ec21f33d1

View File

@ -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/<model>` також
Налаштування `agents.defaults.model` або моделі агента на `codex/<model>` також
автоматично вмикає вбудований плагін `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 <thread-id>` прив’язує поточну сесію OpenClaw до наявного потоку Codex.
- `/codex compact` просить app-server Codex ущільнити прив’язаний потік.
- `/codex review` запускає нативну перевірку Codex для прив’язаного потоку.
- `/codex threads [filter]` показує список нещодавніх ниток Codex.
- `/codex resume <thread-id>` приєднує поточну сесію 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)