chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
aab101d5ea
commit
e23af021f6
@ -1,14 +1,14 @@
|
||||
---
|
||||
read_when:
|
||||
- Вам потрібна швидка діагностика стану каналу + нещодавніх одержувачів сеансу
|
||||
- Вам потрібен придатний для вставлення статус “all” для налагодження
|
||||
summary: Довідник CLI для `openclaw status` (діагностика, проби, знімки використання)
|
||||
title: status
|
||||
- Вам потрібна швидка діагностика стану каналу + одержувачів нещодавніх сеансів
|
||||
- Вам потрібен придатний для вставлення статус «all» для налагодження
|
||||
summary: Довідник CLI для `openclaw status` (діагностика, зонди, знімки використання)
|
||||
title: статус
|
||||
x-i18n:
|
||||
generated_at: "2026-04-23T06:19:26Z"
|
||||
generated_at: "2026-04-23T12:50:54Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: fbe9d94fbe9938cd946ee6f293b5bd3b464b75e1ade2eacdd851788c3bffe94e
|
||||
source_hash: 015614e329ec172a62c625581897fa64589f12dfe28edefe8a2764b5b5367b2a
|
||||
source_path: cli/status.md
|
||||
workflow: 15
|
||||
---
|
||||
@ -26,17 +26,18 @@ openclaw status --usage
|
||||
|
||||
Примітки:
|
||||
|
||||
- `--deep` запускає живі проби (WhatsApp Web + Telegram + Discord + Slack + Signal).
|
||||
- `--usage` виводить нормалізовані вікна використання провайдера як `X% left`.
|
||||
- Необроблені поля `usage_percent` / `usagePercent` у MiniMax означають залишок квоти, тому OpenClaw інвертує їх перед відображенням; за наявності пріоритет мають поля на основі лічильників. Відповіді `model_remains` віддають перевагу запису chat-model, за потреби виводять мітку вікна з часових позначок і включають назву моделі в мітку плану.
|
||||
- Коли поточний знімок сеансу містить мало даних, `/status` може добирати лічильники токенів і кешу з найновішого журналу використання transcript. Наявні ненульові live-значення все одно мають пріоритет над резервними значеннями з transcript.
|
||||
- Резервні дані з transcript також можуть відновити мітку активної runtime-моделі, якщо її немає в live-записі сеансу. Якщо ця модель із transcript відрізняється від вибраної моделі, status визначає context window за відновленою runtime-моделлю, а не за вибраною.
|
||||
- Для обліку розміру prompt резервні дані з transcript віддають перевагу більшому загальному значенню, орієнтованому на prompt, коли метадані сеансу відсутні або менші, щоб сеанси custom-provider не зводилися до відображення `0` токенів.
|
||||
- Вивід включає сховища сеансів для кожного агента, якщо налаштовано кілька агентів.
|
||||
- Огляд включає стан встановлення/виконання Gateway і служби вузла хоста, якщо доступно.
|
||||
- Огляд включає канал оновлення та git SHA (для source checkout).
|
||||
- Інформація про оновлення відображається в огляді; якщо оновлення доступне, status показує підказку виконати `openclaw update` (див. [Оновлення](/uk/install/updating)).
|
||||
- `--deep` запускає живі зонди (WhatsApp Web + Telegram + Discord + Slack + Signal).
|
||||
- `--usage` виводить нормалізовані вікна використання провайдера у форматі `X% left`.
|
||||
- Вивід стану сеансу тепер окремо показує `Runtime:` і `Runner:`. `Runtime` — це шлях виконання та стан ізоляції (`direct`, `docker/*`), тоді як `Runner` показує, чи використовує сеанс вбудований Pi, провайдера на базі CLI або бекенд ACP harness, наприклад `codex (acp/acpx)`.
|
||||
- Необроблені поля MiniMax `usage_percent` / `usagePercent` означають залишок квоти, тому OpenClaw інвертує їх перед показом; за наявності пріоритет мають поля на основі лічильників. Відповіді `model_remains` надають перевагу запису chat-model, за потреби виводять мітку вікна з часових позначок і включають назву моделі до мітки плану.
|
||||
- Коли поточний знімок сеансу містить мало даних, `/status` може дозаповнити лічильники токенів і кешу з найновішого журналу використання transcript. Наявні ненульові живі значення все одно мають пріоритет над резервними значеннями з transcript.
|
||||
- Резервні дані з transcript також можуть відновити мітку активної runtime-моделі, якщо в живому записі сеансу її немає. Якщо ця модель із transcript відрізняється від вибраної моделі, status визначає контекстне вікно за відновленою runtime-моделлю, а не за вибраною.
|
||||
- Для обліку розміру prompt резервні дані з transcript віддають перевагу більшому загальному значенню, орієнтованому на prompt, коли метадані сеансу відсутні або менші, щоб сеанси custom-provider не зводилися до показу `0` токенів.
|
||||
- Вивід містить сховища сеансів для кожного агента, коли налаштовано кілька агентів.
|
||||
- Огляд містить статус установлення/виконання Gateway і служби хоста node, якщо доступно.
|
||||
- Огляд містить канал оновлень і git SHA (для вихідних checkout).
|
||||
- Інформація про оновлення відображається в Overview; якщо доступне оновлення, status показує підказку виконати `openclaw update` (див. [Updating](/uk/install/updating)).
|
||||
- Поверхні status лише для читання (`status`, `status --json`, `status --all`) за можливості визначають підтримувані SecretRef для цільових шляхів конфігурації.
|
||||
- Якщо підтримуваний SecretRef каналу налаштований, але недоступний у поточному шляху команди, status залишається лише для читання і повідомляє про деградований вивід замість аварійного завершення. Людинозрозумілий вивід показує попередження на кшталт “configured token unavailable in this command path”, а JSON-вивід включає `secretDiagnostics`.
|
||||
- Коли локальне для команди визначення SecretRef успішне, status віддає перевагу визначеному знімку і прибирає тимчасові маркери каналу “secret unavailable” з фінального виводу.
|
||||
- `status --all` включає рядок огляду Secrets і розділ діагностики, який підсумовує діагностику секретів (усічено для зручності читання) без зупинки генерації звіту.
|
||||
- Якщо підтримуваний SecretRef каналу налаштовано, але він недоступний у поточному шляху команди, status залишається лише для читання і повідомляє про деградований вивід замість аварійного завершення. У виводі для людини показуються попередження на кшталт «configured token unavailable in this command path», а JSON-вивід містить `secretDiagnostics`.
|
||||
- Коли локальне для команди визначення SecretRef успішне, status надає перевагу визначеному знімку і прибирає тимчасові маркери каналу «secret unavailable» з фінального виводу.
|
||||
- `status --all` містить рядок огляду Secrets і розділ діагностики, який підсумовує діагностику секретів (скорочено для читабельності), не зупиняючи генерацію звіту.
|
||||
|
||||
@ -1,15 +1,15 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви хочете використовувати моделі OpenAI в OpenClaw
|
||||
- Ви хочете автентифікацію через підписку Codex замість API keys
|
||||
- Вам потрібна суворіша поведінка виконання агента GPT-5
|
||||
summary: Використовуйте OpenAI через API keys або підписку Codex в OpenClaw
|
||||
- Ви хочете автентифікацію через підписку Codex замість API-ключів
|
||||
- Вам потрібні суворіші правила виконання агентів GPT-5
|
||||
summary: Використовуйте OpenAI через API-ключі або підписку Codex в OpenClaw
|
||||
title: OpenAI
|
||||
x-i18n:
|
||||
generated_at: "2026-04-23T06:46:31Z"
|
||||
generated_at: "2026-04-23T12:50:48Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: c3d847e53c2faee5363071dfdcb1f4150b64577674161e000844f579482198d1
|
||||
source_hash: ac42660234e1971440f6de3b04adb1d3a1fddca20219fb68936c36e4c2f95265
|
||||
source_path: providers/openai.md
|
||||
workflow: 15
|
||||
---
|
||||
@ -18,39 +18,39 @@ x-i18n:
|
||||
|
||||
OpenAI надає API для розробників для моделей GPT. OpenClaw підтримує два способи автентифікації:
|
||||
|
||||
- **API key** — прямий доступ до OpenAI Platform з оплатою за використання (моделі `openai/*`)
|
||||
- **Підписка Codex** — вхід через ChatGPT/Codex з доступом за підпискою (моделі `openai-codex/*`)
|
||||
- **API-ключ** — прямий доступ до OpenAI Platform з оплатою за використання (моделі `openai/*`)
|
||||
- **Підписка Codex** — вхід через ChatGPT/Codex із доступом за підпискою (моделі `openai-codex/*`)
|
||||
|
||||
OpenAI явно підтримує використання OAuth за підпискою у зовнішніх інструментах і робочих процесах на кшталт OpenClaw.
|
||||
OpenAI явно підтримує використання OAuth підписки у зовнішніх інструментах і робочих процесах, таких як OpenClaw.
|
||||
|
||||
## Покриття можливостей OpenClaw
|
||||
## Підтримка можливостей OpenClaw
|
||||
|
||||
| Можливість OpenAI | Поверхня OpenClaw | Статус |
|
||||
| ------------------------ | ----------------------------------------- | ------------------------------------------------------ |
|
||||
| Chat / Responses | Провайдер моделей `openai/<model>` | Так |
|
||||
| Моделі підписки Codex | Провайдер моделей `openai-codex/<model>` | Так |
|
||||
| Server-side web search | Власний tool Responses від OpenAI | Так, коли web search увімкнено і не закріплено провайдера |
|
||||
| Зображення | `image_generate` | Так |
|
||||
| Відео | `video_generate` | Так |
|
||||
| Text-to-speech | `messages.tts.provider: "openai"` / `tts` | Так |
|
||||
| Batch speech-to-text | `tools.media.audio` / розуміння media | Так |
|
||||
| Streaming speech-to-text | Voice Call `streaming.provider: "openai"` | Так |
|
||||
| Realtime voice | Voice Call `realtime.provider: "openai"` | Так |
|
||||
| Embeddings | Провайдер embedding для memory | Так |
|
||||
| Можливість OpenAI | Поверхня OpenClaw | Статус |
|
||||
| ------------------------- | ----------------------------------------- | ------------------------------------------------------ |
|
||||
| Чат / Responses | Провайдер моделей `openai/<model>` | Так |
|
||||
| Моделі підписки Codex | Провайдер моделей `openai-codex/<model>` | Так |
|
||||
| Вебпошук на стороні сервера | Нативний інструмент OpenAI Responses | Так, коли вебпошук увімкнено й провайдера не зафіксовано |
|
||||
| Зображення | `image_generate` | Так |
|
||||
| Відео | `video_generate` | Так |
|
||||
| Перетворення тексту на мовлення | `messages.tts.provider: "openai"` / `tts` | Так |
|
||||
| Пакетне перетворення мовлення на текст | `tools.media.audio` / розуміння медіа | Так |
|
||||
| Потокове перетворення мовлення на текст | Voice Call `streaming.provider: "openai"` | Так |
|
||||
| Голос у реальному часі | Voice Call `realtime.provider: "openai"` | Так |
|
||||
| Embeddings | провайдер embedding для пам’яті | Так |
|
||||
|
||||
## Початок роботи
|
||||
|
||||
Виберіть бажаний спосіб автентифікації та виконайте кроки налаштування.
|
||||
|
||||
<Tabs>
|
||||
<Tab title="API key (OpenAI Platform)">
|
||||
<Tab title="API-ключ (OpenAI Platform)">
|
||||
**Найкраще для:** прямого доступу до API та оплати за використання.
|
||||
|
||||
<Steps>
|
||||
<Step title="Get your API key">
|
||||
Створіть або скопіюйте API key на [панелі OpenAI Platform](https://platform.openai.com/api-keys).
|
||||
<Step title="Отримайте свій API-ключ">
|
||||
Створіть або скопіюйте API-ключ на [панелі керування OpenAI Platform](https://platform.openai.com/api-keys).
|
||||
</Step>
|
||||
<Step title="Run onboarding">
|
||||
<Step title="Запустіть онбординг">
|
||||
```bash
|
||||
openclaw onboard --auth-choice openai-api-key
|
||||
```
|
||||
@ -61,22 +61,22 @@ x-i18n:
|
||||
openclaw onboard --openai-api-key "$OPENAI_API_KEY"
|
||||
```
|
||||
</Step>
|
||||
<Step title="Verify the model is available">
|
||||
<Step title="Перевірте, що модель доступна">
|
||||
```bash
|
||||
openclaw models list --provider openai
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
### Зведення маршрутів
|
||||
### Підсумок маршруту
|
||||
|
||||
| Model ref | Маршрут | Автентифікація |
|
||||
|-----------|---------|----------------|
|
||||
| Посилання на модель | Маршрут | Автентифікація |
|
||||
|-----------|-------|------|
|
||||
| `openai/gpt-5.4` | Прямий API OpenAI Platform | `OPENAI_API_KEY` |
|
||||
| `openai/gpt-5.4-pro` | Прямий API OpenAI Platform | `OPENAI_API_KEY` |
|
||||
|
||||
<Note>
|
||||
Вхід через ChatGPT/Codex маршрутизується через `openai-codex/*`, а не `openai/*`.
|
||||
Вхід через ChatGPT/Codex маршрутизується через `openai-codex/*`, а не через `openai/*`.
|
||||
</Note>
|
||||
|
||||
### Приклад конфігурації
|
||||
@ -89,16 +89,16 @@ x-i18n:
|
||||
```
|
||||
|
||||
<Warning>
|
||||
OpenClaw **не** надає `openai/gpt-5.3-codex-spark` на прямому шляху API. Реальні запити до OpenAI API відхиляють цю модель. Spark доступний лише в Codex.
|
||||
OpenClaw **не** надає `openai/gpt-5.3-codex-spark` через шлях прямого API. Реальні запити до OpenAI API відхиляють цю модель. Spark доступний лише в Codex.
|
||||
</Warning>
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Codex subscription">
|
||||
**Найкраще для:** використання вашої підписки ChatGPT/Codex замість окремого API key. Codex cloud потребує входу через ChatGPT.
|
||||
<Tab title="Підписка Codex">
|
||||
**Найкраще для:** використання вашої підписки ChatGPT/Codex замість окремого API-ключа. Codex cloud потребує входу через ChatGPT.
|
||||
|
||||
<Steps>
|
||||
<Step title="Run Codex OAuth">
|
||||
<Step title="Запустіть Codex OAuth">
|
||||
```bash
|
||||
openclaw onboard --auth-choice openai-codex
|
||||
```
|
||||
@ -109,33 +109,33 @@ x-i18n:
|
||||
openclaw models auth login --provider openai-codex
|
||||
```
|
||||
|
||||
Для headless або несумісних із callback налаштувань додайте `--device-code`, щоб увійти через потік device-code ChatGPT замість callback браузера localhost:
|
||||
Для headless-середовищ або конфігурацій, де callback працює нестабільно, додайте `--device-code`, щоб увійти через потік device-code ChatGPT замість callback localhost у браузері:
|
||||
|
||||
```bash
|
||||
openclaw models auth login --provider openai-codex --device-code
|
||||
```
|
||||
</Step>
|
||||
<Step title="Set the default model">
|
||||
<Step title="Установіть модель за замовчуванням">
|
||||
```bash
|
||||
openclaw config set agents.defaults.model.primary openai-codex/gpt-5.4
|
||||
```
|
||||
</Step>
|
||||
<Step title="Verify the model is available">
|
||||
<Step title="Перевірте, що модель доступна">
|
||||
```bash
|
||||
openclaw models list --provider openai-codex
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
### Зведення маршрутів
|
||||
### Підсумок маршруту
|
||||
|
||||
| Model ref | Маршрут | Автентифікація |
|
||||
|-----------|---------|----------------|
|
||||
| `openai-codex/gpt-5.4` | OAuth ChatGPT/Codex | Вхід Codex |
|
||||
| `openai-codex/gpt-5.3-codex-spark` | OAuth ChatGPT/Codex | Вхід Codex (залежить від прав доступу) |
|
||||
| Посилання на модель | Маршрут | Автентифікація |
|
||||
|-----------|-------|------|
|
||||
| `openai-codex/gpt-5.4` | ChatGPT/Codex OAuth | Вхід Codex |
|
||||
| `openai-codex/gpt-5.3-codex-spark` | ChatGPT/Codex OAuth | Вхід Codex (залежить від entitlement) |
|
||||
|
||||
<Note>
|
||||
Цей маршрут навмисно відокремлений від `openai/gpt-5.4`. Використовуйте `openai/*` з API key для прямого доступу до Platform і `openai-codex/*` для доступу за підпискою Codex.
|
||||
Цей маршрут навмисно відокремлений від `openai/gpt-5.4`. Використовуйте `openai/*` з API-ключем для прямого доступу до Platform, а `openai-codex/*` — для доступу через підписку Codex.
|
||||
</Note>
|
||||
|
||||
### Приклад конфігурації
|
||||
@ -147,19 +147,19 @@ x-i18n:
|
||||
```
|
||||
|
||||
<Note>
|
||||
Onboarding більше не імпортує матеріали OAuth з `~/.codex`. Увійдіть через OAuth у браузері (типово) або через потік device-code вище — OpenClaw керує отриманими обліковими даними у власному сховищі автентифікації агента.
|
||||
Онбординг більше не імпортує OAuth-матеріали з `~/.codex`. Увійдіть через OAuth у браузері (типово) або через потік device-code вище — OpenClaw керує отриманими обліковими даними у власному сховищі автентифікації агента.
|
||||
</Note>
|
||||
|
||||
### Обмеження вікна context
|
||||
### Обмеження вікна контексту
|
||||
|
||||
OpenClaw розглядає metadata моделі та обмеження context у runtime як окремі значення.
|
||||
OpenClaw розглядає метадані моделі та обмеження контексту під час виконання як окремі значення.
|
||||
|
||||
Для `openai-codex/gpt-5.4`:
|
||||
|
||||
- Власний `contextWindow`: `1050000`
|
||||
- Типове обмеження `contextTokens` у runtime: `272000`
|
||||
- Власне `contextWindow`: `1050000`
|
||||
- Типове обмеження `contextTokens` під час виконання: `272000`
|
||||
|
||||
Менше типове обмеження на практиці дає кращу затримку й якість. Перевизначте його через `contextTokens`:
|
||||
Менше типове обмеження на практиці дає кращі характеристики затримки та якості. Замініть його через `contextTokens`:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -174,7 +174,7 @@ x-i18n:
|
||||
```
|
||||
|
||||
<Note>
|
||||
Використовуйте `contextWindow`, щоб оголосити власні metadata моделі. Використовуйте `contextTokens`, щоб обмежити бюджет context у runtime.
|
||||
Використовуйте `contextWindow`, щоб оголосити власні метадані моделі. Використовуйте `contextTokens`, щоб обмежити бюджет контексту під час виконання.
|
||||
</Note>
|
||||
|
||||
</Tab>
|
||||
@ -182,15 +182,15 @@ x-i18n:
|
||||
|
||||
## Генерація зображень
|
||||
|
||||
Вбудований plugin `openai` реєструє генерацію зображень через tool `image_generate`.
|
||||
Вбудований Plugin `openai` реєструє генерацію зображень через інструмент `image_generate`.
|
||||
|
||||
| Можливість | Значення |
|
||||
| ----------------------- | ------------------------------------- |
|
||||
| Типова модель | `openai/gpt-image-2` |
|
||||
| Макс. кількість зображень на запит | 4 |
|
||||
| Режим редагування | Увімкнено (до 5 еталонних зображень) |
|
||||
| Перевизначення розміру | Підтримується, включно з розмірами 2K/4K |
|
||||
| Співвідношення сторін / роздільна здатність | Не передаються до OpenAI Images API |
|
||||
| Можливість | Значення |
|
||||
| ----------------------- | ---------------------------------- |
|
||||
| Типова модель | `openai/gpt-image-2` |
|
||||
| Макс. кількість зображень на запит | 4 |
|
||||
| Режим редагування | Увімкнено (до 5 еталонних зображень) |
|
||||
| Перевизначення розміру | Підтримується, зокрема розміри 2K/4K |
|
||||
| Співвідношення сторін / роздільна здатність | Не передається до OpenAI Images API |
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -203,20 +203,18 @@ x-i18n:
|
||||
```
|
||||
|
||||
<Note>
|
||||
Спільні параметри tool, вибір провайдера й поведінку failover див. у [Генерація зображень](/uk/tools/image-generation).
|
||||
Див. [Генерація зображень](/uk/tools/image-generation) щодо спільних параметрів інструмента, вибору провайдера та поведінки failover.
|
||||
</Note>
|
||||
|
||||
`gpt-image-2` є типовим для генерації текст-у-зображення в OpenAI і для
|
||||
редагування зображень. `gpt-image-1` і далі можна використовувати як явне
|
||||
перевизначення моделі, але нові робочі процеси OpenAI для зображень мають використовувати `openai/gpt-image-2`.
|
||||
`gpt-image-2` є типовим значенням як для генерації зображень з тексту в OpenAI, так і для редагування зображень. `gpt-image-1` і далі можна використовувати як явне перевизначення моделі, але нові робочі процеси OpenAI для зображень мають використовувати `openai/gpt-image-2`.
|
||||
|
||||
Генерація:
|
||||
Згенерувати:
|
||||
|
||||
```
|
||||
/tool image_generate model=openai/gpt-image-2 prompt="A polished launch poster for OpenClaw on macOS" size=3840x2160 count=1
|
||||
```
|
||||
|
||||
Редагування:
|
||||
Редагувати:
|
||||
|
||||
```
|
||||
/tool image_generate model=openai/gpt-image-2 prompt="Preserve the object shape, change the material to translucent glass" image=/path/to/reference.png size=1024x1536
|
||||
@ -224,15 +222,15 @@ x-i18n:
|
||||
|
||||
## Генерація відео
|
||||
|
||||
Вбудований plugin `openai` реєструє генерацію відео через tool `video_generate`.
|
||||
Вбудований Plugin `openai` реєструє генерацію відео через інструмент `video_generate`.
|
||||
|
||||
| Можливість | Значення |
|
||||
| ---------------- | ------------------------------------------------------------------------------------ |
|
||||
| Типова модель | `openai/sora-2` |
|
||||
| Режими | Текст-у-відео, зображення-у-відео, редагування одного відео |
|
||||
| Еталонні входи | 1 зображення або 1 відео |
|
||||
| Перевизначення розміру | Підтримується |
|
||||
| Інші перевизначення | `aspectRatio`, `resolution`, `audio`, `watermark` ігноруються з попередженням tool |
|
||||
| Можливість | Значення |
|
||||
| -------------- | ------------------------------------------------------------------------------- |
|
||||
| Типова модель | `openai/sora-2` |
|
||||
| Режими | Текст у відео, зображення у відео, редагування одного відео |
|
||||
| Еталонні входи | 1 зображення або 1 відео |
|
||||
| Перевизначення розміру | Підтримується |
|
||||
| Інші перевизначення | `aspectRatio`, `resolution`, `audio`, `watermark` ігноруються з попередженням інструмента |
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -245,22 +243,22 @@ x-i18n:
|
||||
```
|
||||
|
||||
<Note>
|
||||
Спільні параметри tool, вибір провайдера й поведінку failover див. у [Генерація відео](/uk/tools/video-generation).
|
||||
Див. [Генерація відео](/uk/tools/video-generation) щодо спільних параметрів інструмента, вибору провайдера та поведінки failover.
|
||||
</Note>
|
||||
|
||||
## Внесок prompt GPT-5
|
||||
## Внесок у prompt для GPT-5
|
||||
|
||||
OpenClaw додає спільний внесок prompt GPT-5 для запусків сімейства GPT-5 у різних провайдерів. Він застосовується за id моделі, тож `openai/gpt-5.4`, `openai-codex/gpt-5.4`, `openrouter/openai/gpt-5.4`, `opencode/gpt-5.4` та інші сумісні посилання GPT-5 отримують той самий overlay. Старіші моделі GPT-4.x цього не отримують.
|
||||
OpenClaw додає спільний внесок у prompt для GPT-5 для запусків сімейства GPT-5 у різних провайдерів. Він застосовується за ідентифікатором моделі, тому `openai/gpt-5.4`, `openai-codex/gpt-5.4`, `openrouter/openai/gpt-5.4`, `opencode/gpt-5.4` та інші сумісні посилання на GPT-5 отримують однакове накладання. Старіші моделі GPT-4.x цього не отримують.
|
||||
|
||||
Вбудований провайдер native Codex harness (`codex/*`) використовує ту саму поведінку GPT-5 і overlay Heartbeat через developer instructions app-server Codex, тож сесії `codex/gpt-5.x` зберігають ту саму послідовність виконання та проактивні вказівки Heartbeat, навіть попри те, що рештою prompt harness керує Codex.
|
||||
Вбудований провайдер нативного harness Codex (`codex/*`) використовує таку саму поведінку GPT-5 і накладання Heartbeat через інструкції розробника сервера застосунку Codex, тож сеанси `codex/gpt-5.x` зберігають такий самий супровід, проактивний Heartbeat і відповідні вказівки, навіть попри те, що рештою prompt harness керує Codex.
|
||||
|
||||
Внесок GPT-5 додає позначений контракт поведінки для збереження persona, безпеки виконання, дисципліни tool, форми виводу, перевірок завершення та верифікації. Специфічна для каналу поведінка відповіді й тихих повідомлень залишається у спільному системному prompt OpenClaw і політиці вихідної доставки. Вказівки GPT-5 завжди увімкнені для відповідних моделей. Шар дружнього стилю взаємодії є окремим і налаштовуваним.
|
||||
Внесок GPT-5 додає тегований контракт поведінки для збереження персони, безпеки виконання, дисципліни інструментів, форми виводу, перевірок завершення та верифікації. Специфічна для каналу поведінка відповіді та тихих повідомлень залишається у спільному системному prompt OpenClaw і політиці вихідної доставки. Вказівки GPT-5 завжди ввімкнені для відповідних моделей. Рівень дружнього стилю взаємодії є окремим і налаштовується.
|
||||
|
||||
| Значення | Ефект |
|
||||
| ---------------------- | ------------------------------------------ |
|
||||
| `"friendly"` (типово) | Увімкнути шар дружнього стилю взаємодії |
|
||||
| `"friendly"` (типово) | Увімкнути рівень дружнього стилю взаємодії |
|
||||
| `"on"` | Псевдонім для `"friendly"` |
|
||||
| `"off"` | Вимкнути лише шар дружнього стилю |
|
||||
| `"off"` | Вимкнути лише рівень дружнього стилю |
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Config">
|
||||
@ -284,27 +282,27 @@ OpenClaw додає спільний внесок prompt GPT-5 для запус
|
||||
</Tabs>
|
||||
|
||||
<Tip>
|
||||
Під час runtime значення нечутливі до регістру, тож і `"Off"`, і `"off"` вимикають шар дружнього стилю.
|
||||
Під час виконання значення нечутливі до регістру, тож і `"Off"`, і `"off"` вимикають рівень дружнього стилю.
|
||||
</Tip>
|
||||
|
||||
<Note>
|
||||
Застарілий параметр `plugins.entries.openai.config.personality` і далі зчитується як сумісний fallback, коли не задано спільний параметр `agents.defaults.promptOverlays.gpt5.personality`.
|
||||
Застаріле `plugins.entries.openai.config.personality` і далі зчитується як резервний варіант сумісності, коли спільне налаштування `agents.defaults.promptOverlays.gpt5.personality` не задане.
|
||||
</Note>
|
||||
|
||||
## Голос і мовлення
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Speech synthesis (TTS)">
|
||||
Вбудований plugin `openai` реєструє синтез мовлення для поверхні `messages.tts`.
|
||||
<Accordion title="Синтез мовлення (TTS)">
|
||||
Вбудований Plugin `openai` реєструє синтез мовлення для поверхні `messages.tts`.
|
||||
|
||||
| Параметр | Шлях конфігурації | Типове значення |
|
||||
|---------|-------------------|-----------------|
|
||||
| Налаштування | Шлях конфігурації | Типове значення |
|
||||
|---------|------------|---------|
|
||||
| Модель | `messages.tts.providers.openai.model` | `gpt-4o-mini-tts` |
|
||||
| Голос | `messages.tts.providers.openai.voice` | `coral` |
|
||||
| Швидкість | `messages.tts.providers.openai.speed` | (не задано) |
|
||||
| Інструкції | `messages.tts.providers.openai.instructions` | (не задано, лише `gpt-4o-mini-tts`) |
|
||||
| Формат | `messages.tts.providers.openai.responseFormat` | `opus` для voice notes, `mp3` для файлів |
|
||||
| API key | `messages.tts.providers.openai.apiKey` | Використовує `OPENAI_API_KEY` як fallback |
|
||||
| Формат | `messages.tts.providers.openai.responseFormat` | `opus` для голосових нотаток, `mp3` для файлів |
|
||||
| API-ключ | `messages.tts.providers.openai.apiKey` | Резервно використовується `OPENAI_API_KEY` |
|
||||
| Base URL | `messages.tts.providers.openai.baseUrl` | `https://api.openai.com/v1` |
|
||||
|
||||
Доступні моделі: `gpt-4o-mini-tts`, `tts-1`, `tts-1-hd`. Доступні голоси: `alloy`, `ash`, `ballad`, `cedar`, `coral`, `echo`, `fable`, `juniper`, `marin`, `onyx`, `nova`, `sage`, `shimmer`, `verse`.
|
||||
@ -322,21 +320,21 @@ OpenClaw додає спільний внесок prompt GPT-5 для запус
|
||||
```
|
||||
|
||||
<Note>
|
||||
Задайте `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL TTS без впливу на endpoint API чату.
|
||||
Установіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL для TTS, не впливаючи на кінцеву точку API чату.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Speech-to-text">
|
||||
Вбудований plugin `openai` реєструє пакетне speech-to-text через
|
||||
поверхню транскрибування media understanding в OpenClaw.
|
||||
<Accordion title="Перетворення мовлення на текст">
|
||||
Вбудований Plugin `openai` реєструє пакетне перетворення мовлення на текст через
|
||||
поверхню транскрибування для розуміння медіа в OpenClaw.
|
||||
|
||||
- Типова модель: `gpt-4o-transcribe`
|
||||
- Endpoint: OpenAI REST `/v1/audio/transcriptions`
|
||||
- Шлях входу: multipart-завантаження аудіофайлу
|
||||
- Кінцева точка: OpenAI REST `/v1/audio/transcriptions`
|
||||
- Шлях введення: multipart-завантаження аудіофайлу
|
||||
- Підтримується в OpenClaw всюди, де транскрибування вхідного аудіо використовує
|
||||
`tools.media.audio`, включно з сегментами голосових каналів Discord і
|
||||
аудіовкладеннями каналів
|
||||
`tools.media.audio`, зокрема в сегментах голосових каналів Discord і
|
||||
аудіовкладеннях каналів
|
||||
|
||||
Щоб примусово використовувати OpenAI для транскрибування вхідного аудіо:
|
||||
|
||||
@ -358,63 +356,189 @@ OpenClaw додає спільний внесок prompt GPT-5 для запус
|
||||
}
|
||||
```
|
||||
|
||||
Підказки щодо мови й prompt передаються в OpenAI, якщо вони задані через
|
||||
спільну конфігурацію audio media або в запиті транскрибування для окремого виклику.
|
||||
Підказки щодо мови та prompt передаються до OpenAI, коли вони задані
|
||||
у спільній конфігурації аудіомедіа або в запиті транскрибування для конкретного виклику.
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Realtime transcription">
|
||||
Вбудований plugin `openai` реєструє realtime transcription для plugin Voice Call.
|
||||
<Accordion title="Транскрибування в реальному часі">
|
||||
Вбудований Plugin `openai` реєструє транскрибування в реальному часі для Plugin Voice Call.
|
||||
|
||||
| Параметр | Шлях конфігурації | Типове значення |
|
||||
|---------|-------------------|-----------------|
|
||||
| Налаштування | Шлях конфігурації | Типове значення |
|
||||
|---------|------------|---------|
|
||||
| Модель | `plugins.entries.voice-call.config.streaming.providers.openai.model` | `gpt-4o-transcribe` |
|
||||
| Мова | `...openai.language` | (не задано) |
|
||||
| Prompt | `...openai.prompt` | (не задано) |
|
||||
| Тривалість тиші | `...openai.silenceDurationMs` | `800` |
|
||||
| Поріг VAD | `...openai.vadThreshold` | `0.5` |
|
||||
| API key | `...openai.apiKey` | Використовує `OPENAI_API_KEY` як fallback |
|
||||
| API-ключ | `...openai.apiKey` | Резервно використовується `OPENAI_API_KEY` |
|
||||
|
||||
<Note>
|
||||
Використовує з’єднання WebSocket до `wss://api.openai.com/v1/realtime` з аудіо G.711 u-law (`g711_ulaw` / `audio/pcmu`). Цей streaming provider призначений для шляху realtime transcription у Voice Call; Discord voice наразі записує короткі сегменти й натомість використовує пакетний шлях транскрибування `tools.media.audio`.
|
||||
Використовує WebSocket-з’єднання з `wss://api.openai.com/v1/realtime` з аудіо у форматі G.711 u-law (`g711_ulaw` / `audio/pcmu`). Цей провайдер потокової передачі призначений для шляху транскрибування в реальному часі у Voice Call; голос у Discord наразі записує короткі сегменти та натомість використовує шлях пакетного транскрибування `tools.media.audio`.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Realtime voice">
|
||||
Вбудований plugin `openai` реєструє realtime voice для plugin Voice Call.
|
||||
<Accordion title="Голос у реальному часі">
|
||||
Вбудований Plugin `openai` реєструє голос у реальному часі для Plugin Voice Call.
|
||||
|
||||
| Параметр | Шлях конфігурації | Типове значення |
|
||||
|---------|-------------------|-----------------|
|
||||
| Налаштування | Шлях конфігурації | Типове значення |
|
||||
|---------|------------|---------|
|
||||
| Модель | `plugins.entries.voice-call.config.realtime.providers.openai.model` | `gpt-realtime` |
|
||||
| Голос | `...openai.voice` | `alloy` |
|
||||
| Temperature | `...openai.temperature` | `0.8` |
|
||||
| Поріг VAD | `...openai.vadThreshold` | `0.5` |
|
||||
| Тривалість тиші | `...openai.silenceDurationMs` | `500` |
|
||||
| API key | `...openai.apiKey` | Використовує `OPENAI_API_KEY` як fallback |
|
||||
| API-ключ | `...openai.apiKey` | Резервно використовується `OPENAI_API_KEY` |
|
||||
|
||||
<Note>
|
||||
Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двонапрямний виклик tool. Використовує аудіоформат G.711 u-law.
|
||||
Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двонапрямлений виклик інструментів. Використовує аудіоформат G.711 u-law.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Кінцеві точки Azure OpenAI
|
||||
|
||||
Вбудований провайдер `openai` може спрямовувати генерацію зображень до ресурсу Azure OpenAI
|
||||
через перевизначення базового URL. На шляху генерації зображень OpenClaw
|
||||
виявляє імена хостів Azure в `models.providers.openai.baseUrl` і автоматично перемикається
|
||||
на формат запиту Azure.
|
||||
|
||||
<Note>
|
||||
Голос у реальному часі використовує окремий шлях конфігурації
|
||||
(`plugins.entries.voice-call.config.realtime.providers.openai.azureEndpoint`)
|
||||
і на нього не впливає `models.providers.openai.baseUrl`. Див. акордеон **Голос
|
||||
у реальному часі** в розділі [Голос і мовлення](#voice-and-speech) щодо його налаштувань
|
||||
Azure.
|
||||
</Note>
|
||||
|
||||
Використовуйте Azure OpenAI, коли:
|
||||
|
||||
- У вас уже є підписка Azure OpenAI, квота або корпоративна угода
|
||||
- Вам потрібні регіональне зберігання даних або елементи контролю відповідності, які надає Azure
|
||||
- Ви хочете зберегти трафік в межах наявного середовища Azure
|
||||
|
||||
### Конфігурація
|
||||
|
||||
Для генерації зображень через Azure за допомогою вбудованого провайдера `openai` вкажіть
|
||||
`models.providers.openai.baseUrl` на ваш ресурс Azure і встановіть `apiKey` як
|
||||
ключ Azure OpenAI (а не ключ OpenAI Platform):
|
||||
|
||||
```json5
|
||||
{
|
||||
models: {
|
||||
providers: {
|
||||
openai: {
|
||||
baseUrl: "https://<your-resource>.openai.azure.com",
|
||||
apiKey: "<azure-openai-api-key>",
|
||||
},
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
OpenClaw розпізнає такі суфікси хостів Azure для маршруту генерації зображень Azure:
|
||||
|
||||
- `*.openai.azure.com`
|
||||
- `*.services.ai.azure.com`
|
||||
- `*.cognitiveservices.azure.com`
|
||||
|
||||
Для запитів генерації зображень на розпізнаному хості Azure OpenClaw:
|
||||
|
||||
- Надсилає заголовок `api-key` замість `Authorization: Bearer`
|
||||
- Використовує шляхи, прив’язані до розгортання (`/openai/deployments/{deployment}/...`)
|
||||
- Додає `?api-version=...` до кожного запиту
|
||||
|
||||
Інші базові URL (публічний OpenAI, OpenAI-сумісні проксі) зберігають стандартний
|
||||
формат запиту OpenAI для зображень.
|
||||
|
||||
<Note>
|
||||
Маршрутизація Azure для шляху генерації зображень провайдера `openai`
|
||||
потребує OpenClaw 2026.4.22 або новішої версії. Попередні версії трактують будь-який
|
||||
власний `openai.baseUrl` як публічну кінцеву точку OpenAI і не працюватимуть з Azure
|
||||
розгортаннями генерації зображень.
|
||||
</Note>
|
||||
|
||||
### Версія API
|
||||
|
||||
Установіть `AZURE_OPENAI_API_VERSION`, щоб зафіксувати конкретну preview- або GA-версію Azure
|
||||
для шляху генерації зображень Azure:
|
||||
|
||||
```bash
|
||||
export AZURE_OPENAI_API_VERSION="2024-12-01-preview"
|
||||
```
|
||||
|
||||
Типове значення — `2024-12-01-preview`, якщо змінну не задано.
|
||||
|
||||
### Імена моделей — це імена розгортань
|
||||
|
||||
Azure OpenAI прив’язує моделі до розгортань. Для запитів генерації зображень Azure,
|
||||
маршрутизованих через вбудований провайдер `openai`, поле `model` в OpenClaw
|
||||
має бути **іменем розгортання Azure**, яке ви налаштували в порталі Azure, а не
|
||||
публічним ідентифікатором моделі OpenAI.
|
||||
|
||||
Якщо ви створили розгортання з назвою `gpt-image-2-prod`, яке обслуговує `gpt-image-2`:
|
||||
|
||||
```
|
||||
/tool image_generate model=openai/gpt-image-2-prod prompt="A clean poster" size=1024x1024 count=1
|
||||
```
|
||||
|
||||
Те саме правило щодо імені розгортання застосовується до викликів генерації зображень,
|
||||
маршрутизованих через вбудований провайдер `openai`.
|
||||
|
||||
### Регіональна доступність
|
||||
|
||||
Генерація зображень Azure наразі доступна лише в частині регіонів
|
||||
(наприклад, `eastus2`, `swedencentral`, `polandcentral`, `westus3`,
|
||||
`uaenorth`). Перед створенням
|
||||
розгортання перевірте актуальний список регіонів Microsoft і підтвердьте, що конкретна модель пропонується у вашому регіоні.
|
||||
|
||||
### Відмінності параметрів
|
||||
|
||||
Azure OpenAI і публічний OpenAI не завжди приймають однакові параметри зображень.
|
||||
Azure може відхиляти параметри, які допускає публічний OpenAI (наприклад, певні
|
||||
значення `background` для `gpt-image-2`), або надавати їх лише для певних версій
|
||||
моделі. Ці відмінності походять від Azure та базової моделі, а не від
|
||||
OpenClaw. Якщо запит Azure завершується помилкою валідації, перевірте
|
||||
набір параметрів, які підтримує ваше конкретне розгортання та версія API, у
|
||||
порталі Azure.
|
||||
|
||||
<Note>
|
||||
Azure OpenAI використовує нативну транспортну та compat-поведінку, але не отримує
|
||||
приховані заголовки атрибуції OpenClaw. Див. акордеон **Нативні та OpenAI-сумісні
|
||||
маршрути** в розділі [Розширена конфігурація](#advanced-configuration)
|
||||
для деталей.
|
||||
</Note>
|
||||
|
||||
<Tip>
|
||||
Щодо окремого провайдера Azure OpenAI Responses (відмінного від провайдера `openai`)
|
||||
див. посилання на моделі `azure-openai-responses/*` в акордеоні
|
||||
[Compaction на стороні сервера](#server-side-compaction-responses-api).
|
||||
</Tip>
|
||||
|
||||
<Note>
|
||||
Трафік Azure chat і Responses потребує специфічної для Azure конфігурації провайдера/API на
|
||||
додаток до перевизначення базового URL. Якщо вам потрібні виклики моделей Azure не лише для генерації
|
||||
зображень, використовуйте потік онбордингу або конфігурацію провайдера, яка задає
|
||||
відповідний формат API/автентифікації Azure, а не припускайте, що лише `openai.baseUrl` достатньо.
|
||||
</Note>
|
||||
|
||||
## Розширена конфігурація
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Transport (WebSocket vs SSE)">
|
||||
OpenClaw використовує WebSocket-first з fallback до SSE (`"auto"`) як для `openai/*`, так і для `openai-codex/*`.
|
||||
<Accordion title="Транспорт (WebSocket проти SSE)">
|
||||
OpenClaw використовує WebSocket-first із резервним переходом на SSE (`"auto"`) як для `openai/*`, так і для `openai-codex/*`.
|
||||
|
||||
У режимі `"auto"` OpenClaw:
|
||||
- Повторює одну ранню помилку WebSocket перед переходом на SSE
|
||||
- Після помилки позначає WebSocket як degraded приблизно на 60 секунд і використовує SSE під час cooldown
|
||||
- Додає стабільні заголовки ідентичності сесії й ходу для повторів і перепідключень
|
||||
- Нормалізує лічильники використання (`input_tokens` / `prompt_tokens`) між варіантами transport
|
||||
- Після помилки позначає WebSocket як деградований приблизно на 60 секунд і використовує SSE під час цього періоду охолодження
|
||||
- Додає стабільні заголовки ідентичності сеансу та ходу для повторних спроб і повторних підключень
|
||||
- Нормалізує лічильники використання (`input_tokens` / `prompt_tokens`) між варіантами транспорту
|
||||
|
||||
| Значення | Поведінка |
|
||||
|----------|-----------|
|
||||
| `"auto"` (типово) | Спочатку WebSocket, fallback до SSE |
|
||||
|-------|----------|
|
||||
| `"auto"` (типово) | Спочатку WebSocket, потім резервний перехід на SSE |
|
||||
| `"sse"` | Примусово лише SSE |
|
||||
| `"websocket"` | Примусово лише WebSocket |
|
||||
|
||||
@ -433,16 +557,16 @@ OpenClaw додає спільний внесок prompt GPT-5 для запус
|
||||
```
|
||||
|
||||
Пов’язана документація OpenAI:
|
||||
- [Realtime API з WebSocket](https://platform.openai.com/docs/guides/realtime-websocket)
|
||||
- [Потокові відповіді API (SSE)](https://platform.openai.com/docs/guides/streaming-responses)
|
||||
- [Realtime API with WebSocket](https://platform.openai.com/docs/guides/realtime-websocket)
|
||||
- [Streaming API responses (SSE)](https://platform.openai.com/docs/guides/streaming-responses)
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="WebSocket warm-up">
|
||||
OpenClaw типово вмикає WebSocket warm-up для `openai/*`, щоб зменшити затримку першого ходу.
|
||||
<Accordion title="Попередній прогрів WebSocket">
|
||||
OpenClaw типово вмикає попередній прогрів WebSocket для `openai/*`, щоб зменшити затримку першого ходу.
|
||||
|
||||
```json5
|
||||
// Вимкнути warm-up
|
||||
// Вимкнути прогрів
|
||||
{
|
||||
agents: {
|
||||
defaults: {
|
||||
@ -460,13 +584,13 @@ OpenClaw додає спільний внесок prompt GPT-5 для запус
|
||||
|
||||
<a id="openai-fast-mode"></a>
|
||||
|
||||
<Accordion title="Fast mode">
|
||||
OpenClaw надає спільний перемикач fast mode для `openai/*` і `openai-codex/*`:
|
||||
<Accordion title="Швидкий режим">
|
||||
OpenClaw надає спільний перемикач швидкого режиму як для `openai/*`, так і для `openai-codex/*`:
|
||||
|
||||
- **Chat/UI:** `/fast status|on|off`
|
||||
- **Чат/UI:** `/fast status|on|off`
|
||||
- **Конфігурація:** `agents.defaults.models["<provider>/<model>"].params.fastMode`
|
||||
|
||||
Коли режим увімкнено, OpenClaw перетворює fast mode на пріоритетну обробку OpenAI (`service_tier = "priority"`). Наявні значення `service_tier` зберігаються, і fast mode не переписує `reasoning` або `text.verbosity`.
|
||||
Якщо ввімкнено, OpenClaw зіставляє швидкий режим із пріоритетною обробкою OpenAI (`service_tier = "priority"`). Наявні значення `service_tier` зберігаються, а швидкий режим не переписує `reasoning` або `text.verbosity`.
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -482,13 +606,13 @@ OpenClaw додає спільний внесок prompt GPT-5 для запус
|
||||
```
|
||||
|
||||
<Note>
|
||||
Перевизначення на рівні сесії мають пріоритет над конфігурацією. Очищення перевизначення сесії в UI Sessions повертає сесію до типового значення з конфігурації.
|
||||
Перевизначення сеансу мають пріоритет над конфігурацією. Очищення перевизначення сеансу в UI сеансів повертає сеанс до налаштованого типового значення.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Priority processing (service_tier)">
|
||||
API OpenAI надає пріоритетну обробку через `service_tier`. Задайте її для конкретної моделі в OpenClaw:
|
||||
<Accordion title="Пріоритетна обробка (service_tier)">
|
||||
API OpenAI надає пріоритетну обробку через `service_tier`. Установіть її для кожної моделі в OpenClaw:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -506,21 +630,21 @@ OpenClaw додає спільний внесок prompt GPT-5 для запус
|
||||
Підтримувані значення: `auto`, `default`, `flex`, `priority`.
|
||||
|
||||
<Warning>
|
||||
`serviceTier` передається лише до native endpoint OpenAI (`api.openai.com`) і native endpoint Codex (`chatgpt.com/backend-api`). Якщо ви маршрутизуєте будь-якого з цих провайдерів через proxy, OpenClaw залишає `service_tier` без змін.
|
||||
`serviceTier` передається лише до нативних кінцевих точок OpenAI (`api.openai.com`) і нативних кінцевих точок Codex (`chatgpt.com/backend-api`). Якщо ви маршрутизуєте будь-якого з цих провайдерів через проксі, OpenClaw залишає `service_tier` без змін.
|
||||
</Warning>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Server-side compaction (Responses API)">
|
||||
Для прямих моделей OpenAI Responses (`openai/*` на `api.openai.com`) OpenClaw автоматично вмикає server-side Compaction:
|
||||
<Accordion title="Compaction на стороні сервера (Responses API)">
|
||||
Для прямих моделей OpenAI Responses (`openai/*` на `api.openai.com`) OpenClaw автоматично вмикає Compaction на стороні сервера:
|
||||
|
||||
- Примусово задає `store: true` (якщо compat моделі не задає `supportsStore: false`)
|
||||
- Впроваджує `context_management: [{ type: "compaction", compact_threshold: ... }]`
|
||||
- Типовий `compact_threshold`: 70% від `contextWindow` (або `80000`, якщо значення недоступне)
|
||||
- Примусово встановлює `store: true` (якщо compat моделі не задає `supportsStore: false`)
|
||||
- Вставляє `context_management: [{ type: "compaction", compact_threshold: ... }]`
|
||||
- Типове значення `compact_threshold`: 70% від `contextWindow` (або `80000`, якщо значення недоступне)
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Enable explicitly">
|
||||
Корисно для сумісних endpoint, таких як Azure OpenAI Responses:
|
||||
<Tab title="Явно ввімкнути">
|
||||
Корисно для сумісних кінцевих точок, таких як Azure OpenAI Responses:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -536,7 +660,7 @@ OpenClaw додає спільний внесок prompt GPT-5 для запус
|
||||
}
|
||||
```
|
||||
</Tab>
|
||||
<Tab title="Custom threshold">
|
||||
<Tab title="Власний поріг">
|
||||
```json5
|
||||
{
|
||||
agents: {
|
||||
@ -554,7 +678,7 @@ OpenClaw додає спільний внесок prompt GPT-5 для запус
|
||||
}
|
||||
```
|
||||
</Tab>
|
||||
<Tab title="Disable">
|
||||
<Tab title="Вимкнути">
|
||||
```json5
|
||||
{
|
||||
agents: {
|
||||
@ -572,12 +696,12 @@ OpenClaw додає спільний внесок prompt GPT-5 для запус
|
||||
</Tabs>
|
||||
|
||||
<Note>
|
||||
`responsesServerCompaction` керує лише впровадженням `context_management`. Прямі моделі OpenAI Responses все одно примусово використовують `store: true`, якщо compat не задає `supportsStore: false`.
|
||||
`responsesServerCompaction` керує лише вставленням `context_management`. Прямі моделі OpenAI Responses усе одно примусово встановлюють `store: true`, якщо compat не задає `supportsStore: false`.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Strict-agentic GPT mode">
|
||||
<Accordion title="Суворий агентний режим GPT">
|
||||
Для запусків сімейства GPT-5 на `openai/*` і `openai-codex/*` OpenClaw може використовувати суворіший вбудований контракт виконання:
|
||||
|
||||
```json5
|
||||
@ -591,32 +715,32 @@ OpenClaw додає спільний внесок prompt GPT-5 для запус
|
||||
```
|
||||
|
||||
З `strict-agentic` OpenClaw:
|
||||
- Більше не вважає хід лише з планом успішним прогресом, якщо доступна дія через tool
|
||||
- Повторює хід зі спрямуванням діяти негайно
|
||||
- Більше не вважає хід лише з планом успішним прогресом, коли доступна дія інструмента
|
||||
- Повторює хід із вказівкою діяти зараз
|
||||
- Автоматично вмикає `update_plan` для суттєвої роботи
|
||||
- Показує явний заблокований стан, якщо модель і далі планує без дії
|
||||
- Показує явний заблокований стан, якщо модель продовжує планувати без дії
|
||||
|
||||
<Note>
|
||||
Застосовується лише до запусків сімейства GPT-5 OpenAI і Codex. Для інших провайдерів і старіших сімейств моделей зберігається типова поведінка.
|
||||
Поширюється лише на запуски OpenAI і Codex сімейства GPT-5. Для інших провайдерів і старіших сімейств моделей зберігається типова поведінка.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Native vs OpenAI-compatible routes">
|
||||
OpenClaw по-різному обробляє прямі endpoint OpenAI, Codex і Azure OpenAI порівняно з універсальними OpenAI-сумісними proxy `/v1`:
|
||||
<Accordion title="Нативні та OpenAI-сумісні маршрути">
|
||||
OpenClaw по-різному обробляє прямі кінцеві точки OpenAI, Codex і Azure OpenAI порівняно із загальними OpenAI-сумісними проксі `/v1`:
|
||||
|
||||
**Native маршрути** (`openai/*`, `openai-codex/*`, Azure OpenAI):
|
||||
- Зберігають `reasoning: { effort: "none" }` лише для моделей, що підтримують OpenAI `none` effort
|
||||
- Пропускають вимкнений reasoning для моделей або proxy, які відхиляють `reasoning.effort: "none"`
|
||||
- Типово використовують суворий режим для схем tool
|
||||
- Додають приховані заголовки атрибуції лише на перевірених native хостах
|
||||
- Зберігають формування запитів лише для OpenAI (`service_tier`, `store`, сумісність reasoning, підказки кешу prompt)
|
||||
**Нативні маршрути** (`openai/*`, `openai-codex/*`, Azure OpenAI):
|
||||
- Зберігають `reasoning: { effort: "none" }` лише для моделей, які підтримують OpenAI `none` effort
|
||||
- Пропускають вимкнений reasoning для моделей або проксі, які відхиляють `reasoning.effort: "none"`
|
||||
- Типово використовують строгий режим для схем інструментів
|
||||
- Додають приховані заголовки атрибуції лише на перевірених нативних хостах
|
||||
- Зберігають форматування запитів, властиве лише OpenAI (`service_tier`, `store`, reasoning-compat, підказки кешу prompt)
|
||||
|
||||
**Proxy/сумісні маршрути:**
|
||||
- Використовують більш м’яку compat-поведінку
|
||||
- Не примушують до суворих схем tool або native-специфічних заголовків
|
||||
**Проксі/сумісні маршрути:**
|
||||
- Використовують менш сувору compat-поведінку
|
||||
- Не примусово вмикають строгі схеми інструментів або заголовки, притаманні лише нативним маршрутам
|
||||
|
||||
Azure OpenAI використовує native transport і compat-поведінку, але не отримує приховані заголовки атрибуції.
|
||||
Azure OpenAI використовує нативну транспортну та compat-поведінку, але не отримує приховані заголовки атрибуції.
|
||||
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
@ -624,16 +748,16 @@ OpenClaw додає спільний внесок prompt GPT-5 для запус
|
||||
## Пов’язане
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Model selection" href="/uk/concepts/model-providers" icon="layers">
|
||||
<Card title="Вибір моделі" href="/uk/concepts/model-providers" icon="layers">
|
||||
Вибір провайдерів, посилань на моделі та поведінки failover.
|
||||
</Card>
|
||||
<Card title="Image generation" href="/uk/tools/image-generation" icon="image">
|
||||
Спільні параметри tool для зображень і вибір провайдера.
|
||||
<Card title="Генерація зображень" href="/uk/tools/image-generation" icon="image">
|
||||
Спільні параметри інструмента зображень і вибір провайдера.
|
||||
</Card>
|
||||
<Card title="Video generation" href="/uk/tools/video-generation" icon="video">
|
||||
Спільні параметри tool для відео і вибір провайдера.
|
||||
<Card title="Генерація відео" href="/uk/tools/video-generation" icon="video">
|
||||
Спільні параметри інструмента відео і вибір провайдера.
|
||||
</Card>
|
||||
<Card title="OAuth and auth" href="/uk/gateway/authentication" icon="key">
|
||||
Подробиці автентифікації та правила повторного використання облікових даних.
|
||||
<Card title="OAuth і автентифікація" href="/uk/gateway/authentication" icon="key">
|
||||
Відомості про автентифікацію та правила повторного використання облікових даних.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
@ -1,15 +1,15 @@
|
||||
---
|
||||
read_when:
|
||||
- Генерація зображень через агента
|
||||
- Налаштування провайдерів і моделей генерації зображень
|
||||
- Генерування зображень через агента
|
||||
- Налаштування провайдерів і моделей для генерації зображень
|
||||
- Розуміння параметрів інструмента `image_generate`
|
||||
summary: Створюйте та редагуйте зображення за допомогою налаштованих провайдерів (OpenAI, Google Gemini, fal, MiniMax, ComfyUI, Vydra, xAI)
|
||||
summary: Генеруйте та редагуйте зображення за допомогою налаштованих провайдерів (OpenAI, Google Gemini, fal, MiniMax, ComfyUI, Vydra, xAI)
|
||||
title: Генерація зображень
|
||||
x-i18n:
|
||||
generated_at: "2026-04-22T23:11:32Z"
|
||||
generated_at: "2026-04-23T12:50:48Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 228049c74dd3437544cda6418da665aed375c0494ef36a6927d15c28d7783bbd
|
||||
source_hash: 0fbd8eda2cb0867d1426b9349f6778c231051d600ebe451534efbee0e215c871
|
||||
source_path: tools/image-generation.md
|
||||
workflow: 15
|
||||
---
|
||||
@ -19,13 +19,13 @@ x-i18n:
|
||||
Інструмент `image_generate` дає агенту змогу створювати та редагувати зображення за допомогою ваших налаштованих провайдерів. Згенеровані зображення автоматично доставляються як медіавкладення у відповіді агента.
|
||||
|
||||
<Note>
|
||||
Інструмент з’являється, лише коли доступний щонайменше один провайдер генерації зображень. Якщо ви не бачите `image_generate` в інструментах свого агента, налаштуйте `agents.defaults.imageGenerationModel` або задайте API-ключ провайдера.
|
||||
Інструмент з’являється лише тоді, коли доступний принаймні один провайдер генерації зображень. Якщо ви не бачите `image_generate` серед інструментів вашого агента, налаштуйте `agents.defaults.imageGenerationModel` або додайте API-ключ провайдера.
|
||||
</Note>
|
||||
|
||||
## Швидкий старт
|
||||
|
||||
1. Задайте API-ключ принаймні для одного провайдера (наприклад, `OPENAI_API_KEY` або `GEMINI_API_KEY`).
|
||||
2. За бажанням задайте бажану модель:
|
||||
1. Встановіть API-ключ щонайменше для одного провайдера (наприклад, `OPENAI_API_KEY` або `GEMINI_API_KEY`).
|
||||
2. За бажанням вкажіть бажану модель:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -39,21 +39,21 @@ x-i18n:
|
||||
}
|
||||
```
|
||||
|
||||
3. Попросіть агента: _"Згенеруй зображення дружнього маскота-лобстера."_
|
||||
3. Запитайте агента: _"Згенеруй зображення дружнього талісмана-лобстера."_
|
||||
|
||||
Агент автоматично викликає `image_generate`. Додавати інструмент до списку дозволених не потрібно — його ввімкнено за замовчуванням, коли доступний провайдер.
|
||||
Агент автоматично викликає `image_generate`. Дозвільний список інструментів не потрібен — інструмент увімкнений за замовчуванням, коли доступний провайдер.
|
||||
|
||||
## Підтримувані провайдери
|
||||
|
||||
| Провайдер | Модель за замовчуванням | Підтримка редагування | API-ключ |
|
||||
| --------- | -------------------------------- | --------------------------------- | ----------------------------------------------------- |
|
||||
| OpenAI | `gpt-image-2` | Так (до 5 зображень) | `OPENAI_API_KEY` |
|
||||
| Google | `gemini-3.1-flash-image-preview` | Так | `GEMINI_API_KEY` або `GOOGLE_API_KEY` |
|
||||
| fal | `fal-ai/flux/dev` | Так | `FAL_KEY` |
|
||||
| MiniMax | `image-01` | Так (референс суб’єкта) | `MINIMAX_API_KEY` або MiniMax OAuth (`minimax-portal`) |
|
||||
| Провайдер | Модель за замовчуванням | Підтримка редагування | API-ключ |
|
||||
| --------- | -------------------------------- | ---------------------------------- | ----------------------------------------------------- |
|
||||
| OpenAI | `gpt-image-2` | Так (до 5 зображень) | `OPENAI_API_KEY` |
|
||||
| Google | `gemini-3.1-flash-image-preview` | Так | `GEMINI_API_KEY` або `GOOGLE_API_KEY` |
|
||||
| fal | `fal-ai/flux/dev` | Так | `FAL_KEY` |
|
||||
| MiniMax | `image-01` | Так (референс об’єкта) | `MINIMAX_API_KEY` або MiniMax OAuth (`minimax-portal`) |
|
||||
| ComfyUI | `workflow` | Так (1 зображення, налаштовується workflow) | `COMFY_API_KEY` або `COMFY_CLOUD_API_KEY` для хмари |
|
||||
| Vydra | `grok-imagine` | Ні | `VYDRA_API_KEY` |
|
||||
| xAI | `grok-imagine-image` | Так (до 5 зображень) | `XAI_API_KEY` |
|
||||
| Vydra | `grok-imagine` | Ні | `VYDRA_API_KEY` |
|
||||
| xAI | `grok-imagine-image` | Так (до 5 зображень) | `XAI_API_KEY` |
|
||||
|
||||
Використовуйте `action: "list"`, щоб переглянути доступні провайдери та моделі під час виконання:
|
||||
|
||||
@ -71,14 +71,14 @@ x-i18n:
|
||||
| `image` | string | Шлях або URL одного референсного зображення для режиму редагування |
|
||||
| `images` | string[] | Кілька референсних зображень для режиму редагування (до 5) |
|
||||
| `size` | string | Підказка щодо розміру: `1024x1024`, `1536x1024`, `1024x1536`, `2048x2048`, `3840x2160` |
|
||||
| `aspectRatio` | string | Співвідношення сторін: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` |
|
||||
| `aspectRatio`| string | Співвідношення сторін: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` |
|
||||
| `resolution` | string | Підказка щодо роздільної здатності: `1K`, `2K` або `4K` |
|
||||
| `count` | number | Кількість зображень для генерації (1–4) |
|
||||
| `filename` | string | Підказка щодо імені вихідного файла |
|
||||
| `filename` | string | Підказка щодо імені вихідного файлу |
|
||||
|
||||
Не всі провайдери підтримують усі параметри. Коли резервний провайдер підтримує близький геометричний варіант замість точно запитаного, OpenClaw перед надсиланням переналаштовує запит на найближчий підтримуваний розмір, співвідношення сторін або роздільну здатність. Справді непідтримувані перевизначення все одно зазначаються в результаті інструмента.
|
||||
Не всі провайдери підтримують усі параметри. Коли резервний провайдер підтримує близький варіант геометрії замість точно запитаного, OpenClaw перед відправленням переналаштовує значення на найближчий підтримуваний розмір, співвідношення сторін або роздільну здатність. Справді непідтримувані перевизначення все одно вказуються в результаті інструмента.
|
||||
|
||||
Результати інструмента містять застосовані налаштування. Коли OpenClaw переналаштовує геометрію під час резервного переходу між провайдерами, повернуті значення `size`, `aspectRatio` і `resolution` відображають те, що фактично було надіслано, а `details.normalization` фіксує перетворення від запитаного до застосованого.
|
||||
Результати інструмента повідомляють застосовані налаштування. Коли OpenClaw переналаштовує геометрію під час резервного переходу між провайдерами, повернені значення `size`, `aspectRatio` і `resolution` відображають те, що було фактично надіслано, а `details.normalization` фіксує перетворення від запитаного до застосованого.
|
||||
|
||||
## Конфігурація
|
||||
|
||||
@ -101,25 +101,26 @@ x-i18n:
|
||||
|
||||
Під час генерації зображення OpenClaw пробує провайдерів у такому порядку:
|
||||
|
||||
1. Параметр **`model`** з виклику інструмента (якщо агент його вказує)
|
||||
2. **`imageGenerationModel.primary`** із конфігурації
|
||||
1. **Параметр `model`** з виклику інструмента (якщо агент його вказує)
|
||||
2. **`imageGenerationModel.primary`** з конфігурації
|
||||
3. **`imageGenerationModel.fallbacks`** у заданому порядку
|
||||
4. **Автовиявлення** — використовує лише типові значення провайдерів, підкріплені автентифікацією:
|
||||
4. **Автовизначення** — використовує лише типові значення провайдерів, підкріплені автентифікацією:
|
||||
- спочатку поточний провайдер за замовчуванням
|
||||
- далі решта зареєстрованих провайдерів генерації зображень у порядку id провайдера
|
||||
- потім решта зареєстрованих провайдерів генерації зображень у порядку ідентифікаторів провайдерів
|
||||
|
||||
Якщо провайдер не спрацьовує (помилка автентифікації, ліміт запитів тощо), автоматично пробується наступний кандидат. Якщо не спрацьовують усі, помилка міститиме подробиці кожної спроби.
|
||||
Якщо провайдер завершується помилкою (помилка автентифікації, обмеження швидкості тощо), автоматично пробується наступний кандидат. Якщо помиляються всі, помилка містить деталі кожної спроби.
|
||||
|
||||
Примітки:
|
||||
|
||||
- Автовиявлення враховує автентифікацію. Типове значення провайдера потрапляє до списку кандидатів, лише коли OpenClaw справді може автентифікувати цей провайдер.
|
||||
- Автовиявлення ввімкнено за замовчуванням. Задайте
|
||||
- Автовизначення враховує доступність автентифікації. Типове значення провайдера потрапляє до списку кандидатів лише тоді, коли OpenClaw справді може автентифікувати цей провайдер.
|
||||
- Автовизначення увімкнено за замовчуванням. Установіть
|
||||
`agents.defaults.mediaGenerationAutoProviderFallback: false`, якщо хочете, щоб генерація зображень використовувала лише явні записи `model`, `primary` і `fallbacks`.
|
||||
- Використовуйте `action: "list"`, щоб переглянути наразі зареєстрованих провайдерів, їхні типові моделі та підказки щодо auth env vars.
|
||||
- Використовуйте `action: "list"`, щоб переглянути поточно зареєстрованих провайдерів, їхні
|
||||
моделі за замовчуванням і підказки щодо змінних середовища для автентифікації.
|
||||
|
||||
### Редагування зображень
|
||||
|
||||
OpenAI, Google, fal, MiniMax, ComfyUI і xAI підтримують редагування референсних зображень. Передайте шлях або URL референсного зображення:
|
||||
OpenAI, Google, fal, MiniMax, ComfyUI та xAI підтримують редагування референсних зображень. Передайте шлях або URL референсного зображення:
|
||||
|
||||
```
|
||||
"Згенеруй акварельну версію цього фото" + image: "/path/to/photo.jpg"
|
||||
@ -129,14 +130,14 @@ OpenAI, Google і xAI підтримують до 5 референсних зо
|
||||
|
||||
### OpenAI `gpt-image-2`
|
||||
|
||||
Генерація зображень OpenAI за замовчуванням використовує `openai/gpt-image-2`. Старішу модель
|
||||
`openai/gpt-image-1` усе ще можна явно вибрати, але нові запити OpenAI на
|
||||
За замовчуванням генерація зображень OpenAI використовує `openai/gpt-image-2`. Старішу
|
||||
модель `openai/gpt-image-1` усе ще можна явно вибрати, але нові запити OpenAI на
|
||||
генерацію та редагування зображень мають використовувати `gpt-image-2`.
|
||||
|
||||
`gpt-image-2` підтримує як генерацію зображень за текстом, так і редагування
|
||||
`gpt-image-2` підтримує як генерацію зображень із тексту, так і редагування
|
||||
референсних зображень через той самий інструмент `image_generate`. OpenClaw передає в OpenAI `prompt`,
|
||||
`count`, `size` і референсні зображення. OpenAI не отримує
|
||||
`aspectRatio` або `resolution` безпосередньо; коли це можливо, OpenClaw перетворює їх на
|
||||
`aspectRatio` або `resolution` безпосередньо; коли це можливо, OpenClaw відображає їх у
|
||||
підтримуваний `size`, інакше інструмент повідомляє про них як про проігноровані перевизначення.
|
||||
|
||||
Згенерувати одне горизонтальне зображення 4K:
|
||||
@ -163,42 +164,46 @@ OpenAI, Google і xAI підтримують до 5 референсних зо
|
||||
/tool image_generate action=generate model=openai/gpt-image-2 prompt="Combine the character identity from the first image with the color palette from the second" images='["/path/to/character.png","/path/to/palette.jpg"]' size=1536x1024
|
||||
```
|
||||
|
||||
Щоб спрямувати генерацію зображень OpenAI через розгортання Azure OpenAI замість
|
||||
`api.openai.com`, див. [кінцеві точки Azure OpenAI](/uk/providers/openai#azure-openai-endpoints)
|
||||
у документації провайдера OpenAI.
|
||||
|
||||
Генерація зображень MiniMax доступна через обидва вбудовані шляхи автентифікації MiniMax:
|
||||
|
||||
- `minimax/image-01` для налаштувань з API-ключем
|
||||
- `minimax-portal/image-01` для налаштувань з OAuth
|
||||
- `minimax/image-01` для конфігурацій з API-ключем
|
||||
- `minimax-portal/image-01` для конфігурацій з OAuth
|
||||
|
||||
## Можливості провайдерів
|
||||
|
||||
| Можливість | OpenAI | Google | fal | MiniMax | ComfyUI | Vydra | xAI |
|
||||
| --------------------- | -------------------- | -------------------- | ------------------- | -------------------------- | ---------------------------------- | ------- | -------------------- |
|
||||
| Генерація | Так (до 4) | Так (до 4) | Так (до 4) | Так (до 9) | Так (кількість виходів визначається workflow) | Так (1) | Так (до 4) |
|
||||
| Редагування/референс | Так (до 5 зображень) | Так (до 5 зображень) | Так (1 зображення) | Так (1 зображення, референс суб’єкта) | Так (1 зображення, налаштовується workflow) | Ні | Так (до 5 зображень) |
|
||||
| Генерація | Так (до 4) | Так (до 4) | Так (до 4) | Так (до 9) | Так (виходи визначаються workflow) | Так (1) | Так (до 4) |
|
||||
| Редагування/референс | Так (до 5 зображень) | Так (до 5 зображень) | Так (1 зображення) | Так (1 зображення, референс об’єкта) | Так (1 зображення, налаштовується workflow) | Ні | Так (до 5 зображень) |
|
||||
| Керування розміром | Так (до 4K) | Так | Так | Ні | Ні | Ні | Ні |
|
||||
| Співвідношення сторін | Ні | Так | Так (лише генерація) | Так | Ні | Ні | Так |
|
||||
| Роздільна здатність (1K/2K/4K) | Ні | Так | Так | Ні | Ні | Ні | Так (1K/2K) |
|
||||
|
||||
### xAI `grok-imagine-image`
|
||||
|
||||
Вбудований провайдер xAI використовує `/v1/images/generations` для запитів
|
||||
лише з prompt і `/v1/images/edits`, коли присутній `image` або `images`.
|
||||
Вбудований провайдер xAI використовує `/v1/images/generations` для запитів лише з prompt
|
||||
і `/v1/images/edits`, коли присутній `image` або `images`.
|
||||
|
||||
- Моделі: `xai/grok-imagine-image`, `xai/grok-imagine-image-pro`
|
||||
- Кількість: до 4
|
||||
- Референси: один `image` або до п’яти `images`
|
||||
- Співвідношення сторін: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `2:3`, `3:2`
|
||||
- Роздільні здатності: `1K`, `2K`
|
||||
- Роздільна здатність: `1K`, `2K`
|
||||
- Результати: повертаються як вкладення зображень під керуванням OpenClaw
|
||||
|
||||
OpenClaw навмисно не відкриває власні параметри xAI `quality`, `mask`, `user` або
|
||||
додаткові співвідношення сторін, доступні лише нативно, доки ці елементи керування не з’являться в спільному
|
||||
OpenClaw навмисно не відкриває xAI-специфічні `quality`, `mask`, `user` або
|
||||
додаткові співвідношення сторін, доступні лише на рівні xAI, доки ці елементи керування не з’являться в спільному
|
||||
міжпровайдерному контракті `image_generate`.
|
||||
|
||||
## Пов’язане
|
||||
|
||||
- [Огляд інструментів](/uk/tools) — усі доступні інструменти агента
|
||||
- [fal](/uk/providers/fal) — налаштування провайдера зображень і відео fal
|
||||
- [ComfyUI](/uk/providers/comfy) — налаштування локального ComfyUI і workflow Comfy Cloud
|
||||
- [ComfyUI](/uk/providers/comfy) — налаштування локального ComfyUI і Comfy Cloud workflow
|
||||
- [Google (Gemini)](/uk/providers/google) — налаштування провайдера зображень Gemini
|
||||
- [MiniMax](/uk/providers/minimax) — налаштування провайдера зображень MiniMax
|
||||
- [OpenAI](/uk/providers/openai) — налаштування провайдера OpenAI Images
|
||||
|
||||
@ -2,35 +2,35 @@
|
||||
read_when:
|
||||
- Використання або налаштування команд чату
|
||||
- Налагодження маршрутизації команд або дозволів
|
||||
summary: 'Slash-команди: текстові та нативні, конфігурація й підтримувані команди'
|
||||
title: Slash-команди
|
||||
summary: 'Слеш-команди: текстові чи нативні, конфігурація та підтримувані команди'
|
||||
title: Слеш-команди
|
||||
x-i18n:
|
||||
generated_at: "2026-04-23T06:48:54Z"
|
||||
generated_at: "2026-04-23T12:50:53Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 0f6b454afa77cf02b2c307efcc99ef35d002cb560c427affaf03ac12b2b666e8
|
||||
source_hash: 13290dcdf649ae66603a92a0aca68460bb63ff476179cc2dded796aaa841d66c
|
||||
source_path: tools/slash-commands.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Slash-команди
|
||||
# Слеш-команди
|
||||
|
||||
Команди обробляються Gateway. Більшість команд потрібно надсилати як **окреме** повідомлення, що починається з `/`.
|
||||
Команда чату bash, доступна лише на host, використовує `! <cmd>` (із псевдонімом `/bash <cmd>`).
|
||||
Команди обробляє Gateway. Більшість команд потрібно надсилати як **окреме** повідомлення, що починається з `/`.
|
||||
Команда чату bash лише для хоста використовує `! <cmd>` (із псевдонімом `/bash <cmd>`).
|
||||
|
||||
Є дві пов’язані системи:
|
||||
|
||||
- **Команди**: окремі повідомлення `/...`.
|
||||
- **Директиви**: `/think`, `/fast`, `/verbose`, `/trace`, `/reasoning`, `/elevated`, `/exec`, `/model`, `/queue`.
|
||||
- Директиви видаляються з повідомлення до того, як його побачить модель.
|
||||
- У звичайних повідомленнях чату (не лише з директив), вони обробляються як “вбудовані підказки” і **не** зберігають налаштування сесії.
|
||||
- У повідомленнях лише з директивами (повідомлення містить тільки директиви) вони зберігаються в сесії й відповідають підтвердженням.
|
||||
- Директиви застосовуються лише для **авторизованих відправників**. Якщо задано `commands.allowFrom`, використовується лише цей
|
||||
allowlist; інакше авторизація надходить із allowlist каналів/сполучення плюс `commands.useAccessGroups`.
|
||||
Для неавторизованих відправників директиви сприймаються як звичайний текст.
|
||||
- Директиви видаляються з повідомлення до того, як модель його побачить.
|
||||
- У звичайних повідомленнях чату (не лише з директив) вони розглядаються як «вбудовані підказки» і **не** зберігають налаштування сеансу.
|
||||
- У повідомленнях лише з директивами (повідомлення містить тільки директиви) вони зберігаються в сеансі й повертають підтвердження.
|
||||
- Директиви застосовуються лише для **авторизованих відправників**. Якщо задано `commands.allowFrom`, це єдиний використаний
|
||||
список дозволених; інакше авторизація визначається списками дозволених каналу/сполученням плюс `commands.useAccessGroups`.
|
||||
Для неавторизованих відправників директиви обробляються як звичайний текст.
|
||||
|
||||
Також є кілька **вбудованих скорочень** (лише для відправників в allowlist/авторизованих): `/help`, `/commands`, `/status`, `/whoami` (`/id`).
|
||||
Вони виконуються негайно, видаляються до того, як модель побачить повідомлення, а решта тексту проходить звичайним шляхом.
|
||||
Також є кілька **вбудованих скорочень** (лише для відправників зі списку дозволених/авторизованих): `/help`, `/commands`, `/status`, `/whoami` (`/id`).
|
||||
Вони виконуються негайно, видаляються до того, як модель побачить повідомлення, а решта тексту продовжує проходити звичайним шляхом.
|
||||
|
||||
## Конфігурація
|
||||
|
||||
@ -60,110 +60,110 @@ x-i18n:
|
||||
```
|
||||
|
||||
- `commands.text` (типово `true`) вмикає розбір `/...` у повідомленнях чату.
|
||||
- На поверхнях без нативних команд (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams) текстові команди все одно працюють, навіть якщо ви встановите тут `false`.
|
||||
- На поверхнях без нативних команд (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams) текстові команди все одно працюють, навіть якщо встановити це значення в `false`.
|
||||
- `commands.native` (типово `"auto"`) реєструє нативні команди.
|
||||
- Auto: увімкнено для Discord/Telegram; вимкнено для Slack (доки ви не додасте slash-команди); ігнорується для провайдерів без нативної підтримки.
|
||||
- Щоб перевизначити для конкретного провайдера, задайте `channels.discord.commands.native`, `channels.telegram.commands.native` або `channels.slack.commands.native` (bool або `"auto"`).
|
||||
- `false` очищає раніше зареєстровані команди на Discord/Telegram під час запуску. Команди Slack керуються в застосунку Slack і автоматично не видаляються.
|
||||
- `commands.nativeSkills` (типово `"auto"`) реєструє нативно **команди Skills**, коли це підтримується.
|
||||
- Auto: увімкнено для Discord/Telegram; вимкнено для Slack (у Slack потрібне створення окремої slash-команди для кожного Skill).
|
||||
- Щоб перевизначити для конкретного провайдера, задайте `channels.discord.commands.nativeSkills`, `channels.telegram.commands.nativeSkills` або `channels.slack.commands.nativeSkills` (bool або `"auto"`).
|
||||
- `commands.bash` (типово `false`) вмикає `! <cmd>` для запуску команд оболонки host (`/bash <cmd>` — псевдонім; потрібні allowlist у `tools.elevated`).
|
||||
- `commands.bashForegroundMs` (типово `2000`) визначає, скільки часу bash чекає перед переходом у фоновий режим (`0` — одразу у фон).
|
||||
- Auto: увімкнено для Discord/Telegram; вимкнено для Slack (доки ви не додасте слеш-команди); ігнорується для провайдерів без нативної підтримки.
|
||||
- Щоб перевизначити це для конкретного провайдера, задайте `channels.discord.commands.native`, `channels.telegram.commands.native` або `channels.slack.commands.native` (bool або `"auto"`).
|
||||
- `false` очищає раніше зареєстровані команди в Discord/Telegram під час запуску. Команди Slack керуються в застосунку Slack і не видаляються автоматично.
|
||||
- `commands.nativeSkills` (типово `"auto"`) реєструє команди **Skills** нативно, коли це підтримується.
|
||||
- Auto: увімкнено для Discord/Telegram; вимкнено для Slack (у Slack потрібно створювати окрему слеш-команду для кожної навички).
|
||||
- Щоб перевизначити це для конкретного провайдера, задайте `channels.discord.commands.nativeSkills`, `channels.telegram.commands.nativeSkills` або `channels.slack.commands.nativeSkills` (bool або `"auto"`).
|
||||
- `commands.bash` (типово `false`) вмикає `! <cmd>` для виконання команд оболонки хоста (`/bash <cmd>` — псевдонім; потрібні списки дозволених `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` (перевизначення лише для runtime).
|
||||
- `commands.restart` (типово `true`) вмикає `/restart` плюс дії інструментів перезапуску gateway.
|
||||
- `commands.ownerAllowFrom` (необов’язково) задає явний owner allowlist для поверхонь команд/інструментів, доступних лише власнику. Це окремо від `commands.allowFrom`.
|
||||
- Для конкретного каналу `channels.<channel>.commands.enforceOwnerForCommands` (необов’язково, типово `false`) робить так, що команди лише для власника вимагають **ідентичності власника** на цій поверхні. Якщо `true`, відправник має або відповідати розв’язаному кандидату власника (наприклад, запису в `commands.ownerAllowFrom` або нативним метаданим власника провайдера), або мати внутрішню область `operator.admin` на внутрішньому каналі повідомлень. Підстановочний запис у `allowFrom` каналу або порожній/нерозв’язаний список кандидатів власника **не** є достатнім — команди лише для власника на цьому каналі закриваються за принципом fail closed. Залишайте це вимкненим, якщо хочете, щоб команди лише для власника обмежувалися лише через `ownerAllowFrom` і стандартні allowlist команд.
|
||||
- `commands.ownerDisplay` керує тим, як ідентифікатори власників відображаються в системному промпті: `raw` або `hash`.
|
||||
- `commands.ownerDisplaySecret` необов’язково задає HMAC-секрет, що використовується, коли `commands.ownerDisplay="hash"`.
|
||||
- `commands.allowFrom` (необов’язково) задає allowlist для авторизації команд окремо для кожного провайдера. Якщо налаштовано, це
|
||||
єдине джерело авторизації для команд і директив (`commands.useAccessGroups`
|
||||
і allowlist каналів/сполучення ігноруються). Використовуйте `"*"` як глобальне типове значення; ключі конкретних провайдерів мають пріоритет.
|
||||
- `commands.useAccessGroups` (типово `true`) застосовує allowlist/політики до команд, коли `commands.allowFrom` не задано.
|
||||
- `commands.plugins` (типово `false`) вмикає `/plugins` (виявлення/статус plugin-ів, а також встановлення й елементи керування ввімкненням/вимкненням).
|
||||
- `commands.debug` (типово `false`) вмикає `/debug` (перевизначення лише під час виконання).
|
||||
- `commands.restart` (типово `true`) вмикає `/restart`, а також дії інструментів для перезапуску gateway.
|
||||
- `commands.ownerAllowFrom` (необов’язково) задає явний список дозволених для власника для поверхонь команд/інструментів лише для власника. Це окремо від `commands.allowFrom`.
|
||||
- `channels.<channel>.commands.enforceOwnerForCommands` для кожного каналу (необов’язково, типово `false`) змушує команди лише для власника вимагати **ідентичність власника** для виконання на цій поверхні. Якщо `true`, відправник має або відповідати визначеному кандидату у власники (наприклад, запису в `commands.ownerAllowFrom` або нативним метаданим власника провайдера), або мати внутрішню область доступу `operator.admin` на внутрішньому каналі повідомлень. Запис-шаблон у `allowFrom` каналу або порожній/невизначений список кандидатів у власники **не** є достатнім — команди лише для власника на цьому каналі завершуються за принципом fail closed. Залиште це вимкненим, якщо хочете, щоб команди лише для власника обмежувалися лише `ownerAllowFrom` і стандартними списками дозволених для команд.
|
||||
- `commands.ownerDisplay` керує тим, як id власника відображаються в системному запиті: `raw` або `hash`.
|
||||
- `commands.ownerDisplaySecret` необов’язково задає секрет HMAC, який використовується, коли `commands.ownerDisplay="hash"`.
|
||||
- `commands.allowFrom` (необов’язково) задає список дозволених для кожного провайдера для авторизації команд. Якщо налаштовано, це
|
||||
єдине джерело авторизації для команд і директив (списки дозволених каналу/сполучення та `commands.useAccessGroups`
|
||||
ігноруються). Використовуйте `"*"` для глобального типового значення; ключі конкретних провайдерів його перевизначають.
|
||||
- `commands.useAccessGroups` (типово `true`) застосовує списки дозволених/політики до команд, коли `commands.allowFrom` не задано.
|
||||
|
||||
## Список команд
|
||||
|
||||
Поточне джерело істини:
|
||||
|
||||
- core built-ins надходять із `src/auto-reply/commands-registry.shared.ts`
|
||||
- згенеровані dock-команди надходять із `src/auto-reply/commands-registry.data.ts`
|
||||
- команди plugins надходять із викликів `registerCommand()` у Plugin
|
||||
- фактична доступність на вашому Gateway усе одно залежить від прапорців конфігурації, поверхні каналу та встановлених/увімкнених plugins
|
||||
- вбудовані команди core надходять із `src/auto-reply/commands-registry.shared.ts`
|
||||
- згенеровані команди dock надходять із `src/auto-reply/commands-registry.data.ts`
|
||||
- команди plugin-ів надходять із викликів `registerCommand()` у plugin-ах
|
||||
- фактична доступність у вашому gateway усе одно залежить від прапорців конфігурації, поверхні каналу та встановлених/увімкнених plugin-ів
|
||||
|
||||
### Вбудовані core-команди
|
||||
### Вбудовані команди core
|
||||
|
||||
Вбудовані команди, доступні сьогодні:
|
||||
Сьогодні доступні вбудовані команди:
|
||||
|
||||
- `/new [model]` починає нову сесію; `/reset` — псевдонім для скидання.
|
||||
- `/reset soft [message]` зберігає поточний транскрипт, скидає повторно використовувані ідентифікатори сесій бекенда CLI і повторно запускає завантаження startup/system-prompt на місці.
|
||||
- `/compact [instructions]` виконує Compaction контексту сесії. Див. [/concepts/compaction](/uk/concepts/compaction).
|
||||
- `/new [model]` починає новий сеанс; `/reset` — псевдонім скидання.
|
||||
- `/reset soft [message]` зберігає поточний транскрипт, скидає повторно використані id сеансів бекенда CLI та повторно запускає завантаження стартового/системного запиту на місці.
|
||||
- `/compact [instructions]` виконує Compaction контексту сеансу. Див. [/concepts/compaction](/uk/concepts/compaction).
|
||||
- `/stop` перериває поточний запуск.
|
||||
- `/session idle <duration|off>` і `/session max-age <duration|off>` керують строком дії прив’язки до треду.
|
||||
- `/think <level>` задає рівень thinking. Варіанти надходять із профілю провайдера активної моделі; поширені рівні — `off`, `minimal`, `low`, `medium` і `high`, а також custom-рівні на кшталт `xhigh`, `adaptive`, `max` або бінарне `on` лише там, де це підтримується. Псевдоніми: `/thinking`, `/t`.
|
||||
- `/session idle <duration|off>` і `/session max-age <duration|off>` керують строком дії прив’язки до гілки.
|
||||
- `/think <level>` задає рівень мислення. Варіанти надходять із профілю провайдера активної моделі; поширені рівні: `off`, `minimal`, `low`, `medium` і `high`, а також спеціальні рівні на кшталт `xhigh`, `adaptive`, `max` або двійкове `on` лише там, де це підтримується. Псевдоніми: `/thinking`, `/t`.
|
||||
- `/verbose on|off|full` перемикає докладний вивід. Псевдонім: `/v`.
|
||||
- `/trace on|off` перемикає вивід трасування Plugin для поточної сесії.
|
||||
- `/trace on|off` перемикає вивід трасування plugin-ів для поточного сеансу.
|
||||
- `/fast [status|on|off]` показує або задає швидкий режим.
|
||||
- `/reasoning [on|off|stream]` перемикає видимість reasoning. Псевдонім: `/reason`.
|
||||
- `/elevated [on|off|ask|full]` перемикає підвищений режим. Псевдонім: `/elev`.
|
||||
- `/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>` показує або задає типові параметри exec.
|
||||
- `/elevated [on|off|ask|full]` перемикає elevated mode. Псевдонім: `/elev`.
|
||||
- `/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>` показує або задає типові значення exec.
|
||||
- `/model [name|#|status]` показує або задає модель.
|
||||
- `/models [provider] [page] [limit=<n>|size=<n>|all]` перелічує провайдерів або моделі для провайдера.
|
||||
- `/queue <mode>` керує поведінкою черги (`steer`, `interrupt`, `followup`, `collect`, `steer-backlog`) плюс параметрами на кшталт `debounce:2s cap:25 drop:summarize`.
|
||||
- `/help` показує короткий довідковий підсумок.
|
||||
- `/models [provider] [page] [limit=<n>|size=<n>|all]` показує список провайдерів або моделей для провайдера.
|
||||
- `/queue <mode>` керує поведінкою черги (`steer`, `interrupt`, `followup`, `collect`, `steer-backlog`), а також параметрами на кшталт `debounce:2s cap:25 drop:summarize`.
|
||||
- `/help` показує короткий підсумок довідки.
|
||||
- `/commands` показує згенерований каталог команд.
|
||||
- `/tools [compact|verbose]` показує, що поточний агент може використовувати прямо зараз.
|
||||
- `/status` показує стан runtime, включно з usage/quota провайдера, коли це доступно.
|
||||
- `/tasks` перелічує активні/недавні фонові задачі для поточної сесії.
|
||||
- `/status` показує статус середовища виконання, включно з мітками `Runtime`/`Runner` і використанням/квотою провайдера, якщо доступно.
|
||||
- `/tasks` показує список активних/нещодавніх фонових завдань для поточного сеансу.
|
||||
- `/context [list|detail|json]` пояснює, як збирається контекст.
|
||||
- `/export-session [path]` експортує поточну сесію в HTML. Псевдонім: `/export`.
|
||||
- `/export-trajectory [path]` експортує JSONL [trajectory bundle](/uk/tools/trajectory) для поточної сесії. Псевдонім: `/trajectory`.
|
||||
- `/export-session [path]` експортує поточний сеанс в HTML. Псевдонім: `/export`.
|
||||
- `/export-trajectory [path]` експортує JSONL [trajectory bundle](/uk/tools/trajectory) для поточного сеансу. Псевдонім: `/trajectory`.
|
||||
- `/whoami` показує ваш id відправника. Псевдонім: `/id`.
|
||||
- `/skill <name> [input]` запускає Skill за назвою.
|
||||
- `/allowlist [list|add|remove] ...` керує записами allowlist. Лише текстова команда.
|
||||
- `/approve <id> <decision>` розв’язує запити схвалення exec.
|
||||
- `/btw <question>` ставить побічне запитання без зміни майбутнього контексту сесії. Див. [/tools/btw](/uk/tools/btw).
|
||||
- `/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 і параметрами runtime.
|
||||
- `/focus <target>` прив’язує поточний тред Discord або тему/розмову Telegram до цілі сесії.
|
||||
- `/skill <name> [input]` запускає навичку за назвою.
|
||||
- `/allowlist [list|add|remove] ...` керує записами списку дозволених. Лише текстовий режим.
|
||||
- `/approve <id> <decision>` обробляє запити на підтвердження exec.
|
||||
- `/btw <question>` ставить побічне запитання без зміни майбутнього контексту сеансу. Див. [/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 та параметрами середовища виконання.
|
||||
- `/focus <target>` прив’язує поточну гілку Discord або тему/розмову Telegram до цільового сеансу.
|
||||
- `/unfocus` видаляє поточну прив’язку.
|
||||
- `/agents` перелічує агентів, прив’язаних до треду, для поточної сесії.
|
||||
- `/kill <id|#|all>` перериває один або всі запущені sub-agent.
|
||||
- `/steer <id|#> <message>` надсилає керування запущеному sub-agent. Псевдонім: `/tell`.
|
||||
- `/agents` показує список агентів, прив’язаних до гілки, для поточного сеансу.
|
||||
- `/kill <id|#|all>` перериває один або всі запущені субагенти.
|
||||
- `/steer <id|#> <message>` надсилає керування запущеному субагенту. Псевдонім: `/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` керує перевизначеннями конфігурації лише для runtime. Лише для власника. Потрібно `commands.debug: true`.
|
||||
- `/usage off|tokens|full|cost` керує нижнім колонтитулом usage для кожної відповіді або виводить локальний підсумок вартості.
|
||||
- `/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`, щоб вимкнути.
|
||||
- `/restart` перезапускає OpenClaw, якщо цю команду ввімкнено. Типово: увімкнено; задайте `commands.restart: false`, щоб вимкнути її.
|
||||
- `/activation mention|always` задає режим активації групи.
|
||||
- `/send on|off|inherit` задає політику надсилання. Лише для власника.
|
||||
- `/bash <command>` запускає команду оболонки host. Лише текстова команда. Псевдонім: `! <command>`. Потрібно `commands.bash: true` плюс allowlist у `tools.elevated`.
|
||||
- `!poll [sessionId]` перевіряє фонову задачу bash.
|
||||
- `!stop [sessionId]` зупиняє фонову задачу bash.
|
||||
- `/bash <command>` виконує команду оболонки хоста. Лише текстовий режим. Псевдонім: `! <command>`. Потрібно `commands.bash: true` плюс списки дозволених `tools.elevated`.
|
||||
- `!poll [sessionId]` перевіряє фонове завдання bash.
|
||||
- `!stop [sessionId]` зупиняє фонове завдання bash.
|
||||
|
||||
### Згенеровані dock-команди
|
||||
|
||||
Dock-команди генеруються з channel plugins із підтримкою нативних команд. Поточний вбудований набір:
|
||||
Dock-команди генеруються з plugin-ів каналів із підтримкою нативних команд. Поточний вбудований набір:
|
||||
|
||||
- `/dock-discord` (псевдонім: `/dock_discord`)
|
||||
- `/dock-mattermost` (псевдонім: `/dock_mattermost`)
|
||||
- `/dock-slack` (псевдонім: `/dock_slack`)
|
||||
- `/dock-telegram` (псевдонім: `/dock_telegram`)
|
||||
|
||||
### Команди вбудованих plugins
|
||||
### Команди вбудованих plugin-ів
|
||||
|
||||
Вбудовані plugins можуть додавати більше slash-команд. Поточні вбудовані команди в цьому репозиторії:
|
||||
Вбудовані plugin-и можуть додавати більше слеш-команд. Поточні вбудовані команди в цьому репозиторії:
|
||||
|
||||
- `/dreaming [on|off|status|help]` перемикає Dreaming пам’яті. Див. [Dreaming](/uk/concepts/dreaming).
|
||||
- `/pair [qr|status|pending|approve|cleanup|notify]` керує процесом сполучення/налаштування пристрою. Див. [Pairing](/uk/channels/pairing).
|
||||
- `/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 <camera|screen|writes|all> [duration]|disarm` тимчасово озброює високоризикові команди phone node.
|
||||
- `/voice status|list [limit]|set <voiceId|name>` керує конфігурацією голосу Talk. У Discord нативна назва команди — `/talkvoice`.
|
||||
- `/card ...` надсилає попередньо налаштовані rich card для LINE. Див. [LINE](/uk/channels/line).
|
||||
- `/codex status|models|threads|resume|compact|review|account|mcp|skills` переглядає й керує вбудованим harness app-server Codex. Див. [Codex Harness](/uk/plugins/codex-harness).
|
||||
- `/voice status|list [limit]|set <voiceId|name>` керує конфігурацією голосу Talk. У Discord назва нативної команди — `/talkvoice`.
|
||||
- `/card ...` надсилає набори rich card LINE. Див. [LINE](/uk/channels/line).
|
||||
- `/codex status|models|threads|resume|compact|review|account|mcp|skills` перевіряє та керує вбудованим harness app-server Codex. Див. [Codex Harness](/uk/plugins/codex-harness).
|
||||
- Команди лише для QQBot:
|
||||
- `/bot-ping`
|
||||
- `/bot-version`
|
||||
@ -171,73 +171,74 @@ Dock-команди генеруються з channel plugins із підтри
|
||||
- `/bot-upgrade`
|
||||
- `/bot-logs`
|
||||
|
||||
### Динамічні команди Skills
|
||||
### Динамічні команди навичок
|
||||
|
||||
Skills, які може викликати користувач, також доступні як slash-команди:
|
||||
Навички, які може викликати користувач, також доступні як слеш-команди:
|
||||
|
||||
- `/skill <name> [input]` завжди працює як універсальна точка входу.
|
||||
- Skills також можуть з’являтися як прямі команди, наприклад `/prose`, коли Skill/Plugin їх реєструє.
|
||||
- Реєстрація нативних команд Skills керується через `commands.nativeSkills` і `channels.<provider>.commands.nativeSkills`.
|
||||
- навички також можуть з’являтися як прямі команди на кшталт `/prose`, коли навичка/plugin їх реєструє.
|
||||
- реєстрацією нативних команд навичок керують `commands.nativeSkills` і `channels.<provider>.commands.nativeSkills`.
|
||||
|
||||
Примітки:
|
||||
|
||||
- Команди приймають необов’язковий `:` між командою й аргументами (наприклад, `/think: high`, `/send: on`, `/help:`).
|
||||
- `/new <model>` приймає псевдонім моделі, `provider/model` або назву провайдера (fuzzy match); якщо збігу немає, текст обробляється як тіло повідомлення.
|
||||
- Для повної деталізації usage провайдера використовуйте `openclaw status --usage`.
|
||||
- Команди приймають необов’язковий символ `:` між командою та аргументами (наприклад, `/think: high`, `/send: on`, `/help:`).
|
||||
- `/new <model>` приймає псевдонім моделі, `provider/model` або назву провайдера (нечіткий збіг); якщо збігу немає, текст обробляється як тіло повідомлення.
|
||||
- Для повного розподілу використання провайдера використовуйте `openclaw status --usage`.
|
||||
- `/allowlist add|remove` потребує `commands.config=true` і враховує `configWrites` каналу.
|
||||
- У каналах із кількома обліковими записами `/allowlist --account <id>` і `/config set channels.<provider>.accounts.<id>...`, націлені на конфігурацію, також враховують `configWrites` цільового облікового запису.
|
||||
- `/usage` керує нижнім колонтитулом usage для кожної відповіді; `/usage cost` виводить локальний підсумок вартості з журналів сесій OpenClaw.
|
||||
- `/restart` типово ввімкнено; установіть `commands.restart: false`, щоб вимкнути його.
|
||||
- `/plugins install <spec>` приймає ті самі специфікації Plugin, що й `openclaw plugins install`: локальний шлях/архів, npm-пакет або `clawhub:<pkg>`.
|
||||
- `/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`).
|
||||
- Довідник команд ACP і поведінка runtime: [ACP Agents](/uk/tools/acp-agents).
|
||||
- У каналах із кількома обліковими записами команди `/allowlist --account <id>`, націлені на конфігурацію, і `/config set channels.<provider>.accounts.<id>...` також враховують `configWrites` цільового облікового запису.
|
||||
- `/usage` керує нижнім колонтитулом використання для кожної відповіді; `/usage cost` виводить локальний підсумок вартості з журналів сеансів OpenClaw.
|
||||
- `/restart` увімкнено типово; задайте `commands.restart: false`, щоб вимкнути його.
|
||||
- `/plugins install <spec>` приймає ті самі специфікації plugin-ів, що й `openclaw plugins install`: локальний шлях/архів, npm-пакет або `clawhub:<pkg>`.
|
||||
- `/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`).
|
||||
- Довідка з команд ACP і поведінка середовища виконання: [ACP Agents](/uk/tools/acp-agents).
|
||||
- `/verbose` призначено для налагодження та додаткової видимості; у звичайному використанні тримайте його **вимкненим**.
|
||||
- `/trace` вужчий, ніж `/verbose`: він показує лише рядки трасування/налагодження, що належать Plugin, і залишає звичайний докладний вивід інструментів вимкненим.
|
||||
- `/fast on|off` зберігає перевизначення для сесії. Використовуйте опцію `inherit` у UI Sessions, щоб очистити його й повернутися до типових значень конфігурації.
|
||||
- `/fast` залежить від провайдера: OpenAI/OpenAI Codex зіставляють його з `service_tier=priority` на нативних endpoint Responses, тоді як прямі публічні запити Anthropic, включно з трафіком через OAuth, надісланим до `api.anthropic.com`, зіставляють його з `service_tier=auto` або `standard_only`. Див. [OpenAI](/uk/providers/openai) і [Anthropic](/uk/providers/anthropic).
|
||||
- Підсумки збоїв інструментів, як і раніше, показуються, коли це доречно, але детальний текст збоїв включається лише тоді, коли `/verbose` має значення `on` або `full`.
|
||||
- `/reasoning`, `/verbose` і `/trace` є ризикованими в групових середовищах: вони можуть розкрити внутрішнє reasoning, вивід інструментів або діагностику Plugin, які ви не мали наміру показувати. Краще залишати їх вимкненими, особливо в групових чатах.
|
||||
- `/model` негайно зберігає нову модель сесії.
|
||||
- Якщо агент простоює, наступний запуск одразу її використовує.
|
||||
- Якщо запуск уже активний, OpenClaw позначає live-перемикання як очікуване й перезапускається в нову модель лише в чистій точці повтору.
|
||||
- Якщо активність інструментів або вивід відповіді вже почалися, очікуване перемикання може залишатися в черзі до пізнішої можливості повтору або до наступного ходу користувача.
|
||||
- **Швидкий шлях:** повідомлення лише з командами від відправників в allowlist обробляються негайно (обхід черги + моделі).
|
||||
- **Вимога згадування в групі:** повідомлення лише з командами від відправників в allowlist обходять вимоги згадування.
|
||||
- **Вбудовані скорочення (лише для відправників в allowlist):** деякі команди також працюють, коли вбудовані у звичайне повідомлення, і видаляються до того, як модель побачить решту тексту.
|
||||
- Приклад: `hey /status` запускає відповідь зі статусом, а решта тексту проходить звичайним шляхом.
|
||||
- `/trace` вужчий за `/verbose`: він показує лише рядки трасування/налагодження, що належать plugin-ам, і не вмикає звичайний докладний вивід інструментів.
|
||||
- `/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` і `/trace` ризиковані в групових налаштуваннях: вони можуть розкрити внутрішнє reasoning, вивід інструментів або діагностику plugin-ів, які ви не планували показувати. Краще залишати їх вимкненими, особливо в групових чатах.
|
||||
- `/model` одразу зберігає нову модель сеансу.
|
||||
- Якщо агент неактивний, наступний запуск використає її одразу.
|
||||
- Якщо запуск уже активний, OpenClaw позначає перемикання «на льоту» як відкладене й перезапускає з новою моделлю лише в чистій точці повторної спроби.
|
||||
- Якщо активність інструментів або вивід відповіді вже почалися, відкладене перемикання може залишатися в черзі до пізнішої можливості повторної спроби або до наступного ходу користувача.
|
||||
- **Швидкий шлях:** повідомлення лише з командами від відправників зі списку дозволених обробляються негайно (в обхід черги й моделі).
|
||||
- **Фільтрація згадок у групах:** повідомлення лише з командами від відправників зі списку дозволених обходять вимоги щодо згадки.
|
||||
- **Вбудовані скорочення (лише для відправників зі списку дозволених):** деякі команди також працюють, коли вбудовані у звичайне повідомлення, і видаляються до того, як модель побачить решту тексту.
|
||||
- Приклад: `hey /status` викликає відповідь зі статусом, а решта тексту продовжує проходити звичайним шляхом.
|
||||
- Наразі: `/help`, `/commands`, `/status`, `/whoami` (`/id`).
|
||||
- Неавторизовані повідомлення лише з командами тихо ігноруються, а вбудовані токени `/...` обробляються як звичайний текст.
|
||||
- **Команди Skills:** Skills із `user-invocable` доступні як slash-команди. Назви санітизуються до `a-z0-9_` (макс. 32 символи); у разі колізій додаються числові суфікси (наприклад, `_2`).
|
||||
- `/skill <name> [input]` запускає Skill за назвою (корисно, коли обмеження нативних команд не дозволяють окремі команди для кожного Skill).
|
||||
- Типово команди Skills пересилаються моделі як звичайний запит.
|
||||
- Skills можуть необов’язково оголошувати `command-dispatch: tool`, щоб маршрутизувати команду безпосередньо до інструмента (детерміновано, без моделі).
|
||||
- Приклад: `/prose` (Plugin OpenProse) — див. [OpenProse](/uk/prose).
|
||||
- **Аргументи нативних команд:** Discord використовує autocomplete для динамічних параметрів (і кнопкові меню, якщо ви пропускаєте обов’язкові аргументи). Telegram і Slack показують кнопкове меню, коли команда підтримує варіанти й ви пропускаєте аргумент.
|
||||
- **Команди навичок:** навички з `user-invocable` також доступні як слеш-команди. Назви очищуються до `a-z0-9_` (максимум 32 символи); у разі колізій додаються числові суфікси (наприклад, `_2`).
|
||||
- `/skill <name> [input]` запускає навичку за назвою (корисно, коли обмеження нативних команд не дозволяють мати окрему команду для кожної навички).
|
||||
- Типово команди навичок пересилаються моделі як звичайний запит.
|
||||
- Навички можуть за бажанням оголошувати `command-dispatch: tool`, щоб маршрутизувати команду безпосередньо до інструмента (детерміновано, без моделі).
|
||||
- Приклад: `/prose` (plugin OpenProse) — див. [OpenProse](/uk/prose).
|
||||
- **Аргументи нативних команд:** Discord використовує автодоповнення для динамічних параметрів (і кнопкові меню, коли ви пропускаєте обов’язкові аргументи). Telegram і Slack показують кнопкове меню, коли команда підтримує варіанти вибору, а ви пропускаєте аргумент.
|
||||
|
||||
## `/tools`
|
||||
|
||||
`/tools` відповідає на запитання runtime, а не конфігурації: **що цей агент може використовувати прямо зараз у
|
||||
`/tools` відповідає на запитання про середовище виконання, а не про конфігурацію: **що цей агент може використовувати прямо зараз у
|
||||
цій розмові**.
|
||||
|
||||
- Типовий `/tools` — компактний і оптимізований для швидкого перегляду.
|
||||
- Типове `/tools` компактне й оптимізоване для швидкого перегляду.
|
||||
- `/tools verbose` додає короткі описи.
|
||||
- Поверхні нативних команд, що підтримують аргументи, надають той самий перемикач режиму `compact|verbose`.
|
||||
- Результати прив’язані до сесії, тому зміна агента, каналу, треду, авторизації відправника або моделі може
|
||||
- Поверхні з нативними командами, що підтримують аргументи, надають той самий перемикач режиму `compact|verbose`.
|
||||
- Результати прив’язані до сеансу, тож зміна агента, каналу, гілки, авторизації відправника або моделі може
|
||||
змінити вивід.
|
||||
- `/tools` включає інструменти, які справді доступні під час runtime, включно з core-інструментами, підключеними
|
||||
інструментами Plugin і інструментами, що належать каналу.
|
||||
- `/tools` включає інструменти, які реально доступні під час виконання, зокрема core tools, підключені
|
||||
інструменти plugin-ів і інструменти, що належать каналу.
|
||||
|
||||
Для редагування профілів і перевизначень використовуйте панель Tools у Control UI або поверхні конфігурації/каталогу,
|
||||
а не сприймайте `/tools` як статичний каталог.
|
||||
Для редагування профілів і перевизначень використовуйте панель Tools в інтерфейсі Control або поверхні конфігурації/каталогу,
|
||||
а не ставтеся до `/tools` як до статичного каталогу.
|
||||
|
||||
## Поверхні usage (що де показується)
|
||||
## Поверхні використання (що й де показується)
|
||||
|
||||
- **Usage/quota провайдера** (наприклад: “Claude 80% left”) відображається в `/status` для поточного провайдера моделі, коли відстеження usage увімкнено. OpenClaw нормалізує вікна провайдера до `% left`; для MiniMax поля percent лише із залишком інвертуються перед відображенням, а відповіді `model_remains` надають перевагу запису chat-model плюс мітці плану з міткою моделі.
|
||||
- **Рядки token/cache** у `/status` можуть використовувати останній запис usage з транскрипту, якщо live-знімок сесії бідний на дані. Наявні ненульові live-значення все одно мають пріоритет, а резервний варіант із транскрипту також може відновити мітку активної runtime-моделі плюс більший загальний обсяг, орієнтований на промпт, коли збережені підсумки відсутні або менші.
|
||||
- **Токени/вартість для кожної відповіді** керуються через `/usage off|tokens|full` (додаються до звичайних відповідей).
|
||||
- `/model status` стосується **моделей/автентифікації/endpoint**, а не usage.
|
||||
- **Використання/квота провайдера** (наприклад: “Claude 80% left”) показується в `/status` для провайдера поточної моделі, коли відстеження використання ввімкнено. OpenClaw нормалізує вікна провайдерів до `% left`; для MiniMax відсоткові поля лише із залишком інвертуються перед показом, а відповіді `model_remains` надають перевагу запису chat-моделі плюс мітці плану з тегом моделі.
|
||||
- **Рядки токенів/кешу** в `/status` можуть повертатися до останнього запису використання в транскрипті, коли поточний знімок сеансу містить мало даних. Наявні ненульові поточні значення все одно мають пріоритет, а резервний варіант із транскрипту також може відновити мітку активної runtime-моделі плюс більший загальний показник, орієнтований на запит, коли збережені підсумки відсутні або менші.
|
||||
- **Runtime проти runner:** `/status` повідомляє `Runtime` для ефективного шляху виконання та стану sandbox, а `Runner` — для того, хто фактично виконує сеанс: вбудований Pi, провайдер із бекендом CLI чи harness/бекенд ACP.
|
||||
- **Токени/вартість для кожної відповіді** контролюються через `/usage off|tokens|full` (додається до звичайних відповідей).
|
||||
- `/model status` стосується **моделей/автентифікації/endpoints**, а не використання.
|
||||
|
||||
## Вибір моделі (`/model`)
|
||||
|
||||
@ -257,13 +258,13 @@ Skills, які може викликати користувач, також до
|
||||
Примітки:
|
||||
|
||||
- `/model` і `/model list` показують компактний нумерований вибір (сімейство моделей + доступні провайдери).
|
||||
- У Discord `/model` і `/models` відкривають інтерактивний вибір із випадними списками провайдера й моделі та кроком Submit.
|
||||
- `/model <#>` вибирає з цього списку (і по можливості віддає перевагу поточному провайдеру).
|
||||
- `/model status` показує детальний вигляд, включно з налаштованим endpoint провайдера (`baseUrl`) і режимом API (`api`), коли це доступно.
|
||||
- У Discord `/model` і `/models` відкривають інтерактивний вибір зі списками провайдерів і моделей плюс кроком Submit.
|
||||
- `/model <#>` вибирає зі списку цього вибору (і за можливості надає перевагу поточному провайдеру).
|
||||
- `/model status` показує докладний вигляд, включно з налаштованим endpoint провайдера (`baseUrl`) і режимом API (`api`), якщо доступно.
|
||||
|
||||
## Перевизначення debug
|
||||
## Перевизначення налагодження
|
||||
|
||||
`/debug` дає змогу задавати **перевизначення конфігурації лише для runtime** (пам’ять, не диск). Лише для власника. Типово вимкнено; увімкніть через `commands.debug: true`.
|
||||
`/debug` дає змогу задавати **перевизначення конфігурації лише під час виконання** (пам’ять, не диск). Лише для власника. Типово вимкнено; увімкніть через `commands.debug: true`.
|
||||
|
||||
Приклади:
|
||||
|
||||
@ -277,12 +278,12 @@ Skills, які може викликати користувач, також до
|
||||
|
||||
Примітки:
|
||||
|
||||
- Перевизначення застосовуються негайно до нових читань конфігурації, але **не** записуються в `openclaw.json`.
|
||||
- Перевизначення застосовуються одразу до нових читань конфігурації, але **не** записуються в `openclaw.json`.
|
||||
- Використовуйте `/debug reset`, щоб очистити всі перевизначення й повернутися до конфігурації на диску.
|
||||
|
||||
## Вивід трасування Plugin
|
||||
## Вивід трасування plugin-ів
|
||||
|
||||
`/trace` дає змогу перемикати **рядки трасування/налагодження Plugin у межах сесії** без увімкнення повного verbose-режиму.
|
||||
`/trace` дає змогу перемикати **рядки трасування/налагодження plugin-ів на рівні сеансу** без увімкнення повного докладного режиму.
|
||||
|
||||
Приклади:
|
||||
|
||||
@ -294,12 +295,12 @@ Skills, які може викликати користувач, також до
|
||||
|
||||
Примітки:
|
||||
|
||||
- `/trace` без аргументу показує поточний стан трасування для сесії.
|
||||
- `/trace on` вмикає рядки трасування Plugin для поточної сесії.
|
||||
- `/trace` без аргументів показує поточний стан трасування для сеансу.
|
||||
- `/trace on` вмикає рядки трасування plugin-ів для поточного сеансу.
|
||||
- `/trace off` знову їх вимикає.
|
||||
- Рядки трасування Plugin можуть з’являтися в `/status` і як діагностичне повідомлення-продовження після звичайної відповіді помічника.
|
||||
- `/trace` не замінює `/debug`; `/debug`, як і раніше, керує перевизначеннями конфігурації лише для runtime.
|
||||
- `/trace` не замінює `/verbose`; звичайний докладний вивід інструментів/статусу, як і раніше, належить `/verbose`.
|
||||
- Рядки трасування plugin-ів можуть з’являтися в `/status` і як додаткове діагностичне повідомлення після звичайної відповіді помічника.
|
||||
- `/trace` не замінює `/debug`; `/debug` і далі керує перевизначеннями конфігурації лише під час виконання.
|
||||
- `/trace` не замінює `/verbose`; звичайний докладний вивід інструментів/статусу й далі належить до `/verbose`.
|
||||
|
||||
## Оновлення конфігурації
|
||||
|
||||
@ -317,8 +318,8 @@ Skills, які може викликати користувач, також до
|
||||
|
||||
Примітки:
|
||||
|
||||
- Перед записом конфігурація проходить валідацію; недійсні зміни відхиляються.
|
||||
- Оновлення `/config` зберігаються після перезапусків.
|
||||
- Конфігурація перевіряється перед записом; невалідні зміни відхиляються.
|
||||
- Оновлення `/config` зберігаються після перезапуску.
|
||||
|
||||
## Оновлення MCP
|
||||
|
||||
@ -336,11 +337,11 @@ Skills, які може викликати користувач, також до
|
||||
Примітки:
|
||||
|
||||
- `/mcp` зберігає конфігурацію в конфігурації OpenClaw, а не в налаштуваннях проєкту, якими володіє Pi.
|
||||
- Які саме транспорти реально можна виконувати, вирішують runtime adapters.
|
||||
- Runtime-адаптери вирішують, які транспорти реально можна виконати.
|
||||
|
||||
## Оновлення Plugin
|
||||
## Оновлення plugin-ів
|
||||
|
||||
`/plugins` дає змогу операторам переглядати знайдені plugins і перемикати ввімкнення в конфігурації. Для сценаріїв лише на читання можна використовувати `/plugin` як псевдонім. Типово вимкнено; увімкніть через `commands.plugins: true`.
|
||||
`/plugins` дає операторам змогу перевіряти виявлені plugin-и й перемикати стан увімкнення в конфігурації. Потоки лише для читання можуть використовувати `/plugin` як псевдонім. Типово вимкнено; увімкніть через `commands.plugins: true`.
|
||||
|
||||
Приклади:
|
||||
|
||||
@ -354,41 +355,41 @@ Skills, які може викликати користувач, також до
|
||||
|
||||
Примітки:
|
||||
|
||||
- `/plugins list` і `/plugins show` використовують реальне виявлення plugins у поточному робочому просторі плюс конфігурацію на диску.
|
||||
- `/plugins enable|disable` оновлює лише конфігурацію Plugin; він не встановлює і не видаляє plugins.
|
||||
- Після змін `enable`/`disable` перезапустіть gateway, щоб застосувати їх.
|
||||
- `/plugins list` і `/plugins show` використовують реальне виявлення plugin-ів у поточному робочому просторі разом із конфігурацією на диску.
|
||||
- `/plugins enable|disable` оновлює лише конфігурацію plugin-ів; команди не встановлюють і не видаляють plugin-и.
|
||||
- Після змін enable/disable перезапустіть gateway, щоб застосувати їх.
|
||||
|
||||
## Примітки щодо поверхонь
|
||||
## Примітки про поверхні
|
||||
|
||||
- **Текстові команди** працюють у звичайній чат-сесії (DM спільно використовують `main`, групи мають власну сесію).
|
||||
- **Нативні команди** використовують ізольовані сесії:
|
||||
- **Текстові команди** виконуються в звичайному сеансі чату (DM використовують `main`, групи мають власний сеанс).
|
||||
- **Нативні команди** використовують ізольовані сеанси:
|
||||
- Discord: `agent:<agentId>:discord:slash:<userId>`
|
||||
- Slack: `agent:<agentId>:slack:slash:<userId>` (префікс налаштовується через `channels.slack.slashCommand.sessionPrefix`)
|
||||
- Telegram: `telegram:slash:<userId>` (націлюється на чат-сесію через `CommandTargetSessionKey`)
|
||||
- **`/stop`** націлюється на активну чат-сесію, щоб перервати поточний запуск.
|
||||
- **Slack:** `channels.slack.slashCommand` усе ще підтримується для однієї команди у стилі `/openclaw`. Якщо ви вмикаєте `commands.native`, потрібно створити по одній slash-команді Slack для кожної built-in команди (з тими самими назвами, що й `/help`). Меню аргументів команд для Slack доставляються як ефемерні кнопки Block Kit.
|
||||
- Виняток для нативної команди Slack: зареєструйте `/agentstatus` (а не `/status`), оскільки Slack резервує `/status`. Текстовий `/status` у повідомленнях Slack усе одно працює.
|
||||
- Telegram: `telegram:slash:<userId>` (націлюється на сеанс чату через `CommandTargetSessionKey`)
|
||||
- **`/stop`** націлюється на активний сеанс чату, щоб можна було перервати поточний запуск.
|
||||
- **Slack:** `channels.slack.slashCommand` усе ще підтримується для однієї команди стилю `/openclaw`. Якщо ви вмикаєте `commands.native`, потрібно створити одну слеш-команду Slack для кожної вбудованої команди (з тими самими назвами, що й `/help`). Меню аргументів команд для Slack доставляються як ефемерні кнопки Block Kit.
|
||||
- Нативний виняток Slack: зареєструйте `/agentstatus` (а не `/status`), бо Slack резервує `/status`. Текстова `/status` у повідомленнях Slack усе одно працює.
|
||||
|
||||
## Побічні запитання BTW
|
||||
|
||||
`/btw` — це швидке **побічне запитання** про поточну сесію.
|
||||
`/btw` — це швидке **побічне запитання** про поточний сеанс.
|
||||
|
||||
На відміну від звичайного чату:
|
||||
|
||||
- воно використовує поточну сесію як фоновий контекст,
|
||||
- виконується як окремий **одноразовий** виклик без інструментів,
|
||||
- не змінює майбутній контекст сесії,
|
||||
- воно використовує поточний сеанс як фоновий контекст,
|
||||
- виконується як окремий одноразовий виклик **без інструментів**,
|
||||
- не змінює майбутній контекст сеансу,
|
||||
- не записується в історію транскрипту,
|
||||
- доставляється як live-побічний результат, а не як звичайне повідомлення помічника.
|
||||
- доставляється як живий побічний результат, а не як звичайне повідомлення помічника.
|
||||
|
||||
Це робить `/btw` корисним, коли вам потрібне тимчасове уточнення, поки основна
|
||||
задача триває.
|
||||
Це робить `/btw` корисним, коли вам потрібне тимчасове уточнення, поки основне
|
||||
завдання триває.
|
||||
|
||||
Приклад:
|
||||
|
||||
```text
|
||||
/btw what are we doing right now?
|
||||
/btw що ми зараз робимо?
|
||||
```
|
||||
|
||||
Див. [BTW Side Questions](/uk/tools/btw), щоб ознайомитися з повною поведінкою та деталями
|
||||
UX клієнта.
|
||||
Див. [BTW Side Questions](/uk/tools/btw) для повного опису поведінки та деталей UX
|
||||
клієнта.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user