chore(i18n): refresh uk translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-10 22:11:46 +00:00
parent 3e1d0f8544
commit bbbfe83f6c
2 changed files with 440 additions and 447 deletions

File diff suppressed because it is too large Load Diff

View File

@ -1,62 +1,55 @@
---
read_when:
- Ви хочете використовувати вбудований harness app-server Codex
- Вам потрібні посилання на модель Codex і приклади конфігурації
- Ви хочете вимкнути резервний перехід на Pi для розгортань лише з Codex
summary: Запускайте вбудовані ходи агента OpenClaw через вбудований harness app-server Codex
title: Harness Codex
- Ви хочете використовувати вбудований app-server harness Codex
- Вам потрібні посилання на моделі Codex і приклади конфігурації
- Ви хочете вимкнути резервний перехід на PI для розгортань лише з Codex
summary: Запустіть ходи вбудованого агента OpenClaw через вбудований app-server harness Codex
title: Codex Harness
x-i18n:
generated_at: "2026-04-10T21:45:23Z"
generated_at: "2026-04-10T22:09:02Z"
model: gpt-5.4
provider: openai
source_hash: 93aa65d08b8ffd39625d21c054856edb75a1e12d66fc7c6fae343fe398abab8b
source_hash: 71f4f8e67cfc8f573ad8f082dd4fc36ce6524f7bf235e2757117d4653cbb3d71
source_path: plugins/codex-harness.md
workflow: 15
---
# Harness Codex
# Codex Harness
Вбудований плагін `codex` дає OpenClaw змогу запускати вбудовані ходи агента через
app-server Codex замість вбудованого harness Pi.
Вбудований плагін `codex` дає OpenClaw змогу запускати ходи вбудованого агента через Codex app-server замість вбудованого harness PI.
Використовуйте це, коли хочете, щоб Codex керував низькорівневою сесією агента: виявленням
моделей, нативним відновленням нитки, нативною компакцією та виконанням через app-server.
OpenClaw і далі керує каналами чату, файлами сесій, вибором моделі, інструментами,
погодженнями, доставкою медіа та видимим дзеркалом транскрипту.
Використовуйте це, коли хочете, щоб Codex керував низькорівневою сесією агента: виявленням моделей, нативним відновленням thread, нативною компакцією та виконанням app-server.
OpenClaw, як і раніше, керує каналами чату, файлами сесій, вибором моделей, інструментами, погодженнями, доставкою медіа та видимим дзеркалом транскрипту.
Harness вимкнено за замовчуванням. Його вибирають лише тоді, коли плагін `codex`
увімкнено і визначена модель є моделлю `codex/*`, або коли ви явно
примусово задаєте `embeddedHarness.runtime: "codex"` чи `OPENCLAW_AGENT_RUNTIME=codex`.
Якщо ви взагалі не налаштовуєте `codex/*`, наявні запуски PI, OpenAI, Anthropic, Gemini, local
і custom-provider зберігають поточну поведінку.
Harness вимкнений за замовчуванням. Він вибирається лише тоді, коли плагін `codex` увімкнено і визначена модель є моделлю `codex/*`, або коли ви явно примусово задаєте `embeddedHarness.runtime: "codex"` чи `OPENCLAW_AGENT_RUNTIME=codex`.
Якщо ви ніколи не налаштовуєте `codex/*`, наявні запуски PI, OpenAI, Anthropic, Gemini, local і custom-provider зберігають свою поточну поведінку.
## Виберіть правильний префікс моделі
OpenClaw має окремі маршрути для доступу у форматі OpenAI та 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 для вбудованого ходу агента. |
| Model ref | Шлях runtime | Використовуйте, коли |
| ---------------------- | ------------------------------------------- | ------------------------------------------------------------------------ |
| `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 без Codex app-server harness. |
| `codex/gpt-5.4` | Вбудований провайдер Codex плюс Codex harness | Ви хочете нативне виконання Codex app-server для ходу вбудованого агента. |
Harness Codex працює лише з посиланнями на моделі `codex/*`. Наявні посилання `openai/*`,
Codex harness обробляє лише посилання на моделі `codex/*`. Наявні посилання `openai/*`,
`openai-codex/*`, Anthropic, Gemini, xAI, local і custom provider зберігають
свої звичайні шляхи.
## Вимоги
- OpenClaw із доступним вбудованим плагіном `codex`.
- App-server Codex версії `0.118.0` або новішої.
- Codex app-server `0.118.0` або новіший.
- Автентифікація Codex, доступна для процесу app-server.
Плагін блокує старіші або безверсійні handshake app-server. Це дає змогу
OpenClaw працювати лише з тією поверхнею протоколу, з якою його було протестовано.
Плагін блокує старіші або неверсійовані handshakes app-server. Це гарантує, що
OpenClaw працює з поверхнею протоколу, з якою його тестували.
Для live- і Docker smoke-тестів автентифікація зазвичай надходить з `OPENAI_API_KEY`, а також
із необов’язкових файлів CLI Codex, таких як `~/.codex/auth.json` і
`~/.codex/config.toml`. Використовуйте ті самі матеріали автентифікації, що й ваш локальний
app-server Codex.
Для live- і Docker smoke-тестів автентифікація зазвичай надходить із `OPENAI_API_KEY`, а також
необов’язкових файлів Codex CLI, таких як `~/.codex/auth.json` і
`~/.codex/config.toml`. Використовуйте ті самі автентифікаційні матеріали, що й ваш локальний Codex app-server.
## Мінімальна конфігурація
@ -98,13 +91,13 @@ app-server Codex.
}
```
Налаштування `agents.defaults.model` або моделі агента на `codex/<model>` також
Встановлення `agents.defaults.model` або моделі агента в `codex/<model>` також
автоматично вмикає вбудований плагін `codex`. Явний запис плагіна все одно
корисний у спільних конфігураціях, оскільки робить намір розгортання очевидним.
## Додайте Codex без заміни інших моделей
## Додати Codex без заміни інших моделей
Залишайте `runtime: "auto"`, якщо хочете використовувати Codex для моделей `codex/*` і PI для
Залишайте `runtime: "auto"`, якщо хочете використовувати Codex для моделей `codex/*`, а PI — для
всього іншого:
```json5
@ -137,17 +130,17 @@ app-server Codex.
}
```
У такій конфігурації:
За такої конфігурації:
- `/model codex` або `/model codex/gpt-5.4` використовує harness app-server Codex.
- `/model codex` або `/model codex/gpt-5.4` використовує Codex app-server harness.
- `/model gpt` або `/model openai/gpt-5.4` використовує шлях провайдера OpenAI.
- `/model opus` використовує шлях провайдера Anthropic.
- Якщо вибрано не-Codex модель, PI залишається harness сумісності.
## Розгортання лише з Codex
Вимкніть резервний перехід на Pi, якщо вам потрібно довести, що кожен вбудований хід агента використовує
harness Codex:
Вимкніть резервний перехід на PI, якщо вам потрібно підтвердити, що кожен хід вбудованого агента використовує
Codex harness:
```json5
{
@ -171,13 +164,13 @@ OPENCLAW_AGENT_HARNESS_FALLBACK=none \
openclaw gateway run
```
Якщо резервний перехід вимкнено, OpenClaw завершує роботу з помилкою на ранньому етапі, якщо плагін Codex вимкнено,
запитана модель не є посиланням `codex/*`, app-server надто старий або
app-server не може запуститися.
Якщо резервний перехід вимкнено, OpenClaw завершується з помилкою на ранньому етапі, якщо плагін Codex вимкнено,
потрібна модель не є посиланням `codex/*`, app-server надто старий або
app-server не вдається запустити.
## Codex для окремого агента
Ви можете зробити один агент лише для Codex, тоді як типовий агент зберігатиме звичайний
Ви можете зробити одного агента Codex-only, а для агента за замовчуванням залишити звичайний
автовибір:
```json5
@ -209,14 +202,14 @@ app-server не може запуститися.
}
```
Використовуйте звичайні команди сесії для перемикання агентів і моделей. `/new` створює нову
сесію OpenClaw, а harness Codex створює або відновлює власну sidecar-нитку
app-server за потреби. `/reset` очищає прив’язку сесії OpenClaw для цієї нитки.
Використовуйте звичайні команди сесії, щоб перемикати агентів і моделі. `/new` створює нову
сесію OpenClaw, а Codex harness за потреби створює або відновлює свій sidecar app-server
thread. `/reset` очищає прив’язку сесії OpenClaw для цього thread.
## Виявлення моделей
За замовчуванням плагін Codex запитує app-server про доступні моделі. Якщо
виявлення не вдається або перевищує час очікування, він використовує вбудований резервний каталог:
виявлення завершується помилкою або перевищує час очікування, він використовує вбудований резервний каталог:
- `codex/gpt-5.4`
- `codex/gpt-5.4-mini`
@ -242,7 +235,7 @@ app-server за потреби. `/reset` очищає прив’язку сес
}
```
Вимкніть виявлення, якщо хочете, щоб під час запуску не виконувалась перевірка Codex і використовувався лише
Вимкніть виявлення, якщо хочете, щоб під час запуску не виконувалась перевірка Codex і використовувався
резервний каталог:
```json5
@ -264,13 +257,13 @@ app-server за потреби. `/reset` очищає прив’язку сес
## Підключення app-server і політика
За замовчуванням плагін локально запускає Codex так:
За замовчуванням плагін локально запускає Codex командою:
```bash
codex app-server --listen stdio://
```
Ви можете зберегти це значення за замовчуванням і налаштувати лише нативну політику Codex:
Ви можете залишити це значення за замовчуванням і налаштувати лише нативну політику Codex:
```json5
{
@ -315,22 +308,22 @@ codex app-server --listen stdio://
Підтримувані поля `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. |
| `requestTimeoutMs` | `60000` | Час очікування для викликів control-plane app-server. |
| `approvalPolicy` | `"never"` | Нативна політика погодження Codex, що надсилається під час старту/відновлення/ходу нитки. |
| `sandbox` | `"workspace-write"` | Нативний режим sandbox Codex, що надсилається під час старту/відновлення нитки. |
| `approvalsReviewer` | `"user"` | Використовуйте `"guardian_subagent"`, щоб guardian Codex перевіряв нативні погодження. |
| `serviceTier` | не задано | Необов’язковий рівень сервісу Codex, наприклад `"priority"`. |
| Field | Default | Значення |
| ------------------- | ---------------------------------------- | ------------------------------------------------------------------------ |
| `transport` | `"stdio"` | `"stdio"` запускає Codex; `"websocket"` підключається до `url`. |
| `command` | `"codex"` | Виконуваний файл для транспорту stdio. |
| `args` | `["app-server", "--listen", "stdio://"]` | Аргументи для транспорту stdio. |
| `url` | unset | URL WebSocket app-server. |
| `authToken` | unset | Bearer-токен для транспорту WebSocket. |
| `headers` | `{}` | Додаткові заголовки WebSocket. |
| `requestTimeoutMs` | `60000` | Тайм-аут для викликів control-plane app-server. |
| `approvalPolicy` | `"never"` | Нативна політика погодження Codex, що надсилається до start/resume/turn thread. |
| `sandbox` | `"workspace-write"` | Нативний режим sandbox Codex, що надсилається до start/resume thread. |
| `approvalsReviewer` | `"user"` | Використовуйте `"guardian_subagent"`, щоб Codex guardian перевіряв нативні погодження. |
| `serviceTier` | unset | Необов’язковий рівень сервісу Codex, наприклад `"priority"`. |
Старі змінні середовища все ще працюють як резервні значення для локального тестування, коли
відповідне поле конфігурації не задане:
відповідне поле конфігурації не задано:
- `OPENCLAW_CODEX_APP_SERVER_BIN`
- `OPENCLAW_CODEX_APP_SERVER_ARGS`
@ -338,9 +331,9 @@ codex app-server --listen stdio://
- `OPENCLAW_CODEX_APP_SERVER_SANDBOX`
- `OPENCLAW_CODEX_APP_SERVER_GUARDIAN=1`
Для відтворюваних розгортань перевагу слід надавати конфігурації.
Для відтворюваних розгортань перевага надається конфігурації.
## Типові рецепти
## Поширені рецепти
Локальний Codex зі стандартним транспортом stdio:
@ -356,7 +349,7 @@ codex app-server --listen stdio://
}
```
Перевірка harness лише з Codex із вимкненим резервним переходом на Pi:
Перевірка harness лише для Codex, з вимкненим резервним переходом на PI:
```json5
{
@ -373,7 +366,7 @@ codex app-server --listen stdio://
}
```
Погодження Codex із перевіркою guardian:
Погодження Codex, що перевіряються guardian:
```json5
{
@ -394,7 +387,7 @@ codex app-server --listen stdio://
}
```
Віддалений app-server із явними заголовками:
Віддалений app-server з явними заголовками:
```json5
{
@ -417,74 +410,78 @@ codex app-server --listen stdio://
}
```
Перемикання моделей і далі контролюється OpenClaw. Коли сесію OpenClaw приєднано
до наявної нитки Codex, наступний хід знову надсилає до
Перемикання моделей залишається під керуванням OpenClaw. Коли сесію OpenClaw прив’язано
до наявного Codex thread, наступний хід знову надсилає до
app-server поточну вибрану модель `codex/*`, провайдера, політику погодження, sandbox і service tier.
Перемикання з `codex/gpt-5.4` на `codex/gpt-5.2` зберігає прив’язку
нитки, але просить Codex продовжити роботу з новою вибраною моделлю.
Перехід з `codex/gpt-5.4` на `codex/gpt-5.2` зберігає прив’язку до
thread, але просить Codex продовжити з новою вибраною моделлю.
## Команда Codex
Вбудований плагін реєструє `/codex` як авторизовану slash-команду. Вона є
універсальною і працює в будь-якому каналі, що підтримує текстові команди OpenClaw.
універсальною і працює на будь-якому каналі, що підтримує текстові команди 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 status` показує в реальному часі підключення до app-server, моделі, обліковий запис, ліміти швидкості, MCP servers і skills.
- `/codex models` виводить список моделей Codex app-server у реальному часі.
- `/codex threads [filter]` виводить список нещодавніх thread Codex.
- `/codex resume <thread-id>` прив’язує поточну сесію OpenClaw до наявного thread Codex.
- `/codex compact` просить Codex app-server виконати компакцію прив’язаного thread.
- `/codex review` запускає нативну перевірку Codex для прив’язаного thread.
- `/codex account` показує стан облікового запису та лімітів швидкості.
- `/codex mcp` показує список станів MCP-серверів app-server Codex.
- `/codex skills` показує список Skills app-server Codex.
- `/codex mcp` показує стан MCP server Codex app-server.
- `/codex skills` виводить список skills Codex app-server.
`/codex resume` записує той самий файл sidecar-прив’язки, який harness використовує для
звичайних ходів. У наступному повідомленні OpenClaw відновлює цю нитку Codex, передає
поточну вибрану модель OpenClaw `codex/*` до app-server і зберігає
`/codex resume` записує той самий sidecar-файл прив’язки, який harness використовує для
звичайних ходів. У наступному повідомленні OpenClaw відновлює цей thread Codex, передає
поточну вибрану в OpenClaw модель `codex/*` до app-server і зберігає
увімкнену розширену історію.
Поверхня команд вимагає Codex app-server `0.118.0` або новішої версії. Для окремих
методів керування повідомляється `unsupported by this Codex app-server`, якщо
майбутній або кастомний app-server не надає цей метод JSON-RPC.
## Інструменти, медіа та компакція
Harness Codex змінює лише низькорівневий виконавець вбудованого агента.
Codex harness змінює лише низькорівневий виконавець вбудованого агента.
OpenClaw і далі формує список інструментів і отримує динамічні результати інструментів від
harness. Текст, зображення, відео, музика, TTS, погодження та вивід інструментів повідомлень
OpenClaw, як і раніше, формує список інструментів і отримує динамічні результати інструментів від
harness. Текст, зображення, відео, музика, TTS, погодження та вивід інструментів обміну повідомленнями
і далі проходять через звичайний шлях доставки OpenClaw.
Коли вибрана модель використовує harness Codex, нативна компакція нитки
делегується app-server Codex. OpenClaw зберігає дзеркало транскрипту для історії каналу,
Коли вибрана модель використовує Codex harness, нативна компакція thread делегується
Codex app-server. OpenClaw зберігає дзеркало транскрипту для історії каналу,
пошуку, `/new`, `/reset` і майбутнього перемикання моделі або harness.
Генерація медіа не потребує 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, щоб handshake app-server
**app-server відхиляється:** оновіть Codex, щоб handshake app-server
повідомляв версію `0.118.0` або новішу.
**Виявлення моделей повільне:** зменште `plugins.entries.codex.config.discovery.timeoutMs`
або вимкніть виявлення.
**Транспорт WebSocket одразу завершується з помилкою:** перевірте `appServer.url`, `authToken`
і те, що віддалений app-server підтримує ту саму версію протоколу app-server Codex.
**Транспорт WebSocket відразу завершується помилкою:** перевірте `appServer.url`, `authToken`
і те, що віддалений app-server використовує ту саму версію протоколу Codex app-server.
**Не-Codex модель використовує PI:** це очікувано. Harness Codex працює лише з
посиланнями на моделі `codex/*`.
**Не-Codex модель використовує PI:** це очікувана поведінка. Codex harness обробляє лише
посилання на моделі `codex/*`.
## Пов’язано
## Пов’язане
- [Плагіни harness агента](/uk/plugins/sdk-agent-harness)
- [Плагіни Agent Harness](/uk/plugins/sdk-agent-harness)
- [Провайдери моделей](/uk/concepts/model-providers)
- [Довідник із конфігурації](/uk/gateway/configuration-reference)
- [Тестування](/uk/help/testing#live-codex-app-server-harness-smoke)