diff --git a/docs/uk/tools/slash-commands.md b/docs/uk/tools/slash-commands.md index 18538e4e7..5c16570fa 100644 --- a/docs/uk/tools/slash-commands.md +++ b/docs/uk/tools/slash-commands.md @@ -2,35 +2,35 @@ read_when: - Використання або налаштування команд чату - Налагодження маршрутизації команд або дозволів -summary: 'Слеш-команди: текстові чи нативні, конфігурація та підтримувані команди' +summary: 'Слеш-команди: текстові проти нативних, конфігурація та підтримувані команди' title: Слеш-команди x-i18n: - generated_at: "2026-04-21T08:24:22Z" + generated_at: "2026-04-21T15:19:36Z" model: gpt-5.4 provider: openai - source_hash: d90ddee54af7c05b7fdf486590561084581d750e42cd14674d43bbdc0984df5d + source_hash: 26923608329ba2aeece2d4bc8edfa40ae86e03719a9f590f26ff79f57d97521d source_path: tools/slash-commands.md workflow: 15 --- # Слеш-команди -Команди обробляються Gateway. Більшість команд треба надсилати як **окреме** повідомлення, яке починається з `/`. +Команди обробляє Gateway. Більшість команд потрібно надсилати як **окреме** повідомлення, що починається з `/`. Команда чату bash лише для хоста використовує `! ` (із `/bash ` як псевдонімом). Є дві пов’язані системи: - **Команди**: окремі повідомлення `/...`. - **Директиви**: `/think`, `/fast`, `/verbose`, `/trace`, `/reasoning`, `/elevated`, `/exec`, `/model`, `/queue`. - - Директиви вилучаються з повідомлення до того, як його побачить модель. - - У звичайних повідомленнях чату (не лише з директивами) вони розглядаються як «вбудовані підказки» і **не** зберігають налаштування сесії. - - У повідомленнях лише з директивами (повідомлення містить тільки директиви) вони зберігаються в сесії та відповідають підтвердженням. + - Директиви видаляються з повідомлення до того, як його побачить модель. + - У звичайних повідомленнях чату (не лише з директивами) вони трактуються як «вбудовані підказки» і **не** зберігають налаштування сесії. + - У повідомленнях лише з директивами (повідомлення містить тільки директиви) вони зберігаються в сесії та повертають підтвердження. - Директиви застосовуються лише для **авторизованих відправників**. Якщо задано `commands.allowFrom`, це єдиний - список дозволу, який використовується; інакше авторизація береться зі списків дозволу/парування каналу разом із `commands.useAccessGroups`. + використовуваний список дозволу; інакше авторизація надходить зі списків дозволу/сполучення каналу разом із `commands.useAccessGroups`. Неавторизовані відправники бачать директиви як звичайний текст. Також є кілька **вбудованих скорочень** (лише для відправників зі списку дозволу/авторизованих): `/help`, `/commands`, `/status`, `/whoami` (`/id`). -Вони виконуються негайно, вилучаються до того, як повідомлення побачить модель, а решта тексту продовжує проходити звичайним шляхом. +Вони виконуються негайно, видаляються до того, як повідомлення побачить модель, а решта тексту продовжує оброблятися звичайним шляхом. ## Конфігурація @@ -62,105 +62,106 @@ x-i18n: - `commands.text` (типово `true`) вмикає розбір `/...` у повідомленнях чату. - На поверхнях без нативних команд (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams) текстові команди все одно працюють, навіть якщо встановити це значення в `false`. - `commands.native` (типово `"auto"`) реєструє нативні команди. - - Авто: увімкнено для Discord/Telegram; вимкнено для Slack (доки ви не додасте слеш-команди); ігнорується для провайдерів без нативної підтримки. - - Щоб перевизначити для окремого провайдера, встановіть `channels.discord.commands.native`, `channels.telegram.commands.native` або `channels.slack.commands.native` (bool або `"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"`) реєструє команди **Skills** нативно там, де це підтримується. - - Авто: увімкнено для Discord/Telegram; вимкнено для Slack (Slack вимагає створення окремої слеш-команди для кожного skill). - - Щоб перевизначити для окремого провайдера, встановіть `channels.discord.commands.nativeSkills`, `channels.telegram.commands.nativeSkills` або `channels.slack.commands.nativeSkills` (bool або `"auto"`). -- `commands.bash` (типово `false`) вмикає `! ` для запуску shell-команд хоста (`/bash ` — псевдонім; потрібні списки дозволу `tools.elevated`). -- `commands.bashForegroundMs` (типово `2000`) керує тим, як довго bash чекає перед перемиканням у фоновий режим (`0` одразу переводить у фон). +- `commands.nativeSkills` (типово `"auto"`) реєструє нативно команди **Skills**, коли це підтримується. + - Auto: увімкнено для Discord/Telegram; вимкнено для Slack (Slack вимагає створення окремої slash command для кожної навички). + - Щоб перевизначити параметр для конкретного провайдера, задайте `channels.discord.commands.nativeSkills`, `channels.telegram.commands.nativeSkills` або `channels.slack.commands.nativeSkills` (bool або `"auto"`). +- `commands.bash` (типово `false`) вмикає `! ` для виконання команд оболонки хоста (`/bash ` — псевдонім; потребує списків дозволу `tools.elevated`). +- `commands.bashForegroundMs` (типово `2000`) визначає, як довго bash чекає перед переходом у фоновий режим (`0` одразу переводить у фон). - `commands.config` (типово `false`) вмикає `/config` (читання/запис `openclaw.json`). - `commands.mcp` (типово `false`) вмикає `/mcp` (читання/запис конфігурації MCP, якою керує OpenClaw, у `mcp.servers`). -- `commands.plugins` (типово `false`) вмикає `/plugins` (виявлення/статус plugin плюс керування встановленням та ввімкненням/вимкненням). -- `commands.debug` (типово `false`) вмикає `/debug` (перевизначення лише для часу виконання). -- `commands.restart` (типово `true`) вмикає `/restart` і дії інструментів перезапуску gateway. +- `commands.plugins` (типово `false`) вмикає `/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.ownerDisplay` керує тим, як ідентифікатори власника відображаються в системному промпті: `raw` або `hash`. +- `commands.ownerDisplaySecret` необов’язково задає секрет HMAC, що використовується, коли `commands.ownerDisplay="hash"`. - `commands.allowFrom` (необов’язково) задає список дозволу для кожного провайдера для авторизації команд. Якщо налаштовано, це - єдине джерело авторизації для команд і директив (списки дозволу/парування каналу та `commands.useAccessGroups` - ігноруються). Використовуйте `"*"` для глобального значення за замовчуванням; ключі конкретних провайдерів мають пріоритет над ним. -- `commands.useAccessGroups` (типово `true`) примусово застосовує списки дозволу/політики для команд, якщо `commands.allowFrom` не задано. + єдине джерело авторизації для команд і директив (списки дозволу/сполучення каналу та `commands.useAccessGroups` + ігноруються). Використовуйте `"*"` як глобальне типове значення; ключі для конкретних провайдерів його перевизначають. +- `commands.useAccessGroups` (типово `true`) застосовує списки дозволу/політики для команд, якщо `commands.allowFrom` не задано. ## Список команд Поточне джерело істини: -- вбудовані команди ядра походять із `src/auto-reply/commands-registry.shared.ts` -- згенеровані команди dock походять із `src/auto-reply/commands-registry.data.ts` -- команди plugin походять із викликів plugin `registerCommand()` -- фактична доступність на вашому gateway усе одно залежить від прапорців конфігурації, поверхні каналу та встановлених/увімкнених plugin +- вбудовані в ядро команди надходять із `src/auto-reply/commands-registry.shared.ts` +- згенеровані команди dock надходять із `src/auto-reply/commands-registry.data.ts` +- команди плагінів надходять із викликів `registerCommand()` у плагінах +- фактична доступність у вашому gateway усе одно залежить від прапорців конфігурації, поверхні каналу та встановлених/увімкнених плагінів ### Вбудовані команди ядра Вбудовані команди, доступні зараз: -- `/new [model]` починає нову сесію; `/reset` — це псевдонім для скидання. +- `/new [model]` починає нову сесію; `/reset` — це псевдонім скидання. +- `/reset soft [message]` зберігає поточний транскрипт, скидає повторно використані ідентифікатори сесій бекенда CLI та повторно запускає завантаження startup/system-prompt на місці. - `/compact [instructions]` виконує Compaction контексту сесії. Див. [/concepts/compaction](/uk/concepts/compaction). - `/stop` перериває поточний запуск. -- `/session idle ` і `/session max-age ` керують строком дії прив’язки до гілки. -- `/think ` задає рівень thinking. Варіанти беруться з профілю провайдера активної моделі; поширені рівні — `off`, `minimal`, `low`, `medium` і `high`, а також користувацькі рівні на кшталт `xhigh`, `adaptive`, `max` або бінарне `on` лише там, де це підтримується. Псевдоніми: `/thinking`, `/t`. +- `/session idle ` і `/session max-age ` керують строком дії прив’язки до потоку. +- `/think ` встановлює рівень мислення. Параметри надходять із профілю провайдера активної моделі; поширені рівні: `off`, `minimal`, `low`, `medium` і `high`, а користувацькі рівні, як-от `xhigh`, `adaptive`, `max`, або лише двійковий `on`, доступні тільки там, де це підтримується. Псевдоніми: `/thinking`, `/t`. - `/verbose on|off|full` перемикає докладний вивід. Псевдонім: `/v`. -- `/trace on|off` перемикає вивід трасування plugin для поточної сесії. -- `/fast [status|on|off]` показує або задає швидкий режим. -- `/reasoning [on|off|stream]` перемикає видимість reasoning. Псевдонім: `/reason`. -- `/elevated [on|off|ask|full]` перемикає elevated mode. Псевдонім: `/elev`. -- `/exec host= security= ask= node=` показує або задає типові значення exec. -- `/model [name|#|status]` показує або задає модель. +- `/trace on|off` перемикає вивід трасування плагіна для поточної сесії. +- `/fast [status|on|off]` показує або встановлює швидкий режим. +- `/reasoning [on|off|stream]` перемикає видимість міркувань. Псевдонім: `/reason`. +- `/elevated [on|off|ask|full]` перемикає підвищений режим. Псевдонім: `/elev`. +- `/exec host= security= ask= node=` показує або встановлює типові параметри exec. +- `/model [name|#|status]` показує або встановлює модель. - `/models [provider] [page] [limit=|size=|all]` виводить список провайдерів або моделей для провайдера. -- `/queue ` керує поведінкою черги (`steer`, `interrupt`, `followup`, `collect`, `steer-backlog`) плюс параметрами на кшталт `debounce:2s cap:25 drop:summarize`. -- `/help` показує короткий підсумок довідки. +- `/queue ` керує поведінкою черги (`steer`, `interrupt`, `followup`, `collect`, `steer-backlog`), а також параметрами на кшталт `debounce:2s cap:25 drop:summarize`. +- `/help` показує короткий довідковий підсумок. - `/commands` показує згенерований каталог команд. - `/tools [compact|verbose]` показує, що поточний агент може використовувати прямо зараз. -- `/status` показує статус під час виконання, зокрема використання/квоту провайдера, якщо доступно. +- `/status` показує стан під час виконання, зокрема використання/квоту провайдера, якщо доступно. - `/tasks` виводить список активних/нещодавніх фонових завдань для поточної сесії. - `/context [list|detail|json]` пояснює, як збирається контекст. - `/export-session [path]` експортує поточну сесію в HTML. Псевдонім: `/export`. - `/whoami` показує ваш ідентифікатор відправника. Псевдонім: `/id`. -- `/skill [input]` запускає skill за назвою. -- `/allowlist [list|add|remove] ...` керує записами списку дозволу. Лише текстова. -- `/approve ` розв’язує запити на погодження exec. +- `/skill [input]` запускає навичку за назвою. +- `/allowlist [list|add|remove] ...` керує записами списку дозволу. Лише текстова команда. +- `/approve ` розв’язує запити на схвалення exec. - `/btw ` ставить побічне запитання без зміни майбутнього контексту сесії. Див. [/tools/btw](/uk/tools/btw). - `/subagents list|kill|log|info|send|steer|spawn` керує запусками субагентів для поточної сесії. -- `/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help` керує сесіями ACP та параметрами під час виконання. -- `/focus ` прив’язує поточну гілку Discord або тему/розмову Telegram до цільової сесії. -- `/unfocus` знімає поточну прив’язку. -- `/agents` виводить список агентів, прив’язаних до гілки, для поточної сесії. +- `/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help` керує сесіями ACP та параметрами часу виконання. +- `/focus ` прив’язує поточний потік Discord або тему/розмову Telegram до цілі сесії. +- `/unfocus` видаляє поточну прив’язку. +- `/agents` виводить список агентів, прив’язаних до потоку, для поточної сесії. - `/kill ` перериває одного або всіх запущених субагентів. - `/steer ` надсилає керування запущеному субагенту. Псевдонім: `/tell`. -- `/config show|get|set|unset` читає або записує `openclaw.json`. Лише для власника. Потрібно `commands.config: true`. -- `/mcp show|get|set|unset` читає або записує конфігурацію MCP-сервера, якою керує OpenClaw, у `mcp.servers`. Лише для власника. Потрібно `commands.mcp: true`. -- `/plugins list|inspect|show|get|install|enable|disable` перевіряє або змінює стан plugin. `/plugin` — псевдонім. Запис — лише для власника. Потрібно `commands.plugins: true`. -- `/debug show|set|unset|reset` керує перевизначеннями конфігурації лише під час виконання. Лише для власника. Потрібно `commands.debug: true`. +- `/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` — псевдонім. Запис — лише для власника. Потребує `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 ` запускає shell-команду хоста. Лише текстова. Псевдонім: `! `. Потрібно `commands.bash: true` плюс списки дозволу `tools.elevated`. -- `!poll [sessionId]` перевіряє фонове bash-завдання. -- `!stop [sessionId]` зупиняє фонове bash-завдання. +- `/restart` перезапускає OpenClaw, якщо ввімкнено. Типово: увімкнено; задайте `commands.restart: false`, щоб вимкнути. +- `/activation mention|always` встановлює режим активації групи. +- `/send on|off|inherit` встановлює політику надсилання. Лише для власника. +- `/bash ` виконує команду оболонки хоста. Лише текстова команда. Псевдонім: `! `. Потребує `commands.bash: true` та списків дозволу `tools.elevated`. +- `!poll [sessionId]` перевіряє фонове завдання bash. +- `!stop [sessionId]` зупиняє фонове завдання bash. ### Згенеровані команди dock -Команди dock генеруються з plugin каналів із підтримкою нативних команд. Поточний вбудований набір: +Команди dock генеруються з плагінів каналів із підтримкою нативних команд. Поточний вбудований набір: - `/dock-discord` (псевдонім: `/dock_discord`) - `/dock-mattermost` (псевдонім: `/dock_mattermost`) - `/dock-slack` (псевдонім: `/dock_slack`) - `/dock-telegram` (псевдонім: `/dock_telegram`) -### Команди вбудованих plugin +### Команди вбудованих плагінів -Вбудовані plugin можуть додавати більше слеш-команд. Поточні вбудовані команди в цьому репозиторії: +Вбудовані плагіни можуть додавати більше слеш-команд. Поточні вбудовані команди в цьому репозиторії: -- `/dreaming [on|off|status|help]` перемикає dreaming пам’яті. Див. [Dreaming](/uk/concepts/dreaming). -- `/pair [qr|status|pending|approve|cleanup|notify]` керує потоком парування/налаштування пристрою. Див. [Pairing](/uk/channels/pairing). -- `/phone status|arm [duration]|disarm` тимчасово вмикає високоризикові команди phone node. +- `/dreaming [on|off|status|help]` перемикає Dreaming пам’яті. Див. [Dreaming](/uk/concepts/dreaming). +- `/pair [qr|status|pending|approve|cleanup|notify]` керує процесом сполучення/налаштування пристроїв. Див. [Pairing](/uk/channels/pairing). +- `/phone status|arm [duration]|disarm` тимчасово вмикає високоризикові команди вузла телефона. - `/voice status|list [limit]|set ` керує конфігурацією голосу Talk. У Discord нативна назва команди — `/talkvoice`. - `/card ...` надсилає шаблони LINE rich card. Див. [LINE](/uk/channels/line). -- `/codex status|models|threads|resume|compact|review|account|mcp|skills` перевіряє та керує вбудованим app-server harness Codex. Див. [Codex Harness](/uk/plugins/codex-harness). +- `/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` @@ -168,73 +169,73 @@ x-i18n: - `/bot-upgrade` - `/bot-logs` -### Динамічні команди Skills +### Динамічні команди навичок -Skills, які може викликати користувач, також доступні як слеш-команди: +Навички, які може викликати користувач, також доступні як слеш-команди: -- `/skill [input]` завжди працює як універсальна точка входу. -- skills також можуть з’являтися як прямі команди, наприклад `/prose`, коли їх реєструє skill/plugin. -- реєстрація нативних команд skill керується `commands.nativeSkills` і `channels..commands.nativeSkills`. +- `/skill [input]` завжди працює як загальна точка входу. +- навички також можуть з’являтися як прямі команди, наприклад `/prose`, коли їх реєструє навичка/плагін. +- реєстрація нативних команд навичок керується через `commands.nativeSkills` і `channels..commands.nativeSkills`. Примітки: -- Команди приймають необов’язковий `:` між командою та аргументами (наприклад, `/think: high`, `/send: on`, `/help:`). -- `/new ` приймає псевдонім моделі, `provider/model` або назву провайдера (нечіткий збіг); якщо збігу немає, текст розглядається як тіло повідомлення. +- Команди приймають необов’язковий символ `:` між командою та аргументами (наприклад, `/think: high`, `/send: on`, `/help:`). +- `/new ` приймає псевдонім моделі, `provider/model` або назву провайдера (нечіткий збіг); якщо збігу немає, текст трактується як тіло повідомлення. - Для повного розподілу використання провайдера використовуйте `openclaw status --usage`. -- `/allowlist add|remove` потребує `commands.config=true` і враховує `configWrites` каналу. -- У каналах із кількома обліковими записами `/allowlist --account `, націлений на конфігурацію, і `/config set channels..accounts....` також враховують `configWrites` цільового облікового запису. -- `/usage` керує нижнім колонтитулом використання для кожної відповіді; `/usage cost` виводить локальний підсумок вартості з логів сесій OpenClaw. -- `/restart` увімкнено типово; встановіть `commands.restart: false`, щоб вимкнути його. -- `/plugins install ` приймає ті самі специфікації plugin, що й `openclaw plugins install`: локальний шлях/архів, npm-пакет або `clawhub:`. -- `/plugins enable|disable` оновлює конфігурацію plugin і може запропонувати перезапуск. +- `/allowlist add|remove` вимагає `commands.config=true` і враховує `configWrites` каналу. +- У каналах із кількома обліковими записами `/allowlist --account `, націлений на конфігурацію, та `/config set channels..accounts....` також враховують `configWrites` цільового облікового запису. +- `/usage` керує нижнім колонтитулом використання для кожної відповіді; `/usage cost` виводить локальний підсумок вартості з журналів сесій OpenClaw. +- `/restart` увімкнено типово; задайте `commands.restart: false`, щоб вимкнути його. +- `/plugins install ` приймає ті самі специфікації плагінів, що й `openclaw plugins install`: локальний шлях/архів, npm-пакет або `clawhub:`. +- `/plugins enable|disable` оновлює конфігурацію плагіна і може запропонувати перезапуск. - Нативна команда лише для 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 (`/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` в інтерфейсі 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` ризиковані в групових налаштуваннях: вони можуть розкрити внутрішні міркування, вивід інструментів або діагностику plugin, які ви не мали наміру показувати. Краще залишати їх вимкненими, особливо в групових чатах. -- `/model` одразу зберігає нову модель сесії. -- Якщо агент неактивний, наступний запуск використає її відразу. -- Якщо запуск уже активний, OpenClaw позначає живе перемикання як відкладене й перезапускається з новою моделлю лише в чистій точці повторної спроби. -- Якщо активність інструментів або вивід відповіді вже почалися, відкладене перемикання може залишатися в черзі до пізнішої можливості повторної спроби або до наступного ходу користувача. -- **Швидкий шлях:** повідомлення лише з командами від відправників зі списку дозволу обробляються негайно (обхід черги + моделі). -- **Обмеження за згадуванням у групі:** повідомлення лише з командами від відправників зі списку дозволу обходять вимоги щодо згадування. -- **Вбудовані скорочення (лише для відправників зі списку дозволу):** деякі команди також працюють, коли вбудовані у звичайне повідомлення, і вилучаються до того, як модель побачить решту тексту. - - Приклад: `hey /status` запускає відповідь зі статусом, а решта тексту продовжує проходити звичайним шляхом. +- `/trace` вужчий за `/verbose`: він показує лише рядки трасування/налагодження, що належать плагіну, і не вмикає звичайний докладний вивід інструментів. +- `/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` ризиковані в групових налаштуваннях: вони можуть розкрити внутрішні міркування, вивід інструментів або діагностику плагінів, яку ви не планували показувати. Краще залишати їх вимкненими, особливо в групових чатах. +- `/model` негайно зберігає нову модель сесії. +- Якщо агент неактивний, наступний запуск одразу її використає. +- Якщо запуск уже активний, OpenClaw позначає живе перемикання як очікуване й перезапускає з новою моделлю лише в чистій точці повторної спроби. +- Якщо активність інструментів або вивід відповіді вже почалися, очікуване перемикання може залишатися в черзі до пізнішої можливості повторної спроби або наступного ходу користувача. +- **Швидкий шлях:** повідомлення лише з командами від відправників зі списку дозволу обробляються негайно (в обхід черги й моделі). +- **Фільтрація згадок у групі:** повідомлення лише з командами від відправників зі списку дозволу обходять вимоги щодо згадок. +- **Вбудовані скорочення (лише для відправників зі списку дозволу):** деякі команди також працюють, коли вбудовані у звичайне повідомлення, і видаляються до того, як модель побачить решту тексту. + - Приклад: `hey /status` запускає відповідь зі статусом, а решта тексту далі проходить звичайним шляхом. - Наразі: `/help`, `/commands`, `/status`, `/whoami` (`/id`). -- Неавторизовані повідомлення лише з командами тихо ігноруються, а вбудовані токени `/...` розглядаються як звичайний текст. -- **Команди Skills:** skills із позначкою `user-invocable` доступні як слеш-команди. Імена нормалізуються до `a-z0-9_` (максимум 32 символи); у разі конфліктів додаються числові суфікси (наприклад, `_2`). - - `/skill [input]` запускає skill за назвою (це корисно, коли обмеження нативних команд не дозволяють окремі команди для кожного skill). - - Типово команди skill пересилаються моделі як звичайний запит. - - Skills можуть необов’язково оголошувати `command-dispatch: tool`, щоб спрямувати команду безпосередньо до інструмента (детерміновано, без моделі). - - Приклад: `/prose` (plugin OpenProse) — див. [OpenProse](/uk/prose). -- **Аргументи нативних команд:** Discord використовує автодоповнення для динамічних параметрів (і меню кнопок, коли ви пропускаєте обов’язкові аргументи). Telegram і Slack показують меню кнопок, коли команда підтримує варіанти, а ви пропускаєте аргумент. +- Неавторизовані повідомлення лише з командами тихо ігноруються, а вбудовані токени `/...` трактуються як звичайний текст. +- **Команди Skills:** навички `user-invocable` доступні як слеш-команди. Назви санітизуються до `a-z0-9_` (макс. 32 символи); у разі колізій додаються числові суфікси (наприклад, `_2`). + - `/skill [input]` запускає навичку за назвою (корисно, коли обмеження нативних команд не дозволяють окремі команди для кожної навички). + - Типово команди навичок пересилаються моделі як звичайний запит. + - Навички можуть необов’язково оголошувати `command-dispatch: tool`, щоб спрямовувати команду безпосередньо до інструмента (детерміновано, без моделі). + - Приклад: `/prose` (плагін OpenProse) — див. [OpenProse](/uk/prose). +- **Аргументи нативних команд:** Discord використовує автодоповнення для динамічних параметрів (і меню кнопок, коли ви пропускаєте обов’язкові аргументи). Telegram і Slack показують меню кнопок, коли команда підтримує варіанти вибору, а ви пропускаєте аргумент. ## `/tools` -`/tools` відповідає на запитання про стан під час виконання, а не про конфігурацію: **що цей агент може використовувати прямо зараз у +`/tools` відповідає на запитання про час виконання, а не про конфігурацію: **що цей агент може використовувати прямо зараз у цій розмові**. -- Типове `/tools` компактне й оптимізоване для швидкого перегляду. +- Типове `/tools` є компактним і оптимізованим для швидкого перегляду. - `/tools verbose` додає короткі описи. -- Поверхні з нативними командами, що підтримують аргументи, надають той самий перемикач режиму як `compact|verbose`. -- Результати прив’язані до сесії, тому зміна агента, каналу, гілки, авторизації відправника або моделі може +- Поверхні нативних команд, які підтримують аргументи, надають той самий перемикач режиму як `compact|verbose`. +- Результати прив’язані до сесії, тому зміна агента, каналу, потоку, авторизації відправника або моделі може змінити вивід. - `/tools` включає інструменти, які реально доступні під час виконання, зокрема інструменти ядра, підключені - інструменти plugin і інструменти, що належать каналу. + інструменти плагінів і інструменти, що належать каналу. -Для редагування профілю та перевизначень використовуйте панель Tools в інтерфейсі керування або поверхні конфігурації/каталогу, -а не розглядайте `/tools` як статичний каталог. +Для редагування профілю та перевизначень використовуйте панель Tools у Control UI або поверхні конфігурації/каталогу, +а не сприймайте `/tools` як статичний каталог. ## Поверхні використання (що де показується) -- **Використання/квота провайдера** (наприклад: «Claude 80% left») з’являється в `/status` для провайдера поточної моделі, коли відстеження використання ввімкнено. OpenClaw нормалізує вікна провайдерів до `% left`; для MiniMax поля відсотків лише із залишком інвертуються перед показом, а відповіді `model_remains` надають перевагу запису chat-моделі разом із міткою плану, прив’язаною до моделі. -- **Рядки токенів/кешу** в `/status` можуть повертатися до останнього запису використання в транскрипті, якщо живий знімок сесії містить мало даних. Наявні ненульові живі значення все одно мають пріоритет, а резервний варіант із транскрипту також може відновити мітку активної моделі під час виконання плюс більший загальний підсумок, орієнтований на prompt, коли збережені підсумки відсутні або менші. +- **Використання/квота провайдера** (приклад: «Claude 80% left») показується в `/status` для провайдера поточної моделі, коли відстеження використання ввімкнено. OpenClaw нормалізує вікна провайдера до `% left`; для MiniMax поля відсотка лише із залишком інвертуються перед показом, а відповіді `model_remains` надають перевагу запису chat-model разом із міткою плану з тегом моделі. +- **Рядки token/cache** у `/status` можуть повертатися до останнього запису використання транскрипту, коли живий знімок сесії бідний на дані. Наявні ненульові живі значення все одно мають пріоритет, а fallback до транскрипту також може відновити мітку активної моделі часу виконання разом із більшим загальним значенням, орієнтованим на промпт, коли збережені підсумки відсутні або менші. - **Токени/вартість для кожної відповіді** керуються через `/usage off|tokens|full` (додається до звичайних відповідей). -- `/model status` стосується **моделей/автентифікації/endpoint**, а не використання. +- `/model status` стосується **моделей/автентифікації/endpoints**, а не використання. ## Вибір моделі (`/model`) @@ -254,13 +255,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` дає змогу задавати **перевизначення конфігурації лише під час виконання** (пам’ять, не диск). Лише для власника. Типово вимкнено; увімкніть через `commands.debug: true`. +`/debug` дає змогу встановлювати **перевизначення конфігурації лише під час виконання** (у пам’яті, не на диску). Лише для власника. Вимкнено типово; увімкніть через `commands.debug: true`. Приклади: @@ -277,9 +278,9 @@ Skills, які може викликати користувач, також до - Перевизначення застосовуються негайно до нових читань конфігурації, але **не** записуються в `openclaw.json`. - Використовуйте `/debug reset`, щоб очистити всі перевизначення та повернутися до конфігурації на диску. -## Вивід трасування plugin +## Вивід трасування плагіна -`/trace` дає змогу перемикати **рядки трасування/налагодження plugin у межах сесії** без увімкнення повного докладного режиму. +`/trace` дає змогу перемикати **рядки трасування/налагодження плагіна в межах сесії** без увімкнення повного докладного режиму. Приклади: @@ -291,16 +292,16 @@ Skills, які може викликати користувач, також до Примітки: -- `/trace` без аргументу показує поточний стан трасування для сесії. -- `/trace on` вмикає рядки трасування plugin для поточної сесії. -- `/trace off` знову вимикає їх. -- Рядки трасування plugin можуть з’являтися в `/status` і як додаткове діагностичне повідомлення після звичайної відповіді асистента. -- `/trace` не замінює `/debug`; `/debug` як і раніше керує перевизначеннями конфігурації лише під час виконання. -- `/trace` не замінює `/verbose`; звичайний докладний вивід інструментів/статусу й надалі належить до `/verbose`. +- `/trace` без аргументу показує поточний стан трасування сесії. +- `/trace on` вмикає рядки трасування плагіна для поточної сесії. +- `/trace off` знову їх вимикає. +- Рядки трасування плагіна можуть з’являтися в `/status` і як подальше діагностичне повідомлення після звичайної відповіді помічника. +- `/trace` не замінює `/debug`; `/debug` і далі керує перевизначеннями конфігурації лише під час виконання. +- `/trace` не замінює `/verbose`; звичайний докладний вивід інструментів/статусу все ще належить `/verbose`. ## Оновлення конфігурації -`/config` записує в конфігурацію на диску (`openclaw.json`). Лише для власника. Типово вимкнено; увімкніть через `commands.config: true`. +`/config` записує у вашу конфігурацію на диску (`openclaw.json`). Лише для власника. Вимкнено типово; увімкніть через `commands.config: true`. Приклади: @@ -314,12 +315,12 @@ Skills, які може викликати користувач, також до Примітки: -- Перед записом конфігурація проходить перевірку; недійсні зміни відхиляються. -- Оновлення `/config` зберігаються після перезапуску. +- Конфігурація перевіряється перед записом; недійсні зміни відхиляються. +- Оновлення `/config` зберігаються після перезапусків. ## Оновлення MCP -`/mcp` записує визначення MCP-серверів, якими керує OpenClaw, у `mcp.servers`. Лише для власника. Типово вимкнено; увімкніть через `commands.mcp: true`. +`/mcp` записує визначення MCP-серверів, якими керує OpenClaw, у `mcp.servers`. Лише для власника. Вимкнено типово; увімкніть через `commands.mcp: true`. Приклади: @@ -332,12 +333,12 @@ Skills, які може викликати користувач, також до Примітки: -- `/mcp` зберігає конфігурацію в конфігурації OpenClaw, а не в налаштуваннях проєкту, якими володіє Pi. -- Адаптери під час виконання вирішують, які транспорти реально можна запускати. +- `/mcp` зберігає конфігурацію в конфігурації OpenClaw, а не в налаштуваннях проєкту, що належать Pi. +- Адаптери часу виконання визначають, які транспорти реально можна виконати. -## Оновлення plugin +## Оновлення плагінів -`/plugins` дає змогу операторам переглядати виявлені plugin і перемикати їх увімкнення в конфігурації. Для сценаріїв лише читання можна використовувати `/plugin` як псевдонім. Типово вимкнено; увімкніть через `commands.plugins: true`. +`/plugins` дає змогу операторам переглядати виявлені плагіни й перемикати їхнє ввімкнення в конфігурації. Потоки лише для читання можуть використовувати `/plugin` як псевдонім. Вимкнено типово; увімкніть через `commands.plugins: true`. Приклади: @@ -351,20 +352,20 @@ Skills, які може викликати користувач, також до Примітки: -- `/plugins list` і `/plugins show` використовують реальне виявлення plugin у поточному робочому просторі разом із конфігурацією на диску. -- `/plugins enable|disable` оновлює лише конфігурацію plugin; це не встановлює й не видаляє plugin. -- Після змін увімкнення/вимкнення перезапустіть gateway, щоб застосувати їх. +- `/plugins list` і `/plugins show` використовують реальне виявлення плагінів у поточному робочому просторі разом із конфігурацією на диску. +- `/plugins enable|disable` оновлює лише конфігурацію плагінів; він не встановлює і не видаляє плагіни. +- Після змін `enable/disable` перезапустіть gateway, щоб застосувати їх. ## Примітки щодо поверхонь -- **Текстові команди** виконуються в звичайній сесії чату (DM ділять `main`, групи мають власну сесію). +- **Текстові команди** працюють у звичайній сесії чату (DM ділять `main`, групи мають власну сесію). - **Нативні команди** використовують ізольовані сесії: - Discord: `agent::discord:slash:` - Slack: `agent::slack:slash:` (префікс налаштовується через `channels.slack.slashCommand.sessionPrefix`) - Telegram: `telegram:slash:` (націлюється на сесію чату через `CommandTargetSessionKey`) -- **`/stop`** націлюється на активну сесію чату, щоб перервати поточний запуск. -- **Slack:** `channels.slack.slashCommand` усе ще підтримується для однієї команди у стилі `/openclaw`. Якщо ви вмикаєте `commands.native`, потрібно створити одну слеш-команду Slack для кожної вбудованої команди (з тими самими назвами, що й у `/help`). Меню аргументів команд для Slack доставляються як тимчасові кнопки Block Kit. - - Нативний виняток Slack: реєструйте `/agentstatus` (а не `/status`), тому що Slack резервує `/status`. Текстова `/status` у повідомленнях Slack усе одно працює. +- **`/stop`** націлюється на активну сесію чату, щоб мати змогу перервати поточний запуск. +- **Slack:** `channels.slack.slashCommand` усе ще підтримується для однієї команди у стилі `/openclaw`. Якщо ви вмикаєте `commands.native`, потрібно створити одну slash command у Slack для кожної вбудованої команди (з тими самими назвами, що й у `/help`). Меню аргументів команд для Slack доставляються як ефемерні кнопки Block Kit. + - Виняток для нативних команд Slack: зареєструйте `/agentstatus` (а не `/status`), оскільки Slack резервує `/status`. Текстова `/status` у повідомленнях Slack усе одно працює. ## Побічні запитання BTW @@ -373,10 +374,10 @@ Skills, які може викликати користувач, також до На відміну від звичайного чату: - воно використовує поточну сесію як фоновий контекст, -- воно виконується як окремий **одноразовий** виклик без інструментів, -- воно не змінює майбутній контекст сесії, -- воно не записується в історію транскрипту, -- воно доставляється як живий побічний результат, а не як звичайне повідомлення асистента. +- запускається як окремий **одноразовий** виклик **без інструментів**, +- не змінює майбутній контекст сесії, +- не записується в історію транскрипту, +- доставляється як живий побічний результат, а не як звичайне повідомлення помічника. Це робить `/btw` корисним, коли вам потрібне тимчасове уточнення, поки основне завдання триває. @@ -387,5 +388,5 @@ Skills, які може викликати користувач, також до /btw what are we doing right now? ``` -Див. [BTW Side Questions](/uk/tools/btw), щоб дізнатися про повну поведінку та деталі UX -клієнта. +Див. [BTW Side Questions](/uk/tools/btw), щоб дізнатися повну поведінку та подробиці +UX клієнта.