Plugins
إدارة الإضافات
تغطي واجهة التحكم سير العمل الشائع للاكتشاف والتثبيت والتمكين والتعطيل.
وتضيف CLI التحديث وإلغاء التثبيت والإعداد المتقدم وعناصر التحكم الصريحة
في مصدر التثبيت. للاطلاع على عقد الأوامر الكامل والعلامات وقواعد اختيار المصدر
والحالات الحدّية، راجع openclaw plugins.
سير عمل CLI نموذجي: ابحث عن حزمة، وثبّتها من ClawHub أو npm أو git أو مسار محلي، ودع Gateway المُدار يُعاد تشغيله تلقائيًا (أو أعد تشغيله يدويًا)، ثم تحقق من تسجيلات وقت التشغيل الخاصة بالـ Plugin.
استخدام واجهة التحكم
افتح Plugins في واجهة التحكم، أو استخدم /settings/plugins نسبةً إلى
المسار الأساسي المُعدّ لواجهة التحكم. على سبيل المثال، يستخدم المسار الأساسي /openclaw
المسار /openclaw/settings/plugins. تحتوي الصفحة على علامتي تبويب:
- المثبّتة تعرض المخزون المحلي الكامل مجمّعًا حسب الفئة (القنوات،
وموفّرو النماذج، والذاكرة، والأدوات). يفتح كل صف عرضًا تفصيليًا؛ وتتيح قائمة
التجاوز (
…) الخاصة به تمكين الـ Plugin أو تعطيله، كما توفر الإزالة للـ Plugins المثبّتة خارجيًا. وتعرض علامة التبويب أيضًا خوادم MCP المُعدّة، مع إجراءات التمكين والتعطيل والإزالة نفسها المستندة إلى القوائم، وذلك بتحريرmcp.serversفي إعدادات Gateway. - الاكتشاف هو المتجر: Plugins مميزة مضمنة مع OpenClaw، وPlugins خارجية رسمية، ورفّ منتقى من الموصلات. إما أن تضيف بطاقات الموصلات خادم MCP مستضافًا بنقرة واحدة (GitHub وNotion وLinear وSentry وHome Assistant)، أو تنتقل إلى بحث ClawHub مُعبّأ مسبقًا. تؤدي الكتابة في مربع البحث إلى الاستعلام من ClawHub ضمن الصفحة وإلحاق قسم من ClawHub يتضمن أعداد التنزيل وشارات التحقق من المصدر.
لا تحتاج الـ Plugins المضمنة إلى تثبيت حزمة. إجراء القائمة الخاص بها هو التمكين أو التعطيل. على سبيل المثال، يأتي Workboard مضمنًا مع OpenClaw ومعطّلًا افتراضيًا، لذا اختر التمكين لتشغيله. لا يمكن إزالة الـ Plugins المجمّعة، بل يمكن تعطيلها فقط.
يتطلب الوصول إلى الكتالوج والبحث operator.read. وتتطلب تغييرات التثبيت والتمكين والتعطيل
والإزالة وخادم MCP الصلاحية operator.admin. ينفّذ Gateway عملية تثبيت ClawHub
مع الحفاظ على فحوصات الثقة والتكامل وسياسة تثبيت الـ Plugins.
كما أن تمكين Plugin مثبّت بصفة مسؤول يسجّل تلك الثقة الصريحة
بإضافة الـ Plugin المحدد إلى قائمة plugins.allow تقييدية موجودة.
ويظل إدخال plugins.deny الصريح هو المرجع الحاكم، ويجب
إزالته قبل تمكين الـ Plugin.
يتطلب تثبيت شيفرة Plugin أو إزالتها إعادة تشغيل Gateway. ويمكن تطبيق تغييرات
التمكين دون إعادة تشغيل عندما يدعم ذلك كل من الـ Plugin المثبّت ووقت تشغيل
Gateway الحالي؛ وإلا فستخبرك الواجهة بأن إعادة التشغيل مطلوبة.
وتظل موصلات MCP المدعومة بـ OAuth بحاجة إلى تنفيذ openclaw mcp login <name>
مرة واحدة من CLI بعد إضافتها.
لا تثبّت واجهة التحكم من مصادر npm أو git أو المسارات المحلية العشوائية، ولا تحدّث الـ Plugins، ولا تعرض إعدادات Plugin الغنية. استخدم مسارات عمل CLI أدناه لهذه العمليات.
عرض الـ Plugins والبحث عنها
openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --jsonopenclaw plugins search "calendar"--json للبرامج النصية:
openclaw plugins list --json \ | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'يمثل plugins list فحصًا ساكنًا للمخزون: ما يستطيع OpenClaw اكتشافه من
الإعدادات والبيانات الوصفية وسجل الـ Plugins الدائم. ولا يثبت أن
Gateway قيد التشغيل قد استورد وقت تشغيل الـ Plugin. يتضمن إخراج JSON
تشخيصات السجل وقيمة dependencyStatus لكل Plugin (أي ما إذا كانت
dependencies/optionalDependencies المعلنة قابلة للحل على القرص).
يستعلم plugins search من ClawHub عن حزم Plugins القابلة للتثبيت، ويطبع
تلميح تثبيت (openclaw plugins install clawhub:<package>) لكل نتيجة.
تمكين الـ Plugins وتعطيلها
openclaw plugins enable <plugin-id>openclaw plugins disable <plugin-id>يبدّل إدخال إعدادات Plugin دون المساس بالملفات المثبّتة. تكون بعض
الـ Plugins المجمّعة (موفّرو النماذج/الكلام المجمّعون، وPlugin المتصفح المجمّع)
ممكّنة افتراضيًا؛ بينما تتطلب أخرى enable بعد التثبيت.
تثبيت الـ Plugins
# ابحث في ClawHub عن حزم Plugins.openclaw plugins search "calendar" # ثبّت من ClawHub.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # ثبّت من npm.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/[email protected]openclaw plugins install npm:@openclaw/codex # ثبّت من عنصر npm-pack محلي.openclaw plugins install npm-pack:<path.tgz> # ثبّت من git أو نسخة تطوير محلية.openclaw plugins install git:github.com/acme/[email protected]openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-pluginتُثبّت مواصفات الحزم المجردة من npm خلال انتقال الإطلاق، إلا إذا كان
الاسم يطابق معرّف Plugin مجمّع أو رسمي، وعندئذٍ يستخدم OpenClaw
النسخة المحلية/الرسمية بدلًا منه. استخدم clawhub: أو npm: أو git: أو
npm-pack: لاختيار المصدر بصورة حتمية. تُعد حزم كتالوج OpenClaw المجمّعة والرسمية
موثوقة إلى جانب حزم ClawHub. وتتطلب مصادر npm العشوائية الجديدة
أو git أو المسار/الأرشيف المحلي أو npm-pack: أو السوق
الخيار --force في عمليات التثبيت غير التفاعلية، بعد مراجعة
المصدر والثقة به.
يؤكد --force مصدرًا غير تابع لـ ClawHub دون مطالبة، ويستبدل
هدف تثبيت موجودًا عند الحاجة. وللترقيات الروتينية لتثبيت npm
أو ClawHub أو hook-pack متعقّب، استخدم openclaw plugins update بدلًا منه. مع
--link، لا يفعل --force سوى تأكيد المصدر؛ ولا يُنسخ المجلد المرتبط
ولا يُستبدل.
إعادة التشغيل والفحص
يُعاد تشغيل Gateway مُدار قيد التشغيل ومفعّل فيه إعادة تحميل الإعدادات تلقائيًا بعد تثبيت شيفرة Plugin أو تحديثها أو إلغاء تثبيتها. إذا كان Gateway غير مُدار أو كانت إعادة التحميل معطّلة، فأعد تشغيله بنفسك قبل فحص أسطح وقت التشغيل الحية:
openclaw gateway restartopenclaw plugins inspect <plugin-id> --runtime --jsonيحمّل inspect --runtime وحدة الـ Plugin ويثبت أنها سجّلت أسطح وقت التشغيل
(الأدوات، والخطافات، والخدمات، وطرائق Gateway، ومسارات HTTP، وأوامر
CLI المملوكة للـ Plugin). أما inspect وlist العاديان فهما فحوصات
ساكنة للبيانات الوصفية/الإعدادات/السجل فقط.
تحديث الـ Plugins
openclaw plugins update <plugin-id>openclaw plugins update <npm-package-or-spec>openclaw plugins update --allopenclaw plugins update <plugin-id> --dry-runتؤدي تمرير معرّف Plugin إلى إعادة استخدام مواصفة التثبيت المتعقّبة الخاصة به:
تُرحّل وسوم التوزيع المخزّنة (@beta) والإصدارات الدقيقة المثبّتة إلى عمليات
update <plugin-id> اللاحقة.
يمثل openclaw plugins update --all مسار الصيانة المجمّعة. ولا يزال
يحترم مواصفات التثبيت المتعقّبة العادية، لكن سجلات Plugins الرسمية الموثوقة من OpenClaw
تتزامن مع هدف الكتالوج الرسمي الحالي بدلًا من
البقاء مثبّتة على حزمة رسمية دقيقة قديمة؛ وعندما تكون update.channel
هي beta، تفضّل هذه المزامنة مسار إصدار beta. استخدم
update <plugin-id> موجّهًا للإبقاء على مواصفة رسمية دقيقة أو موسومة دون تغيير.
بالنسبة إلى عمليات تثبيت npm، مرّر مواصفة حزمة صريحة لتغيير السجل المتعقّب:
openclaw plugins update @scope/openclaw-plugin@betaopenclaw plugins update @scope/openclaw-pluginيعيد الأمر الثاني Plugin إلى مسار الإصدار الافتراضي للسجل عندما يكون قد ثُبّت سابقًا على إصدار أو وسم دقيق.
راجع openclaw plugins للاطلاع على قواعد الرجوع
والتثبيت الدقيقة.
إلغاء تثبيت الـ Plugins
openclaw plugins uninstall <plugin-id> --dry-runopenclaw plugins uninstall <plugin-id>openclaw plugins uninstall <plugin-id> --keep-filesيؤدي إلغاء التثبيت إلى إزالة إدخال إعدادات الـ Plugin، وسجل فهرس الـ Plugin الدائم،
وإدخالات قائمة السماح/الرفض، وإدخالات plugins.load.paths المرتبطة عند
انطباق ذلك. ويُزال دليل التثبيت المُدار ما لم تمرّر
--keep-files. ويُعاد تشغيل Gateway مُدار قيد التشغيل تلقائيًا عندما
يغيّر إلغاء التثبيت مصدر الـ Plugin.
في وضع Nix (OPENCLAW_NIX_MODE=1)، تكون عمليات تثبيت الـ Plugin وتحديثه وإلغاء تثبيته
وتمكينه وتعطيله كلها معطّلة؛ أدِر هذه الخيارات في مصدر Nix
الخاص بالتثبيت بدلًا من ذلك.
اختيار مصدر
| المصدر | استخدمه عندما | مثال |
|---|---|---|
| ClawHub | تريد اكتشافًا أصيلًا في OpenClaw وملخصات الفحص والإصدارات والتلميحات | openclaw plugins install clawhub:<package> |
| git | تريد فرعًا أو وسمًا أو التزامًا من مستودع | openclaw plugins install git:github.com/<owner>/<repo>@<ref> |
| مسار محلي | تطوّر Plugin أو تختبره على الجهاز نفسه | openclaw plugins install --link ./my-plugin |
| السوق | تثبّت Plugin سوق متوافقًا مع Claude | openclaw plugins install <plugin> --marketplace <source> |
| npm pack | تتحقق من عنصر حزمة محلي عبر دلالات تثبيت npm | openclaw plugins install npm-pack:<path.tgz> |
| npmjs.com | تنشر حزم JavaScript بالفعل أو تحتاج إلى وسوم توزيع npm/سجل خاص | openclaw plugins install npm:@acme/openclaw-plugin |
يجب أن تكون عمليات تثبيت المسارات المحلية المُدارة أدلة Plugins أو أرشيفات. ضع
ملفات Plugin المستقلة في plugins.load.paths بدلًا من تثبيتها
باستخدام plugins install.
نشر الـ Plugins
يمثل ClawHub سطح الاكتشاف العام الأساسي لـ Plugins الخاصة بـ OpenClaw. انشر هناك عندما تريد أن يعثر المستخدمون على البيانات الوصفية للـ Plugin، وسجل الإصدارات، ونتائج فحص السجل، وتلميحات التثبيت قبل أن يثبّتوه.
npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/[email protected]يجب أن تتضمن Plugins الأصلية لـ npm بيان Plugin (openclaw.plugin.json) بالإضافة إلى
بيانات package.json الوصفية قبل النشر:
{ "name": "@acme/openclaw-plugin", "version": "1.0.0", "type": "module", "openclaw": { "extensions": ["./dist/index.js"] }}npm publish --access publicopenclaw plugins install npm:@acme/openclaw-pluginopenclaw plugins install npm:@acme/openclaw-plugin@betaopenclaw plugins install npm:@acme/[email protected]استخدم هذه الصفحات للاطلاع على عقد النشر الكامل بدلًا من اعتبار هذه الصفحة مرجع النشر:
- النشر على ClawHub يشرح المالكين والنطاقات والإصدارات والمراجعة والتحقق من صحة الحزمة ونقل الحزمة.
- إنشاء الـ Plugins يعرض بنية حزمة الـ Plugin
الكاملة (بما في ذلك
openclaw.plugin.json) وسير عمل النشر الأول. - بيان الـ Plugin يعرّف حقول بيان الـ Plugin الأصلي.
إذا كانت الحزمة نفسها متاحة على كل من ClawHub وnpm، فاستخدم البادئة الصريحة
clawhub: أو npm: لفرض مصدر واحد.
ذو صلة
- الـ Plugins - التثبيت والإعداد وإعادة التشغيل واستكشاف الأخطاء وإصلاحها
openclaw plugins- مرجع CLI الكامل- Plugins المجتمع - الاكتشاف العام والنشر على ClawHub
- ClawHub - عمليات CLI الخاصة بالسجل
- إنشاء الـ Plugins - إنشاء حزمة Plugin
- بيان الـ Plugin - البيان والبيانات الوصفية للحزمة
