`openclaw hooks`

Управление хуками агента (событийно-ориентированные автоматизации для команд вроде /new, /reset и запуска Gateway (шлюза)). Связанное:

Хуки: Хуки
Хуки плагинов: Plugins

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

openclaw hooks list

Перечисляет все обнаруженные хуки из каталогов рабочего пространства, управляемых и входящих в комплект. Параметры:

--eligible: Показать только подходящие хуки (требования выполнены)
--json: Вывод в формате JSON
-v, --verbose: Показать подробную информацию, включая отсутствующие требования

Пример вывода:

Hooks (4/4 ready)

Ready:
  🚀 boot-md ✓ - Run BOOT.md on gateway startup
  📝 command-logger ✓ - Log all command events to a centralized audit file
  💾 session-memory ✓ - Save session context to memory when /new command is issued
  😈 soul-evil ✓ - Swap injected SOUL content during a purge window or by random chance

Пример (подробно):

openclaw hooks list --verbose

Показывает отсутствующие требования для неподходящих хуков. Пример (JSON):

openclaw hooks list --json

Возвращает структурированный JSON для программного использования.

Получение информации о хуке

openclaw hooks info <name>

Показывает подробную информацию о конкретном хуке. Аргументы:

<name>: Имя хука (например, session-memory)

Параметры:

--json: Вывод в формате JSON

Пример:

openclaw hooks info session-memory

Вывод:

💾 session-memory ✓ Ready

Save session context to memory when /new command is issued

Details:
  Source: openclaw-bundled
  Path: /path/to/openclaw/hooks/bundled/session-memory/HOOK.md
  Handler: /path/to/openclaw/hooks/bundled/session-memory/handler.ts
  Homepage: https://docs.openclaw.ai/hooks#session-memory
  Events: command:new

Requirements:
  Config: ✓ workspace.dir

Проверка пригодности хуков

openclaw hooks check

Показывает сводку статуса пригодности хуков (сколько готово и сколько не готово). Параметры:

--json: Вывод в формате JSON

Пример вывода:

Hooks Status

Total hooks: 4
Ready: 4
Not ready: 0

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

openclaw hooks enable <name>

Включает конкретный хук, добавляя его в ваш конфиг (~/.openclaw/config.json). Примечание: Хуки, управляемые плагинами, показывают plugin:<id> в openclaw hooks list и не могут быть включены/отключены здесь. Вместо этого включите/отключите плагин. Аргументы:

<name>: Имя хука (например, session-memory)

Пример:

openclaw hooks enable session-memory

Вывод:

✓ Enabled hook: 💾 session-memory

Что делает:

Проверяет, существует ли хук и подходит ли он
Обновляет hooks.internal.entries.<name>.enabled = true в вашем конфиге
Сохраняет конфиг на диск

После включения:

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

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

openclaw hooks disable <name>

Отключает конкретный хук, обновляя ваш конфиг. Аргументы:

<name>: Имя хука (например, command-logger)

Пример:

openclaw hooks disable command-logger

Вывод:

⏸ Disabled hook: 📝 command-logger

После отключения:

Перезапустите Gateway (шлюз), чтобы хуки перезагрузились

Установка хуков

openclaw hooks install <path-or-spec>

Устанавливает пакет хуков из локальной папки/архива или npm. Спецификации npm принимаются только из реестра (имя пакета + необязательная версия/тег). Спецификации Git/URL/file отклоняются. Установка зависимостей выполняется с --ignore-scripts в целях безопасности. Что делает:

Копирует пакет хуков в ~/.openclaw/hooks/<id>
Включает установленные хуки в hooks.internal.entries.*
Записывает установку в hooks.internal.installs

Параметры:

-l, --link: Связать локальный каталог вместо копирования (добавляет его в hooks.internal.load.extraDirs)

Поддерживаемые архивы: .zip, .tgz, .tar.gz, .tar Примеры:

# Local directory
openclaw hooks install ./my-hook-pack

# Local archive
openclaw hooks install ./my-hook-pack.zip

# NPM package
openclaw hooks install @openclaw/my-hook-pack

# Link a local directory without copying
openclaw hooks install -l ./my-hook-pack

Обновление хуков

openclaw hooks update <id>
openclaw hooks update --all

Обновляет установленные пакеты хуков (только установки из npm). Параметры:

--all: Обновить все отслеживаемые пакеты хуков
--dry-run: Показать, что изменится, без записи

Bundled Hooks

session-memory

Сохраняет контекст сеанса в памяти, когда вы выполняете /new. Включение:

openclaw hooks enable session-memory

Вывод: ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md См.: документация session-memory

bootstrap-extra-files

Добавляет дополнительные bootstrap-файлы (например, локальные для монорепозитория AGENTS.md / TOOLS.md) во время agent:bootstrap. Включение:

openclaw hooks включают bootstrap-extra-files

См.: хук SOUL Evil

command-logger

Журналирует все события команд в централизованный файл аудита. Включение:

openclaw hooks enable command-logger

Вывод: ~/.openclaw/logs/commands.log Просмотр логов:

# Recent commands
tail -n 20 ~/.openclaw/logs/commands.log

# Pretty-print
cat ~/.openclaw/logs/commands.log | jq .

# Filter by action
grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .

См.: документация command-logger

boot-md

Запускает BOOT.md при старте Gateway (шлюза) (после запуска каналов). Включение: События: gateway:startup

openclaw hooks enable boot-md

См.: документация boot-md

Команды CLI

RPC и API

Шаблоны

Технический справочник

Внутренние механизмы концепций

Проект

Примечания к выпуску

Эксперименты

хуки

`openclaw hooks`

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

Получение информации о хуке

Проверка пригодности хуков

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

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

Установка хуков

Обновление хуков

Bundled Hooks

session-memory

bootstrap-extra-files

command-logger

boot-md

​openclaw hooks

​Список всех хуков

​Получение информации о хуке

​Проверка пригодности хуков

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

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

​Установка хуков

​Обновление хуков

​Bundled Hooks

​session-memory

​bootstrap-extra-files

​command-logger

​boot-md

`openclaw hooks`

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

Получение информации о хуке

Проверка пригодности хуков

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

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

Установка хуков

Обновление хуков

Bundled Hooks

session-memory

bootstrap-extra-files

command-logger

boot-md