openclaw hooks

Ajan hook'larını (/new, /reset gibi komutlar ve Gateway başlatma işlemi için 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 paketle birlikte sunulan dizinlerde bulunan hook'ları listeler.

• --eligible: yalnızca gereksinimleri karşılanan hook'lar.
• --json: yapılandırılmış çıktı.
• -v, --verbose: karşılanmayan gereksinimleri içeren bir Eksik 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ı 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 engelleme nedeniyle birlikte listeler.

Bir hook'u etkinleştirme

openclaw hooks enable <name>

Yapılandırmaya hooks.internal.entries.<name>.enabled = true değerini ekler veya 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> olarak gösterilir ve buradan etkinleştirilemez/devre dışı bırakılamaz; bunun yerine sahibi olan Plugin'i etkinleştirin veya devre dışı bırakın.

Etkinleştirdikten sonra hook'ların yeniden yüklenmesi için 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ıran ve işlemi plugins komutlarına ileten kullanım dışı bırakı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 dağıtım etiketi. Git/URL/dosya belirtimleri ve semver aralıkları reddedilir. Bağımlılık yüklemeleri proje içinde --ignore-scripts ile çalıştırılı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).
• Desteklenen arşivler: .zip, .tgz, .tar.gz, .tar.
• -l, --link, yerel bir dizini kopyalamak yerine bağlar (hooks.internal.load.extraDirs içine 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 hooks.internal.installs içinde tam olarak çözümlenmiş bir name@version biçiminde kaydeder.
• Yükleme işlemi paketi ~/.openclaw/hooks/<id> konumuna kopyalar, hook'larını hooks.internal.entries.* altında etkinleştirir ve yüklemeyi hooks.internal.installs altında kaydeder.
• Saklanan bütünlük karması indirilen yapıtla artık 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 ortamında).

Paketle birlikte sunulan hook'lar

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

command-logger günlük dosyası

tail -n 20 ~/.openclaw/logs/commands.log        # son komutlarcat ~/.openclaw/logs/commands.log | jq .          # okunaklı 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ı