Skip to main content

​
openclaw hooks

Керуйте хуками агента (автоматизаціями, керованими подіями, для команд на кшталт /new, /reset і запуску Gateway). Команда openclaw hooks без аргументів еквівалентна openclaw hooks list. Пов’язане: Хуки — Хуки Plugin

​
Перегляд списку хуків

Виводить список хуків, виявлених у робочому просторі, керованих, додаткових і вбудованих каталогах.
  • --eligible: лише хуки, вимоги яких виконано.
  • --json: структурований вивід.
  • -v, --verbose: додати стовпець «Відсутнє» з невиконаними вимогами.

​
Отримання інформації про хук

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

​
Перевірка відповідності вимогам

Виводить зведення про кількість готових і неготових хуків; якщо є неготові хуки, перелічує кожен із причиною блокування.

​
Увімкнення хука

Додає або оновлює hooks.internal.entries.<name>.enabled = true у конфігурації, а також вмикає головний перемикач hooks.internal.enabled (Gateway не завантажує жодного внутрішнього обробника хуків, доки не налаштовано принаймні один). Команда завершується помилкою, якщо хук не існує, керується Plugin або не відповідає вимогам (вимоги не виконано). Хуки, керовані Plugin, позначаються як plugin:<id> у виводі hooks list, і їх не можна ввімкнути або вимкнути тут; натомість увімкніть або вимкніть Plugin-власник. Після ввімкнення перезапустіть 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 безпосередньо до стандартного виводу.

​
Пов’язане