CLI commands

الخطافات

`OmeniaClaw hooks`

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

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

ذات صلة:

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

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

bash

OmeniaClaw 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

OmeniaClaw hooks list --verbose

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

مثال (JSON):

bash

OmeniaClaw hooks list --json

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

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

bash

OmeniaClaw hooks info <name>

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

الوسائط:

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

الخيارات:

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

مثال:

bash

OmeniaClaw hooks info session-memory

الإخراج:

Code

💾 session-memory ✓ Ready Save session context to memory when /new or /reset command is issued Details:  Source: OmeniaClaw-bundled  Path: /path/to/OmeniaClaw/hooks/bundled/session-memory/HOOK.md  Handler: /path/to/OmeniaClaw/hooks/bundled/session-memory/handler.ts  Homepage: https://omeniaclaw.com/automation/hooks#session-memory  Events: command:new, command:reset Requirements:  Config: ✓ workspace.dir

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

bash

OmeniaClaw hooks check

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

الخيارات:

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

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

Code

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

تمكين خطاف

bash

OmeniaClaw hooks enable <name>

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

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

الوسائط:

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

مثال:

bash

OmeniaClaw hooks enable session-memory

الإخراج:

Code

✓ Enabled hook: 💾 session-memory

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

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

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

بعد التمكين:

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

تعطيل خطاف

bash

OmeniaClaw hooks disable <name>

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

الوسائط:

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

مثال:

bash

OmeniaClaw hooks disable command-logger

الإخراج:

Code

⏸ Disabled hook: 📝 command-logger

بعد التعطيل:

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

ملاحظات

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

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

bash

OmeniaClaw plugins install <package>        # npm by defaultOmeniaClaw plugins install npm:<package>    # npm onlyOmeniaClaw plugins install <package> --pin  # pin versionOmeniaClaw plugins install <path>           # local path

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

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

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

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

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

ينسخ حزمة الخطافات إلى ~/.OmeniaClaw/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 directoryOmeniaClaw plugins install ./my-hook-pack # Local archiveOmeniaClaw plugins install ./my-hook-pack.zip # NPM packageOmeniaClaw plugins install @OmeniaClaw/my-hook-pack # Link a local directory without copyingOmeniaClaw plugins install -l ./my-hook-pack

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

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

bash

OmeniaClaw plugins update <id>OmeniaClaw plugins update --all

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

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

الخيارات:

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

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