Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw hooks

Ajan kancalarını yönetin (/new, /reset ve Gateway başlangıcı gibi komutlar için olay güdümlü otomasyonlar). openclaw hooks komutunu alt komut olmadan çalıştırmak, openclaw hooks list ile eşdeğerdir. İlgili:

​
Tüm kancaları listeleme

openclaw 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ı): 
openclaw hooks list --verbose
Uygun olmayan kancalar için eksik gereksinimleri gösterir. Örnek (JSON): 
openclaw hooks list --json
Programlı kullanım için yapılandırılmış JSON döndürür.

​
Kanca bilgilerini alma

openclaw 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: 
openclaw hooks info session-memory
Çıktı: 
💾 session-memory ✓ Ready

Save session context to memory when /new or /reset command is issued

Details:
  Source: openclaw-bundled
  Path: /path/to/openclaw/hooks/bundled/session-memory/HOOK.md
  Handler: /path/to/openclaw/hooks/bundled/session-memory/handler.ts
  Homepage: https://docs.openclaw.ai/automation/hooks#session-memory
  Events: command:new, command:reset

Requirements:
  Config: ✓ workspace.dir

​
Kancaların uygunluğunu denetleme

openclaw 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: 4
Ready: 4
Not ready: 0

​
Bir kancayı etkinleştirme

openclaw hooks enable <name>
Yapılandırmanıza ekleyerek belirli bir kancayı etkinleştirir (varsayılan olarak ~/.openclaw/openclaw.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 openclaw 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: 
openclaw 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

openclaw 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: 
openclaw 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

  • openclaw 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

openclaw plugins install <package>        # npm by default
openclaw plugins install npm:<package>    # npm only
openclaw plugins install <package> --pin  # pin version
openclaw plugins install <path>           # local path
Kanca paketlerini birleşik plugins yükleyicisi üzerinden yükleyin. openclaw hooks install uyumluluk takma adı olarak çalışmaya devam eder, ancak bir kullanımdan kaldırma uyarısı yazdırır ve openclaw 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 OpenClaw 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 ~/.openclaw/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 directory
openclaw plugins install ./my-hook-pack

# Local archive
openclaw plugins install ./my-hook-pack.zip

# NPM package
openclaw plugins install @openclaw/my-hook-pack

# Link a local directory without copying
openclaw 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

openclaw plugins update <id>
openclaw plugins update --all
İzlenen npm tabanlı kanca paketlerini birleşik plugins güncelleyicisi üzerinden güncelleyin. openclaw hooks update uyumluluk takma adı olarak çalışmaya devam eder, ancak bir kullanımdan kaldırma uyarısı yazdırır ve openclaw 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, OpenClaw 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: 
openclaw hooks enable session-memory
Çıktı: Varsayılan olarak ~/.openclaw/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: 
openclaw 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: 
openclaw hooks enable command-logger
Çıktı: ~/.openclaw/logs/commands.log Günlükleri görüntüle: 
# Recent commands
tail -n 20 ~/.openclaw/logs/commands.log

# Pretty-print
cat ~/.openclaw/logs/commands.log | jq .

# Filter by action
grep '"action":"new"' ~/.openclaw/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: 
openclaw hooks enable boot-md
Ayrıca bakın: boot-md belgeleri

​
İlgili