English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaishiالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiruفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

CLI commands

Hooks

openclaw hooks

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

Запуск openclaw hooks без подкоманды эквивалентен openclaw hooks list.

Связанные разделы:

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

bash
openclaw hooks list

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

Параметры:

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

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

Code
Hooks (4/4 ready) Ready:  🚀 boot-md ✓ - Run BOOT.md on gateway startup  📎 bootstrap-extra-files ✓ - Inject extra workspace bootstrap files during agent bootstrap  📝 command-logger ✓ - Log all command events to a centralized audit file  💾 session-memory ✓ - Save session context to memory when /new or /reset command is issued

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

bash
openclaw hooks list --verbose

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

Пример (JSON):

bash
openclaw hooks list --json

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

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

bash
openclaw hooks info <name>

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

Аргументы:

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

Параметры:

  • --json: Вывести как JSON

Пример:

bash
openclaw hooks info session-memory

Вывод:

Code
💾 session-memory ✓ Ready Save session context to memory when /new or /reset 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/automation/hooks#session-memory  Events: command:new, command:reset Requirements:  Config: ✓ workspace.dir

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

bash
openclaw hooks check

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

Параметры:

  • --json: Вывести как JSON

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

Code
Hooks Status Total hooks: 4Ready: 4Not ready: 0

Включить хук

bash
openclaw hooks enable <name>

Включает конкретный хук, добавляя его в вашу конфигурацию (по умолчанию ~/.openclaw/openclaw.json).

Примечание: Хуки рабочей области по умолчанию отключены, пока вы не включите их здесь или в конфигурации. Хуки, управляемые plugins, показывают plugin:<id> в openclaw hooks list, и их нельзя включить или отключить здесь. Вместо этого включите или отключите соответствующий plugin.

Аргументы:

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

Пример:

bash
openclaw hooks enable session-memory

Вывод:

Code
✓ Enabled hook: 💾 session-memory

Что делает команда:

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

Если хук получен из <workspace>/hooks/, этот шаг явного включения обязателен перед тем, как Gateway сможет его загрузить.

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

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

Отключить хук

bash
openclaw hooks disable <name>

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

Аргументы:

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

Пример:

bash
openclaw hooks disable command-logger

Вывод:

Code
⏸ Disabled hook: 📝 command-logger

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

  • Перезапустите gateway, чтобы хуки перезагрузились

Примечания

  • openclaw hooks list --json, info --json и check --json записывают структурированный JSON напрямую в stdout.
  • Хуки, управляемые Plugin, нельзя включить или отключить здесь; вместо этого включите или отключите владеющий plugin.

Установить пакеты хуков

bash
openclaw plugins install <package>        # npm by defaultopenclaw plugins install npm:<package>    # npm onlyopenclaw plugins install <package> --pin  # pin versionopenclaw plugins install <path>           # local path

Устанавливает пакеты хуков через единый установщик plugins.

openclaw hooks install по-прежнему работает как псевдоним совместимости, но выводит предупреждение об устаревании и перенаправляет на openclaw plugins install.

Спецификации npm работают только через реестр (имя пакета + необязательная точная версия или dist-tag). Спецификации Git/URL/file и диапазоны semver отклоняются. Установка зависимостей выполняется локально для проекта с --ignore-scripts ради безопасности, даже если в вашей оболочке заданы глобальные настройки установки npm.

Базовые спецификации и @latest остаются на стабильной ветке. Если npm разрешает любую из них в предварительную версию, OpenClaw останавливается и просит явно согласиться через тег предварительной версии, например @beta/@rc, или точную предварительную версию.

Что делает команда:

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

Параметры:

  • -l, --link: Связать локальный каталог вместо копирования (добавляет его в hooks.internal.load.extraDirs)
  • --pin: Записывать установки npm как точно разрешенные name@version в hooks.internal.installs

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

Примеры:

bash
# Local directoryopenclaw plugins install ./my-hook-pack # Local archiveopenclaw plugins install ./my-hook-pack.zip # NPM packageopenclaw plugins install @openclaw/my-hook-pack # Link a local directory without copyingopenclaw plugins install -l ./my-hook-pack

Связанные пакеты хуков считаются управляемыми хуками из каталога, настроенного оператором, а не хуками рабочей области.

Обновить пакеты хуков

bash
openclaw plugins update <id>openclaw plugins update --all

Обновляет отслеживаемые пакеты хуков на основе npm через единый обновлятор plugins.

openclaw hooks update по-прежнему работает как псевдоним совместимости, но выводит предупреждение об устаревании и перенаправляет на openclaw plugins update.

Параметры:

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

Когда сохраненный хеш целостности существует и хеш полученного артефакта меняется, OpenClaw выводит предупреждение и запрашивает подтверждение перед продолжением. Используйте глобальный --yes, чтобы пропустить запросы в CI или неинтерактивных запусках.

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

session-memory

Сохраняет контекст сессии в память, когда вы выполняете /new или /reset.

Включить:

bash
openclaw hooks enable session-memory

Вывод: по умолчанию ~/.openclaw/workspace/memory/YYYY-MM-DD-HHMM.md. Задайте hooks.internal.entries.session-memory.llmSlug: true для слагов имен файлов, сгенерированных моделью.

См.: документацию session-memory

bootstrap-extra-files

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

Включить:

bash
openclaw hooks enable bootstrap-extra-files

См.: документацию bootstrap-extra-files

command-logger

Записывает все события команд в централизованный файл аудита.

Включить:

bash
openclaw hooks enable command-logger

Вывод: ~/.openclaw/logs/commands.log

Просмотреть логи:

bash
# Recent commandstail -n 20 ~/.openclaw/logs/commands.log # Pretty-printcat ~/.openclaw/logs/commands.log | jq . # Filter by actiongrep '"action":"new"' ~/.openclaw/logs/commands.log | jq .

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

boot-md

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

События: gateway:startup

Включить:

bash
openclaw hooks enable boot-md

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

Связанные разделы

Was this useful?
On this page

On this page