Skills
Команди з косою рискою
Gateway обробляє команди, надіслані як окремі повідомлення, що починаються з /.
Bash-команди лише для хоста використовують ! <cmd> (із /bash <cmd> як псевдонімом).
Коли розмову прив’язано до сеансу ACP, звичайний текст спрямовується до
середовища ACP. Команди керування Gateway залишаються локальними: /acp ... завжди надходить
до обробника команд OpenClaw, а /status і /unfocus залишаються локальними, коли
обробку команд увімкнено для цієї поверхні.
Три типи команд
Окремі повідомлення /..., які обробляє Gateway. Вони мають бути
єдиним вмістом повідомлення.
/think, /fast, /verbose, /trace, /reasoning, /elevated,
/exec, /model, /queue — вилучаються з повідомлення до того, як його
побачить модель. Зберігають налаштування сеансу, якщо надіслані окремо; діють як вбудовані підказки,
якщо надіслані з іншим текстом.
/help, /commands, /status, /whoami — виконуються негайно та
вилучаються до того, як модель побачить решту тексту. Лише для авторизованих відправників.
Докладно про поведінку директив
- Директиви вилучаються з повідомлення до того, як його побачить модель.
- У повідомленнях, що містять лише директиви (повідомлення складається лише з директив), вони зберігаються в сеансі, а у відповідь надходить підтвердження.
- У повідомленнях звичайного чату з іншим текстом вони діють як вбудовані підказки та не зберігають налаштування сеансу.
- Директиви застосовуються лише для авторизованих відправників. Якщо встановлено
commands.allowFrom, використовується лише цей список дозволених користувачів; інакше авторизація визначається списками дозволених користувачів каналу/спарюванням разом ізcommands.useAccessGroups. Для неавторизованих відправників директиви обробляються як звичайний текст.
Конфігурація
{ commands: { native: "auto", nativeSkills: "auto", text: true, bash: false, bashForegroundMs: 2000, config: false, mcp: false, plugins: false, debug: false, restart: true, ownerAllowFrom: ["discord:123456789012345678"], ownerDisplay: "raw", ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}", allowFrom: { "*": ["user1"], discord: ["user:123"], }, useAccessGroups: true, },}commands.textbooleandefault: trueВмикає розбір /... у повідомленнях чату. На поверхнях без нативних команд
(WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams) текстові
команди працюють, навіть якщо встановлено значення false.
commands.nativeboolean | "auto"default: "auto"Реєструє нативні команди. Автоматичний режим: увімкнено для Discord/Telegram; вимкнено для Slack;
ігнорується для постачальників без нативної підтримки. Перевизначається для окремого каналу за допомогою
channels.<provider>.commands.native. У Discord значення false пропускає реєстрацію
команд із косою рискою; раніше зареєстровані команди можуть залишатися видимими до видалення.
commands.nativeSkillsboolean | "auto"default: "auto"Реєструє команди Skills як нативні, якщо це підтримується. Автоматичний режим: увімкнено для
Discord/Telegram; вимкнено для Slack. Перевизначається за допомогою
channels.<provider>.commands.nativeSkills.
commands.bashbooleandefault: falseДозволяє ! <cmd> запускати команди оболонки хоста (псевдонім /bash <cmd>). Потребує
списків дозволених користувачів tools.elevated.
commands.bashForegroundMsnumberdefault: 2000Час очікування bash перед переходом у фоновий режим (0 означає
негайний перехід у фоновий режим).
commands.configbooleandefault: falseВмикає /config (читання/запис openclaw.json). Лише для власника.
commands.mcpbooleandefault: falseВмикає /mcp (читання/запис керованої OpenClaw конфігурації MCP у mcp.servers). Лише для власника.
commands.pluginsbooleandefault: falseВмикає /plugins (виявлення/стан плагінів, а також встановлення й увімкнення/вимкнення). Запис доступний лише власнику.
commands.debugbooleandefault: falseВмикає /debug (перевизначення конфігурації лише під час виконання). Лише для власника.
commands.restartbooleandefault: trueВмикає /restart і дії інструментів для перезапуску Gateway.
commands.ownerAllowFromstring[]Явний список дозволених власників для поверхонь команд, доступних лише власнику. Окремий від
commands.allowFrom і доступу через спарювання в особистих повідомленнях.
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs
.commands.enforceOwnerForCommands" type="boolean" default="false">
Для кожного каналу: вимагає ідентичність власника для команд, доступних лише власнику. Якщо значення true,
відправник має відповідати commands.ownerAllowFrom або мати внутрішню область дії operator.admin.
Запис із символом узагальнення в allowFrom не є достатнім.
commands.ownerDisplay"raw" | "hash"Керує тим, як ідентифікатори власників відображаються в системному запиті.
commands.ownerDisplaySecretstringСекрет HMAC, що використовується, коли задано commands.ownerDisplay: "hash".
commands.allowFromobjectОкремий для кожного провайдера список дозволених джерел для авторизації команд. Якщо його налаштовано, він є
єдиним джерелом авторизації для команд і директив. Використовуйте "*" як
глобальне значення за замовчуванням; ключі конкретних провайдерів мають вищий пріоритет.
commands.useAccessGroupsbooleandefault: trueЗабезпечує дотримання списків дозволених джерел і політик для команд, коли commands.allowFrom не задано.
Список команд
Команди надходять із трьох джерел:
- Вбудовані команди ядра:
src/auto-reply/commands-registry.shared.ts - Згенеровані команди панелі:
src/auto-reply/commands-registry.data.ts - Команди Plugin: виклики
registerCommand()у Plugin
Доступність залежить від прапорців конфігурації, можливостей каналу та встановлених і ввімкнених Plugin.
Команди ядра
Сеанси та запуски
| Команда | Опис |
|---|---|
/new [model] |
Архівувати поточний сеанс і почати новий |
/reset [soft [message]] |
Скинути поточний сеанс без його заміни. soft зберігає стенограму, видаляє повторно використані ідентифікатори сеансів серверної частини CLI та повторно запускає ініціалізацію |
/name <title> |
Назвати або перейменувати поточний сеанс. Не вказуйте назву, щоб побачити поточну назву та пропозицію |
/compact [instructions] |
Стиснути контекст сеансу. Див. Compaction |
/stop |
Перервати поточний запуск |
/session idle <duration|off> |
Керувати завершенням прив’язки до гілки через бездіяльність |
/session max-age <duration|off> |
Керувати завершенням прив’язки до гілки через досягнення максимального віку |
/export-session [path] |
Експортувати поточний сеанс у HTML. Псевдонім: /export |
/export-trajectory [path] |
Експортувати пакет траєкторії JSONL для поточного сеансу. Псевдонім: /trajectory |
Керування моделлю та запуском
| Команда | Опис |
|---|---|
/think <level|default> |
Установити рівень обмірковування або очистити перевизначення сеансу. Псевдоніми: /thinking, /t |
/verbose on|off|full |
Увімкнути або вимкнути докладний вивід. Псевдонім: /v |
/trace on|off |
Увімкнути або вимкнути трасувальний вивід Plugin для поточного сеансу |
/fast [status|auto|on|off|default] |
Показати, установити або очистити швидкий режим |
/reasoning [on|off|stream] |
Увімкнути або вимкнути видимість міркувань. Псевдонім: /reason |
/elevated [on|off|ask|full] |
Увімкнути або вимкнути режим підвищених привілеїв. Псевдонім: /elev |
/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id> |
Показати або встановити типові параметри виконання |
/login [codex|openai|openai-codex] |
Пов’язати облікові дані для входу в Codex/OpenAI із приватного чату або сеансу вебінтерфейсу. Лише для власника чи адміністратора |
/model [name|#|status] |
Показати або встановити модель |
/models [provider] [page] [limit=<n>|all] |
Перелічити налаштованих або доступних за автентифікацією постачальників чи моделі |
/queue <mode> |
Керувати поведінкою черги активного запуску. Див. Черга та Керування чергою |
/steer <message> |
Додати вказівки до активного запуску. Псевдонім: /tell. Див. Спрямування |
Безпека verbose / trace / fast / reasoning
/verboseпризначено для налагодження — за звичайного використання залишайте його вимкненим./traceпоказує лише належні Plugin рядки трасування та налагодження; звичайний докладний вивід залишається вимкненим./fast auto|on|offзберігає перевизначення сеансу; скористайтеся параметромinheritв інтерфейсі Sessions, щоб очистити його./fastзалежить від постачальника: OpenAI/Codex зіставляють його зservice_tier=priority; прямі запити Anthropic зіставляють його зservice_tier=autoабоstandard_only./reasoning,/verboseі/traceризиковано використовувати в групах — вони можуть розкрити внутрішні міркування або діагностику Plugin. Залишайте їх вимкненими в групових чатах.
Подробиці перемикання моделі
/modelнегайно зберігає нову модель у сеансі.- Якщо агент неактивний, її буде використано вже під час наступного запуску.
- Якщо запуск активний, перемикання позначається як відкладене й застосовується в наступній безпечній точці повторної спроби.
Виявлення та стан
| Команда | Опис |
|---|---|
/help |
Показати стислий огляд довідки |
/commands |
Показати згенерований каталог команд |
/tools [compact|verbose] |
Показати, що поточний агент може використовувати зараз |
/status |
Показати стан виконання та середовища, час роботи Gateway і системи, справність Plugin, а також використання й квоту постачальника |
/status plugins |
Показати докладний стан Plugin: помилки завантаження, карантини, збої Plugin каналів, проблеми із залежностями та сповіщення про сумісність. Потрібно commands.plugins: true |
/goal [status|start|edit|pause|resume|complete|block|clear] ... |
Керувати постійною метою поточного сеансу |
/diagnostics [note] |
Процес створення звіту для служби підтримки лише для власника. Щоразу запитує схвалення виконання |
/crestodian <request> |
Запустити помічник налаштування та відновлення Crestodian з приватного повідомлення власника |
/tasks |
Перелічити активні та нещодавні фонові завдання поточного сеансу |
/context [list|detail|map|json] |
Пояснити, як формується контекст |
/whoami |
Показати ваш ідентифікатор відправника. Псевдонім: /id |
/usage off|tokens|full|reset|cost |
Керувати приміткою про використання під кожною відповіддю (reset/inherit/clear/default очищає перевизначення сеансу, щоб знову успадковувати налаштоване типове значення) або вивести локальний підсумок вартості |
Skills, списки дозволів і схвалення
| Команда | Опис |
|---|---|
/skill <name> [input] |
Запустити навичку за назвою |
/learn [request] |
Створити чернетку однієї навички для перевірки з поточної розмови або вказаних джерел за допомогою Майстерні навичок |
/allowlist [list|add|remove] ... |
Керувати записами списку дозволів. Лише текст |
/approve <id> <decision> |
Опрацювати запити на схвалення виконання або Plugin |
/btw <question> |
Поставити побічне запитання, не змінюючи контекст сеансу. Псевдонім: /side. Див. До речі |
Субагенти та ACP
| Команда | Опис |
|---|---|
/subagents list|log|info |
Переглянути запуски субагентів для поточного сеансу |
/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help |
Керувати сеансами ACP та параметрами середовища виконання. Для керування середовищем виконання потрібна ідентичність зовнішнього власника або внутрішнього адміністратора Gateway |
/focus <target> |
Прив’язати поточну гілку Discord або тему Telegram до цільового сеансу |
/unfocus |
Видалити прив’язку поточної гілки |
/agents |
Перелічити агентів, прив’язаних до гілки поточного сеансу |
Записи й адміністрування лише для власника
| Команда | Вимоги | Опис |
|---|---|---|
/config show|get|set|unset |
commands.config: true |
Читати або записувати openclaw.json. Лише для власника |
/mcp show|get|set|unset |
commands.mcp: true |
Читати або записувати конфігурацію сервера MCP, якою керує OpenClaw. Лише для власника |
/plugins list|inspect|show|get|install|enable|disable |
commands.plugins: true |
Переглядати або змінювати стан плагінів. Запис — лише для власника. Псевдонім: /plugin |
/debug show|set|unset|reset |
commands.debug: true |
Перевизначення конфігурації лише для середовища виконання. Лише для власника |
/restart |
commands.restart: true (типово) |
Перезапустити OpenClaw |
/send on|off|inherit |
власник | Установити політику надсилання |
Голос, TTS і керування каналом
| Команда | Опис |
|---|---|
/tts on|off|status|chat|latest|provider|limit|summary|audio|help |
Керувати TTS. Див. TTS |
/activation mention|always |
Установити режим активації групи |
/bash <command> |
Виконати команду оболонки на хості. Псевдонім: ! <command>. Потрібно commands.bash: true |
!poll [sessionId] |
Перевірити фонове завдання bash |
!stop [sessionId] |
Зупинити фонове завдання bash |
Команди стикування
Команди стикування перемикають маршрут відповіді активного сеансу на інший пов’язаний канал. Відомості про налаштування та усунення несправностей див. у розділі Стикування каналів.
Створюються з плагінів каналів, які підтримують нативні команди:
/dock-discord(псевдонім:/dock_discord)/dock-mattermost(псевдонім:/dock_mattermost)/dock-slack(псевдонім:/dock_slack)/dock-telegram(псевдонім:/dock_telegram)
Для команд стикування потрібен параметр session.identityLinks. Відправник із вихідного каналу та цільовий співрозмовник
мають належати до однієї групи ідентичностей.
Команди вбудованих плагінів
| Команда | Опис |
|---|---|
/dreaming [on|off|status|help] |
Увімкнути або вимкнути Dreaming для пам’яті (власник або адміністратор Gateway). Див. Dreaming |
/pair [qr|status|pending|approve|cleanup|notify] |
Керувати сполученням пристроїв. Див. Сполучення |
/phone status|arm ...|disarm |
Тимчасово дозволити команди Node із високим ризиком (камера, екран, комп’ютер, операції запису). Див. Використання комп’ютера |
/voice status|list|set <voiceId> |
Керувати конфігурацією голосу Talk. Нативна назва в Discord: /talkvoice |
/card ... |
Надсилати шаблони розширених карток LINE. Див. LINE |
/codex <action> ... |
Прив’язувати, спрямовувати й перевіряти обв’язку сервера застосунку Codex (стан, гілки, відновлення, модель, швидкий режим, дозволи, ущільнення, перевірка, mcp, Skills тощо). Див. Обв’язка Codex |
Лише для QQBot: /bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs
Команди Skills
Skills, які може викликати користувач, доступні як команди з косою рискою:
/skill <name> [input]завжди працює як універсальна точка входу.- Skills можуть реєструватися як безпосередні команди (наприклад,
/proseдля OpenProse). - Реєстрація нативних команд Skills керується параметрами
commands.nativeSkillsіchannels.<provider>.commands.nativeSkills. - Назви очищуються до
a-z0-9_(щонайбільше 32 символи); у разі конфліктів додаються числові суфікси.
Маршрутизація команд Skills
Типово команди Skills спрямовуються до моделі як звичайний запит.
Skills можуть оголосити command-dispatch: tool, щоб спрямовувати запит безпосередньо до інструмента
(детерміновано, без участі моделі). Приклад: /prose (плагін OpenProse)
— див. OpenProse.
Аргументи нативних команд
Discord використовує автодоповнення для динамічних параметрів і меню кнопок, коли обов’язкові
аргументи не вказано. Telegram і Slack показують меню кнопок для команд із
варіантами вибору. Динамічні варіанти визначаються за моделлю цільового сеансу, тому залежні від
моделі параметри, як-от рівні /think, враховують перевизначення /model у сеансі.
/tools: що агент може використовувати зараз
/tools відповідає на запитання про середовище виконання: що цей агент може використовувати просто зараз у цій
розмові, а не показує статичний каталог конфігурації.
/tools # компактне подання/tools verbose # із короткими описамиРезультати обмежені поточним сеансом. Зміна агента, каналу, гілки, авторизації відправника або моделі може змінити результат. Щоб редагувати профілі та перевизначення, скористайтеся панеллю інструментів у Control UI або засобами конфігурації.
/model: вибір моделі
/model # показати засіб вибору моделі/model list # те саме/model 3 # вибрати за номером із засобу вибору/model openai/gpt-5.4/model opus@anthropic:default/model default # очистити вибір моделі для сеансу/model status # докладне подання з кінцевою точкою та режимом APIУ Discord команди /model і /models відкривають інтерактивний засіб вибору з розкривними списками
постачальників і моделей. Засіб вибору враховує agents.defaults.models, зокрема
записи provider/*.
/config: запис конфігурації на диск
/config show/config show messages.responsePrefix/config get messages.responsePrefix/config set messages.responsePrefix="[openclaw]"/config unset messages.responsePrefixПеред записом конфігурація перевіряється. Недійсні зміни відхиляються. Оновлення через /config
зберігаються після перезапусків.
/mcp: конфігурація сервера MCP
/mcp show/mcp show context7/mcp set context7={"command":"uvx","args":["context7-mcp"]}/mcp unset context7/mcp зберігає конфігурацію в конфігурації OpenClaw, а не в налаштуваннях проєкту вбудованого агента.
/mcp show приховує поля з обліковими даними, значення розпізнаних прапорців облікових даних
і відомі аргументи, схожі на секрети. Якщо команду виконано з групи,
конфігурація надсилається власнику приватно; якщо приватний маршрут до власника
недоступний, команда безпечно завершується помилкою та просить власника повторити спробу в особистому
чаті.
/debug: перевизначення лише для середовища виконання
/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset/plugins: керування плагінами
/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install ./path/to/plugin/plugins enable|disable оновлює конфігурацію плагінів і виконує гаряче перезавантаження
середовища виконання плагінів Gateway для нових ходів агента. /plugins install автоматично
перезапускає керовані Gateway, оскільки змінилися модулі вихідного коду плагінів.
/trace: виведення трасування плагінів
/trace # показати поточний стан трасування/trace on/trace off/trace показує обмежені сеансом рядки трасування й налагодження плагінів без повного докладного
режиму. Він не замінює /debug (перевизначення середовища виконання) або /verbose (звичайне
виведення інструментів).
/btw: побічні запитання
/btw — це швидке побічне запитання щодо контексту поточного сеансу. Псевдонім: /side.
/btw що ми зараз робимо?/side що змінилося, поки тривав основний запуск?На відміну від звичайного повідомлення:
- Використовує поточний сеанс як фоновий контекст.
- У сеансах обв’язки Codex запускається як тимчасова побічна гілка Codex.
- Не змінює майбутній контекст сеансу.
- Не записується до історії стенограми.
Повний опис поведінки див. у розділі Побічні запитання BTW.
Примітки щодо поверхонь
Область сеансу для кожної поверхні
- Текстові команди: виконуються у звичайному сеансі чату (особисті повідомлення використовують спільний
main, групи мають власний сеанс). - Нативні команди Discord:
agent:<agentId>:discord:slash:<userId> - Нативні команди Slack:
agent:<agentId>:slack:slash:<userId>(префікс налаштовується черезchannels.slack.slashCommand.sessionPrefix) - Нативні команди Telegram:
telegram:slash:<userId>(цільовим є сеанс чату черезCommandTargetSessionKey) /login codexнадсилає коди сполучення пристрою лише через особистий чат або канали відповіді Web UI. У разі виклику в групі або темі Telegram власнику пропонується натомість написати боту особисте повідомлення./stopспрямовується до активного сеансу чату, щоб перервати поточний запуск.
Особливості Slack
channels.slack.slashCommand підтримує одну команду у стилі /openclaw.
Якщо задано commands.native: true, створіть окрему команду Slack із косою рискою для кожної вбудованої
команди. Зареєструйте /agentstatus (не /status), оскільки Slack резервує
/status. Текстова команда /status і надалі працює в повідомленнях Slack.
Швидкий шлях і вбудовані скорочення
- Повідомлення, що містять лише команди й надіслані відправниками зі списку дозволених, обробляються негайно (в обхід черги та моделі).
- Вбудовані скорочення (
/help,/commands,/status,/whoami) також працюють усередині звичайних повідомлень і вилучаються, перш ніж модель побачить решту тексту. - Неавторизовані повідомлення, що містять лише команди, мовчки ігноруються; вбудовані токени
/...розглядаються як звичайний текст.
Примітки щодо аргументів
- Команди допускають необов’язковий символ
:між командою та аргументами (/think: high,/send: on). /new <model>приймає псевдонім моделі,provider/modelабо назву постачальника (нечітка відповідність); якщо відповідності немає, текст розглядається як тіло повідомлення.- Для
/allowlist add|removeпотрібноcommands.config: true; команда враховує параметр каналуconfigWrites.
Використання постачальника та стан
- Використання/квота провайдера (наприклад, «Claude: залишилося 80%») відображається в
/statusдля провайдера поточної моделі, коли ввімкнено відстеження використання. - Рядки токенів/кешу в
/statusможуть використовувати останній запис про використання з журналу сеансу, якщо поточний знімок сеансу містить недостатньо даних. - Виконання та середовище виконання:
/statusпоказуєExecutionдля фактичного шляху пісочниці таRuntimeдля виконавця сеансу:OpenClaw Default,OpenAI Codex, серверна частина CLI або серверна частина ACP. - Токени/вартість для кожної відповіді: керуються командою
/usage off|tokens|full. /model statusстосується моделей, автентифікації та кінцевих точок, а не використання.