Skills
Команды с косой чертой
Gateway обрабатывает команды, отправленные отдельными сообщениями, начинающимися с /.
Команды 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. Для неавторизованных отправителей директивы обрабатываются как обычный текст.
Конфигурация
{ 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 (чтение и запись конфигурации MCP, управляемой OpenClaw, в 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 - Команды плагинов: вызовы
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 |
Управление моделью и запуском
| Команда | Описание |
|---|---|
/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 auto|on|offсохраняет переопределение сеанса; для его удаления используйте параметр Sessions UIinherit./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] |
Процесс создания отчёта для поддержки, доступный только владельцу. Каждый раз запрашивает разрешение на выполнение |
/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> |
Обрабатывать запросы на подтверждение выполнения команд или действий плагина |
/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 |
owner | Задать политику отправки |
Голос, 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> ... |
Привязывать, направлять и проверять окружение app-server 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 отвечает на вопрос о среде выполнения: что этот агент может использовать прямо сейчас в этом
разговоре, а не предоставляет статический каталог конфигурации.
/tools # компактное представление/tools verbose # с краткими описаниямиРезультаты относятся к конкретному сеансу. Смена агента, канала, ветки, авторизации отправителя или модели может изменить вывод. Для редактирования профиля и переопределений используйте панель Tools в Control UI или интерфейсы конфигурации.
/model: выбор модели
/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: запись конфигурации на диск
/config show/config show messages.responsePrefix/config get messages.responsePrefix/config set messages.responsePrefix="[openclaw]"/config unset messages.responsePrefixПеред записью конфигурация проходит проверку. Недопустимые изменения отклоняются. Обновления /config
сохраняются после перезапуска.
/mcp: конфигурация сервера MCP
/mcp show/mcp show context7/mcp set context7={"command":"uvx","args":["context7-mcp"]}/mcp unset context7/mcp сохраняет конфигурацию в конфигурации OpenClaw, а не в настройках проекта встроенного агента.
/mcp show скрывает поля, содержащие учетные данные, значения распознанных флагов учетных данных
и известные аргументы, похожие на секреты. При запуске из группы
конфигурация отправляется владельцу в личном сообщении; если частный маршрут к владельцу
недоступен, команда безопасно завершается с отказом и просит владельца повторить попытку в личном
чате.
/debug: переопределения только для среды выполнения
/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset/plugins: управление плагинами
/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: вывод трассировки плагинов
/trace # показать текущее состояние трассировки/trace on/trace off/trace показывает относящиеся к сеансу строки трассировки и отладки плагинов без полного подробного
режима. Это не заменяет /debug (переопределения среды выполнения) или /verbose (обычный
вывод инструментов).
/btw: дополнительные вопросы
/btw — это быстрый дополнительный вопрос о контексте текущего сеанса. Псевдоним: /side.
/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относится к моделям, аутентификации и конечным точкам, а не к использованию.
