Plugins

إدارة Plugins الخاصة بـ Gateway، وحزم الخطافات، والحزم المتوافقة.

الأوامر

OmeniaClaw plugins listOmeniaClaw plugins list --enabledOmeniaClaw plugins list --verboseOmeniaClaw plugins list --jsonOmeniaClaw plugins search <query>OmeniaClaw plugins search <query> --limit 20OmeniaClaw plugins search <query> --jsonOmeniaClaw plugins install <path-or-spec>OmeniaClaw plugins inspect <id>OmeniaClaw plugins inspect <id> --runtimeOmeniaClaw plugins inspect <id> --jsonOmeniaClaw plugins inspect --allOmeniaClaw plugins info <id>OmeniaClaw plugins enable <id>OmeniaClaw plugins disable <id>OmeniaClaw plugins registryOmeniaClaw plugins registry --refreshOmeniaClaw plugins uninstall <id>OmeniaClaw plugins doctorOmeniaClaw plugins update <id-or-npm-spec>OmeniaClaw plugins update --allOmeniaClaw plugins marketplace list <marketplace>OmeniaClaw plugins marketplace list <marketplace> --json

للتحقيق في بطء التثبيت، أو الفحص، أو إلغاء التثبيت، أو تحديث السجل، شغّل الأمر مع OmeniaClaw_PLUGIN_LIFECYCLE_TRACE=1. يكتب التتبع أزمنة المراحل إلى stderr ويبقي مخرجات JSON قابلة للتحليل. راجع تصحيح الأخطاء.

التثبيت

OmeniaClaw plugins search "calendar"                   # search ClawHub pluginsOmeniaClaw plugins install <package>                      # npm by defaultOmeniaClaw plugins install clawhub:<package>              # ClawHub onlyOmeniaClaw plugins install npm:<package>                  # npm onlyOmeniaClaw plugins install npm-pack:<path.tgz>            # local npm pack through npm install semanticsOmeniaClaw plugins install git:github.com/<owner>/<repo>  # git repoOmeniaClaw plugins install git:github.com/<owner>/<repo>@<ref>OmeniaClaw plugins install <package> --force              # overwrite existing installOmeniaClaw plugins install <package> --pin                # pin versionOmeniaClaw plugins install <package> --dangerously-force-unsafe-installOmeniaClaw plugins install <path>                         # local pathOmeniaClaw plugins install <plugin>@<marketplace>         # marketplaceOmeniaClaw plugins install <plugin> --marketplace <name>  # marketplace (explicit)OmeniaClaw plugins install <plugin> --marketplace https://github.com/<owner>/<repo>

يمكن للمشرفين الذين يختبرون التثبيتات وقت الإعداد تجاوز مصادر تثبيت Plugin التلقائية باستخدام متغيرات بيئة محمية. راجع تجاوزات تثبيت Plugin.

يستعلم plugins search من ClawHub عن حزم Plugin القابلة للتثبيت ويطبع أسماء حزم جاهزة للتثبيت. يبحث في حزم code-plugin وbundle-plugin، وليس Skills. استخدم OmeniaClaw skills search للبحث عن Skills في ClawHub.

تستخدم تثبيتات ClawHub محدد موقع صريحًا clawhub:<package>:

OmeniaClaw plugins install clawhub:OmeniaClaw-codex-app-serverOmeniaClaw plugins install clawhub:[email protected]

تُثبَّت مواصفات Plugin الآمنة لـ npm المجردة من npm افتراضيًا أثناء مرحلة انتقال الإطلاق:

OmeniaClaw plugins install OmeniaClaw-codex-app-server

استخدم npm: لجعل الحل المقتصر على npm صريحًا:

OmeniaClaw plugins install npm:OmeniaClaw-codex-app-serverOmeniaClaw plugins install npm:@scope/[email protected]

يتحقق OmeniaClaw من توافق واجهة API المعلنة للـ Plugin / الحد الأدنى لتوافق Gateway قبل التثبيت. عندما ينشر إصدار ClawHub المحدد قطعة ClawPack أثرية، ينزّل OmeniaClaw حزمة npm ذات الإصدار .tgz، ويتحقق من ترويسة ملخص ClawHub وملخص القطعة الأثرية، ثم يثبتها عبر مسار الأرشيف العادي. لا تزال إصدارات ClawHub الأقدم التي لا تحتوي على بيانات تعريف ClawPack تثبّت عبر مسار التحقق القديم لأرشيف الحزمة. تحتفظ التثبيتات المسجلة ببيانات تعريف مصدر ClawHub، ونوع القطعة الأثرية، وتكامل npm، وملخص shasum في npm، واسم tarball، وحقائق ملخص ClawPack للتحديثات اللاحقة. تحتفظ تثبيتات ClawHub غير ذات الإصدار بمواصفة مسجلة غير ذات إصدار كي يتمكن OmeniaClaw plugins update من تتبع إصدارات ClawHub الأحدث؛ أما محددات الإصدار أو الوسم الصريحة مثل clawhub:[email protected] وclawhub:pkg@beta فتبقى مثبتة على ذلك المحدد.

اختصار السوق

استخدم اختصار plugin@marketplace عندما يكون اسم السوق موجودًا في ذاكرة التخزين المؤقت للسجل المحلي الخاصة بـ Claude في ~/.claude/plugins/known_marketplaces.json:

OmeniaClaw plugins marketplace list <marketplace-name>OmeniaClaw plugins install <plugin-name>@<marketplace-name>

استخدم --marketplace عندما تريد تمرير مصدر السوق صراحةً:

OmeniaClaw plugins install <plugin-name> --marketplace <marketplace-name>OmeniaClaw plugins install <plugin-name> --marketplace <owner/repo>OmeniaClaw plugins install <plugin-name> --marketplace https://github.com/<owner>/<repo>OmeniaClaw plugins install <plugin-name> --marketplace ./my-marketplace

بالنسبة إلى المسارات والأرشيفات المحلية، يكتشف OmeniaClaw تلقائيًا:

• Plugins أصلية لـ OmeniaClaw (OmeniaClaw.plugin.json)
• حزم متوافقة مع Codex (.codex-plugin/plugin.json)
• حزم متوافقة مع Claude (.claude-plugin/plugin.json أو تخطيط مكونات Claude الافتراضي)
• حزم متوافقة مع Cursor (.cursor-plugin/plugin.json)

القائمة

OmeniaClaw plugins listOmeniaClaw plugins list --enabledOmeniaClaw plugins list --verboseOmeniaClaw plugins list --jsonOmeniaClaw plugins search <query>OmeniaClaw plugins search <query> --limit 20OmeniaClaw plugins search <query> --json

plugins search هو بحث بعيد في كتالوج ClawHub. لا يفحص الحالة المحلية، ولا يغيّر الإعدادات، ولا يثبت الحزم، ولا يحمّل كود وقت تشغيل Plugin. تتضمن نتائج البحث اسم حزمة ClawHub، والعائلة، والقناة، والإصدار، والملخص، و تلميح تثبيت مثل OmeniaClaw plugins install clawhub:<package>.

للعمل على Plugin مضمّن داخل صورة Docker معبأة، اربط دليل مصدر Plugin فوق مسار المصدر المعبأ المطابق، مثل /app/extensions/synology-chat. سيكتشف OmeniaClaw طبقة المصدر المركّبة هذه قبل /app/dist/extensions/synology-chat؛ أما دليل المصدر المنسوخ فقط فيبقى غير فعّال، بحيث تظل التثبيتات المعبأة العادية تستخدم dist المجمّع.

لتصحيح أخطاء خطافات وقت التشغيل:

• يعرض OmeniaClaw plugins inspect <id> --runtime --json الخطافات المسجلة والتشخيصات من تمريرة فحص حمّلت الوحدة. لا يثبت فحص وقت التشغيل الاعتماديات أبدًا؛ استخدم OmeniaClaw doctor --fix لتنظيف حالة الاعتماديات القديمة أو استرداد Plugins القابلة للتنزيل المفقودة المشار إليها في الإعدادات.
• يؤكد OmeniaClaw gateway status --deep --require-rpc Gateway القابل للوصول، وتلميحات الخدمة/العملية، ومسار الإعدادات، وصحة RPC.
• تتطلب خطافات المحادثة غير المضمّنة (llm_input, llm_output, before_model_resolve, before_agent_reply, before_agent_run, before_agent_finalize, agent_end) القيمة plugins.entries.<id>.hooks.allowConversationAccess=true.

استخدم --link لتجنب نسخ دليل محلي (يضيفه إلى plugins.load.paths):

OmeniaClaw plugins install -l ./my-plugin

فهرس Plugin

بيانات تعريف تثبيت Plugin هي حالة مُدارة آليًا، وليست إعدادات مستخدم. تكتبها عمليات التثبيت والتحديث إلى plugins/installs.json ضمن دليل حالة OmeniaClaw النشط. خريطة installRecords ذات المستوى الأعلى هي المصدر الدائم لبيانات تعريف التثبيت، بما في ذلك السجلات الخاصة ببيانات Plugin الظاهرة المعطوبة أو المفقودة. مصفوفة plugins هي ذاكرة التخزين المؤقت لسجل البدء البارد المشتقة من البيانات الظاهرة. يتضمن الملف تحذيرًا بعدم التحرير ويستخدمه OmeniaClaw plugins update، وإلغاء التثبيت، والتشخيصات، وسجل Plugins البارد.

عندما يرى OmeniaClaw سجلات plugins.installs القديمة المشحونة في الإعدادات، تتعامل قراءات وقت التشغيل معها كمدخلات توافق دون إعادة كتابة OmeniaClaw.json. تنقل عمليات الكتابة الصريحة لـ Plugin وOmeniaClaw doctor --fix تلك السجلات إلى فهرس Plugin وتزيل مفتاح الإعدادات عندما تكون كتابة الإعدادات مسموحة؛ إذا فشلت أي من عمليتي الكتابة، تُحفظ سجلات الإعدادات حتى لا تضيع بيانات تعريف التثبيت.

إلغاء التثبيت

OmeniaClaw plugins uninstall <id>OmeniaClaw plugins uninstall <id> --dry-runOmeniaClaw plugins uninstall <id> --keep-files

يزيل uninstall سجلات Plugin من plugins.entries، وفهرس Plugin المحفوظ، وإدخالات قوائم السماح/المنع الخاصة بـ Plugin، وإدخالات plugins.load.paths المرتبطة عند الاقتضاء. ما لم يتم ضبط --keep-files، يزيل إلغاء التثبيت أيضًا دليل التثبيت المُدار المتتبَّع عندما يكون داخل جذر امتدادات Plugin في OmeniaClaw. بالنسبة إلى Plugins الذاكرة النشطة، تُعاد خانة الذاكرة إلى memory-core.

التحديث

OmeniaClaw plugins update <id-or-npm-spec>OmeniaClaw plugins update --allOmeniaClaw plugins update <id-or-npm-spec> --dry-runOmeniaClaw plugins update @OmeniaClaw/voice-callOmeniaClaw plugins update OmeniaClaw-codex-app-server --dangerously-force-unsafe-install

تنطبق التحديثات على تثبيتات Plugin المتتبَّعة في فهرس Plugin المُدار وتثبيتات حزم الخطافات المتتبَّعة في hooks.internal.installs.

الفحص

OmeniaClaw plugins inspect <id>OmeniaClaw plugins inspect <id> --runtimeOmeniaClaw plugins inspect <id> --json

يعرض الفحص الهوية، وحالة التحميل، والمصدر، وإمكانات البيانات الظاهرة، وأعلام السياسة، والتشخيصات، وبيانات تعريف التثبيت، وإمكانات الحزمة، وأي دعم مكتشف لخوادم MCP أو LSP دون استيراد وقت تشغيل Plugin افتراضيًا. أضف --runtime لتحميل وحدة Plugin وتضمين الخطافات، والأدوات، والأوامر، والخدمات، وطرق Gateway، ومسارات HTTP المسجلة. يبلّغ فحص وقت التشغيل عن اعتماديات Plugin المفقودة مباشرةً؛ أما التثبيتات والإصلاحات فتبقى في OmeniaClaw plugins install وOmeniaClaw plugins update وOmeniaClaw doctor --fix.

عادةً ما تُثبّت أوامر CLI المملوكة للـ Plugin كمجموعات أوامر جذرية لـ OmeniaClaw، لكن يمكن للـ Plugins أيضًا تسجيل أوامر متداخلة تحت أصل أساسي مثل OmeniaClaw nodes. بعد أن يعرض inspect --runtime أمرًا ضمن cliCommands، شغّله في المسار المدرج؛ على سبيل المثال، يمكن التحقق من Plugin يسجل demo-git باستخدام OmeniaClaw demo-git ping.

يُصنّف كل Plugin حسب ما يسجله فعليًا في وقت التشغيل:

• plain-capability — نوع قدرة واحد (مثل Plugin خاص بالمزوّد فقط)
• hybrid-capability — أنواع قدرات متعددة (مثل النص + الكلام + الصور)
• hook-only — hooks فقط، بلا قدرات أو أسطح
• non-capability — أدوات/أوامر/خدمات لكن بلا قدرات

راجع أشكال Plugin لمزيد من المعلومات حول نموذج القدرات.

الفحص

OmeniaClaw plugins doctor

يُبلّغ doctor عن أخطاء تحميل Plugin، وتشخيصات البيان/الاكتشاف، وإشعارات التوافق. عندما يكون كل شيء سليمًا، يطبع No plugin issues detected.

إذا كان Plugin مكوّنًا موجودًا على القرص لكنه محظور بسبب فحوص أمان المسار الخاصة بالمحمّل، فإن التحقق من التكوين يُبقي إدخال Plugin ويُبلّغ عنه كـ present but blocked. أصلح تشخيص Plugin المحظور السابق، مثل ملكية المسار أو أذونات الكتابة للعامة، بدلًا من إزالة تكوين plugins.entries.<id> أو plugins.allow.

بالنسبة إلى حالات فشل شكل الوحدة مثل فقدان صادرات register/activate، أعد التشغيل مع OmeniaClaw_PLUGIN_LOAD_DEBUG=1 لتضمين ملخص مضغوط لشكل الصادرات في مخرجات التشخيص.

السجل

OmeniaClaw plugins registryOmeniaClaw plugins registry --refreshOmeniaClaw plugins registry --json

سجل Plugins المحلي هو نموذج القراءة الباردة المستمر في OmeniaClaw لهوية Plugins المثبتة، وتمكينها، وبيانات تعريف المصدر، وملكية المساهمات. يمكن لبدء التشغيل العادي، والبحث عن مالك المزوّد، وتصنيف إعداد القناة، وجرد Plugins قراءته من دون استيراد وحدات تشغيل Plugins.

استخدم plugins registry لفحص ما إذا كان السجل المستمر موجودًا أو حديثًا أو قديمًا. استخدم --refresh لإعادة بنائه من فهرس Plugins المستمر، وسياسة التكوين، وبيانات تعريف البيان/الحزمة. هذا مسار إصلاح، وليس مسار تفعيل وقت التشغيل.

يُصلح OmeniaClaw doctor --fix أيضًا الانحراف المُدار في npm المجاور للسجل: إذا كانت حزمة @OmeniaClaw/* يتيمة أو مستعادة ضمن جذر npm المُدار الخاص بـ Plugins تحجب Plugin مضمّنًا، يزيل doctor تلك الحزمة القديمة ويعيد بناء السجل حتى يتحقق بدء التشغيل مقابل البيان المضمّن. يعيد Doctor أيضًا ربط حزمة المضيف OmeniaClaw داخل Plugins المُدارة عبر npm التي تُعلن peerDependencies.OmeniaClaw، بحيث تُحلّ استيرادات وقت التشغيل المحلية للحزمة مثل OmeniaClaw/plugin-sdk/* بعد التحديثات أو إصلاحات npm.

السوق

OmeniaClaw plugins marketplace list <source>OmeniaClaw plugins marketplace list <source> --json

تقبل قائمة السوق مسار سوق محليًا، أو مسار marketplace.json، أو اختصار GitHub مثل owner/repo، أو عنوان URL لمستودع GitHub، أو عنوان URL لـ git. يطبع --json تسمية المصدر المحلولة إضافة إلى بيان السوق المحلل وإدخالات Plugins.

ذات صلة

• بناء Plugins
• مرجع CLI
• ClawHub