/.
Команди 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. Для неавторизованих відправників директиви обробляються як звичайний текст.
Конфігурація
boolean
за замовчуванням:"true"
Вмикає розбір
/... у повідомленнях чату. На поверхнях без нативних команд
(WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams) текстові
команди працюють, навіть якщо встановлено false.boolean | "auto"
за замовчуванням:"\"auto\""
Реєструє нативні команди. Автоматичний режим: увімкнено для Discord/Telegram; вимкнено для Slack;
ігнорується для постачальників без нативної підтримки. Перевизначається для кожного каналу через
channels.<provider>.commands.native. У Discord false пропускає реєстрацію
команд із косою рискою; раніше зареєстровані команди можуть залишатися видимими до видалення.boolean | "auto"
за замовчуванням:"\"auto\""
Реєструє команди навичок як нативні, якщо це підтримується. Автоматичний режим: увімкнено для
Discord/Telegram; вимкнено для Slack. Перевизначається через
channels.<provider>.commands.nativeSkills.boolean
за замовчуванням:"false"
Вмикає
! <cmd> для виконання команд оболонки хоста (псевдонім /bash <cmd>). Потребує
списків дозволених tools.elevated.number
за замовчуванням:"2000"
Визначає, скільки часу bash очікує перед переходом у фоновий режим (
0 переходить
у фоновий режим негайно).boolean
за замовчуванням:"false"
Вмикає
/config (читання/запис openclaw.json). Лише для власника.boolean
за замовчуванням:"false"
Вмикає
/mcp (читання/запис керованої OpenClaw конфігурації MCP у mcp.servers). Лише для власника.boolean
за замовчуванням:"false"
Вмикає
/plugins (виявлення/стан плагінів, а також установлення та ввімкнення/вимкнення). Запис — лише для власника.boolean
за замовчуванням:"false"
Вмикає
/debug (перевизначення конфігурації лише під час виконання). Лише для власника.boolean
за замовчуванням:"true"
Вмикає
/restart та зовнішні запити на перезапуск SIGUSR1.string[]
Явний список дозволених власників для поверхонь команд, доступних лише власнику. Окремий від
commands.allowFrom і доступу через сполучення в особистих повідомленнях.boolean
за замовчуванням:"false"
Для кожного каналу: вимагає ідентичності власника для команд, доступних лише власнику. Коли
true,
відправник має відповідати commands.ownerAllowFrom або мати внутрішню область дії operator.admin.
Запис із символом узагальнення allowFrom недостатній."raw" | "hash"
Керує тим, як ідентифікатори власника відображаються в системній підказці.
string
Секрет HMAC, що використовується, коли
commands.ownerDisplay: "hash".object
Список дозволених для кожного постачальника для авторизації команд. Якщо його налаштовано, він є
єдиним джерелом авторизації для команд і директив. Використовуйте
"*" як
глобальне типове значення; ключі конкретних постачальників його перевизначають.boolean
за замовчуванням:"true"
Застосовує списки дозволених/політики для команд, коли
commands.allowFrom не встановлено.Список команд
Команди надходять із трьох джерел:- Вбудовані команди ядра:
src/auto-reply/commands-registry.shared.ts - Згенеровані команди доку:
src/auto-reply/commands-registry.data.ts - Команди плагінів: виклики
registerCommand()плагіна
Команди ядра
Сеанси та запуски
Сеанси та запуски
Явні шляхи
/export-session замінюють наявні файли в
робочому просторі. Пропустіть шлях, щоб згенерувати ім’я файлу, захищене від колізій.Control UI перехоплює введене
/new, щоб створити новий
сеанс панелі та перейти до нього, крім випадку, коли налаштовано session.dmScope: "main"
і поточний батьківський сеанс є основним сеансом агента — тоді /new
скидає основний сеанс на місці. Введене /reset усе одно виконує
скидання Gateway на місці. Використовуйте /model default, коли потрібно очистити закріплений
вибір моделі сеансу.Керування моделлю та запуском
Керування моделлю та запуском
Безпека verbose / trace / fast / reasoning
Безпека 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негайно зберігає нову модель у сеансі.- Якщо агент неактивний, наступний запуск відразу використовує її.
- Якщо запуск активний, перемикання позначається як очікуване та застосовується в наступній безпечній точці повторної спроби.
Виявлення та стан
Виявлення та стан
Skills, списки дозволів, схвалення
Skills, списки дозволів, схвалення
Субагенти та ACP
Субагенти та ACP
Записи й адміністрування лише для власника
Записи й адміністрування лише для власника
Голос, TTS, керування каналом
Голос, TTS, керування каналом
Команди стикування
Команди стикування перемикають маршрут відповіді активного сеансу на інший пов’язаний канал. Відомості про налаштування та усунення несправностей див. у розділі Стикування каналів. Згенеровано з плагінів каналів із підтримкою нативних команд:/dock-discord(псевдонім:/dock_discord)/dock-mattermost(псевдонім:/dock_mattermost)/dock-slack(псевдонім:/dock_slack)/dock-telegram(псевдонім:/dock_telegram)
session.identityLinks. Відправник у вихідному каналі та цільовий співрозмовник
мають належати до однієї групи ідентичностей.
Команди комплектних плагінів
Лише для 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 передаються моделі як звичайний запит.Skills можуть оголошувати
command-dispatch: tool, щоб передавати запит безпосередньо інструменту
(детерміновано, без залучення моделі). Приклад: /prose (плагін OpenProse)
— див. OpenProse.Аргументи нативних команд
Аргументи нативних команд
Discord використовує автодоповнення для динамічних параметрів і меню кнопок, коли обов’язкові
аргументи не вказано. Telegram і Slack показують меню кнопок для команд із
варіантами. Динамічні варіанти визначаються відповідно до моделі цільового сеансу, тому залежні від
моделі параметри, як-от рівні
/think, враховують перевизначення /model сеансу./tools: що агент може використовувати зараз
/tools відповідає на запитання про середовище виконання: що цей агент може використовувати просто зараз у цій
розмові, а не надає статичний каталог конфігурації.
/model: вибір моделі
/model і /models відкривають інтерактивний засіб вибору зі спадними списками
провайдерів і моделей. Засіб вибору враховує agents.defaults.models, зокрема
записи provider/*.
/config: запис конфігурації на диск
Лише для власника. Типово вимкнено — увімкніть за допомогою
commands.config: true./config
зберігаються після перезапусків.
/mcp: конфігурація сервера MCP
Лише для власника. Типово вимкнено — увімкніть за допомогою
commands.mcp: true./mcp зберігає конфігурацію в конфігурації OpenClaw, а не в налаштуваннях проєкту вбудованого агента.
/mcp show приховує поля з обліковими даними, розпізнані значення прапорців
облікових даних і відомі аргументи, схожі на секрети. Під час виконання з групи
конфігурація приватно надсилається власнику; якщо приватний маршрут до власника
недоступний, команда безпечно завершується відмовою та просить власника повторити спробу в особистому
чаті.
/debug: перевизначення лише для середовища виконання
Лише для власника. Типово вимкнено — увімкніть за допомогою
commands.debug: true.
Перевизначення негайно застосовуються до нових зчитувань конфігурації, але не записуються на диск./plugins: керування плагінами
Запис — лише для власника. Типово вимкнено — увімкніть за допомогою
commands.plugins: true./plugins enable|disable оновлює конфігурацію плагіна та виконує гаряче перезавантаження
середовища виконання плагінів Gateway для нових звернень агента. /plugins install автоматично перезапускає керовані
Gateway, оскільки вихідні модулі плагіна змінилися. Установлення з довіреного ClawHub
та офіційного каталогу не потребують додаткового підтвердження. Довільні джерела npm,
git, архіви, npm-pack: та локальні шляхи показують попередження про походження й
потребують кінцевого --force після перевірки джерела. Цей прапорець підтверджує
джерело та дозволяє замінити наявне встановлення; він не обходить
security.installPolicy або перевірки безпеки інсталятора. Випуски ClawHub із
попередженнями про ризики все одно потребують окремого, доступного лише в оболонці
прапорця --acknowledge-clawhub-risk. Установлення з маркетплейсу, пов’язані та закріплені встановлення також
залишаються доступними лише в оболонці.
/trace: вивід трасування плагіна
/trace показує обмежені сеансом рядки трасування й налагодження плагіна без повного докладного
режиму. Це не замінює /debug (перевизначення середовища виконання) або /verbose (звичайний
вивід інструменту).
/btw: побічні запитання
/btw — це коротке побічне запитання про контекст поточного сеансу. Псевдонім: /side.
- Використовує поточний сеанс як фоновий контекст.
- У сеансах оснастки Codex виконується як тимчасова побічна гілка Codex.
- Не змінює майбутній контекст сеансу.
- Не записується до історії розшифрування.
Примітки щодо поверхонь
Область сеансу для кожної поверхні
Область сеансу для кожної поверхні
- Текстові команди: виконуються у звичайному сеансі чату (особисті повідомлення спільно використовують
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
Особливості 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стосується моделей, автентифікації та кінцевих точок, а не використання.
Пов’язані матеріали
Skills
Як реєструються та контролюються команди зі скісною рискою для навичок.
Створення навичок
Створіть навичку, яка реєструє власну команду зі скісною рискою.
BTW
Додаткові запитання без зміни контексту сеансу.
Керування
Спрямовуйте агента під час виконання за допомогою
/steer.