Команди зі слешем
Команди обробляються Gateway. Більшість команд потрібно надсилати як окреме повідомлення, яке починається з/.
Чат-команда bash лише для host використовує ! <cmd> (з /bash <cmd> як псевдонімом).
Є дві пов’язані системи:
- Команди: окремі повідомлення
/.... - Директиви:
/think,/fast,/verbose,/reasoning,/elevated,/exec,/model,/queue.- Директиви вилучаються з повідомлення до того, як його побачить модель.
- У звичайних повідомленнях чату (не лише з директивами) вони трактуються як «вбудовані підказки» і не зберігають налаштування сесії.
- У повідомленнях лише з директивами (повідомлення містить лише директиви) вони зберігаються в сесії та відповідають підтвердженням.
- Директиви застосовуються лише для авторизованих відправників. Якщо задано
commands.allowFrom, це єдиний allowlist, який використовується; інакше авторизація надходить із allowlist каналів/pairing разом ізcommands.useAccessGroups. Для неавторизованих відправників директиви трактуються як звичайний текст.
/help, /commands, /status, /whoami (/id).
Вони виконуються негайно, вилучаються до того, як повідомлення побачить модель, а решта тексту продовжує проходити звичайним потоком.
Config
commands.text(типовоtrue) вмикає розбір/...у повідомленнях чату.- На поверхнях без нативних команд (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams) текстові команди все одно працюють, навіть якщо ви встановите
false.
- На поверхнях без нативних команд (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams) текстові команди все одно працюють, навіть якщо ви встановите
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 потрібно створювати окрему slash command для кожної skill).
- Використовуйте
channels.discord.commands.nativeSkills,channels.telegram.commands.nativeSkillsабоchannels.slack.commands.nativeSkills, щоб перевизначити це для конкретного провайдера (bool або"auto").
commands.bash(типовоfalse) вмикає! <cmd>для запуску shell-команд на host (/bash <cmd>— псевдонім; потребує allowlist дляtools.elevated).commands.bashForegroundMs(типово2000) керує тим, скільки часу bash чекає перед переходом у фоновий режим (0одразу переводить у фон).commands.config(типовоfalse) вмикає/config(читання/записopenclaw.json).commands.mcp(типовоfalse) вмикає/mcp(читання/запис config MCP під керуванням OpenClaw уmcp.servers).commands.plugins(типовоfalse) вмикає/plugins(виявлення/стан plugin плюс керування встановленням і вмиканням/вимиканням).commands.debug(типовоfalse) вмикає/debug(перевизначення лише для runtime).commands.allowFrom(необов’язково) задає allowlist для авторизації команд окремо для кожного провайдера. Якщо його налаштовано, це єдине джерело авторизації для команд і директив (commands.useAccessGroupsта allowlist каналів/pairing ігноруються). Використовуйте"*"як глобальне значення за замовчуванням; ключі для конкретних провайдерів його перевизначають.commands.useAccessGroups(типовоtrue) застосовує allowlist/політики для команд, колиcommands.allowFromне задано.
Список команд
Текстові + нативні (коли ввімкнено):/help/commands/tools [compact|verbose](показує, що поточний агент може використовувати прямо зараз;verboseдодає описи)/skill <name> [input](запустити skill за назвою)/status(показати поточний стан; включає використання/квоту провайдера для поточного провайдера моделі, коли доступно)/tasks(перелічити фонові завдання для поточної сесії; показує деталі активних і нещодавніх завдань із локальними для агента резервними підрахунками)/allowlist(переглянути/додати/видалити записи allowlist)/approve <id> <decision>(обробити запити схвалення exec; використовуйте повідомлення про очікуване схвалення для доступних рішень)/context [list|detail|json](пояснює «контекст»;detailпоказує розмір для кожного файла + кожного інструмента + кожної skill + системного запиту)/btw <question>(поставити тимчасове побічне запитання про поточну сесію без зміни майбутнього контексту сесії; див. /tools/btw)/export-session [path](псевдонім:/export) (експортувати поточну сесію в HTML із повним системним запитом)/whoami(показати ваш sender id; псевдонім:/id)/session idle <duration|off>(керування автоматичним зняттям фокусу через неактивність для прив’язок сфокусованих потоків)/session max-age <duration|off>(керування жорстким автоматичним зняттям фокусу за максимальним віком для прив’язок сфокусованих потоків)/subagents list|kill|log|info|send|steer|spawn(переглянути, керувати або запускати sub-agent для поточної сесії)/acp spawn|cancel|steer|close|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|sessions(перегляд і керування runtime-сесіями ACP)/agents(перелічити агентів, прив’язаних до потоку для цієї сесії)/focus <target>(Discord: прив’язати цей потік або новий потік до цілі session/subagent)/unfocus(Discord: прибрати поточну прив’язку потоку)/kill <id|#|all>(негайно перервати один або всі запущені sub-agent для цієї сесії; без повідомлення-підтвердження)/steer <id|#> <message>(негайно перенаправити запущений sub-agent: під час виконання, якщо можливо, інакше перервати поточну роботу та перезапустити з повідомленням steer)/tell <id|#> <message>(псевдонім для/steer)/config show|get|set|unset(зберегти config на диск, лише для власника; потребуєcommands.config: true)/mcp show|get|set|unset(керування config сервера OpenClaw MCP, лише для власника; потребуєcommands.mcp: true)/plugins list|show|get|install|enable|disable(перегляд виявлених plugin, встановлення нових і перемикання стану ввімкнення; запис лише для власника; потребуєcommands.plugins: true)/plugin— псевдонім для/plugins./plugin install <spec>приймає ті самі специфікації plugin, що йopenclaw plugins install: локальний шлях/архів, npm-пакет абоclawhub:<pkg>.- Записи enable/disable усе ще відповідають підказкою про перезапуск. На gateway переднього плану з watch OpenClaw може виконати цей перезапуск автоматично відразу після запису.
/debug show|set|unset|reset(перевизначення runtime, лише для власника; потребуєcommands.debug: true)/usage off|tokens|full|cost(нижній колонтитул використання для кожної відповіді або локальний підсумок витрат)/tts off|always|inbound|tagged|status|provider|limit|summary|audio(керування TTS; див. /tts)- Discord: нативна команда —
/voice(Discord резервує/tts); текстова/ttsусе одно працює.
- Discord: нативна команда —
/stop/restart/dock-telegram(псевдонім:/dock_telegram) (перемкнути відповіді на Telegram)/dock-discord(псевдонім:/dock_discord) (перемкнути відповіді на Discord)/dock-slack(псевдонім:/dock_slack) (перемкнути відповіді на Slack)/activation mention|always(лише для груп)/send on|off|inherit(лише для власника)/resetабо/new [model](необов’язкова підказка моделі; решта передається далі)/think <off|minimal|low|medium|high|xhigh>(динамічні варіанти за моделлю/провайдером; псевдоніми:/thinking,/t)/fast status|on|off(без аргументу показує поточний ефективний стан fast mode)/verbose on|full|off(псевдонім:/v)/reasoning on|off|stream(псевдонім:/reason; коли ввімкнено, надсилає окреме повідомлення з префіксомReasoning:;stream= лише чернетка Telegram)/elevated on|off|ask|full(псевдонім:/elev;fullпропускає схвалення exec)/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>(надішліть/exec, щоб побачити поточне значення)/model <name>(псевдонім:/models; або/<alias>зagents.defaults.models.*.alias)/queue <mode>(плюс параметри на кшталтdebounce:2s cap:25 drop:summarize; надішліть/queue, щоб побачити поточні налаштування)/bash <command>(лише для host; псевдонім для! <command>; потребуєcommands.bash: true+ allowlist дляtools.elevated)/dreaming [on|off|status|help]або/dreaming [enable|disable] [light|deep|rem](перемкнути фази dreaming або показати стан; див. Dreaming)
/compact [instructions](див. /concepts/compaction)! <command>(лише для host; по одній за раз; використовуйте!poll+!stopдля довготривалих завдань)!poll(перевірити вивід / стан; приймає необов’язковийsessionId;/bash pollтакож працює)!stop(зупинити запущене завдання bash; приймає необов’язковийsessionId;/bash stopтакож працює)
- Команди приймають необов’язковий
:між командою й аргументами (наприклад,/think: high,/send: on,/help:). /new <model>приймає псевдонім моделі,provider/modelабо назву провайдера (нечіткий збіг); якщо збігів немає, текст трактується як тіло повідомлення.- Для повного розбору використання провайдера використовуйте
openclaw status --usage. /allowlist add|removeпотребуєcommands.config=trueі враховує каналconfigWrites.- У каналах з кількома обліковими записами
/allowlist --account <id>, націлений на config, і/config set channels.<provider>.accounts.<id>...також враховуютьconfigWritesцільового облікового запису. /usageкерує нижнім колонтитулом використання для кожної відповіді;/usage costдрукує локальний підсумок витрат із логів сесій OpenClaw./restartувімкнено за замовчуванням; установітьcommands.restart: false, щоб вимкнути його.- Нативна команда лише для Discord:
/vc join|leave|statusкерує голосовими каналами (потребуєchannels.discord.voiceі нативних команд; недоступна як текст). - Команди прив’язки потоків Discord (
/focus,/unfocus,/agents,/session idle,/session max-age) потребують, щоб ефективні прив’язки потоків були ввімкнені (session.threadBindings.enabledта/абоchannels.discord.threadBindings.enabled). - Довідка щодо команд ACP і поведінка runtime: ACP Agents.
/verboseпризначено для налагодження та додаткової видимості; у звичайному використанні тримайте його вимкненим./fast on|offзберігає перевизначення сесії. Використовуйте параметрinheritв UI Sessions, щоб очистити його та повернутися до типових значень config./fastзалежить від провайдера: OpenAI/OpenAI Codex маплять його наservice_tier=priorityу нативних endpoint Responses, тоді як прямі публічні запити Anthropic, включно з трафіком з OAuth-автентифікацією, надісланим доapi.anthropic.com, маплять його наservice_tier=autoабоstandard_only. Див. OpenAI і Anthropic.- Підсумки збоїв інструментів усе ще показуються, коли це доречно, але детальний текст збоїв включається лише коли
/verboseмає значенняonабоfull. /reasoning(і/verbose) ризиковані в групових налаштуваннях: вони можуть розкрити внутрішні міркування або вивід інструментів, які ви не хотіли показувати. Краще залишати їх вимкненими, особливо в групових чатах./modelнегайно зберігає нову модель сесії.- Якщо агент неактивний, наступний запуск одразу її використовує.
- Якщо виконання вже активне, OpenClaw позначає живе перемикання як очікуване й перезапускає на новій моделі лише в чистій точці повторної спроби.
- Якщо активність інструмента або вивід відповіді вже почалися, очікуване перемикання може залишатися в черзі до пізнішої можливості повторної спроби або до наступного ходу користувача.
- Швидкий шлях: повідомлення лише з командами від allowlisted відправників обробляються негайно (обхід черги + моделі).
- Обмеження групових згадок: повідомлення лише з командами від allowlisted відправників обходять вимоги щодо згадки.
- Вбудовані скорочення (лише для allowlisted відправників): деякі команди також працюють, коли вбудовані у звичайне повідомлення, і вилучаються до того, як модель побачить решту тексту.
- Приклад:
hey /statusвикликає відповідь зі статусом, а решта тексту продовжує проходити звичайним потоком.
- Приклад:
- Наразі:
/help,/commands,/status,/whoami(/id). - Неавторизовані повідомлення лише з командами мовчки ігноруються, а вбудовані токени
/...трактуються як звичайний текст. - Команди skill: skill із
user-invocableнадаються як slash commands. Назви санітизуються доa-z0-9_(максимум 32 символи); колізії отримують числові суфікси (наприклад,_2)./skill <name> [input]запускає skill за назвою (корисно, коли обмеження нативних команд не дозволяють окремі команди для кожної skill).- За замовчуванням команди skill пересилаються до моделі як звичайний запит.
- Skill можуть необов’язково оголошувати
command-dispatch: tool, щоб маршрутизувати команду безпосередньо до інструмента (детерміновано, без моделі). - Приклад:
/prose(plugin OpenProse) — див. OpenProse.
- Аргументи нативних команд: Discord використовує автодоповнення для динамічних параметрів (і меню кнопок, коли ви пропускаєте обов’язкові аргументи). Telegram і Slack показують меню кнопок, коли команда підтримує варіанти, а ви пропускаєте аргумент.
/tools
/tools відповідає на питання про runtime, а не про config: що цей агент може використовувати прямо зараз у
цій розмові.
- Типовий
/toolsкомпактний і оптимізований для швидкого перегляду. /tools verboseдодає короткі описи.- Поверхні нативних команд, що підтримують аргументи, надають той самий перемикач режиму
compact|verbose. - Результати прив’язані до сесії, тож зміна агента, каналу, потоку, авторизації відправника або моделі може змінити вивід.
/toolsвключає інструменти, які реально доступні під час runtime, зокрема core-інструменти, інструменти підключених plugin і інструменти, що належать каналам.
/tools як статичний каталог.
Поверхні використання (що де показується)
- Використання/квота провайдера (наприклад: «Claude 80% left») з’являється в
/statusдля поточного провайдера моделі, коли відстеження використання ввімкнене. OpenClaw нормалізує вікна провайдерів до% left; для MiniMax поля відсотка, що показують лише залишок, інвертуються перед показом, а відповідіmodel_remainsвіддають перевагу запису chat-model разом із міткою плану, прив’язаною до моделі. - Рядки токенів/кешу в
/statusможуть резервно братися з найновішого запису використання транскрипту, коли поточний знімок сесії містить мало даних. Наявні ненульові поточні значення все ще мають пріоритет, а резервний перехід до транскрипту також може відновити мітку активної моделі runtime плюс більший загальний обсяг, орієнтований на запит, коли збережені підсумки відсутні або менші. - Токени/вартість для кожної відповіді керуються через
/usage off|tokens|full(додається до звичайних відповідей). /model statusстосується моделей/автентифікації/endpoint, а не використання.
Вибір моделі (/model)
/model реалізовано як директиву.
Приклади:
/modelі/model listпоказують компактний нумерований вибір (сімейство моделей + доступні провайдери).- У Discord
/modelі/modelsвідкривають інтерактивний вибір із випадними списками провайдера та моделі плюс кроком Submit. /model <#>вибирає з цього списку (і за можливості віддає перевагу поточному провайдеру)./model statusпоказує детальний вигляд, включно з налаштованим endpoint провайдера (baseUrl) і режимом API (api), коли доступно.
Перевизначення налагодження
/debug дозволяє встановлювати перевизначення лише для runtime (пам’ять, а не диск). Лише для власника. За замовчуванням вимкнено; увімкніть через commands.debug: true.
Приклади:
- Перевизначення застосовуються негайно до нових читань config, але не записуються в
openclaw.json. - Використовуйте
/debug reset, щоб очистити всі перевизначення й повернутися до config на диску.
Оновлення config
/config записує у ваш config на диску (openclaw.json). Лише для власника. За замовчуванням вимкнено; увімкніть через commands.config: true.
Приклади:
- Config перевіряється перед записом; недійсні зміни відхиляються.
- Оновлення
/configзберігаються після перезапуску.
Оновлення MCP
/mcp записує визначення серверів MCP під керуванням OpenClaw у mcp.servers. Лише для власника. За замовчуванням вимкнено; увімкніть через commands.mcp: true.
Приклади:
/mcpзберігає config у config OpenClaw, а не в налаштуваннях проєкту під керуванням Pi.- Адаптери runtime вирішують, які транспорти справді можна виконати.
Оновлення plugin
/plugins дозволяє операторам переглядати виявлені plugin і перемикати стан ввімкнення в config. Потоки лише для читання можуть використовувати /plugin як псевдонім. За замовчуванням вимкнено; увімкніть через commands.plugins: true.
Приклади:
/plugins listі/plugins showвикористовують реальне виявлення plugin на основі поточного workspace плюс config на диску./plugins enable|disableоновлює лише config plugin; воно не встановлює й не видаляє plugin.- Після змін enable/disable перезапустіть gateway, щоб застосувати їх.
Примітки щодо поверхонь
- Текстові команди виконуються в звичайній сесії чату (DM використовують
main, групи мають власну сесію). - Нативні команди використовують ізольовані сесії:
- Discord:
agent:<agentId>:discord:slash:<userId> - Slack:
agent:<agentId>:slack:slash:<userId>(префікс налаштовується черезchannels.slack.slashCommand.sessionPrefix) - Telegram:
telegram:slash:<userId>(націлюється на сесію чату черезCommandTargetSessionKey)
- Discord:
/stopнацілюється на активну сесію чату, щоб можна було перервати поточне виконання.- Slack:
channels.slack.slashCommandусе ще підтримується для однієї команди у стилі/openclaw. Якщо ви ввімкнетеcommands.native, ви маєте створити одну slash command Slack для кожної вбудованої команди (з тими самими назвами, що й/help). Меню аргументів команд для Slack доставляються як ефемерні кнопки Block Kit.- Нативний виняток Slack: зареєструйте
/agentstatus(а не/status), тому що Slack резервує/status. Текстова/statusу повідомленнях Slack усе одно працює.
- Нативний виняток Slack: зареєструйте
Побічні запитання BTW
/btw — це швидке побічне запитання про поточну сесію.
На відміну від звичайного чату:
- воно використовує поточну сесію як фоновий контекст,
- воно виконується як окремий одноразовий виклик без інструментів,
- воно не змінює майбутній контекст сесії,
- воно не записується в історію транскрипту,
- воно доставляється як живий побічний результат, а не як звичайне повідомлення асистента.
/btw корисним, коли вам потрібне тимчасове уточнення, поки основне
завдання триває.
Приклад: