OmeniaClaw hooks

Ajan kancalarını yönetin (/new, /reset ve Gateway başlangıcı gibi komutlar için olay güdümlü otomasyonlar).

OmeniaClaw hooks komutunu alt komut olmadan çalıştırmak, OmeniaClaw hooks list ile eşdeğerdir.

İlgili:

• Kancalar: Kancalar
• Plugin kancaları: Plugin kancaları

Tüm kancaları listeleme

OmeniaClaw hooks list

Çalışma alanı, yönetilen, ek ve paketle gelen dizinlerden keşfedilen tüm kancaları listeler. Gateway başlangıcı, en az bir dahili kanca yapılandırılana kadar dahili kanca işleyicilerini yüklemez.

Seçenekler:

• --eligible: Yalnızca uygun kancaları gösterir (gereksinimler karşılanmış)
• --json: JSON olarak çıktı verir
• -v, --verbose: Eksik gereksinimler dahil ayrıntılı bilgileri gösterir

Örnek çıktı:

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

Örnek (ayrıntılı):

OmeniaClaw hooks list --verbose

Uygun olmayan kancalar için eksik gereksinimleri gösterir.

Örnek (JSON):

OmeniaClaw hooks list --json

Programlı kullanım için yapılandırılmış JSON döndürür.

Kanca bilgilerini alma

OmeniaClaw hooks info <name>

Belirli bir kanca hakkında ayrıntılı bilgi gösterir.

Argümanlar:

• <name>: Kanca adı veya kanca anahtarı (ör. session-memory)

Seçenekler:

• --json: JSON olarak çıktı verir

Örnek:

OmeniaClaw hooks info session-memory

Çıktı:

💾 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

Kancaların uygunluğunu denetleme

OmeniaClaw hooks check

Kanca uygunluk durumunun özetini gösterir (kaç tanesi hazır, kaç tanesi hazır değil).

Seçenekler:

• --json: JSON olarak çıktı verir

Örnek çıktı:

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

Bir kancayı etkinleştirme

OmeniaClaw hooks enable <name>

Yapılandırmanıza ekleyerek belirli bir kancayı etkinleştirir (varsayılan olarak ~/.OmeniaClaw/OmeniaClaw.json).

Not: Çalışma alanı kancaları, burada veya yapılandırmada etkinleştirilene kadar varsayılan olarak devre dışıdır. Plugin tarafından yönetilen kancalar OmeniaClaw hooks list içinde plugin:<id> gösterir ve buradan etkinleştirilemez/devre dışı bırakılamaz. Bunun yerine Plugin'i etkinleştirin/devre dışı bırakın.

Argümanlar:

• <name>: Kanca adı (ör. session-memory)

Örnek:

OmeniaClaw hooks enable session-memory

Çıktı:

✓ Enabled hook: 💾 session-memory

Ne yapar:

• Kancanın var olup olmadığını ve uygun olup olmadığını denetler
• Yapılandırmanızda hooks.internal.entries.<name>.enabled = true değerini günceller
• Yapılandırmayı diske kaydeder

Kanca <workspace>/hooks/ içinden geldiyse, Gateway'in bunu yüklemesinden önce bu katılım adımı gerekir.

Etkinleştirdikten sonra:

• Kancaların yeniden yüklenmesi için gateway'i yeniden başlatın (macOS'ta menü çubuğu uygulamasını yeniden başlatın veya geliştirmede gateway sürecinizi yeniden başlatın).

Bir kancayı devre dışı bırakma

OmeniaClaw hooks disable <name>

Yapılandırmanızı güncelleyerek belirli bir kancayı devre dışı bırakır.

Argümanlar:

• <name>: Kanca adı (ör. command-logger)

Örnek:

OmeniaClaw hooks disable command-logger

Çıktı:

⏸ Disabled hook: 📝 command-logger

Devre dışı bıraktıktan sonra:

• Kancaların yeniden yüklenmesi için gateway'i yeniden başlatın

Notlar

• OmeniaClaw hooks list --json, info --json ve check --json, yapılandırılmış JSON'u doğrudan stdout'a yazar.
• Plugin tarafından yönetilen kancalar burada etkinleştirilemez veya devre dışı bırakılamaz; bunun yerine sahibi olan Plugin'i etkinleştirin veya devre dışı bırakın.

Kanca paketlerini yükleme

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

Kanca paketlerini birleşik plugins yükleyicisi üzerinden yükleyin.

OmeniaClaw hooks install uyumluluk takma adı olarak çalışmaya devam eder, ancak bir kullanımdan kaldırma uyarısı yazdırır ve OmeniaClaw plugins install komutuna yönlendirir.

Npm tanımları yalnızca registry kapsamındadır (paket adı + isteğe bağlı tam sürüm veya dist-tag). Git/URL/file tanımları ve semver aralıkları reddedilir. Bağımlılık yüklemeleri, kabuğunuzda global npm yükleme ayarları olsa bile güvenlik için --ignore-scripts ile proje yerelinde çalışır.

Çıplak tanımlar ve @latest kararlı kanalda kalır. npm bunlardan herhangi birini ön sürüme çözümlerse OmeniaClaw durur ve @beta/@rc gibi bir ön sürüm etiketiyle veya tam bir ön sürüm numarasıyla açıkça katılmanızı ister.

Ne yapar:

• Kanca paketini ~/.OmeniaClaw/hooks/<id> içine kopyalar
• Yüklü kancaları hooks.internal.entries.* içinde etkinleştirir
• Yüklemeyi hooks.internal.installs altında kaydeder

Seçenekler:

• -l, --link: Yerel bir dizini kopyalamak yerine bağlar (hooks.internal.load.extraDirs içine ekler)
• --pin: npm yüklemelerini hooks.internal.installs içinde tam çözümlenmiş name@version olarak kaydeder

Desteklenen arşivler: .zip, .tgz, .tar.gz, .tar

Örnekler:

# 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

Bağlanan kanca paketleri, çalışma alanı kancaları olarak değil, operatör tarafından yapılandırılmış bir dizinden gelen yönetilen kancalar olarak değerlendirilir.

Kanca paketlerini güncelleme

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

İzlenen npm tabanlı kanca paketlerini birleşik plugins güncelleyicisi üzerinden güncelleyin.

OmeniaClaw hooks update uyumluluk takma adı olarak çalışmaya devam eder, ancak bir kullanımdan kaldırma uyarısı yazdırır ve OmeniaClaw plugins update komutuna yönlendirir.

Seçenekler:

• --all: İzlenen tüm kanca paketlerini günceller
• --dry-run: Yazmadan neyin değişeceğini gösterir

Saklanan bir bütünlük hash'i varsa ve getirilen yapıt hash'i değişirse, OmeniaClaw bir uyarı yazdırır ve devam etmeden önce onay ister. CI/etkileşimsiz çalıştırmalarda istemleri atlamak için global --yes kullanın.

Paketle gelen kancalar

session-memory

/new veya /reset verdiğinizde oturum bağlamını belleğe kaydeder.

Etkinleştir:

OmeniaClaw hooks enable session-memory

Çıktı: Varsayılan olarak ~/.OmeniaClaw/workspace/memory/YYYY-MM-DD-HHMM.md. Model tarafından oluşturulan dosya adı slug'ları için hooks.internal.entries.session-memory.llmSlug: true ayarlayın.

Ayrıca bakın: session-memory belgeleri

bootstrap-extra-files

agent:bootstrap sırasında ek bootstrap dosyaları (örneğin monorepo yerelinde AGENTS.md / TOOLS.md) enjekte eder.

Etkinleştir:

OmeniaClaw hooks enable bootstrap-extra-files

Ayrıca bakın: bootstrap-extra-files belgeleri

command-logger

Tüm komut olaylarını merkezi bir denetim dosyasına kaydeder.

Etkinleştir:

OmeniaClaw hooks enable command-logger

Çıktı: ~/.OmeniaClaw/logs/commands.log

Günlükleri görüntüle:

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

Ayrıca bakın: command-logger belgeleri

boot-md

Gateway başladığında (kanallar başladıktan sonra) BOOT.md çalıştırır.

Olaylar: gateway:startup

Etkinleştir:

OmeniaClaw hooks enable boot-md

Ayrıca bakın: boot-md belgeleri

İlgili

• CLI başvurusu
• Otomasyon kancaları