openclaw hooks

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

См. также: Хуки — Хуки плагинов

Список хуков

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

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

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

Хуки (готово 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 не загружает внутренние обработчики хуков, пока не настроен хотя бы один хук). Команда завершается ошибкой, если хук не существует, управляется плагином или не соответствует требованиям (требования не выполнены).

Для хуков, управляемых плагинами, в hooks list отображается plugin:<id>; их нельзя включить или отключить здесь — вместо этого включите или отключите соответствующий плагин.

После включения перезапустите 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
• Хуки автоматизации