Skip to main content

​
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

Ç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 bilgilerini alma

<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

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

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

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

​
Hook paketlerini yükleme ve güncelleme

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ı

​
Notlar

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

​
İlgili