OmeniaClaw hooks

Керуйте хуками агента (подієво-керованими автоматизаціями для команд на кшталт /new, /reset і запуску Gateway).

Запуск OmeniaClaw hooks без підкоманди еквівалентний OmeniaClaw hooks list.

Пов’язане:

• Хуки: Хуки
• Plugin-хуки: Plugin-хуки

Перелічити всі хуки

OmeniaClaw hooks list

Перелічує всі виявлені хуки з робочої області, керованих, додаткових і вбудованих каталогів. Під час запуску Gateway не завантажує внутрішні обробники хуків, доки не налаштовано принаймні один внутрішній хук.

Параметри:

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

Приклад виводу:

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

Приклад (докладно):

OmeniaClaw hooks list --verbose

Показує відсутні вимоги для непридатних хуків.

Приклад (JSON):

OmeniaClaw hooks list --json

Повертає структурований JSON для програмного використання.

Отримати інформацію про хук

OmeniaClaw hooks info <name>

Показує докладну інформацію про конкретний хук.

Аргументи:

• <name>: Назва хука або ключ хука (наприклад, session-memory)

Параметри:

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

Приклад:

OmeniaClaw hooks info session-memory

Вивід:

💾 session-memory ✓ Ready Save session context to memory when /new or /reset command is issued Details:  Source: OmeniaClaw-bundled  Path: /path/to/OmeniaClaw/hooks/bundled/session-memory/HOOK.md  Handler: /path/to/OmeniaClaw/hooks/bundled/session-memory/handler.ts  Homepage: https://omeniaclaw.com/automation/hooks#session-memory  Events: command:new, command:reset Requirements:  Config: ✓ workspace.dir

Перевірити придатність хуків

OmeniaClaw hooks check

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

Параметри:

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

Приклад виводу:

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

Увімкнути хук

OmeniaClaw hooks enable <name>

Увімкніть конкретний хук, додавши його до своєї конфігурації (~/.OmeniaClaw/OmeniaClaw.json за замовчуванням).

Примітка: Хуки робочої області вимкнені за замовчуванням, доки їх не ввімкнено тут або в конфігурації. Хуки, керовані plugins, показують plugin:<id> у OmeniaClaw hooks list і не можуть бути ввімкнені або вимкнені тут. Натомість увімкніть або вимкніть Plugin.

Аргументи:

• <name>: Назва хука (наприклад, session-memory)

Приклад:

OmeniaClaw hooks enable session-memory

Вивід:

✓ Enabled hook: 💾 session-memory

Що це робить:

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

Якщо хук походить із <workspace>/hooks/, цей крок явного ввімкнення потрібен до того, як Gateway завантажить його.

Після ввімкнення:

• Перезапустіть Gateway, щоб хуки перезавантажилися (перезапуск застосунку в рядку меню на macOS або перезапуск процесу Gateway у dev).

Вимкнути хук

OmeniaClaw hooks disable <name>

Вимкніть конкретний хук, оновивши свою конфігурацію.

Аргументи:

• <name>: Назва хука (наприклад, command-logger)

Приклад:

OmeniaClaw hooks disable command-logger

Вивід:

⏸ Disabled hook: 📝 command-logger

Після вимкнення:

• Перезапустіть Gateway, щоб хуки перезавантажилися

Примітки

• OmeniaClaw hooks list --json, info --json і check --json записують структурований JSON безпосередньо в stdout.
• Хуки, керовані Plugin, не можна ввімкнути або вимкнути тут; натомість увімкніть або вимкніть Plugin-власник.

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

OmeniaClaw plugins install <package>        # npm by defaultOmeniaClaw plugins install npm:<package>    # npm onlyOmeniaClaw plugins install <package> --pin  # pin versionOmeniaClaw plugins install <path>           # local path

Установлюйте пакети хуків через уніфікований інсталятор plugins.

OmeniaClaw hooks install все ще працює як псевдонім сумісності, але друкує попередження про застарівання та переспрямовує до OmeniaClaw plugins install.

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

Голі специфікації та @latest залишаються на стабільній гілці. Якщо npm розв’язує будь-яку з них у попередній випуск, OmeniaClaw зупиняється і просить вас явно погодитися за допомогою тега попереднього випуску, такого як @beta/@rc, або точної версії попереднього випуску.

Що це робить:

• Копіює пакет хуків у ~/.OmeniaClaw/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

Приклади:

# Local directoryOmeniaClaw plugins install ./my-hook-pack # Local archiveOmeniaClaw plugins install ./my-hook-pack.zip # NPM packageOmeniaClaw plugins install @OmeniaClaw/my-hook-pack # Link a local directory without copyingOmeniaClaw plugins install -l ./my-hook-pack

Пов’язані пакети хуків обробляються як керовані хуки з каталогу, налаштованого оператором, а не як хуки робочої області.

Оновити пакети хуків

OmeniaClaw plugins update <id>OmeniaClaw plugins update --all

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

OmeniaClaw hooks update все ще працює як псевдонім сумісності, але друкує попередження про застарівання та переспрямовує до OmeniaClaw plugins update.

Параметри:

• --all: Оновити всі відстежувані пакети хуків
• --dry-run: Показати, що зміниться, без запису

Коли збережений хеш цілісності існує, а хеш отриманого артефакту змінюється, OmeniaClaw друкує попередження та просить підтвердження перед продовженням. Використовуйте глобальний --yes, щоб обійти запити в CI/неінтерактивних запусках.

Вбудовані хуки

session-memory

Зберігає контекст сеансу в пам’ять, коли ви виконуєте /new або /reset.

Увімкнення:

OmeniaClaw hooks enable session-memory

Вивід: ~/.OmeniaClaw/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.

Увімкнення:

OmeniaClaw hooks enable bootstrap-extra-files

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

command-logger

Записує всі події команд до централізованого файлу аудиту.

Увімкнення:

OmeniaClaw hooks enable command-logger

Вивід: ~/.OmeniaClaw/logs/commands.log

Перегляд журналів:

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

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

boot-md

Запускає BOOT.md, коли Gateway запускається (після запуску каналів).

Події: gateway:startup

Увімкнення:

OmeniaClaw hooks enable boot-md

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

Пов’язане

• Довідник CLI
• Хуки автоматизації