Skills

Команди з косою рискою

Gateway обробляє команди, надіслані як окремі повідомлення, що починаються з /. Bash-команди лише для хоста використовують ! <cmd> (із /bash <cmd> як псевдонімом).

Коли розмову прив’язано до сеансу ACP, звичайний текст спрямовується до середовища ACP. Команди керування Gateway залишаються локальними: /acp ... завжди надходить до обробника команд OpenClaw, а /status і /unfocus залишаються локальними, коли обробку команд увімкнено для цієї поверхні.

Три типи команд

Докладно про поведінку директив
  • Директиви вилучаються з повідомлення до того, як його побачить модель.
  • У повідомленнях, що містять лише директиви (повідомлення складається лише з директив), вони зберігаються в сеансі, а у відповідь надходить підтвердження.
  • У повідомленнях звичайного чату з іншим текстом вони діють як вбудовані підказки та не зберігають налаштування сеансу.
  • Директиви застосовуються лише для авторизованих відправників. Якщо встановлено commands.allowFrom, використовується лише цей список дозволених користувачів; інакше авторизація визначається списками дозволених користувачів каналу/спарюванням разом із commands.useAccessGroups. Для неавторизованих відправників директиви обробляються як звичайний текст.

Конфігурація

json5
{  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 відповідає на запитання про середовище виконання: що цей агент може використовувати просто зараз у цій розмові, а не показує статичний каталог конфігурації.

text
/tools         # компактне подання/tools verbose # із короткими описами

Результати обмежені поточним сеансом. Зміна агента, каналу, гілки, авторизації відправника або моделі може змінити результат. Щоб редагувати профілі та перевизначення, скористайтеся панеллю інструментів у Control UI або засобами конфігурації.

/model: вибір моделі

text
/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: запис конфігурації на диск

text
/config show/config show messages.responsePrefix/config get messages.responsePrefix/config set messages.responsePrefix="[openclaw]"/config unset messages.responsePrefix

Перед записом конфігурація перевіряється. Недійсні зміни відхиляються. Оновлення через /config зберігаються після перезапусків.

/mcp: конфігурація сервера MCP

text
/mcp show/mcp show context7/mcp set context7={"command":"uvx","args":["context7-mcp"]}/mcp unset context7

/mcp зберігає конфігурацію в конфігурації OpenClaw, а не в налаштуваннях проєкту вбудованого агента. /mcp show приховує поля з обліковими даними, значення розпізнаних прапорців облікових даних і відомі аргументи, схожі на секрети. Якщо команду виконано з групи, конфігурація надсилається власнику приватно; якщо приватний маршрут до власника недоступний, команда безпечно завершується помилкою та просить власника повторити спробу в особистому чаті.

/debug: перевизначення лише для середовища виконання

text
/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset

/plugins: керування плагінами

text
/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: виведення трасування плагінів

text
/trace          # показати поточний стан трасування/trace on/trace off

/trace показує обмежені сеансом рядки трасування й налагодження плагінів без повного докладного режиму. Він не замінює /debug (перевизначення середовища виконання) або /verbose (звичайне виведення інструментів).

/btw: побічні запитання

/btw — це швидке побічне запитання щодо контексту поточного сеансу. Псевдонім: /side.

text
/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 стосується моделей, автентифікації та кінцевих точок, а не використання.

Пов’язані матеріали

Was this useful?
On this page

On this page