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