Skills
Слеш-команди
Gateway обробляє команди, надіслані як окремі повідомлення, що починаються з /.
Bash-команди лише для хоста використовують ! <cmd> (з /bash <cmd> як псевдонімом).
Коли розмову прив’язано до ACP-сесії, звичайний текст маршрутизується до ACP
harness. Команди керування 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"Реєструє нативні команди. Auto: увімкнено для Discord/Telegram; вимкнено для Slack;
ігнорується для провайдерів без нативної підтримки. Перевизначайте для кожного каналу через
channels.<provider>.commands.native. У Discord false пропускає реєстрацію slash-command;
раніше зареєстровані команди можуть залишатися видимими, доки їх не видалять.
commands.nativeSkillsboolean | "auto"default: "auto"Реєструє команди Skills нативно, коли це підтримується. 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 (читає/записує MCP-конфігурацію, керовану OpenClaw, у mcp.servers). Лише для власника.
commands.pluginsbooleandefault: falseУмикає /plugins (виявлення/статус plugin плюс встановлення та ввімкнення/вимкнення). Записи лише для власника.
commands.debugbooleandefault: falseУмикає /debug (перевизначення конфігурації лише під час виконання). Лише для власника.
commands.restartbooleandefault: trueУмикає /restart і дії інструментів перезапуску gateway.
commands.ownerAllowFromstring[]Явний список дозволів власника для командних поверхонь лише для власника. Окремо від
commands.allowFrom і доступу через DM-сполучення.
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs
.commands.enforceOwnerForCommands" type="boolean" default="false">
Для кожного каналу: вимагає ідентичності власника для команд лише для власника. Коли true,
відправник має збігатися з commands.ownerAllowFrom або мати внутрішній scope operator.admin.
Запис із wildcard у allowFrom не є достатнім.
commands.ownerDisplay"raw" | "hash"Керує тим, як id власників відображаються в системному prompt.
commands.ownerDisplaySecretstringHMAC-секрет, який використовується, коли commands.ownerDisplay: "hash".
commands.allowFromobjectСписок дозволів для авторизації команд для кожного провайдера. Коли налаштовано, він є
єдиним джерелом авторизації для команд і директив. Використовуйте "*" для
глобального значення за замовчуванням; ключі конкретних провайдерів його перевизначають.
commands.useAccessGroupsbooleandefault: trueЗастосовує списки дозволів/політики для команд, коли commands.allowFrom не задано.
Список команд
Команди надходять із трьох джерел:
- Вбудовані команди ядра:
src/auto-reply/commands-registry.shared.ts - Згенеровані dock-команди:
src/auto-reply/commands-registry.data.ts - Команди Plugin: виклики
registerCommand()plugin
Доступність залежить від прапорців конфігурації, поверхні каналу та встановлених/увімкнених plugins.
Команди ядра
Сесії та запуски
| Команда | Опис |
|---|---|
/new [model] |
Архівувати поточну сесію та почати нову |
/reset [soft [message]] |
Скинути поточну сесію на місці. soft зберігає transcript, відкидає повторно використані id сесій CLI backend і повторно запускає старт |
/name <title> |
Назвати або перейменувати поточну сесію. Пропустіть назву, щоб побачити поточну назву та пропозицію |
/compact [instructions] |
Стиснути контекст сесії. Див. Compaction |
/stop |
Перервати поточний запуск |
/session idle <duration|off> |
Керувати закінченням строку простою прив’язки thread |
/session max-age <duration|off> |
Керувати закінченням максимального віку прив’язки thread |
/export-session [path] |
Експортувати поточну сесію в HTML. Псевдонім: /export |
/export-trajectory [path] |
Експортувати JSONL-пакет trajectory для поточної сесії. Псевдонім: /trajectory |
Керування моделлю та запуском
| Команда | Опис |
|---|---|
/think <level|default> |
Установити рівень thinking або очистити перевизначення сесії. Псевдоніми: /thinking, /t |
/verbose on|off|full |
Перемкнути докладний вивід. Псевдонім: /v |
/trace on|off |
Перемкнути вивід трасування plugin для поточної сесії |
/fast [status|auto|on|off|default] |
Показати, установити або очистити швидкий режим |
/reasoning [on|off|stream] |
Перемкнути видимість reasoning. Псевдонім: /reason |
/elevated [on|off|ask|full] |
Перемкнути elevated-режим. Псевдонім: /elev |
/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id> |
Показати або встановити стандартні значення exec |
/login [codex|openai|openai-codex] |
Сполучити вхід Codex/OpenAI із приватного чату або Web UI-сесії. Лише власник/адміністратор |
/model [name|#|status] |
Показати або встановити модель |
/models [provider] [page] [limit=<n>|all] |
Перелічити налаштованих/доступних для auth провайдерів або моделі |
/queue <mode> |
Керувати поведінкою черги активного запуску. Див. Черга і Керування чергою |
/steer <message> |
Вставити вказівки в активний запуск. Псевдонім: /tell. Див. Керування |
Безпека verbose / trace / fast / reasoning
/verboseпризначено для налагодження — тримайте його вимкненим під час звичайного використання./traceпоказує лише рядки trace/debug, що належать plugin; звичайний докладний шум залишається вимкненим./fast auto|on|offзберігає перевизначення сесії; використовуйте опціюinheritу Sessions UI, щоб його очистити./fastзалежить від провайдера: OpenAI/Codex зіставляють його зservice_tier=priority; прямі запити Anthropic зіставляють його зservice_tier=autoабоstandard_only./reasoning,/verboseі/traceризиковані в групових налаштуваннях — вони можуть розкрити внутрішнє reasoning або діагностику plugin. Тримайте їх вимкненими в групових чатах.
Докладно про перемикання моделі
/modelнегайно зберігає нову модель у сесії.- Якщо агент простоює, наступний запуск використовує її відразу.
- Якщо запуск активний, перемикання позначається як очікуване та застосовується в наступній чистій точці повторної спроби.
Виявлення та статус
| Команда | Опис |
|---|---|
/help |
Показати короткий підсумок довідки |
/commands |
Показати згенерований каталог команд |
/tools [compact|verbose] |
Показати, що поточний агент може використовувати просто зараз |
/status |
Показати статус виконання/runtime, час безперервної роботи Gateway і системи, справність plugin, а також використання/квоту провайдера |
/status plugins |
Показати детальну справність plugin: помилки завантаження, карантини, збої каналів, проблеми залежностей, повідомлення про сумісність |
/goal [status|start|pause|resume|complete|block|clear] ... |
Керувати довготривалою ціллю поточної сесії |
/diagnostics [note] |
Потік звіту підтримки лише для власника. Щоразу запитує схвалення exec |
/crestodian <request> |
Запустити помічник налаштування та ремонту Crestodian з DM власника |
/tasks |
Перелічити активні/недавні фонові завдання для поточної сесії |
/context [list|detail|map|json] |
Пояснити, як збирається контекст |
/whoami |
Показати ваш sender id. Псевдонім: /id |
/usage off|tokens|full|reset|cost |
Керувати footer використання для кожної відповіді (reset/inherit/clear/default очищає перевизначення сесії для повторного успадкування налаштованого стандартного значення) або вивести локальний підсумок вартості |
Skills, списки дозволів, схвалення
| Команда | Опис |
|---|---|
/skill <name> [input] |
Запустити skill за назвою |
/allowlist [list|add|remove] ... |
Керувати записами списку дозволів. Лише текст |
/approve <id> <decision> |
Вирішити запити схвалення exec або plugin |
/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. Запис лише для власника. Псевдонім: /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 |
Команди стикування
Команди стикування перемикають маршрут відповіді активного сеансу на інший пов’язаний канал. Див. Стикування каналів щодо налаштування та усунення проблем.
Згенеровано з Plugin каналів із підтримкою нативних команд:
/dock-discord(псевдонім:/dock_discord)/dock-mattermost(псевдонім:/dock_mattermost)/dock-slack(псевдонім:/dock_slack)/dock-telegram(псевдонім:/dock_telegram)
Команди стикування потребують session.identityLinks. Відправник-джерело та цільовий учасник
мають бути в одній групі ідентичності.
Команди вбудованих Plugin
| Команда | Опис |
|---|---|
/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 status|models|threads|resume|compact|review|diagnostics|account|mcp|skills |
Керувати серверним застосунком harness Codex. Див. Codex harness |
Лише QQBot: /bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs
Команди Skills
Skills, які може викликати користувач, доступні як slash-команди:
/skill <name> [input]завжди працює як універсальна точка входу.- Skills можуть реєструватися як прямі команди (наприклад,
/proseдля OpenProse). - Реєстрація нативних команд Skills керується
commands.nativeSkillsіchannels.<provider>.commands.nativeSkills. - Імена нормалізуються до
a-z0-9_(макс. 32 символи); колізії отримують числові суфікси.
Маршрутизація команд Skills
Типово команди Skills спрямовуються до моделі як звичайний запит.
Skills можуть оголосити command-dispatch: tool, щоб спрямовуватися безпосередньо до інструмента
(детерміновано, без участі моделі). Приклад: /prose (Plugin OpenProse)
— див. OpenProse.
Аргументи нативних команд
Discord використовує автодоповнення для динамічних параметрів і меню кнопок, коли обов’язкові
аргументи пропущено. Telegram і Slack показують меню кнопок для команд із
варіантами вибору. Динамічні варіанти визначаються відносно моделі цільового сеансу, тому специфічні для моделі
параметри, як-от рівні /think, відповідають перевизначенню /model сеансу.
/tools — що агент може використовувати зараз
/tools відповідає на питання середовища виконання: що цей агент може використовувати прямо зараз у цій
розмові — не статичний каталог конфігурації.
/tools # compact view/tools verbose # with short descriptionsРезультати обмежені сеансом. Зміна агента, каналу, треду, авторизації відправника або моделі може змінити вивід. Для редагування профілю та перевизначень використовуйте панель Control UI Tools або поверхні конфігурації.
/model — вибір моделі
/model # show model picker/model list # same/model 3 # select by number from picker/model openai/gpt-5.4/model opus@anthropic:default/model default # clear the session model selection/model status # detailed view with endpoint and API modeУ 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, а не в налаштуваннях проєкту вбудованого агента.
/debug — перевизначення лише в середовищі виконання
/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset/plugins — керування Plugin
/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install ./path/to/plugin/plugins enable|disable оновлює конфігурацію Plugin і гаряче перезавантажує середовище виконання Plugin Gateway
для нових ходів агента. /plugins install автоматично перезапускає керовані
Gateway, оскільки змінилися вихідні модулі Plugin.
/trace — вивід трасування Plugin
/trace # show current trace state/trace on/trace off/trace показує рядки трасування/налагодження Plugin, обмежені сеансом, без повного докладного
режиму. Він не замінює /debug (перевизначення середовища виконання) або /verbose (звичайний
вивід інструментів).
/btw — побічні запитання
/btw — це швидке побічне запитання про контекст поточного сеансу. Псевдонім: /side.
/btw what are we doing right now?/side what changed while the main run continued?На відміну від звичайного повідомлення:
- Використовує поточний сеанс як фоновий контекст.
- У сеансах Codex harness запускається як ефемерний побічний тред Codex.
- Не змінює майбутній контекст сеансу.
- Не записується в історію транскрипту.
Див. Побічні запитання BTW для повної поведінки.
Примітки щодо поверхонь
Область сеансу для кожної поверхні
- Текстові команди: виконуються у звичайному чат-сеансі (DM використовують спільний
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 просять власника натомість написати боту в DM./stopцілять в активний чат-сеанс, щоб перервати поточний запуск.
Особливості Slack
channels.slack.slashCommand підтримує одну команду в стилі /openclaw.
З commands.native: true створіть по одній slash-команді 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% left") показується в
/statusдля провайдера поточної моделі, коли відстеження використання ввімкнено. - Рядки токенів/кешу в
/statusможуть відступати до останнього запису використання з транскрипту, коли живий знімок сеансу неповний. - Виконання проти середовища виконання:
/statusповідомляєExecutionдля ефективного шляху sandbox іRuntimeдля того, хто запускає сеанс:OpenClaw Default,OpenAI Codex, бекенд CLI або бекенд ACP. - Токени/вартість на відповідь: керується через
/usage off|tokens|full. /model statusстосується моделей/автентифікації/endpoint, а не використання.