Skip to main content

​
openclaw hooks

Управление хуками агента (автоматизация на основе событий для таких команд, как /new, /reset, и запуска Gateway). Вызов openclaw hooks без аргументов эквивалентен openclaw hooks list. См. также: Хуки — Хуки плагинов

​
Список хуков

Выводит хуки, обнаруженные в каталогах рабочей области, управляемых, дополнительных и встроенных хуков.
  • --eligible: только хуки, требования которых выполнены.
  • --json: структурированный вывод.
  • -v, --verbose: добавить столбец Missing с невыполненными требованиями.

​
Получение сведений о хуке

<name> — имя или ключ хука (например, session-memory). Показывает источник, пути к файлу и обработчику, домашнюю страницу, события и состояние каждого требования (двоичные файлы, переменные окружения, конфигурация, ОС).

​
Проверка соответствия требованиям

Выводит сводку количества готовых и неготовых хуков; для неготовых хуков перечисляет причины блокировки каждого из них.

​
Включение хука

Добавляет или обновляет hooks.internal.entries.<name>.enabled = true в конфигурации, а также включает главный переключатель hooks.internal.enabled (Gateway не загружает внутренние обработчики хуков, пока не настроен хотя бы один хук). Команда завершается ошибкой, если хук не существует, управляется плагином или не соответствует требованиям (требования не выполнены). Для хуков, управляемых плагинами, в hooks list отображается plugin:<id>; их нельзя включить или отключить здесь — вместо этого включите или отключите соответствующий плагин. После включения перезапустите Gateway (перезапустите приложение в строке меню macOS или процесс Gateway в среде разработки), чтобы он повторно загрузил хуки.

​
Отключение хука

Устанавливает hooks.internal.entries.<name>.enabled = false. После этого перезапустите Gateway.

​
Установка и обновление пакетов хуков

Пакеты хуков устанавливаются и обновляются через единый установщик и средство обновления плагинов; openclaw hooks install / openclaw hooks update по-прежнему работают как устаревшие псевдонимы, которые выводят предупреждение и перенаправляют выполнение командам plugins.
  • Спецификации npm поддерживают только реестр: имя пакета и необязательная точная версия или тег дистрибутива. Спецификации Git, URL и файлов, а также диапазоны semver отклоняются. Зависимости устанавливаются локально для проекта с помощью --ignore-scripts.
  • Спецификации без префикса и @latest остаются на стабильном канале; если npm разрешает предварительную версию, OpenClaw останавливается и предлагает явно подтвердить её использование (@beta, @rc или точная предварительная версия).
  • Поддерживаемые архивы: .zip, .tgz, .tar.gz, .tar.
  • -l, --link связывает локальный каталог вместо его копирования (добавляет его в hooks.internal.load.extraDirs); связанные пакеты хуков являются управляемыми хуками из настроенного оператором каталога, а не хуками рабочей области.
  • --pin записывает установки npm как точную разрешённую name@version в hooks.internal.installs.
  • При установке пакет копируется в ~/.openclaw/hooks/<id>, его хуки включаются в hooks.internal.entries.*, а сведения об установке записываются в hooks.internal.installs.
  • Если сохранённый хеш целостности больше не совпадает с полученным артефактом, OpenClaw выводит предупреждение и запрашивает подтверждение перед продолжением; передайте глобальный параметр --yes, чтобы пропустить запрос (например, в CI).

​
Встроенные хуки

Включите любой встроенный хук с помощью openclaw hooks enable <hook-name>. Подробное описание, ключи конфигурации и значения по умолчанию: Встроенные хуки.

​
Файл журнала command-logger

​
Примечания

  • hooks list --json, info --json и check --json выводят структурированный JSON непосредственно в стандартный вывод.

​
См. также