> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Хуки

# `openclaw hooks`

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

См. также: [Хуки](https://docs2.openclaw.ai/ru/automation/hooks.md) — [Хуки плагинов](https://docs2.openclaw.ai/ru/plugins/hooks.md)

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks info <name> [--json]
```

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks check [--json]
```

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks enable <name>
```

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

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

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks disable <name>
```

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install <package>        # по умолчанию npm
openclaw plugins install npm:<package>    # только npm
openclaw plugins install <package> --pin  # закрепить разрешённую версию
openclaw plugins install <path>           # локальный каталог или архив
openclaw plugins install -l <path>        # связать локальный каталог вместо копирования

openclaw plugins update <id>
openclaw plugins update --all
openclaw 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).

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

| Хук | События | Назначение |
| - | - | - |
| boot-md | `gateway:startup` | Запускает `BOOT.md` при запуске Gateway для каждой настроенной области агента |
| bootstrap-extra-files | `agent:bootstrap` | Добавляет дополнительные загрузочные файлы (например, `AGENTS.md`/`TOOLS.md` монорепозитория) при начальной загрузке агента |
| command-logger | `command` | Записывает события команд в `~/.openclaw/logs/commands.log` |
| compaction-notifier | `session:compact:before`, `session:compact:after` | Отправляет видимые уведомления в чат при начале и завершении Compaction сеанса |
| session-memory | `command:new`, `command:reset` | Сохраняет контекст сеанса в память при `/new` или `/reset` |

Включите любой встроенный хук с помощью `openclaw hooks enable <hook-name>`. Подробное описание, ключи конфигурации и значения по умолчанию: [Встроенные хуки](https://docs2.openclaw.ai/ru/automation/hooks.md#bundled-hooks).

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](https://docs2.openclaw.ai/ru/cli.md)
* [Хуки автоматизации](https://docs2.openclaw.ai/ru/automation/hooks.md)