---
read_when:
    - Вы хотите управлять хуками агента
    - Вы хотите проверить доступность хуков или включить хуки рабочей области
summary: Справочник CLI для `openclaw hooks` (хуки агента)
title: Хуки
x-i18n:
    generated_at: "2026-07-13T18:01:21Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 24
    provider: openai
    source_hash: f33d1e343771971bdc17dcafdabc6c4fc893b3080897862475a148e5f3957796
    source_path: cli/hooks.md
    workflow: 16
---

# `openclaw hooks`

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

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

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

```bash
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
openclaw hooks info <name> [--json]
```

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

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

```bash
openclaw hooks check [--json]
```

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

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

```bash
openclaw hooks enable <name>
```

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

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

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

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

```bash
openclaw hooks disable <name>
```

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

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

```bash
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>`. Подробное описание, ключи конфигурации и значения по умолчанию: [Встроенные хуки](/ru/automation/hooks#bundled-hooks).

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

```bash
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](/ru/cli)
- [Хуки автоматизации](/ru/automation/hooks)