Skip to main content

openclaw hooks

إدارة خطافات الوكيل (أتمتة قائمة على الأحداث لأوامر مثل /new و/reset وبدء تشغيل الـ Gateway). ذو صلة:
  • الخطافات: Hooks
  • خطافات الإضافات: Plugins

قائمة جميع الروابط

يعرض جميع الخطافات المكتشفة من مجلدات مساحة العمل والمُدارة والمُضمَّنة. الخيارات:
  • --eligible: إظهار الخطافات المؤهلة فقط (المتطلبات مستوفاة)
  • --json: الإخراج بصيغة JSON
  • -v, --verbose: إظهار معلومات تفصيلية بما في ذلك المتطلبات المفقودة
مثال على الإخراج:
مثال (تفصيلي):
يعرض المتطلبات المفقودة للخطافات غير المؤهلة. مثال (JSON):
يعيد JSON مُنظَّمًا للاستخدام البرمجي.

الحصول على معلومات الخطاف

يعرض معلومات تفصيلية حول خطاف معيّن. المعاملات:
  • <name>: اسم الخطاف (مثل session-memory)
الخيارات:
  • --json: الإخراج بصيغة JSON
مثال:
الإخراج:

التحقق من أهلية الخطافات

يعرض ملخص حالة أهلية الخطافات (عدد الجاهز مقابل غير الجاهز). الخيارات:
  • --json: الإخراج بصيغة JSON
مثال على الإخراج:

تمكين خطاف

تمكين خطاف معيّن عبر إضافته إلى التهيئة الخاصة بك (~/.openclaw/config.json). ملاحظة: الخطافات المُدارة بواسطة الإضافات تُظهر plugin:<id> في openclaw hooks list ولا يمكن تمكينها أو تعطيلها من هنا. بدلاً من ذلك، قم بتمكين أو تعطيل الإضافة. المعاملات:
  • <name>: اسم الخطاف (مثل session-memory)
مثال:
الإخراج:
ما الذي يفعله:
  • يتحقق من وجود الخطاف وأنه مؤهل
  • يُحدِّث hooks.internal.entries.<name>.enabled = true في التهيئة الخاصة بك
  • يحفظ التهيئة على القرص
بعد التمكين:
  • أعد تشغيل الـ Gateway لإعادة تحميل الخطافات (إعادة تشغيل تطبيق شريط القائمة على macOS، أو إعادة تشغيل عملية الـ Gateway في وضع التطوير).

تعطيل خطاف

تعطيل خطاف معيّن عبر تحديث التهيئة الخاصة بك. المعاملات:
  • <name>: اسم الخطاف (مثل command-logger)
مثال:
الإخراج:
بعد التعطيل:
  • أعد تشغيل الـ Gateway لإعادة تحميل الخطافات

تثبيت الخطافات

تثبيت حزمة خطافات من مجلد/أرشيف محلي أو من npm. مواصفات Npm هي registry-only (اسم الحزمة + إصدار/وسم اختياري). يتم رفض مواصفات Git/URL/file. تُنفَّذ عمليات تثبيت الاعتماديات باستخدام --ignore-scripts لأسباب تتعلق بالأمان. ما الذي يفعله:
  • ينسخ حزمة الخطافات إلى ~/.openclaw/hooks/<id>
  • يفعّل الخطافات المثبّتة في hooks.internal.entries.*
  • يسجّل عملية التثبيت ضمن hooks.internal.installs
الخيارات:
  • -l, --link: ربط دليل محلي بدلاً من النسخ (يضيفه إلى hooks.internal.load.extraDirs)
الأرشيفات المدعومة: .zip و.tgz و.tar.gz و.tar أمثلة:

تحديث الخطافات

تحديث حِزم الخطافات المثبّتة (تثبيتات npm فقط). الخيارات:
  • --all: تحديث جميع حِزم الخطافات المتعقَّبة
  • --dry-run: إظهار ما الذي سيتغيّر دون الكتابة

الخطافات المُضمَّنة

session-memory

يحفظ سياق الجلسة في الذاكرة عند إصدارك /new. التمكين:
الإخراج: ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md انظر: توثيق session-memory

bootstrap-extra-files

يحقن ملفات bootstrap إضافية (على سبيل المثال ملفات AGENTS.md / TOOLS.md المحلية ضمن monorepo) أثناء agent:bootstrap. التمكين:
انظر: SOUL Evil Hook

command-logger

يسجّل جميع أحداث الأوامر في ملف تدقيق مركزي. التمكين:
الإخراج: ~/.openclaw/logs/commands.log عرض السجلات:
انظر: توثيق command-logger

boot-md

يشغّل BOOT.md عند بدء تشغيل الـ Gateway (بعد بدء القنوات). التمكين: الأحداث: gateway:startup
انظر: توثيق boot-md