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"

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

text
/tools         # стислий перегляд/tools verbose # з короткими описами

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

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

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 надсилає коди сполучення пристроїв лише через приватний чат або канали відповіді вебінтерфейсу. У разі виклику в групі або темі 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