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"Реєструє команди навичок як нативні, якщо це підтримується. Автоматичний режим: увімкнено для
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 та зовнішні запити на перезапуск SIGUSR1.
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 - Команди плагінів: виклики
registerCommand()плагіна
Доступність залежить від прапорців конфігурації, поверхні каналу та встановлених/увімкнених плагінів.
Команди ядра
Сеанси та запуски
| Команда | Опис |
|---|---|
/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 |
Явні шляхи /export-session замінюють наявні файли в
робочому просторі. Пропустіть шлях, щоб згенерувати ім’я файлу, захищене від колізій.
Керування моделлю та запуском
| Команда | Опис |
|---|---|
/think <level|default> |
Установити рівень міркування або очистити перевизначення сеансу. Псевдоніми: /thinking, /t |
/verbose on|off|full |
Перемкнути докладне виведення. Псевдонім: /v |
/trace on|off |
Перемкнути виведення трасування плагіна для поточного сеансу |
/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показує лише рядки трасування/налагодження, що належать плагіну; звичайне докладне виведення залишається вимкненим./fast auto|on|offзберігає перевизначення сеансу; щоб очистити його, скористайтеся параметромinheritв інтерфейсі Sessions./fastзалежить від постачальника: OpenAI/Codex зіставляють його зservice_tier=priority; прямі запити Anthropic зіставляють його зservice_tier=autoабоstandard_only./reasoning,/verboseта/traceризиковано використовувати в групах — вони можуть розкрити внутрішні міркування або діагностику плагінів. Залишайте їх вимкненими в групових чатах.
Докладно про перемикання моделей
/modelнегайно зберігає нову модель у сеансі.- Якщо агент неактивний, наступний запуск відразу використовує її.
- Якщо запуск активний, перемикання позначається як очікуване та застосовується в наступній безпечній точці повторної спроби.
Виявлення та стан
| Команда | Опис |
|---|---|
/help |
Показати стислий довідковий огляд |
/commands |
Показати згенерований каталог команд |
/tools [compact|verbose] |
Показати, що поточний агент може використовувати зараз |
/status |
Показати стан виконання/середовища виконання, час роботи Gateway і системи, працездатність плагінів, а також використання/квоту постачальника |
/status plugins |
Показати докладний стан плагінів: помилки завантаження, карантини, збої плагінів каналів, проблеми залежностей, сповіщення про сумісність. Потребує commands.plugins: true |
/goal [status|start|edit|pause|resume|complete|block|clear] ... |
Керувати довготривалою ціллю поточного сеансу |
/diagnostics [note] |
Процес створення звіту підтримки лише для власника. Щоразу запитує схвалення виконання |
/openclaw <request> |
Запустити помічник налаштування та відновлення OpenClaw з особистого повідомлення власника |
/tasks |
Перелічити активні/недавні фонові завдання поточного сеансу |
/context [list|detail|map|json] |
Пояснити, як формується контекст |
/whoami |
Показати ідентифікатор відправника. Псевдонім: /id |
/usage off|tokens|full|reset|cost |
Керувати нижнім колонтитулом використання для кожної відповіді (reset/inherit/clear/default очищає перевизначення сеансу, щоб знову успадкувати налаштоване типове значення) або вивести локальний підсумок витрат |
Skills, списки дозволів, схвалення
| Команда | Опис |
|---|---|
/skill <name> [input] |
Запустити skill за назвою |
/learn [request] |
Підготувати один придатний до перевірки skill із поточної розмови або вказаних джерел за допомогою Майстерні skills |
/allowlist [list|add|remove] ... |
Керувати записами списку дозволів. Лише текст |
/approve <id> <decision> |
Опрацьовувати запити на схвалення виконання команд або плагінів |
/btw <question> |
Поставити побічне запитання без зміни контексту сеансу. Псевдонім: /side. Див. BTW |
Субагенти та 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 |
Тимчасово дозволити високоризикові команди вузла (камера/екран/комп’ютер/запис). Див. Використання комп’ютера |
/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 # з короткими описамиРезультати обмежено сеансом. Зміна агента, каналу, гілки, авторизації відправника або моделі може змінити вивід. Для редагування профілю та перевизначень використовуйте панель Tools в інтерфейсі керування або поверхні конфігурації.
/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 clawhub:<package>/plugins install npm:@openclaw/<official-package>/plugins install npm:<package> --force/plugins install git:<repository>@<ref> --force/plugins enable|disable оновлює конфігурацію плагіна та виконує гаряче перезавантаження
середовища виконання плагінів Gateway для нових звернень агента. /plugins install автоматично перезапускає керовані
Gateway, оскільки вихідні модулі плагіна змінилися. Установлення з довіреного ClawHub
та офіційного каталогу не потребують додаткового підтвердження. Довільні джерела npm,
git, архіви, npm-pack: та локальні шляхи показують попередження про походження й
потребують кінцевого --force після перевірки джерела. Цей прапорець підтверджує
джерело та дозволяє замінити наявне встановлення; він не обходить
security.installPolicy або перевірки безпеки інсталятора. Випуски ClawHub із
попередженнями про ризики все одно потребують окремого, доступного лише в оболонці
прапорця --acknowledge-clawhub-risk. Установлення з маркетплейсу, пов’язані та закріплені встановлення також
залишаються доступними лише в оболонці.
/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надсилає коди сполучення пристроїв лише через приватний чат або канали відповіді вебінтерфейсу. У разі виклику в групі або темі 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стосується моделей, автентифікації та кінцевих точок, а не використання.