/.
Команды 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 auto|on|offсохраняет переопределение сеанса; для его очистки используйте параметрinheritв интерфейсе сеансов./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
Команды навыков
Доступные пользователю навыки предоставляются в виде команд с косой чертой:/skill <name> [input]всегда работает как универсальная точка входа.- Навыки могут регистрироваться как непосредственные команды (например,
/proseдля OpenProse). - Регистрация собственных команд навыков управляется параметрами
commands.nativeSkillsиchannels.<provider>.commands.nativeSkills. - Имена очищаются до формата
a-z0-9_(не более 32 символов); при конфликтах добавляются числовые суффиксы.
Аргументы собственных команд
Аргументы собственных команд
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отправляет коды сопряжения устройств только через личный чат или пути ответа Web UI. При вызове в группе или теме Telegram владельцу предлагается вместо этого написать боту личное сообщение./stopнацелена на активный сеанс чата, чтобы прервать текущий запуск.
Особенности Slack
Особенности 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относится к моделям, аутентификации и конечным точкам, а не к использованию.
Связанные материалы
Skills
Как регистрируются и ограничиваются slash-команды навыков.
Создание навыков
Создайте навык, регистрирующий собственную slash-команду.
BTW
Дополнительные вопросы без изменения контекста сеанса.
Управление
Направляйте работу агента во время выполнения с помощью
/steer.