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.

Что делает:

• Копирует пакет хуков в ~/.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

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

soul-evil¶

Подменяет внедрённое содержимое SOUL.md на SOUL_EVIL.md в течение окна очистки или со случайной вероятностью.

Включение:

openclaw hooks enable soul-evil

См.: хук SOUL Evil

boot-md¶

Запускает BOOT.md при старте Gateway (шлюза) (после запуска каналов).

События: gateway:startup

Включение:

openclaw hooks enable boot-md

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