openclaw hooks

Ajan hook'larını (/new, /reset ve gateway başlatma gibi komutlara yönelik olay güdümlü otomasyonları) yönetin. Yalın openclaw hooks, openclaw hooks list ile eşdeğerdir.

İlgili: Hook'lar - Plugin hook'ları

Hook'ları listeleme

openclaw hooks list [--eligible] [--json] [-v|--verbose]

Çalışma alanı, yönetilen, ek ve paketlenmiş dizinlerde keşfedilen hook'ları listeler.

• --eligible: yalnızca gereksinimleri karşılanan hook'lar.
• --json: yapılandırılmış çıktı.
• -v, --verbose: karşılanmamış gereksinimleri içeren bir Missing sütunu ekler.

Hook'lar (4/5 hazır) Hazır:  🚀 boot-md ✓ - Gateway başlatılırken BOOT.md dosyasını çalıştır  📎 bootstrap-extra-files ✓ - Ajan önyüklemesi sırasında ek çalışma alanı önyükleme dosyalarını ekle  📝 command-logger ✓ - Tüm komut olaylarını merkezi bir denetim dosyasına kaydet  💾 session-memory ✓ - /new veya /reset komutu verildiğinde oturum bağlamını belleğe kaydet

Hook bilgilerini alma

openclaw hooks info <name> [--json]

<name>, hook adı veya hook anahtarıdır (örneğin session-memory). Kaynağı, dosya/işleyici yollarını, ana sayfayı, olayları ve gereksinim başına durumu (ikili dosyalar, ortam, yapılandırma, işletim sistemi) gösterir.

Uygunluğu denetleme

openclaw hooks check [--json]

Hazır/hazır değil sayı özetini yazdırır; hazır olmayan hook'lar varsa her birini engelleyen nedenle birlikte listeler.

Bir hook'u etkinleştirme

openclaw hooks enable <name>

Yapılandırmadaki hooks.internal.entries.<name>.enabled = true öğesini ekler/günceller ve ayrıca hooks.internal.enabled ana anahtarını açar (en az bir hook yapılandırılana kadar gateway hiçbir dahili hook işleyicisini yüklemez). Hook mevcut değilse, Plugin tarafından yönetiliyorsa veya uygun değilse (gereksinimleri eksikse) başarısız olur.

Plugin tarafından yönetilen hook'lar hooks list içinde plugin:<id> gösterir ve buradan etkinleştirilemez/devre dışı bırakılamaz; bunun yerine sahibi olan Plugin'i etkinleştirin veya devre dışı bırakın.

Hook'ları yeniden yüklemesi için etkinleştirdikten sonra gateway'i yeniden başlatın (macOS menü çubuğu uygulamasını veya geliştirme ortamındaki gateway işleminizi yeniden başlatın).

Bir hook'u devre dışı bırakma

openclaw hooks disable <name>

hooks.internal.entries.<name>.enabled = false olarak ayarlar. Ardından gateway'i yeniden başlatın.

Hook paketlerini yükleme ve güncelleme

openclaw plugins install <package>        # varsayılan olarak npmopenclaw plugins install npm:<package>    # yalnızca npmopenclaw plugins install <package> --pin  # çözümlenen sürümü sabitleopenclaw plugins install <path>           # yerel dizin veya arşivopenclaw plugins install -l <path>        # yerel dizini kopyalamak yerine bağla openclaw plugins update <id>openclaw plugins update --allopenclaw plugins update --dry-run

Hook paketleri birleşik Plugin yükleyicisi/güncelleyicisi aracılığıyla yüklenir; openclaw hooks install / openclaw hooks update, uyarı yazdırıp plugins komutlarına yönlendiren, kullanımdan kaldırılmış takma adlar olarak çalışmaya devam eder.

• Npm belirtimleri yalnızca kayıt defteriyle sınırlıdır: paket adı ve isteğe bağlı tam sürüm veya dist-tag. Git/URL/dosya belirtimleri ve semver aralıkları reddedilir. Bağımlılık yüklemeleri --ignore-scripts ile projeye yerel olarak çalışır.
• Yalın belirtimler ve @latest kararlı kanalda kalır; npm bir ön sürüm çözümlerse OpenClaw durur ve açıkça katılmanızı ister (@beta, @rc veya tam bir ön sürüm numarası).
• Desteklenen arşivler: .zip, .tgz, .tar.gz, .tar.
• -l, --link, yerel bir dizini kopyalamak yerine bağlar (hooks.internal.load.extraDirs öğesine ekler); bağlı hook paketleri çalışma alanı hook'ları değil, operatör tarafından yapılandırılmış bir dizindeki yönetilen hook'lardır.
• --pin, npm yüklemelerini paylaşılan SQLite durumunda tam çözümlenmiş bir name@version olarak kaydeder.
• Yükleme, paketi ~/.openclaw/hooks/<id> konumuna kopyalar, hook'larını hooks.internal.entries.* altında etkinleştirir ve yükleme kaynağını paylaşılan SQLite durumuna kaydeder.
• Saklanan bütünlük karması artık getirilen yapıtla eşleşmiyorsa OpenClaw uyarır ve devam etmeden önce onay ister; istemi atlamak için genel --yes seçeneğini kullanın (örneğin CI'da).

Paketlenmiş hook'lar

Paketlenmiş herhangi bir hook'u openclaw hooks enable <hook-name> ile etkinleştirin. Tüm ayrıntılar, yapılandırma anahtarları ve varsayılanlar: Paketlenmiş hook'lar.

command-logger günlük dosyası

tail -n 20 ~/.openclaw/logs/commands.log        # son komutlarcat ~/.openclaw/logs/commands.log | jq .          # okunaklı biçimde yazdırgrep '"action":"new"' ~/.openclaw/logs/commands.log | jq .   # eyleme göre filtrele

Notlar

• hooks list --json, info --json ve check --json yapılandırılmış JSON'u doğrudan standart çıktıya yazar.

İlgili

• CLI başvurusu
• Otomasyon hook'ları