CLI commands

الخطافات

`openclaw hooks`

إدارة خطافات الوكيل (عمليات أتمتة مدفوعة بالأحداث لأوامر مثل /new و/reset وبدء تشغيل Gateway). يعادل الأمر openclaw hooks دون خيارات الأمر openclaw hooks list.

راجع أيضًا: الخطافات - خطافات Plugin

سرد الخطافات

bash

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

يسرد الخطافات المكتشفة في أدلة مساحة العمل والأدلة المُدارة والإضافية والمضمّنة.

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

Code

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

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

bash

openclaw hooks info <name> [--json]

يمثّل <name> اسم الخطاف أو مفتاحه (مثل session-memory). يعرض المصدر ومسارات الملف/المعالج والصفحة الرئيسية والأحداث وحالة كل متطلب (الملفات التنفيذية والبيئة والإعدادات ونظام التشغيل).

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

bash

openclaw hooks check [--json]

يطبع ملخصًا لأعداد الخطافات الجاهزة وغير الجاهزة؛ وعند وجود خطافات غير جاهزة، يسرد كل خطاف مع سبب منعه.

تمكين خطاف

bash

openclaw hooks enable <name>

يضيف أو يحدّث hooks.internal.entries.<name>.enabled = true في الإعدادات، ويفعّل أيضًا المفتاح الرئيسي hooks.internal.enabled (لا يحمّل Gateway أي معالج خطاف داخلي حتى تتم تهيئة خطاف واحد على الأقل). يفشل الأمر إذا كان الخطاف غير موجود، أو مُدارًا بواسطة Plugin، أو غير مؤهل (بسبب متطلبات مفقودة).

تُظهر الخطافات المُدارة بواسطة Plugin القيمة plugin:<id> في hooks list، ولا يمكن تمكينها أو تعطيلها هنا؛ مكّن Plugin المالك أو عطّله بدلًا من ذلك.

أعد تشغيل Gateway بعد التمكين (بإعادة تشغيل تطبيق شريط القوائم في macOS، أو إعادة تشغيل عملية Gateway في بيئة التطوير) لكي يعيد تحميل الخطافات.

تعطيل خطاف

bash

openclaw hooks disable <name>

يضبط hooks.internal.entries.<name>.enabled = false. أعد تشغيل Gateway بعد ذلك.

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

bash

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 --allopenclaw plugins update --dry-run

تُثبّت حزم الخطافات وتُحدّث عبر أداة تثبيت Plugins وتحديثها الموحّدة؛ ولا يزال openclaw hooks install وopenclaw hooks update يعملان كاسمين مستعارين مهملين يطبعان تحذيرًا ويمرران التنفيذ إلى أوامر plugins.

تقتصر مواصفات 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).