CLI commands

الخطافات

`openclaw hooks`

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

تشغيل openclaw hooks بلا أمر فرعي يعادل openclaw hooks list.

ذات صلة:

الخطافات: الخطافات
خطافات Plugin: خطافات Plugin

سرد كل الخطافات

bash

openclaw hooks list

يسرد كل الخطافات المكتشفة من أدلة مساحة العمل، والمدارة، والإضافية، والمضمنة. لا يحمّل بدء تشغيل Gateway معالجات الخطافات الداخلية حتى يتم تكوين خطاف داخلي واحد على الأقل.

الخيارات:

--eligible: إظهار الخطافات المؤهلة فقط (المتطلبات مستوفاة)
--json: الإخراج بصيغة JSON
-v, --verbose: إظهار معلومات تفصيلية تشمل المتطلبات المفقودة

مثال على الإخراج:

Code

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

مثال (تفصيلي):

bash

openclaw hooks list --verbose

يعرض المتطلبات المفقودة للخطافات غير المؤهلة.

مثال (JSON):

bash

openclaw hooks list --json

يعيد JSON منظماً للاستخدام البرمجي.

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

bash

openclaw hooks info <name>

يعرض معلومات تفصيلية عن خطاف محدد.

الوسائط:

<name>: اسم الخطاف أو مفتاح الخطاف (مثل session-memory)

الخيارات:

--json: الإخراج بصيغة JSON

مثال:

bash

openclaw hooks info session-memory

الإخراج:

Code

💾 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

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

bash

openclaw hooks check

يعرض ملخصاً لحالة أهلية الخطافات (كم عدد الجاهزة مقابل غير الجاهزة).

الخيارات:

--json: الإخراج بصيغة JSON

مثال على الإخراج:

Code

Hooks Status Total hooks: 4Ready: 4Not ready: 0

تمكين خطاف

bash

openclaw hooks enable <name>

يمكّن خطافاً محدداً عبر إضافته إلى تكوينك (~/.openclaw/openclaw.json افتراضياً).

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

الوسائط:

<name>: اسم الخطاف (مثل session-memory)

مثال:

bash

openclaw hooks enable session-memory

الإخراج:

Code

✓ Enabled hook: 💾 session-memory

ما الذي يفعله:

يتحقق مما إذا كان الخطاف موجوداً ومؤهلاً
يحدّث hooks.internal.entries.<name>.enabled = true في تكوينك
يحفظ التكوين إلى القرص

إذا كان الخطاف قادماً من <workspace>/hooks/، فهذه الخطوة الاختيارية مطلوبة قبل أن يحمّله Gateway.

بعد التمكين:

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

تعطيل خطاف

bash

openclaw hooks disable <name>

يعطّل خطافاً محدداً عبر تحديث تكوينك.

الوسائط:

<name>: اسم الخطاف (مثل command-logger)

مثال:

bash

openclaw hooks disable command-logger

الإخراج:

Code

⏸ Disabled hook: 📝 command-logger

بعد التعطيل:

أعد تشغيل Gateway حتى تُعاد تحميل الخطافات

ملاحظات

تكتب openclaw hooks list --json وinfo --json وcheck --json بيانات JSON منظّمة مباشرة إلى stdout.
لا يمكن تمكين أو تعطيل الخطافات المُدارة بواسطة Plugin هنا؛ مكّن أو عطّل Plugin المالك بدلاً من ذلك.

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

bash

openclaw plugins install <package>        # npm by defaultopenclaw plugins install npm:<package>    # npm onlyopenclaw plugins install <package> --pin  # pin versionopenclaw plugins install <path>           # local path

ثبّت حزم الخطافات عبر مثبّت plugins الموحد.

لا يزال openclaw hooks install يعمل كاسم بديل للتوافق، لكنه يطبع تحذير إهمال ويمرر إلى openclaw plugins install.

مواصفات npm خاصة بالسجل فقط (اسم الحزمة + إصدار دقيق اختياري أو dist-tag). تُرفض مواصفات Git/URL/file ونطاقات semver. تعمل عمليات تثبيت الاعتماديات محلياً ضمن المشروع مع --ignore-scripts للأمان، حتى عندما تحتوي الصدفة لديك على إعدادات تثبيت npm عمومية.

تبقى المواصفات المجردة و@latest على مسار stable. إذا حل npm أياً من هذين إلى إصدار تمهيدي، يتوقف OpenClaw ويطلب منك الاشتراك صراحة باستخدام وسم إصدار تمهيدي مثل @beta/@rc أو إصدار تمهيدي دقيق.

ما الذي يفعله:

ينسخ حزمة الخطافات إلى ~/.openclaw/hooks/<id>
يمكّن الخطافات المثبتة في hooks.internal.entries.*
يسجل التثبيت ضمن hooks.internal.installs

الخيارات:

-l, --link: ربط دليل محلي بدلاً من نسخه (يضيفه إلى hooks.internal.load.extraDirs)
--pin: تسجيل تثبيتات npm بصيغة name@version المحلولة بدقة في hooks.internal.installs

الأرشيفات المدعومة: .zip و.tgz و.tar.gz و.tar

أمثلة:

bash

# Local directoryopenclaw plugins install ./my-hook-pack # Local archiveopenclaw plugins install ./my-hook-pack.zip # NPM packageopenclaw plugins install @openclaw/my-hook-pack # Link a local directory without copyingopenclaw plugins install -l ./my-hook-pack

تُعامل حزم الخطافات المرتبطة كخطافات مُدارة من دليل مكوّن بواسطة المشغّل، وليس كخطافات مساحة عمل.

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

bash

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

حدّث حزم الخطافات المستندة إلى npm والمتتبعة عبر محدّث plugins الموحد.

لا يزال openclaw hooks update يعمل كاسم بديل للتوافق، لكنه يطبع تحذير إهمال ويمرر إلى openclaw plugins update.

الخيارات:

--all: تحديث كل حزم الخطافات المتتبعة
--dry-run: إظهار ما سيتغير دون كتابة

عندما توجد تجزئة سلامة مخزنة وتتغير تجزئة الأثر الذي تم جلبه، يطبع OpenClaw تحذيراً ويطلب التأكيد قبل المتابعة. استخدم --yes العام لتجاوز المطالبات في CI/التشغيل غير التفاعلي.