openclaw hooks

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

Пов’язане: Хуки — Хуки Plugin

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

openclaw hooks list [--eligible] [--json] [-v|--verbose]

Виводить список хуків, виявлених у робочому просторі, керованих, додаткових і вбудованих каталогах.

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

Хуки (4/5 готові) Готові:  🚀 boot-md ✓ — Запускає BOOT.md під час запуску Gateway  📎 bootstrap-extra-files ✓ — Впроваджує додаткові початкові файли робочого простору під час початкового налаштування агента  📝 command-logger ✓ — Записує всі події команд у централізований файл аудиту  💾 session-memory ✓ — Зберігає контекст сеансу в пам’яті після виконання команди /new або /reset

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

openclaw hooks info <name> [--json]

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

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

openclaw hooks check [--json]

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

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

openclaw hooks enable <name>

Додає або оновлює hooks.internal.entries.<name>.enabled = true у конфігурації, а також вмикає головний перемикач hooks.internal.enabled (Gateway не завантажує жодного внутрішнього обробника хуків, доки не налаштовано принаймні один). Команда завершується помилкою, якщо хук не існує, керується Plugin або не відповідає вимогам (вимоги не виконано).

Хуки, керовані Plugin, позначаються як plugin:<id> у виводі hooks list, і їх не можна ввімкнути або вимкнути тут; натомість увімкніть або вимкніть Plugin-власник.

Після ввімкнення перезапустіть Gateway (перезапустіть застосунок у рядку меню macOS або процес Gateway у середовищі розробки), щоб він повторно завантажив хуки.

Вимкнення хука

openclaw hooks disable <name>

Установлює hooks.internal.entries.<name>.enabled = false. Після цього перезапустіть Gateway.

Встановлення й оновлення пакетів хуків

openclaw plugins install <package>        # типово npmopenclaw plugins install npm:<package>    # лише npmopenclaw plugins install <package> --pin  # закріпити визначену версіюopenclaw plugins install <path>           # локальний каталог або архівopenclaw plugins install -l <path>        # створити посилання на локальний каталог замість копіювання openclaw plugins update <id>openclaw plugins update --allopenclaw plugins update --dry-run

Пакети хуків установлюються через уніфікований засіб установлення й оновлення плагінів; 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

tail -n 20 ~/.openclaw/logs/commands.log        # останні командиcat ~/.openclaw/logs/commands.log | jq .          # форматований вивідgrep '"action":"new"' ~/.openclaw/logs/commands.log | jq .   # фільтрування за дією

Примітки

• hooks list --json, info --json і check --json записують структурований JSON безпосередньо до стандартного виводу.

Пов’язане

• Довідник CLI
• Хуки автоматизації