Skip to main content

​
openclaw hooks

Kelola hook agen (otomatisasi berbasis peristiwa untuk perintah seperti /new, /reset, dan startup Gateway). openclaw hooks tanpa argumen setara dengan openclaw hooks list. Terkait: Hook - Hook Plugin

​
Mencantumkan hook

Mencantumkan hook yang ditemukan dari direktori ruang kerja, terkelola, tambahan, dan bawaan.
  • --eligible: hanya hook yang persyaratannya terpenuhi.
  • --json: keluaran terstruktur.
  • -v, --verbose: sertakan kolom Missing yang berisi persyaratan yang belum terpenuhi.

​
Mendapatkan informasi hook

<name> adalah nama atau kunci hook (misalnya session-memory). Menampilkan sumber, jalur file/handler, beranda, peristiwa, dan status setiap persyaratan (biner, env, konfigurasi, OS).

​
Memeriksa kelayakan

Mencetak ringkasan jumlah siap/tidak siap; jika ada hook yang tidak siap, mencantumkan masing-masing beserta alasan pemblokirnya.

​
Mengaktifkan hook

Menambahkan/memperbarui hooks.internal.entries.<name>.enabled = true dalam konfigurasi dan juga mengaktifkan sakelar utama hooks.internal.enabled (Gateway tidak memuat handler hook internal apa pun hingga setidaknya satu dikonfigurasi). Gagal jika hook tidak ada, dikelola Plugin, atau tidak memenuhi syarat (persyaratan tidak lengkap). Hook yang dikelola Plugin menampilkan plugin:<id> dalam hooks list dan tidak dapat diaktifkan/dinonaktifkan di sini; aktifkan atau nonaktifkan Plugin pemiliknya sebagai gantinya. Mulai ulang Gateway setelah mengaktifkan (mulai ulang aplikasi bilah menu macOS, atau mulai ulang proses Gateway Anda dalam pengembangan) agar hook dimuat ulang.

​
Menonaktifkan hook

Menetapkan hooks.internal.entries.<name>.enabled = false. Mulai ulang Gateway setelahnya.

​
Menginstal dan memperbarui paket hook

Paket hook diinstal melalui penginstal/pembaruan Plugin terpadu; openclaw hooks install / openclaw hooks update masih berfungsi sebagai alias usang yang mencetak peringatan dan meneruskan ke perintah plugins.
  • Spesifikasi npm hanya untuk registry: nama paket ditambah versi persis atau dist-tag opsional. Spesifikasi Git/URL/file dan rentang semver ditolak. Instalasi dependensi dijalankan secara lokal dalam proyek dengan --ignore-scripts.
  • Spesifikasi tanpa versi dan @latest tetap berada di jalur stabil; jika npm meresolusi ke prarilis, OpenClaw berhenti dan meminta Anda untuk menyetujuinya secara eksplisit (@beta, @rc, atau versi prarilis persis).
  • Arsip yang didukung: .zip, .tgz, .tar.gz, .tar.
  • -l, --link menautkan direktori lokal alih-alih menyalinnya (menambahkannya ke hooks.internal.load.extraDirs); paket hook tertaut adalah hook terkelola dari direktori yang dikonfigurasi operator, bukan hook ruang kerja.
  • --pin mencatat instalasi npm sebagai name@version persis yang diresolusi dalam hooks.internal.installs.
  • Instalasi menyalin paket ke ~/.openclaw/hooks/<id>, mengaktifkan hook-nya di bawah hooks.internal.entries.*, dan mencatat instalasi di bawah hooks.internal.installs.
  • Jika hash integritas tersimpan tidak lagi cocok dengan artefak yang diambil, OpenClaw memperingatkan dan meminta konfirmasi sebelum melanjutkan; berikan --yes global untuk melewati konfirmasi (misalnya dalam CI).

​
Hook bawaan

Aktifkan hook bawaan apa pun dengan openclaw hooks enable <hook-name>. Detail lengkap, kunci konfigurasi, dan nilai default: Hook bawaan.

​
File log command-logger

​
Catatan

  • hooks list --json, info --json, dan check --json menulis JSON terstruktur langsung ke stdout.

​
Terkait