Skills

Слеш-команди

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

Коли розмову прив’язано до ACP-сесії, звичайний текст маршрутизується до ACP harness. Команди керування 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"

Реєструє нативні команди. 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.ownerDisplaySecretstring

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

text
/tools         # compact view/tools verbose # with short descriptions

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

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

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

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, а не в налаштуваннях проєкту вбудованого агента.

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

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

/plugins — керування Plugin

text
/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

text
/trace          # show current trace state/trace on/trace off

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

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

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

text
/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, а не використання.

Пов’язане

Was this useful?
On this page

On this page