Skip to main content

​
openclaw hooks

Ajan hooks’larını yönetin ( /new, /reset gibi komutlar ve gateway başlangıcı için olay güdümlü otomasyonlar). İlgili:

​
Tüm Hooks’ları Listeleme

Çalışma alanı, yönetilen ve paketlenmiş dizinlerden keşfedilen tüm hooks’ları listeler. Seçenekler:
  • --eligible: Yalnızca uygun hooks’ları gösterir (gereksinimler karşılanmış)
  • --json: JSON olarak çıktı verir
  • -v, --verbose: Eksik gereksinimler dahil ayrıntılı bilgileri gösterir
Örnek çıktı:
Örnek (ayrıntılı):
Uygun olmayan hooks’lar için eksik gereksinimleri gösterir. Örnek (JSON):
Programatik kullanım için yapılandırılmış JSON döndürür.

​
Hook Bilgilerini Alma

Belirli bir hook hakkında ayrıntılı bilgi gösterir. Argümanlar:
  • <name>: Hook adı (ör. session-memory)
Seçenekler:
  • --json: JSON olarak çıktı verir
Örnek:
Output:

​
Hooks Uygunluğunu Kontrol Etme

Hook uygunluk durumunun özetini gösterir (kaçının hazır olduğu vs. hazır olmadığı). Seçenekler:
  • --json: JSON olarak çıktı verir
Örnek çıktı:

​
Bir Hook’u Etkinleştirme

Belirli bir hook’u yapılandırmanıza (~/.openclaw/config.json) ekleyerek etkinleştirir. Not: Eklentiler tarafından yönetilen hooks’lar openclaw hooks list içinde plugin:<id> olarak görünür ve buradan etkinleştirilemez/devre dışı bırakılamaz. Bunun yerine eklentiyi etkinleştirin/devre dışı bırakın. Argümanlar:
  • <name>: Hook adı (ör. session-memory)
Örnek:
Output:
Ne yapar:
  • Hook’un var olup olmadığını ve uygunluğunu kontrol eder
  • Yapılandırmanızdaki hooks.internal.entries.<name>.enabled = true alanını günceller
  • Yapılandırmayı diske kaydeder
Etkinleştirdikten sonra:
  • Hooks’ları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ştirme ortamında gateway sürecini yeniden başlatın).

​
Disable a Hook

Yapılandırmanızı güncelleyerek belirli bir hook’u devre dışı bırakır. Argümanlar:
  • <name>: Hook adı (ör. command-logger)
Örnek:
Output:
Devre dışı bıraktıktan sonra:
  • Hooks’ların yeniden yüklenmesi için gateway’i yeniden başlatın

​
Hooks Yükleme

Yerel bir klasörden/arşivden veya npm’den bir hook paketi yükler. Npm özellikleri yalnızca registry (paket adı + isteğe bağlı sürüm/etiket) içindir. Git/URL/file özellikleri reddedilir. Bağımlılık kurulumları güvenlik için --ignore-scripts ile çalıştırılır. Ne yapar:
  • Hook paketini ~/.openclaw/hooks/<id> içine kopyalar
  • Yüklenen hooks’ları hooks.internal.entries.* içinde etkinleştirir
  • Kurulumu hooks.internal.installs altında kaydeder
Seçenekler:
  • -l, --link: Kopyalamak yerine yerel bir dizini bağlar (hooks.internal.load.extraDirs içine ekler)
Desteklenen arşivler: .zip, .tgz, .tar.gz, .tar Örnekler:

​
Hooks Güncelleme

Yüklü hook paketlerini günceller (yalnızca npm kurulumları). Seçenekler:
  • --all: İzlenen tüm hook paketlerini günceller
  • --dry-run: Yazmadan neyin değişeceğini gösterir

​
Paketlenmiş Hooks

​
session-memory

/new verdiğinizde oturum bağlamını belleğe kaydeder. Etkinleştir:
Çıktı: ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md Bkz.: session-memory dokümantasyonu

​
bootstrap-extra-files

agent:bootstrap sırasında ek bootstrap dosyaları (örneğin monorepo-yerel AGENTS.md / TOOLS.md) ekler. Etkinleştir:
Bkz.: bootstrap-extra-files dokümantasyonu

​
command-logger

Tüm komut olaylarını merkezi bir denetim dosyasına kaydeder. Etkinleştir:
Çıktı: ~/.openclaw/logs/commands.log Günlükleri görüntüleme:
Bkz.: command-logger dokümantasyonu

​
boot-md

Gateway başlatıldığında (kanallar başladıktan sonra) BOOT.md çalıştırır. Etkinleştir: Olaylar: gateway:startup
Bkz.: boot-md dokümantasyonu