From 6e19f4b8ce5de8e1e5bfaf1366463d05709b72b5 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Fri, 10 Apr 2026 21:21:45 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/plugins/codex-harness.md | 223 +++++++++++++++++++-------- docs/uk/tools/slash-commands.md | 251 ++++++++++++++++--------------- 2 files changed, 289 insertions(+), 185 deletions(-) diff --git a/docs/uk/plugins/codex-harness.md b/docs/uk/plugins/codex-harness.md index f91b9651f..6aab734e4 100644 --- a/docs/uk/plugins/codex-harness.md +++ b/docs/uk/plugins/codex-harness.md @@ -1,65 +1,65 @@ --- read_when: - - Ви хочете використовувати комплектний harness app-server Codex + - Ви хочете використовувати вбудований каркас app-server Codex - Вам потрібні посилання на моделі Codex і приклади конфігурації - Ви хочете вимкнути резервний перехід на PI для розгортань лише з Codex -summary: Запускайте вбудовані ходи агента OpenClaw через комплектний harness app-server Codex -title: Harness Codex +summary: Запускайте вбудовані ходи агента OpenClaw через вбудований каркас app-server Codex +title: Каркас Codex Harness x-i18n: - generated_at: "2026-04-10T21:05:11Z" + generated_at: "2026-04-10T21:20:36Z" model: gpt-5.4 provider: openai - source_hash: b1babe5b3498eb2a963f3e66a46975bd261886398499453d0d240e1fbc309bf4 + source_hash: 7ba7e0eeb264f846a66a927baf6ded83438a7b4a3df86ee9fe562105f5bb05aa source_path: plugins/codex-harness.md workflow: 15 --- -# Harness Codex +# Каркас Codex -Комплектний плагін `codex` дає OpenClaw змогу запускати вбудовані ходи агента через -app-server Codex замість вбудованого harness PI. +Вбудований плагін `codex` дозволяє OpenClaw запускати вбудовані ходи агента через +app-server Codex замість вбудованого каркаса PI. Використовуйте це, коли хочете, щоб Codex керував низькорівневою сесією агента: виявленням -моделей, нативним відновленням потоку, нативною компакцією та виконанням app-server. -OpenClaw і далі керує чат-каналами, файлами сесій, вибором моделі, інструментами, -погодженнями, доставленням медіа та видимим дзеркалом транскрипту. +моделей, нативним відновленням потоку, нативним ущільненням і виконанням app-server. +OpenClaw, як і раніше, керує каналами чату, файлами сесій, вибором моделі, інструментами, +погодженнями, доставкою медіа та видимим дзеркалом транскрипту. -Harness вимкнений за замовчуванням. Він вибирається лише тоді, коли плагін `codex` +Каркас вимкнено за замовчуванням. Він вибирається лише тоді, коли плагін `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: +OpenClaw має окремі маршрути для доступу у форматі OpenAI та Codex: -| Посилання на модель | Шлях 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 без harness app-server Codex. | -| `codex/gpt-5.4` | Комплектний провайдер Codex плюс harness Codex | Вам потрібне нативне виконання app-server 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 для вбудованого ходу агента. | -Harness Codex обробляє лише посилання на моделі `codex/*`. Наявні посилання `openai/*`, +Каркас Codex обробляє лише посилання на моделі `codex/*`. Наявні посилання `openai/*`, `openai-codex/*`, Anthropic, Gemini, xAI, local і custom provider зберігають свої звичайні шляхи. ## Вимоги -- OpenClaw із доступним комплектним плагіном `codex`. -- App-server Codex версії `0.118.0` або новішої. -- Автентифікація Codex, доступна процесу app-server. +- OpenClaw із доступним вбудованим плагіном `codex`. +- App-server Codex `0.118.0` або новіший. +- Автентифікація Codex, доступна для процесу app-server. -Плагін блокує старіші або неверсійовані узгодження app-server. Це дає змогу -OpenClaw працювати на поверхні протоколу, з якою його було протестовано. +Плагін блокує старіші або неверсійовані узгодження app-server. Це зберігає +роботу OpenClaw на поверхні протоколу, з якою його було протестовано. -Для live- і Docker smoke-тестів автентифікація зазвичай надходить із `OPENAI_API_KEY`, а також +Для живих і Docker smoke-тестів автентифікація зазвичай надходить із `OPENAI_API_KEY`, а також необов’язкових файлів Codex CLI, таких як `~/.codex/auth.json` і -`~/.codex/config.toml`. Використовуйте ті самі матеріали автентифікації, що й ваш локальний app-server Codex. +`~/.codex/config.toml`. Використовуйте ті самі облікові дані автентифікації, що й ваш локальний app-server Codex. ## Мінімальна конфігурація -Використовуйте `codex/gpt-5.4`, увімкніть комплектний плагін і примусово задайте harness `codex`: +Використовуйте `codex/gpt-5.4`, увімкніть вбудований плагін і примусово задайте каркас `codex`: ```json5 { @@ -82,7 +82,7 @@ OpenClaw працювати на поверхні протоколу, з яко } ``` -Якщо у вашій конфігурації використовується `plugins.allow`, додайте туди також `codex`: +Якщо у вашій конфігурації використовується `plugins.allow`, також включіть туди `codex`: ```json5 { @@ -97,14 +97,14 @@ OpenClaw працювати на поверхні протоколу, з яко } ``` -Установлення `agents.defaults.model` або моделі агента в `codex/` також -автоматично вмикає комплектний плагін `codex`. Явний запис плагіна все одно +Установлення `agents.defaults.model` або моделі агента на `codex/` також +автоматично вмикає вбудований плагін `codex`. Явний запис плагіна все одно корисний у спільних конфігураціях, оскільки робить намір розгортання очевидним. ## Додайте Codex без заміни інших моделей -Залишайте `runtime: "auto"`, якщо хочете використовувати Codex для моделей `codex/*`, а PI — для -усього іншого: +Залишайте `runtime: "auto"`, коли хочете використовувати Codex для моделей `codex/*`, а PI — для +всього іншого: ```json5 { @@ -138,15 +138,15 @@ OpenClaw працювати на поверхні протоколу, з яко За такої форми: -- `/model codex` або `/model codex/gpt-5.4` використовує harness app-server Codex. +- `/model codex` або `/model codex/gpt-5.4` використовує каркас app-server Codex. - `/model gpt` або `/model openai/gpt-5.4` використовує шлях провайдера OpenAI. - `/model opus` використовує шлях провайдера Anthropic. -- Якщо вибрано не-Codex модель, PI залишається harness сумісності. +- Якщо вибрано не-Codex модель, PI залишається каркасом сумісності. ## Розгортання лише з Codex -Вимкніть резервний перехід на PI, якщо вам потрібно підтвердити, що кожен вбудований хід агента використовує -harness Codex: +Вимкніть резервний перехід на PI, коли потрібно довести, що кожен вбудований хід агента використовує +каркас Codex: ```json5 { @@ -162,7 +162,7 @@ harness Codex: } ``` -Перевизначення через змінні середовища: +Перевизначення через середовище: ```bash OPENCLAW_AGENT_RUNTIME=codex \ @@ -170,13 +170,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, тоді як агент за замовчуванням зберігатиме звичайний автовибір: ```json5 @@ -209,13 +209,13 @@ app-server не вдається запустити. ``` Використовуйте звичайні команди сесії, щоб перемикати агентів і моделі. `/new` створює нову -сесію OpenClaw, а harness Codex створює або відновлює свій побічний потік app-server +сесію OpenClaw, а каркас Codex створює або відновлює свій допоміжний потік app-server за потреби. `/reset` очищає прив’язку сесії OpenClaw для цього потоку. ## Виявлення моделей -За замовчуванням плагін Codex запитує в app-server доступні моделі. Якщо -виявлення не вдається або перевищує час очікування, використовується комплектний резервний каталог: +За замовчуванням плагін Codex запитує доступні моделі в app-server. Якщо +виявлення завершується помилкою або перевищує час очікування, використовується вбудований резервний каталог: - `codex/gpt-5.4` - `codex/gpt-5.4-mini` @@ -241,7 +241,7 @@ app-server не вдається запустити. } ``` -Вимкніть виявлення, якщо хочете, щоб під час запуску не виконувалася перевірка Codex і використовувався +Вимкніть виявлення, коли хочете, щоб під час запуску не виконувалася перевірка Codex і використовувався резервний каталог: ```json5 @@ -261,43 +261,146 @@ app-server не вдається запустити. } ``` -## Інструменти, медіа та компакція +## Підключення до app-server і політика -Harness Codex змінює лише низькорівневий виконавець вбудованого агента. +За замовчуванням плагін запускає Codex локально за допомогою: + +```bash +codex app-server --listen stdio:// +``` + +Ви можете зберегти це значення за замовчуванням і лише налаштувати нативну політику Codex: + +```json5 +{ + plugins: { + entries: { + codex: { + enabled: true, + config: { + appServer: { + approvalPolicy: "on-request", + sandbox: "workspace-write", + serviceTier: "priority", + }, + }, + }, + }, + }, +} +``` + +Для вже запущеного app-server використовуйте транспорт WebSocket: + +```json5 +{ + plugins: { + entries: { + codex: { + enabled: true, + config: { + appServer: { + transport: "websocket", + url: "ws://127.0.0.1:39175", + authToken: "${CODEX_APP_SERVER_TOKEN}", + requestTimeoutMs: 60000, + }, + }, + }, + }, + }, +} +``` + +Підтримувані поля `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"`. | + +Старі змінні середовища все ще працюють як резервні значення для локального тестування, коли +відповідне поле конфігурації не задано: + +- `OPENCLAW_CODEX_APP_SERVER_BIN` +- `OPENCLAW_CODEX_APP_SERVER_ARGS` +- `OPENCLAW_CODEX_APP_SERVER_APPROVAL_POLICY` +- `OPENCLAW_CODEX_APP_SERVER_SANDBOX` +- `OPENCLAW_CODEX_APP_SERVER_GUARDIAN=1` + +Для відтворюваних розгортань перевага надається конфігурації. + +## Команда Codex + +Вбудований плагін реєструє `/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 account` показує стан облікового запису та лімітів швидкості. +- `/codex mcp` показує стан MCP-серверів app-server Codex. +- `/codex skills` показує список Skills app-server Codex. + +`/codex resume` записує той самий файл допоміжної прив’язки, який каркас використовує для +звичайних ходів. У наступному повідомленні OpenClaw відновлює цей потік Codex, передає +поточну вибрану модель OpenClaw `codex/*` до app-server і залишає розширену +історію ввімкненою. + +## Інструменти, медіа та ущільнення + +Каркас Codex змінює лише низькорівневий виконавець вбудованого агента. OpenClaw, як і раніше, формує список інструментів і отримує динамічні результати інструментів від -harness. Текст, зображення, відео, музика, TTS, погодження та вивід інструментів повідомлень -і далі проходять звичайним шляхом доставлення OpenClaw. +каркаса. Текст, зображення, відео, музика, TTS, погодження та вивід інструментів обміну повідомленнями +продовжують проходити через звичайний шлях доставки OpenClaw. -Коли вибрана модель використовує harness Codex, нативна компакція потоку +Коли вибрана модель використовує каркас Codex, нативне ущільнення потоку делегується app-server Codex. OpenClaw зберігає дзеркало транскрипту для історії каналу, -пошуку, `/new`, `/reset` і майбутнього перемикання моделі або harness. +пошуку, `/new`, `/reset` і майбутнього перемикання моделі або каркаса. -Генерація медіа не потребує PI. Генерація зображень, відео, музики, PDF, TTS і розуміння медіа -і далі використовують відповідні налаштування провайдера/моделі, такі як +Генерація медіа не потребує PI. Генерація зображень, відео, музики, PDF, TTS та +розуміння медіа й далі використовують відповідні налаштування провайдера/моделі, такі як `agents.defaults.imageGenerationModel`, `videoGenerationModel`, `pdfModel` і `messages.tts`. -## Усунення проблем +## Усунення несправностей **Codex не з’являється в `/model`:** увімкніть `plugins.entries.codex.enabled`, -установіть посилання на модель `codex/*` або перевірте, чи `plugins.allow` не виключає `codex`. +задайте посилання на модель `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` або новішу. -**Виявлення моделей працює повільно:** зменште `plugins.entries.codex.config.discovery.timeoutMs` +**Виявлення моделей повільне:** зменште `plugins.entries.codex.config.discovery.timeoutMs` або вимкніть виявлення. -**Не-Codex модель використовує PI:** це очікувана поведінка. Harness Codex обробляє лише +**Транспорт WebSocket одразу завершується помилкою:** перевірте `appServer.url`, `authToken` +і те, що віддалений app-server підтримує ту саму версію протоколу app-server Codex. + +**Модель не Codex використовує PI:** це очікувано. Каркас Codex обробляє лише посилання на моделі `codex/*`. ## Пов’язане -- [Плагіни Agent Harness](/uk/plugins/sdk-agent-harness) +- [Плагіни каркаса агента](/uk/plugins/sdk-agent-harness) - [Провайдери моделей](/uk/concepts/model-providers) - [Довідник із конфігурації](/uk/gateway/configuration-reference) - [Тестування](/uk/help/testing#live-codex-app-server-harness-smoke) diff --git a/docs/uk/tools/slash-commands.md b/docs/uk/tools/slash-commands.md index 317755b55..53edae039 100644 --- a/docs/uk/tools/slash-commands.md +++ b/docs/uk/tools/slash-commands.md @@ -1,14 +1,14 @@ --- read_when: - - Використання або налаштування чат-команд + - Використання або налаштування команд чату - Налагодження маршрутизації команд або дозволів -summary: 'Слеш-команди: текстові та нативні, конфігурація й підтримувані команди' +summary: 'Слеш-команди: текстові vs нативні, конфігурація та підтримувані команди' title: Слеш-команди x-i18n: - generated_at: "2026-04-08T05:14:57Z" + generated_at: "2026-04-10T21:20:33Z" model: gpt-5.4 provider: openai - source_hash: 4a7ee7f1a8012058279b9e632889b291d4e659e4ec81209ca8978afbb9ad4b96 + source_hash: 2cc346361c3b1a63aae9ec0f28706f4cb0b866b6c858a3999101f6927b923b4a source_path: tools/slash-commands.md workflow: 15 --- @@ -16,21 +16,21 @@ x-i18n: # Слеш-команди Команди обробляються Gateway. Більшість команд потрібно надсилати як **окреме** повідомлення, що починається з `/`. -Команда чату bash лише для хоста використовує `! ` (із `/bash ` як псевдонімом). +Команда чату bash лише для хоста використовує `! ` (із псевдонімом `/bash `). Є дві пов’язані системи: - **Команди**: окремі повідомлення `/...`. - **Директиви**: `/think`, `/fast`, `/verbose`, `/reasoning`, `/elevated`, `/exec`, `/model`, `/queue`. - Директиви видаляються з повідомлення до того, як його побачить модель. - - У звичайних чат-повідомленнях (не лише з директивами) вони трактуються як «вбудовані підказки» і **не** зберігають налаштування сесії. - - У повідомленнях лише з директивами (повідомлення містить тільки директиви) вони зберігаються в сесії та повертають підтвердження. - - Директиви застосовуються лише для **авторизованих відправників**. Якщо задано `commands.allowFrom`, використовується лише цей - список дозволених; інакше авторизація походить зі списків дозволених/спарювання каналу плюс `commands.useAccessGroups`. + - У звичайних повідомленнях чату (не лише з директивами) вони трактуються як «вбудовані підказки» і **не** зберігають налаштування сесії. + - У повідомленнях, що містять лише директиви (повідомлення складається тільки з директив), вони зберігаються в сесії та відповідають підтвердженням. + - Директиви застосовуються лише для **авторизованих відправників**. Якщо задано `commands.allowFrom`, це єдиний + список дозволених; інакше авторизація походить зі списків дозволених каналів/парування разом із `commands.useAccessGroups`. Для неавторизованих відправників директиви трактуються як звичайний текст. Також є кілька **вбудованих скорочень** (лише для відправників зі списку дозволених/авторизованих): `/help`, `/commands`, `/status`, `/whoami` (`/id`). -Вони виконуються негайно, видаляються до того, як повідомлення побачить модель, а решта тексту продовжує проходити звичайним шляхом. +Вони виконуються негайно, видаляються до того, як повідомлення побачить модель, а решта тексту продовжує оброблятися звичайним потоком. ## Конфігурація @@ -59,29 +59,29 @@ x-i18n: } ``` -- `commands.text` (типове значення `true`) вмикає розбір `/...` у чат-повідомленнях. +- `commands.text` (типово `true`) вмикає розбір `/...` у повідомленнях чату. - На поверхнях без нативних команд (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams) текстові команди все одно працюють, навіть якщо встановити це значення в `false`. -- `commands.native` (типове значення `"auto"`) реєструє нативні команди. - - Auto: увімкнено для Discord/Telegram; вимкнено для Slack (поки ви не додасте слеш-команди); ігнорується для провайдерів без нативної підтримки. - - Щоб перевизначити поведінку для конкретного провайдера, задайте `channels.discord.commands.native`, `channels.telegram.commands.native` або `channels.slack.commands.native` (bool або `"auto"`). +- `commands.native` (типово `"auto"`) реєструє нативні команди. + - Auto: увімкнено для Discord/Telegram; вимкнено для Slack (доки ви не додасте slash commands); ігнорується для провайдерів без нативної підтримки. + - Щоб перевизначити для конкретного провайдера, задайте `channels.discord.commands.native`, `channels.telegram.commands.native` або `channels.slack.commands.native` (bool або `"auto"`). - `false` очищає раніше зареєстровані команди в Discord/Telegram під час запуску. Команди Slack керуються в застосунку Slack і не видаляються автоматично. -- `commands.nativeSkills` (типове значення `"auto"`) реєструє нативні команди **skill**, коли це підтримується. - - Auto: увімкнено для Discord/Telegram; вимкнено для Slack (Slack вимагає створення окремої слеш-команди для кожного skill). - - Щоб перевизначити поведінку для конкретного провайдера, задайте `channels.discord.commands.nativeSkills`, `channels.telegram.commands.nativeSkills` або `channels.slack.commands.nativeSkills` (bool або `"auto"`). -- `commands.bash` (типове значення `false`) вмикає `! ` для виконання команд оболонки хоста (`/bash ` — псевдонім; потребує списків дозволених `tools.elevated`). -- `commands.bashForegroundMs` (типове значення `2000`) керує тим, як довго bash чекає перед переходом у фоновий режим (`0` одразу відправляє у фон). -- `commands.config` (типове значення `false`) вмикає `/config` (читання/запис `openclaw.json`). -- `commands.mcp` (типове значення `false`) вмикає `/mcp` (читання/запис керованої OpenClaw конфігурації MCP у `mcp.servers`). -- `commands.plugins` (типове значення `false`) вмикає `/plugins` (виявлення/стан plugin, а також керування встановленням і вмиканням/вимиканням). -- `commands.debug` (типове значення `false`) вмикає `/debug` (перевизначення лише під час виконання). -- `commands.restart` (типове значення `true`) вмикає `/restart`, а також дії інструментів для перезапуску gateway. -- `commands.ownerAllowFrom` (необов’язково) задає явний список дозволених власника для поверхонь команд/інструментів лише для власника. Це окремо від `commands.allowFrom`. -- `commands.ownerDisplay` визначає, як ідентифікатори власника відображаються в системному запиті: `raw` або `hash`. -- `commands.ownerDisplaySecret` необов’язково задає HMAC-секрет, що використовується, коли `commands.ownerDisplay="hash"`. -- `commands.allowFrom` (необов’язково) задає список дозволених для авторизації команд для кожного провайдера. Якщо його налаштовано, це - єдине джерело авторизації для команд і директив (списки дозволених/спарювання каналу та `commands.useAccessGroups` - ігноруються). Використовуйте `"*"` для глобального типового значення; ключі для конкретних провайдерів мають пріоритет. -- `commands.useAccessGroups` (типове значення `true`) примусово застосовує списки дозволених/політики для команд, коли `commands.allowFrom` не задано. +- `commands.nativeSkills` (типово `"auto"`) реєструє команди **Skills** нативно, коли це підтримується. + - Auto: увімкнено для Discord/Telegram; вимкнено для Slack (у Slack потрібно створювати окрему slash command для кожного skill). + - Щоб перевизначити для конкретного провайдера, задайте `channels.discord.commands.nativeSkills`, `channels.telegram.commands.nativeSkills` або `channels.slack.commands.nativeSkills` (bool або `"auto"`). +- `commands.bash` (типово `false`) вмикає `! ` для запуску команд оболонки хоста (`/bash ` є псевдонімом; потрібні списки дозволених `tools.elevated`). +- `commands.bashForegroundMs` (типово `2000`) визначає, скільки часу bash чекає перед перемиканням у фоновий режим (`0` одразу переводить у фон). +- `commands.config` (типово `false`) вмикає `/config` (читання/запис `openclaw.json`). +- `commands.mcp` (типово `false`) вмикає `/mcp` (читання/запис конфігурації MCP, якою керує OpenClaw, у `mcp.servers`). +- `commands.plugins` (типово `false`) вмикає `/plugins` (виявлення/статус plugins, а також елементи керування встановленням і ввімкненням/вимкненням). +- `commands.debug` (типово `false`) вмикає `/debug` (лише перевизначення під час виконання). +- `commands.restart` (типово `true`) вмикає `/restart`, а також дії інструментів перезапуску gateway. +- `commands.ownerAllowFrom` (необов’язково) задає явний список дозволених власника для поверхонь команд/інструментів, доступних лише власнику. Це окремо від `commands.allowFrom`. +- `commands.ownerDisplay` визначає, як ідентифікатори власника відображаються в системному prompt: `raw` або `hash`. +- `commands.ownerDisplaySecret` необов’язково задає HMAC-секрет, який використовується, коли `commands.ownerDisplay="hash"`. +- `commands.allowFrom` (необов’язково) задає список дозволених для авторизації команд окремо для кожного провайдера. Якщо його налаштовано, це + єдине джерело авторизації для команд і директив (списки дозволених каналів/парування та `commands.useAccessGroups` + ігноруються). Використовуйте `"*"` як глобальне типове значення; ключі конкретних провайдерів мають пріоритет. +- `commands.useAccessGroups` (типово `true`) застосовує списки дозволених/політики для команд, якщо `commands.allowFrom` не задано. ## Список команд @@ -90,75 +90,76 @@ x-i18n: - вбудовані core-команди походять із `src/auto-reply/commands-registry.shared.ts` - згенеровані dock-команди походять із `src/auto-reply/commands-registry.data.ts` - plugin-команди походять із викликів plugin `registerCommand()` -- фактична доступність на вашому gateway усе одно залежить від прапорців конфігурації, поверхні каналу та встановлених/увімкнених plugin +- фактична доступність на вашому gateway усе ще залежить від прапорців конфігурації, поверхні каналу та встановлених/увімкнених plugins ### Вбудовані core-команди -Доступні сьогодні вбудовані команди: +Вбудовані команди, доступні зараз: -- `/new [model]` запускає нову сесію; `/reset` — псевдонім для скидання. -- `/compact [instructions]` ущільнює контекст сесії. Див. [/concepts/compaction](/uk/concepts/compaction). +- `/new [model]` запускає нову сесію; `/reset` — це псевдонім скидання. +- `/compact [instructions]` стискає контекст сесії. Див. [/concepts/compaction](/uk/concepts/compaction). - `/stop` перериває поточний запуск. - `/session idle ` і `/session max-age ` керують строком дії прив’язки до потоку. - `/think ` задає рівень thinking. Псевдоніми: `/thinking`, `/t`. -- `/verbose on|off|full` перемикає розширений вивід. Псевдонім: `/v`. +- `/verbose on|off|full` перемикає докладний вивід. Псевдонім: `/v`. - `/fast [status|on|off]` показує або задає швидкий режим. - `/reasoning [on|off|stream]` перемикає видимість reasoning. Псевдонім: `/reason`. - `/elevated [on|off|ask|full]` перемикає elevated mode. Псевдонім: `/elev`. - `/exec host= security= ask= node=` показує або задає типові значення exec. - `/model [name|#|status]` показує або задає модель. - `/models [provider] [page] [limit=|size=|all]` виводить список провайдерів або моделей для провайдера. -- `/queue ` керує поведінкою черги (`steer`, `interrupt`, `followup`, `collect`, `steer-backlog`) плюс параметрами на кшталт `debounce:2s cap:25 drop:summarize`. -- `/help` показує коротку довідку. +- `/queue ` керує поведінкою черги (`steer`, `interrupt`, `followup`, `collect`, `steer-backlog`), а також параметрами на кшталт `debounce:2s cap:25 drop:summarize`. +- `/help` показує короткий підсумок довідки. - `/commands` показує згенерований каталог команд. - `/tools [compact|verbose]` показує, що поточний агент може використовувати просто зараз. -- `/status` показує стан під час виконання, включно з використанням/квотою провайдера, коли доступно. -- `/tasks` перелічує активні/нещодавні фонові завдання для поточної сесії. +- `/status` показує статус під час виконання, зокрема використання/квоту провайдера, якщо доступно. +- `/tasks` виводить активні/нещодавні фонові завдання для поточної сесії. - `/context [list|detail|json]` пояснює, як збирається контекст. - `/export-session [path]` експортує поточну сесію в HTML. Псевдонім: `/export`. -- `/whoami` показує ваш id відправника. Псевдонім: `/id`. +- `/whoami` показує ваш ідентифікатор відправника. Псевдонім: `/id`. - `/skill [input]` запускає skill за назвою. -- `/allowlist [list|add|remove] ...` керує записами списку дозволених. Лише текст. -- `/approve ` опрацьовує запити на затвердження exec. +- `/allowlist [list|add|remove] ...` керує записами списку дозволених. Лише текстова команда. +- `/approve ` опрацьовує запити на підтвердження exec. - `/btw ` ставить побічне запитання без зміни майбутнього контексту сесії. Див. [/tools/btw](/uk/tools/btw). -- `/subagents list|kill|log|info|send|steer|spawn` керує запусками субагентів для поточної сесії. -- `/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help` керує сесіями ACP та параметрами під час виконання. +- `/subagents list|kill|log|info|send|steer|spawn` керує запусками sub-agent для поточної сесії. +- `/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help` керує сесіями ACP і параметрами під час виконання. - `/focus ` прив’язує поточний потік Discord або тему/розмову Telegram до цілі сесії. - `/unfocus` знімає поточну прив’язку. -- `/agents` перелічує агентів, прив’язаних до потоку, для поточної сесії. -- `/kill ` перериває один або всі запущені субагенти. -- `/steer ` надсилає керування запущеному субагенту. Псевдонім: `/tell`. -- `/config show|get|set|unset` читає або записує `openclaw.json`. Лише для власника. Потребує `commands.config: true`. -- `/mcp show|get|set|unset` читає або записує конфігурацію MCP-сервера, керовану OpenClaw, у `mcp.servers`. Лише для власника. Потребує `commands.mcp: true`. -- `/plugins list|inspect|show|get|install|enable|disable` перевіряє або змінює стан plugin. `/plugin` — псевдонім. Запис — лише для власника. Потребує `commands.plugins: true`. -- `/debug show|set|unset|reset` керує перевизначеннями конфігурації лише під час виконання. Лише для власника. Потребує `commands.debug: true`. -- `/usage off|tokens|full|cost` керує нижнім колонтитулом використання для кожної відповіді або виводить локальний підсумок вартості. +- `/agents` виводить список агентів, прив’язаних до потоку, для поточної сесії. +- `/kill ` перериває один або всі запущені sub-agent. +- `/steer ` надсилає керувальне повідомлення запущеному sub-agent. Псевдонім: `/tell`. +- `/config show|get|set|unset` читає або записує `openclaw.json`. Лише для власника. Потрібно `commands.config: true`. +- `/mcp show|get|set|unset` читає або записує конфігурацію MCP-сервера, якою керує OpenClaw, у `mcp.servers`. Лише для власника. Потрібно `commands.mcp: true`. +- `/plugins list|inspect|show|get|install|enable|disable` перевіряє або змінює стан plugin. `/plugin` — це псевдонім. Запис — лише для власника. Потрібно `commands.plugins: true`. +- `/debug show|set|unset|reset` керує перевизначеннями конфігурації лише під час виконання. Лише для власника. Потрібно `commands.debug: true`. +- `/usage off|tokens|full|cost` керує нижнім колонтитулом використання для кожної відповіді або виводить локальний підсумок витрат. - `/tts on|off|status|provider|limit|summary|audio|help` керує TTS. Див. [/tools/tts](/uk/tools/tts). - `/restart` перезапускає OpenClaw, якщо це ввімкнено. Типово: увімкнено; встановіть `commands.restart: false`, щоб вимкнути. - `/activation mention|always` задає режим активації групи. - `/send on|off|inherit` задає політику надсилання. Лише для власника. -- `/bash ` виконує команду оболонки хоста. Лише текст. Псевдонім: `! `. Потребує `commands.bash: true` плюс списки дозволених `tools.elevated`. +- `/bash ` запускає команду оболонки хоста. Лише текстова команда. Псевдонім: `! `. Потрібно `commands.bash: true` плюс списки дозволених `tools.elevated`. - `!poll [sessionId]` перевіряє фонове завдання bash. - `!stop [sessionId]` зупиняє фонове завдання bash. ### Згенеровані dock-команди -Dock-команди генеруються з channel plugin із підтримкою нативних команд. Поточний вбудований набір: +Dock-команди генеруються з channel plugins із підтримкою native-command. Поточний вбудований набір: - `/dock-discord` (псевдонім: `/dock_discord`) - `/dock-mattermost` (псевдонім: `/dock_mattermost`) - `/dock-slack` (псевдонім: `/dock_slack`) - `/dock-telegram` (псевдонім: `/dock_telegram`) -### Команди вбудованих plugin +### Команди bundled plugin -Вбудовані plugin можуть додавати більше слеш-команд. Поточні вбудовані команди в цьому репозиторії: +Bundled plugins можуть додавати більше слеш-команд. Поточні bundled-команди в цьому репозиторії: - `/dreaming [on|off|status|help]` перемикає memory dreaming. Див. [Dreaming](/uk/concepts/dreaming). -- `/pair [qr|status|pending|approve|cleanup|notify]` керує потоком спарювання/налаштування пристрою. Див. [Pairing](/uk/channels/pairing). -- `/phone status|arm [duration]|disarm` тимчасово активує високоризикові команди phone node. -- `/voice status|list [limit]|set ` керує конфігурацією голосу Talk. У Discord назва нативної команди — `/talkvoice`. -- `/card ...` надсилає пресети LINE rich card. Див. [LINE](/uk/channels/line). +- `/pair [qr|status|pending|approve|cleanup|notify]` керує потоком парування/налаштування пристрою. Див. [Pairing](/uk/channels/pairing). +- `/phone status|arm [duration]|disarm` тимчасово вмикає високоризикові команди phone node. +- `/voice status|list [limit]|set ` керує конфігурацією голосу Talk. У Discord нативна назва команди — `/talkvoice`. +- `/card ...` надсилає шаблони LINE rich card. Див. [LINE](/uk/channels/line). +- `/codex status|models|threads|resume|compact|review|account|mcp|skills` перевіряє та керує bundled harness сервера застосунку Codex. Див. [Codex Harness](/uk/plugins/codex-harness). - Команди лише для QQBot: - `/bot-ping` - `/bot-version` @@ -170,68 +171,68 @@ Dock-команди генеруються з channel plugin із підтрим Skills, які може викликати користувач, також доступні як слеш-команди: -- `/skill [input]` завжди працює як загальна точка входу. -- skills також можуть з’являтися як прямі команди на кшталт `/prose`, коли skill/plugin їх реєструє. -- реєстрацією нативних skill-команд керують `commands.nativeSkills` і `channels..commands.nativeSkills`. +- `/skill [input]` завжди працює як універсальна точка входу. +- skills також можуть з’являтися як прямі команди, наприклад `/prose`, коли skill/plugin їх реєструє. +- нативна реєстрація skill-команд керується через `commands.nativeSkills` і `channels..commands.nativeSkills`. Примітки: -- Команди приймають необов’язковий `:` між командою та аргументами (наприклад, `/think: high`, `/send: on`, `/help:`). -- `/new ` приймає псевдонім моделі, `provider/model` або назву провайдера (нечіткий збіг); якщо збігу немає, текст трактується як тіло повідомлення. -- Для повного розподілу використання за провайдерами використовуйте `openclaw status --usage`. -- `/allowlist add|remove` потребує `commands.config=true` і враховує канал `configWrites`. -- У каналах із кількома обліковими записами `/allowlist --account `, націлені на конфігурацію, і `/config set channels..accounts....` також враховують `configWrites` цільового облікового запису. -- `/usage` керує нижнім колонтитулом використання для кожної відповіді; `/usage cost` виводить локальний підсумок вартості з журналів сесій OpenClaw. +- Команди приймають необов’язковий символ `:` між командою та аргументами (наприклад, `/think: high`, `/send: on`, `/help:`). +- `/new ` приймає псевдонім моделі, `provider/model` або назву провайдера (нечітке зіставлення); якщо збігу немає, текст трактується як тіло повідомлення. +- Для повного розподілу використання провайдера використовуйте `openclaw status --usage`. +- `/allowlist add|remove` вимагає `commands.config=true` і враховує канал `configWrites`. +- У каналах із кількома обліковими записами `/allowlist --account `, націлений на конфігурацію, і `/config set channels..accounts....` також враховують `configWrites` цільового облікового запису. +- `/usage` керує нижнім колонтитулом використання для кожної відповіді; `/usage cost` виводить локальний підсумок витрат із журналів сесій OpenClaw. - `/restart` увімкнено типово; встановіть `commands.restart: false`, щоб вимкнути його. - `/plugins install ` приймає ті самі специфікації plugin, що й `openclaw plugins install`: локальний шлях/архів, npm-пакет або `clawhub:`. - `/plugins enable|disable` оновлює конфігурацію plugin і може запропонувати перезапуск. -- Нативна команда лише для Discord: `/vc join|leave|status` керує голосовими каналами (потребує `channels.discord.voice` і нативних команд; недоступна як текст). -- Команди прив’язки до потоку в Discord (`/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age`) потребують, щоб ефективні прив’язки до потоку були ввімкнені (`session.threadBindings.enabled` та/або `channels.discord.threadBindings.enabled`). +- Нативна команда лише для Discord: `/vc join|leave|status` керує голосовими каналами (потрібні `channels.discord.voice` і нативні команди; недоступна як текстова команда). +- Команди прив’язки до потоку Discord (`/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age`) вимагають, щоб ефективні прив’язки до потоку були увімкнені (`session.threadBindings.enabled` та/або `channels.discord.threadBindings.enabled`). - Довідник команд ACP і поведінка під час виконання: [ACP Agents](/uk/tools/acp-agents). - `/verbose` призначено для налагодження та додаткової видимості; у звичайному використанні тримайте його **вимкненим**. -- `/fast on|off` зберігає перевизначення сесії. Використовуйте параметр `inherit` у UI Sessions, щоб очистити його й повернутися до типових значень конфігурації. -- `/fast` залежить від провайдера: OpenAI/OpenAI Codex зіставляють його з `service_tier=priority` на нативних ендпойнтах Responses, тоді як прямі публічні запити Anthropic, включно з OAuth-автентифікованим трафіком, надісланим до `api.anthropic.com`, зіставляють його з `service_tier=auto` або `standard_only`. Див. [OpenAI](/uk/providers/openai) і [Anthropic](/uk/providers/anthropic). -- Підсумки збоїв інструментів усе ще показуються, коли це доречно, але детальний текст збоїв включається лише тоді, коли `/verbose` має значення `on` або `full`. -- `/reasoning` (і `/verbose`) ризиковані в групових налаштуваннях: вони можуть розкрити внутрішнє reasoning або вивід інструментів, який ви не збиралися показувати. Краще залишати їх вимкненими, особливо в групових чатах. -- `/model` негайно зберігає нову модель сесії. -- Якщо агент простоює, наступний запуск використовує її одразу. -- Якщо запуск уже активний, OpenClaw позначає живе перемикання як очікуване й перезапускається з новою моделлю лише в чистій точці повторної спроби. -- Якщо активність інструментів або вивід відповіді вже почалися, очікуване перемикання може залишатися в черзі до пізнішої можливості повторної спроби або до наступного ходу користувача. -- **Швидкий шлях:** повідомлення лише з командами від відправників зі списку дозволених обробляються негайно (оминають чергу та модель). -- **Фільтрація згадок у групах:** повідомлення лише з командами від відправників зі списку дозволених обходять вимоги до згадки. -- **Вбудовані скорочення (лише для відправників зі списку дозволених):** деякі команди також працюють, коли вбудовані в звичайне повідомлення, і видаляються до того, як модель побачить решту тексту. - - Приклад: `hey /status` викликає відповідь зі статусом, а решта тексту продовжує проходити звичайним шляхом. -- Зараз: `/help`, `/commands`, `/status`, `/whoami` (`/id`). -- Неавторизовані повідомлення лише з командами мовчки ігноруються, а вбудовані токени `/...` трактуються як звичайний текст. -- **Skill-команди:** skills із типом `user-invocable` доступні як слеш-команди. Назви санітизуються до `a-z0-9_` (макс. 32 символи); у разі колізій додаються числові суфікси (наприклад, `_2`). - - `/skill [input]` запускає skill за назвою (корисно, коли обмеження нативних команд не дають створити окремі команди для кожного skill). +- `/fast on|off` зберігає перевизначення сесії. Щоб очистити його й повернутися до типових значень із конфігурації, використовуйте опцію `inherit` в інтерфейсі Sessions. +- `/fast` залежить від провайдера: OpenAI/OpenAI Codex зіставляють його з `service_tier=priority` на нативних endpoints Responses, тоді як прямі публічні запити Anthropic, зокрема трафік з OAuth-автентифікацією, надісланий до `api.anthropic.com`, зіставляють його з `service_tier=auto` або `standard_only`. Див. [OpenAI](/uk/providers/openai) і [Anthropic](/uk/providers/anthropic). +- Підсумки збоїв інструментів усе ще показуються, коли це доречно, але докладний текст збоїв включається лише коли `/verbose` має значення `on` або `full`. +- `/reasoning` (і `/verbose`) ризиковані в групових налаштуваннях: вони можуть розкрити внутрішні міркування або вивід інструментів, які ви не мали наміру показувати. Краще залишати їх вимкненими, особливо в групових чатах. +- `/model` одразу зберігає нову модель сесії. +- Якщо агент неактивний, наступний запуск використає її одразу. +- Якщо запуск уже активний, OpenClaw позначає живе перемикання як відкладене та перезапускає на новій моделі лише в чистій точці повторної спроби. +- Якщо активність інструментів або вивід відповіді вже почалися, відкладене перемикання може залишатися в черзі до пізнішої можливості повторної спроби або до наступного ходу користувача. +- **Швидкий шлях:** повідомлення лише з командою від відправників зі списку дозволених обробляються негайно (в обхід черги й моделі). +- **Керування згадками в групі:** повідомлення лише з командою від відправників зі списку дозволених обходять вимоги щодо згадування. +- **Вбудовані скорочення (лише для відправників зі списку дозволених):** деякі команди також працюють, коли вбудовані у звичайне повідомлення, і видаляються до того, як модель побачить решту тексту. + - Приклад: `hey /status` запускає відповідь зі статусом, а решта тексту продовжує оброблятися звичайним потоком. +- Наразі: `/help`, `/commands`, `/status`, `/whoami` (`/id`). +- Неавторизовані повідомлення лише з командою тихо ігноруються, а вбудовані токени `/...` трактуються як звичайний текст. +- **Skill-команди:** skills з позначкою `user-invocable` доступні як слеш-команди. Назви очищуються до `a-z0-9_` (максимум 32 символи); у разі колізій додаються числові суфікси (наприклад, `_2`). + - `/skill [input]` запускає skill за назвою (це корисно, коли обмеження нативних команд не дають створити окремі команди для кожного skill). - Типово skill-команди пересилаються моделі як звичайний запит. - - Skills можуть необов’язково оголосити `command-dispatch: tool`, щоб спрямувати команду безпосередньо в інструмент (детерміновано, без моделі). + - Skills можуть необов’язково оголошувати `command-dispatch: tool`, щоб маршрутизувати команду безпосередньо до інструмента (детерміновано, без моделі). - Приклад: `/prose` (plugin OpenProse) — див. [OpenProse](/uk/prose). -- **Аргументи нативних команд:** Discord використовує автодоповнення для динамічних параметрів (і меню кнопок, коли ви пропускаєте обов’язкові аргументи). Telegram і Slack показують меню кнопок, коли команда підтримує варіанти вибору, а ви не вказуєте аргумент. +- **Аргументи нативних команд:** Discord використовує автодоповнення для динамічних параметрів (і кнопкові меню, коли ви пропускаєте обов’язкові аргументи). Telegram і Slack показують кнопкове меню, коли команда підтримує вибір значень і ви пропускаєте аргумент. ## `/tools` -`/tools` відповідає на запитання під час виконання, а не на запитання про конфігурацію: **що цей агент може використовувати прямо зараз -у цій розмові**. +`/tools` відповідає на запитання про стан під час виконання, а не про конфігурацію: **що цей агент може використовувати просто зараз у +цій розмові**. -- Типовий `/tools` компактний і оптимізований для швидкого перегляду. +- Типовий `/tools` є компактним і оптимізованим для швидкого перегляду. - `/tools verbose` додає короткі описи. - Поверхні нативних команд, які підтримують аргументи, надають той самий перемикач режиму як `compact|verbose`. - Результати прив’язані до сесії, тому зміна агента, каналу, потоку, авторизації відправника або моделі може змінити вивід. -- `/tools` включає інструменти, які реально доступні під час виконання, зокрема core tools, підключені - plugin tools і channel-owned tools. +- `/tools` включає інструменти, які реально доступні під час виконання, зокрема core-інструменти, підключені + plugin-інструменти та інструменти, що належать каналам. -Для редагування профілю та перевизначень використовуйте панель Tools у Control UI або поверхні конфігурації/каталогу, а не -ставтеся до `/tools` як до статичного каталогу. +Для редагування профілів і перевизначень використовуйте панель Tools у Control UI або поверхні конфігурації/каталогу, а не +трактуйте `/tools` як статичний каталог. -## Поверхні використання (що де показується) +## Поверхні використання (що і де показується) -- **Використання/квота провайдера** (наприклад, «Claude 80% left») показується в `/status` для поточного провайдера моделі, коли відстеження використання увімкнено. OpenClaw нормалізує вікна провайдерів до `% left`; для MiniMax поля відсотка лише із залишком інвертуються перед показом, а відповіді `model_remains` віддають перевагу запису chat-model плюс мітці плану з тегом моделі. -- **Рядки token/cache** у `/status` можуть повертатися до останнього запису використання в транскрипті, якщо актуальний знімок сесії бідний на дані. Наявні ненульові актуальні значення все одно мають пріоритет, а повернення до транскрипту також може відновити мітку активної моделі під час виконання плюс більший загальний обсяг, орієнтований на prompt, коли збережені підсумки відсутні або менші. -- **Tokens/cost для кожної відповіді** керується через `/usage off|tokens|full` (додається до звичайних відповідей). -- `/model status` стосується **моделей/автентифікації/ендпойнтів**, а не використання. +- **Використання/квота провайдера** (наприклад, «Claude 80% left») показується в `/status` для провайдера поточної моделі, коли відстеження використання увімкнено. OpenClaw нормалізує вікна провайдера до `% left`; для MiniMax поля percent із лише залишком інвертуються перед показом, а відповіді `model_remains` віддають перевагу запису chat-model плюс мітці плану з тегом моделі. +- **Рядки токенів/кешу** в `/status` можуть повертатися до останнього запису використання в транскрипті, коли живий знімок сесії неповний. Наявні ненульові живі значення все одно мають пріоритет, а резервний варіант із транскрипту також може відновити мітку активної моделі під час виконання та більшу загальну кількість, орієнтовану на prompt, коли збережені підсумки відсутні або менші. +- **Токени/вартість для кожної відповіді** контролюються через `/usage off|tokens|full` (додаються до звичайних відповідей). +- `/model status` стосується **моделей/автентифікації/endpoints**, а не використання. ## Вибір моделі (`/model`) @@ -251,13 +252,13 @@ Skills, які може викликати користувач, також до Примітки: - `/model` і `/model list` показують компактний нумерований вибір (сімейство моделей + доступні провайдери). -- У Discord `/model` і `/models` відкривають інтерактивний вибір із випадними списками провайдера та моделі плюс кроком Submit. -- `/model <#>` вибирає зі списку вибору (і за можливості віддає перевагу поточному провайдеру). -- `/model status` показує детальний вигляд, зокрема налаштований ендпойнт провайдера (`baseUrl`) і режим API (`api`), коли доступно. +- У Discord `/model` і `/models` відкривають інтерактивний вибір зі спадними списками провайдера й моделі та кроком Submit. +- `/model <#>` вибирає зі списку цього вибору (і за можливості віддає перевагу поточному провайдеру). +- `/model status` показує докладний перегляд, зокрема налаштований endpoint провайдера (`baseUrl`) і режим API (`api`), коли доступно. ## Перевизначення для налагодження -`/debug` дає змогу задавати перевизначення конфігурації **лише під час виконання** (пам’ять, не диск). Лише для власника. Типово вимкнено; увімкніть через `commands.debug: true`. +`/debug` дає змогу задавати **лише під час виконання** перевизначення конфігурації (у пам’яті, не на диску). Лише для власника. Типово вимкнено; увімкніть через `commands.debug: true`. Приклади: @@ -271,8 +272,8 @@ Skills, які може викликати користувач, також до Примітки: -- Перевизначення застосовуються негайно до нових читань конфігурації, але **не** записуються в `openclaw.json`. -- Використовуйте `/debug reset`, щоб очистити всі перевизначення й повернутися до конфігурації на диску. +- Перевизначення застосовуються негайно до нових читань конфігурації, але **не** записуються до `openclaw.json`. +- Використовуйте `/debug reset`, щоб очистити всі перевизначення та повернутися до конфігурації на диску. ## Оновлення конфігурації @@ -290,12 +291,12 @@ Skills, які може викликати користувач, також до Примітки: -- Конфігурація перевіряється перед записом; недійсні зміни відхиляються. -- Оновлення `/config` зберігаються після перезапусків. +- Перед записом конфігурація перевіряється; недійсні зміни відхиляються. +- Оновлення через `/config` зберігаються після перезапусків. ## Оновлення MCP -`/mcp` записує визначення MCP-серверів, керованих OpenClaw, у `mcp.servers`. Лише для власника. Типово вимкнено; увімкніть через `commands.mcp: true`. +`/mcp` записує визначення MCP-серверів, якими керує OpenClaw, у `mcp.servers`. Лише для власника. Типово вимкнено; увімкніть через `commands.mcp: true`. Приклади: @@ -308,12 +309,12 @@ Skills, які може викликати користувач, також до Примітки: -- `/mcp` зберігає конфігурацію в конфігурації OpenClaw, а не в налаштуваннях проєкту, що належать Pi. -- Адаптери під час виконання вирішують, які транспорти реально можна виконати. +- `/mcp` зберігає конфігурацію в конфігурації OpenClaw, а не в налаштуваннях проєкту, якими керує Pi. +- Адаптери під час виконання визначають, які транспорти реально можна виконувати. ## Оновлення plugin -`/plugins` дає операторам змогу переглядати знайдені plugin і перемикати стан увімкнення в конфігурації. Потоки лише для читання можуть використовувати `/plugin` як псевдонім. Типово вимкнено; увімкніть через `commands.plugins: true`. +`/plugins` дає операторам змогу перевіряти знайдені plugins і перемикати їх увімкнення в конфігурації. Для потоків лише читання можна використовувати `/plugin` як псевдонім. Типово вимкнено; увімкніть через `commands.plugins: true`. Приклади: @@ -327,22 +328,22 @@ Skills, які може викликати користувач, також до Примітки: -- `/plugins list` і `/plugins show` використовують реальне виявлення plugin для поточного workspace плюс конфігурацію на диску. -- `/plugins enable|disable` оновлює лише конфігурацію plugin; це не встановлює і не видаляє plugin. -- Після змін увімкнення/вимкнення перезапустіть gateway, щоб застосувати їх. +- `/plugins list` і `/plugins show` використовують реальне виявлення plugins для поточного робочого простору разом із конфігурацією на диску. +- `/plugins enable|disable` оновлює лише конфігурацію plugin; він не встановлює і не видаляє plugins. +- Після змін `enable/disable` перезапустіть gateway, щоб застосувати їх. ## Примітки щодо поверхонь -- **Текстові команди** виконуються у звичайній чат-сесії (приватні повідомлення використовують `main`, групи мають власну сесію). +- **Текстові команди** виконуються в нормальній чат-сесії (DM використовують `main`, групи мають власну сесію). - **Нативні команди** використовують ізольовані сесії: - Discord: `agent::discord:slash:` - Slack: `agent::slack:slash:` (префікс налаштовується через `channels.slack.slashCommand.sessionPrefix`) - Telegram: `telegram:slash:` (націлюється на чат-сесію через `CommandTargetSessionKey`) -- **`/stop`** націлюється на активну чат-сесію, щоб можна було перервати поточний запуск. -- **Slack:** `channels.slack.slashCommand` усе ще підтримується для однієї команди у стилі `/openclaw`. Якщо ви вмикаєте `commands.native`, ви повинні створити одну слеш-команду Slack для кожної вбудованої команди (з тими ж назвами, що й `/help`). Меню аргументів команд для Slack доставляються як ефемерні кнопки Block Kit. - - Виняток для нативної команди Slack: зареєструйте `/agentstatus` (не `/status`), тому що Slack резервує `/status`. Текстова `/status` у повідомленнях Slack усе одно працює. +- **`/stop`** націлюється на активну чат-сесію, щоб мати змогу перервати поточний запуск. +- **Slack:** `channels.slack.slashCommand` усе ще підтримується для однієї команди у стилі `/openclaw`. Якщо ви вмикаєте `commands.native`, потрібно створити по одній slash command у Slack для кожної вбудованої команди (з тими самими назвами, що й `/help`). Меню аргументів команд для Slack доставляються як ефемерні кнопки Block Kit. + - Нативний виняток Slack: реєструйте `/agentstatus` (а не `/status`), тому що Slack резервує `/status`. Текстовий `/status` у повідомленнях Slack усе ще працює. -## Побічні запитання BTW +## BTW side questions `/btw` — це швидке **побічне запитання** про поточну сесію. @@ -355,7 +356,7 @@ Skills, які може викликати користувач, також до - воно доставляється як живий побічний результат, а не як звичайне повідомлення асистента. Це робить `/btw` корисним, коли вам потрібне тимчасове уточнення, поки основне -завдання триває. +завдання продовжується. Приклад: @@ -363,5 +364,5 @@ Skills, які може викликати користувач, також до /btw what are we doing right now? ``` -Див. [BTW Side Questions](/uk/tools/btw), щоб дізнатися про повну поведінку та деталі -клієнтського UX. +Див. [BTW Side Questions](/uk/tools/btw), щоб дізнатися повну поведінку та +подробиці UX клієнта.