​

openclaw hooks

​

سرد الخطافات

openclaw hooks list [--eligible] [--json] [-v|--verbose]

• --eligible: الخطافات التي استُوفيت متطلباتها فقط.
• --json: مخرجات منظّمة.
• -v, --verbose: تضمين عمود للمتطلبات المفقودة التي لم تُستوفَ.

الخطافات (4/5 جاهزة)

جاهزة:
  🚀 boot-md ✓ - تشغيل BOOT.md عند بدء تشغيل Gateway
  📎 bootstrap-extra-files ✓ - إدراج ملفات تمهيد إضافية لمساحة العمل أثناء تمهيد الوكيل
  📝 command-logger ✓ - تسجيل جميع أحداث الأوامر في ملف تدقيق مركزي
  💾 session-memory ✓ - حفظ سياق الجلسة في الذاكرة عند إصدار الأمر /new أو /reset

​

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

openclaw hooks info <name> [--json]

​

التحقق من الأهلية

openclaw hooks check [--json]

​

تمكين خطاف

openclaw hooks enable <name>

​

تعطيل خطاف

openclaw hooks disable <name>

​

تثبيت حزم الخطافات وتحديثها

openclaw plugins install <package>        # npm افتراضيًا
openclaw plugins install npm:<package>    # npm فقط
openclaw plugins install <package> --pin  # تثبيت الإصدار المحلول
openclaw plugins install <path>           # دليل محلي أو أرشيف
openclaw plugins install -l <path>        # ربط دليل محلي بدلًا من نسخه

openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins update --dry-run

• تقتصر مواصفات npm على السجل: اسم الحزمة مع إصدار دقيق اختياري أو وسم توزيع. تُرفض مواصفات Git وعناوين URL والملفات ونطاقات semver. تُثبّت التبعيات محليًا داخل المشروع باستخدام --ignore-scripts.
• تبقى المواصفات المجردة و@latest ضمن المسار المستقر؛ وإذا حلّ npm إصدارًا تجريبيًا، يتوقف OpenClaw ويطلب منك الاشتراك فيه صراحةً (@beta أو @rc أو إصدار تجريبي دقيق).
• الأرشيفات المدعومة: .zip و.tgz و.tar.gz و.tar.
• يربط -l, --link دليلًا محليًا بدلًا من نسخه (ويضيفه إلى hooks.internal.load.extraDirs)؛ حزم الخطافات المرتبطة هي خطافات مُدارة من دليل أعدّه المشغّل، وليست خطافات مساحة العمل.
• يسجّل --pin عمليات تثبيت npm بالصيغة الدقيقة المحلولة name@version في hooks.internal.installs.
• ينسخ التثبيت الحزمة إلى ~/.openclaw/hooks/<id>، ويمكّن خطافاتها ضمن hooks.internal.entries.*، ويسجّل التثبيت ضمن hooks.internal.installs.
• إذا لم تعد بصمة التكامل المخزّنة تطابق العنصر المُجلَب، يحذّر OpenClaw ويطلب التأكيد قبل المتابعة؛ مرّر الخيار العام --yes لتجاوز الطلب (على سبيل المثال في CI).

​

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

​

ملف سجل command-logger

tail -n 20 ~/.openclaw/logs/commands.log        # الأوامر الأخيرة
cat ~/.openclaw/logs/commands.log | jq .          # طباعة منسقة
grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .   # التصفية حسب الإجراء

​

ملاحظات

• تكتب hooks list --json وinfo --json وcheck --json بيانات JSON المنظّمة مباشرةً إلى المخرجات القياسية.

​

ذو صلة

• مرجع CLI
• خطافات الأتمتة