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 контекста сеанса. См. 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> Показать или задать значения exec по умолчанию
/login [codex|openai|openai-codex] Связать вход Codex/OpenAI из личного чата или сеанса веб-интерфейса. Только для владельца или администратора
/model [name|#|status] Показать или задать модель
/models [provider] [page] [limit=<n>|all] Вывести список настроенных или доступных после аутентификации провайдеров либо моделей
/queue <mode> Управлять поведением очереди активного запуска. См. Очередь и Управление очередью
/steer <message> Передать указания в активный запуск. Псевдоним: /tell. См. Управление
Безопасность подробного вывода, трассировки, быстрого режима и рассуждений
  • /verbose предназначен для отладки — при обычном использовании держите его выключенным.
  • /trace показывает только принадлежащие плагину строки трассировки и отладки; обычный подробный вывод остаётся выключенным.
  • /fast auto|on|off сохраняет переопределение сеанса; для его очистки используйте параметр inherit в интерфейсе сеансов.
  • /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] Запустить навык по имени
/learn [request] Создать черновик одного навыка, готового к проверке, на основе текущего разговора или указанных источников с помощью Мастерской навыков
/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, навыки и другое). См. Оснастка Codex

Только для QQBot: /bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs

Команды навыков

Доступные пользователю навыки предоставляются в виде команд с косой чертой:

  • /skill <name> [input] всегда работает как универсальная точка входа.
  • Навыки могут регистрироваться как непосредственные команды (например, /prose для OpenProse).
  • Регистрация собственных команд навыков управляется параметрами commands.nativeSkills и channels.<provider>.commands.nativeSkills.
  • Имена очищаются до формата a-z0-9_ (не более 32 символов); при конфликтах добавляются числовые суффиксы.
Диспетчеризация команд навыков

По умолчанию команды навыков направляются модели как обычные запросы.

Навыки могут объявить command-dispatch: tool, чтобы направлять запрос непосредственно инструменту (детерминированно, без участия модели). Пример: /prose (плагин OpenProse) — см. OpenProse.

Аргументы собственных команд

Discord использует автодополнение для динамических параметров и меню кнопок, когда обязательные аргументы не указаны. Telegram и Slack отображают меню кнопок для команд с вариантами выбора. Динамические варианты определяются на основе модели целевого сеанса, поэтому зависящие от модели параметры, например уровни /think, учитывают переопределение /model сеанса.

/tools: что агент может использовать сейчас

/tools отвечает на вопрос о среде выполнения: что этот агент может использовать прямо сейчас в этом разговоре, а не отображает статический каталог конфигурации.

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

Результаты относятся к конкретному сеансу. Смена агента, канала, ветки, авторизации отправителя или модели может изменить вывод. Для редактирования профиля и переопределений используйте панель Tools в 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 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 отправляет коды сопряжения устройств только через личный чат или пути ответа Web UI. При вызове в группе или теме Telegram владельцу предлагается вместо этого написать боту личное сообщение.
  • /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%») отображается в /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