OmeniaClaw hooks

Kelola pengait agen (otomasi berbasis peristiwa untuk perintah seperti /new, /reset, dan startup Gateway).

Menjalankan OmeniaClaw hooks tanpa subperintah setara dengan OmeniaClaw hooks list.

Terkait:

• Pengait: Pengait
• Pengait Plugin: Pengait Plugin

Cantumkan semua pengait

OmeniaClaw hooks list

Cantumkan semua pengait yang ditemukan dari direktori workspace, terkelola, tambahan, dan bawaan. Startup Gateway tidak memuat handler pengait internal hingga setidaknya satu pengait internal dikonfigurasi.

Opsi:

• --eligible: Tampilkan hanya pengait yang memenuhi syarat (persyaratan terpenuhi)
• --json: Keluarkan sebagai JSON
• -v, --verbose: Tampilkan informasi terperinci termasuk persyaratan yang belum terpenuhi

Contoh output:

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

Contoh (verbose):

OmeniaClaw hooks list --verbose

Menampilkan persyaratan yang belum terpenuhi untuk pengait yang tidak memenuhi syarat.

Contoh (JSON):

OmeniaClaw hooks list --json

Mengembalikan JSON terstruktur untuk penggunaan terprogram.

Dapatkan informasi pengait

OmeniaClaw hooks info <name>

Tampilkan informasi terperinci tentang pengait tertentu.

Argumen:

• <name>: Nama pengait atau kunci pengait (misalnya, session-memory)

Opsi:

• --json: Keluarkan sebagai JSON

Contoh:

OmeniaClaw hooks info session-memory

Output:

💾 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

Periksa kelayakan pengait

OmeniaClaw hooks check

Tampilkan ringkasan status kelayakan pengait (berapa banyak yang siap dibandingkan yang belum siap).

Opsi:

• --json: Keluarkan sebagai JSON

Contoh output:

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

Aktifkan Pengait

OmeniaClaw hooks enable <name>

Aktifkan pengait tertentu dengan menambahkannya ke konfigurasi Anda (~/.OmeniaClaw/OmeniaClaw.json secara default).

Catatan: Pengait workspace dinonaktifkan secara default hingga diaktifkan di sini atau dalam konfigurasi. Pengait yang dikelola oleh plugin menampilkan plugin:<id> di OmeniaClaw hooks list dan tidak dapat diaktifkan/dinonaktifkan di sini. Aktifkan/nonaktifkan plugin-nya sebagai gantinya.

Argumen:

• <name>: Nama pengait (misalnya, session-memory)

Contoh:

OmeniaClaw hooks enable session-memory

Output:

✓ Enabled hook: 💾 session-memory

Yang dilakukannya:

• Memeriksa apakah pengait ada dan memenuhi syarat
• Memperbarui hooks.internal.entries.<name>.enabled = true dalam konfigurasi Anda
• Menyimpan konfigurasi ke disk

Jika pengait berasal dari <workspace>/hooks/, langkah opt-in ini diperlukan sebelum Gateway akan memuatnya.

Setelah mengaktifkan:

• Mulai ulang gateway agar pengait dimuat ulang (mulai ulang aplikasi bilah menu di macOS, atau mulai ulang proses gateway Anda dalam dev).

Nonaktifkan Pengait

OmeniaClaw hooks disable <name>

Nonaktifkan pengait tertentu dengan memperbarui konfigurasi Anda.

Argumen:

• <name>: Nama pengait (misalnya, command-logger)

Contoh:

OmeniaClaw hooks disable command-logger

Output:

⏸ Disabled hook: 📝 command-logger

Setelah menonaktifkan:

• Mulai ulang gateway agar pengait dimuat ulang

Catatan

• OmeniaClaw hooks list --json, info --json, dan check --json menulis JSON terstruktur langsung ke stdout.
• Pengait yang dikelola Plugin tidak dapat diaktifkan atau dinonaktifkan di sini; aktifkan atau nonaktifkan plugin pemiliknya sebagai gantinya.

Pasang paket pengait

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

Pasang paket pengait melalui pemasang plugin terpadu.

OmeniaClaw hooks install masih berfungsi sebagai alias kompatibilitas, tetapi mencetak peringatan penghentian dan meneruskan ke OmeniaClaw plugins install.

Spesifikasi npm bersifat hanya-registry (nama paket + versi persis opsional atau dist-tag). Spesifikasi Git/URL/file dan rentang semver ditolak. Pemasangan dependensi berjalan lokal-proyek dengan --ignore-scripts demi keamanan, bahkan ketika shell Anda memiliki pengaturan pemasangan npm global.

Spesifikasi polos dan @latest tetap berada di jalur stabil. Jika npm menyelesaikan salah satu dari itu ke prarilis, OmeniaClaw berhenti dan meminta Anda ikut serta secara eksplisit dengan tag prarilis seperti @beta/@rc atau versi prarilis persis.

Yang dilakukannya:

• Menyalin paket pengait ke ~/.OmeniaClaw/hooks/<id>
• Mengaktifkan pengait yang dipasang di hooks.internal.entries.*
• Mencatat pemasangan di bawah hooks.internal.installs

Opsi:

• -l, --link: Tautkan direktori lokal alih-alih menyalin (menambahkannya ke hooks.internal.load.extraDirs)
• --pin: Catat pemasangan npm sebagai name@version hasil penyelesaian persis di hooks.internal.installs

Arsip yang didukung: .zip, .tgz, .tar.gz, .tar

Contoh:

# 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

Paket pengait tertaut diperlakukan sebagai pengait terkelola dari direktori yang dikonfigurasi operator, bukan sebagai pengait workspace.

Perbarui paket pengait

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

Perbarui paket pengait berbasis npm yang dilacak melalui pembaru plugin terpadu.

OmeniaClaw hooks update masih berfungsi sebagai alias kompatibilitas, tetapi mencetak peringatan penghentian dan meneruskan ke OmeniaClaw plugins update.

Opsi:

• --all: Perbarui semua paket pengait yang dilacak
• --dry-run: Tampilkan apa yang akan berubah tanpa menulis

Ketika hash integritas tersimpan ada dan hash artefak yang diambil berubah, OmeniaClaw mencetak peringatan dan meminta konfirmasi sebelum melanjutkan. Gunakan --yes global untuk melewati prompt dalam CI/proses noninteraktif.

Pengait bawaan

session-memory

Menyimpan konteks sesi ke memori saat Anda mengeluarkan /new atau /reset.

Aktifkan:

OmeniaClaw hooks enable session-memory

Output: ~/.OmeniaClaw/workspace/memory/YYYY-MM-DD-HHMM.md secara default. Tetapkan hooks.internal.entries.session-memory.llmSlug: true untuk slug nama file yang dibuat model.

Lihat: dokumentasi session-memory

bootstrap-extra-files

Menyuntikkan file bootstrap tambahan (misalnya AGENTS.md / TOOLS.md lokal-monorepo) selama agent:bootstrap.

Aktifkan:

OmeniaClaw hooks enable bootstrap-extra-files

Lihat: dokumentasi bootstrap-extra-files

command-logger

Mencatat semua peristiwa perintah ke file audit terpusat.

Aktifkan:

OmeniaClaw hooks enable command-logger

Output: ~/.OmeniaClaw/logs/commands.log

Lihat 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 .

Lihat: dokumentasi command-logger

boot-md

Menjalankan BOOT.md saat gateway dimulai (setelah channel dimulai).

Peristiwa: gateway:startup

Aktifkan:

OmeniaClaw hooks enable boot-md

Lihat: dokumentasi boot-md

Terkait

• Referensi CLI
• Pengait otomasi