إدارة الإضافات

تغطي واجهة التحكم سير العمل الشائع للاكتشاف والتثبيت والتمكين والتعطيل. تضيف CLI التحديث وإلغاء التثبيت والتهيئة المتقدمة وعناصر تحكم صريحة في مصدر التثبيت. للاطلاع على عقد الأوامر الكامل والخيارات وقواعد اختيار المصدر والحالات الحدّية، راجع openclaw plugins.

سير عمل CLI نموذجي: ابحث عن حزمة، وثبّتها من ClawHub أو npm أو git أو مسار محلي، ودع Gateway المُدار يُعيد التشغيل تلقائيًا (أو أعد تشغيله يدويًا)، ثم تحقق من تسجيلات وقت التشغيل الخاصة بالـ Plugin.

استخدام واجهة التحكم

افتح الإضافات في واجهة التحكم، أو استخدم /settings/plugins نسبةً إلى المسار الأساسي المُهيأ لواجهة التحكم. على سبيل المثال، يستخدم المسار الأساسي /openclaw المسار /openclaw/settings/plugins. تحتوي الصفحة على علامتي تبويب:

• تعرض المُثبّتة المخزون المحلي الكامل مجمّعًا حسب الفئة (القنوات، وموفّرو النماذج، والذاكرة، والأدوات). يفتح كل صف عرضًا تفصيليًا؛ وتتيح قائمة التجاوز (…) الخاصة به تمكين الـ Plugin أو تعطيله، كما توفر خيار إزالة للإضافات المثبّتة خارجيًا. تسرد علامة التبويب أيضًا خوادم MCP المُهيأة، مع إجراءات التمكين والتعطيل والإزالة نفسها المعتمدة على القوائم، وذلك عبر تعديل mcp.servers في تهيئة Gateway.
• تمثل الاكتشاف المتجر: الإضافات المميزة المضمّنة مع OpenClaw، والإضافات الخارجية الرسمية، ورفًا منسقًا للموصلات. تضيف بطاقات الموصلات إما خادم MCP مستضافًا بنقرة واحدة (GitHub وNotion وLinear وSentry وHome Assistant)، أو تنقلك إلى بحث مُعبّأ مسبقًا في ClawHub. تؤدي الكتابة في مربع البحث إلى الاستعلام من ClawHub ضمن الصفحة وإلحاق قسم من ClawHub يتضمن أعداد التنزيل وشارات التحقق من المصدر.

لا تحتاج الإضافات المضمّنة إلى تثبيت حزمة. يكون إجراء القائمة الخاص بها تمكين أو تعطيل. على سبيل المثال، يأتي Workboard مضمنًا مع OpenClaw ويكون معطّلًا افتراضيًا، لذا اختر تمكين لتشغيله. لا يمكن إزالة الإضافات المجمّعة، بل يمكن تعطيلها فقط.

يتطلب الوصول إلى الكتالوج والبحث operator.read. ويتطلب التثبيت والتمكين والتعطيل والإزالة وتغييرات خادم MCP الصلاحية operator.admin. ينفّذ Gateway عملية تثبيت من ClawHub مع الحفاظ على فحوصات سياسة الثقة والتكامل وتثبيت الإضافات.

يتطلب تثبيت شيفرة Plugin أو إزالتها إعادة تشغيل Gateway. يمكن تطبيق تغييرات التمكين دون إعادة تشغيل عندما يدعم ذلك كل من الـ Plugin المثبّت ووقت تشغيل Gateway الحالي؛ وإلا فستخبرك الواجهة بأن إعادة التشغيل مطلوبة. لا تزال موصلات MCP المدعومة بـ OAuth تحتاج إلى تنفيذ openclaw mcp login <name> مرة واحدة من CLI بعد إضافتها.

لا تثبّت واجهة التحكم من مصادر npm أو git أو المسارات المحلية الاعتباطية، ولا تحدّث الإضافات، ولا تعرض تهيئة غنية للـ Plugin. استخدم مسارات عمل CLI أدناه لهذه العمليات.

سرد الإضافات والبحث عنها

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 اكتشافه من التهيئة والبيانات الوصفية وسجل الإضافات المحفوظ. ولا يثبت أن Gateway قيد التشغيل بالفعل قد استورد وقت تشغيل الـ Plugin. يتضمن إخراج JSON تشخيصات السجل وحالة dependencyStatus لكل Plugin (أي ما إذا كانت dependencies/optionalDependencies المعلنة قابلة للحل على القرص).

يستعلم plugins search من ClawHub عن حزم Plugin القابلة للتثبيت ويطبع تلميح تثبيت (openclaw plugins install clawhub:<package>) لكل نتيجة.

تمكين الإضافات وتعطيلها

openclaw plugins enable <plugin-id>openclaw plugins disable <plugin-id>

يبدّل إدخال تهيئة Plugin دون المساس بالملفات المثبّتة. تكون بعض الإضافات المجمّعة (موفّرو النماذج/الكلام المجمّعون، وPlugin المتصفح المجمّع) مُمكّنة افتراضيًا؛ وتتطلب إضافات أخرى تنفيذ enable بعد التثبيت.

تثبيت الإضافات

# Search ClawHub for plugin packages.openclaw plugins search "calendar" # Install from ClawHub.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # Install from npm.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/openclaw-plugin@1.2.3openclaw plugins install npm:@openclaw/codex # Install from a local npm-pack artifact.openclaw plugins install npm-pack:<path.tgz> # Install from git or a local development checkout.openclaw plugins install git:github.com/acme/openclaw-plugin@v1.0.0openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

تُثبّت مواصفات الحزم المجرّدة من npm أثناء الانتقال عند الإطلاق، ما لم يطابق الاسم معرّف Plugin مجمّعًا أو رسميًا، وفي هذه الحالة يستخدم OpenClaw النسخة المحلية/الرسمية بدلًا منه. استخدم clawhub: أو npm: أو git: أو npm-pack: لاختيار مصدر حتمي.

استخدم --force فقط لاستبدال هدف تثبيت موجود من مصدر مختلف. للترقيات الاعتيادية لتثبيت npm أو ClawHub أو hook-pack متتبَّع، استخدم openclaw plugins update بدلًا من ذلك؛ لا يُدعم --force مع --link.

إعادة التشغيل والفحص

يُعاد تشغيل Gateway مُدار وقيد التشغيل، مع تمكين إعادة تحميل التهيئة، تلقائيًا بعد تثبيت شيفرة Plugin أو تحديثها أو إلغاء تثبيتها. إذا كان Gateway غير مُدار أو كانت إعادة التحميل معطّلة، فأعد تشغيله بنفسك قبل فحص أسطح وقت التشغيل الحية:

openclaw gateway restartopenclaw plugins inspect <plugin-id> --runtime --json

يحمّل inspect --runtime وحدة الـ Plugin ويثبت أنها سجّلت أسطح وقت التشغيل (الأدوات، والخطافات، والخدمات، وطرائق Gateway، ومسارات HTTP، وأوامر CLI المملوكة للـ Plugin). أما inspect العادي وlist فهما مجرد فحوصات ساكنة للبيان/التهيئة/السجل.

تحديث الإضافات

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 مسار الصيانة الجماعية. ولا يزال يحترم مواصفات التثبيت المتتبَّعة الاعتيادية، لكن سجلات إضافات OpenClaw الرسمية الموثوقة تتزامن مع هدف الكتالوج الرسمي الحالي بدلًا من البقاء مثبّتة على حزمة رسمية قديمة ذات إصدار دقيق؛ وعندما تكون update.channel بالقيمة beta، تفضّل هذه المزامنة مسار إصدار بيتا. استخدم update <plugin-id> مستهدفًا للإبقاء على مواصفة رسمية دقيقة أو موسومة دون تغيير.

بالنسبة إلى عمليات تثبيت npm، مرّر مواصفة حزمة صريحة لتبديل السجل المتتبَّع:

openclaw plugins update @scope/openclaw-plugin@betaopenclaw plugins update @scope/openclaw-plugin

يعيد الأمر الثاني Plugin إلى مسار الإصدار الافتراضي للسجل عندما يكون قد ثُبّت سابقًا على إصدار دقيق أو وسم.

راجع openclaw plugins للاطلاع على قواعد الرجوع الاحتياطي والتثبيت الدقيقة.

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

openclaw plugins uninstall <plugin-id> --dry-runopenclaw plugins uninstall <plugin-id>openclaw plugins uninstall <plugin-id> --keep-files

يزيل إلغاء التثبيت إدخال تهيئة الـ Plugin، وسجل فهرس الإضافات المحفوظ، وإدخالات قوائم السماح/المنع، وإدخالات plugins.load.paths المرتبطة عند الانطباق. ويُزال دليل التثبيت المُدار ما لم تمرّر --keep-files. يُعاد تشغيل Gateway مُدار وقيد التشغيل تلقائيًا عندما يغيّر إلغاء التثبيت مصدر الـ Plugin.

في وضع Nix ‏(OPENCLAW_NIX_MODE=1)، تكون عمليات تثبيت الإضافات وتحديثها وإلغاء تثبيتها وتمكينها وتعطيلها كلها معطّلة؛ أدِر هذه الخيارات في مصدر Nix الخاص بالتثبيت بدلًا من ذلك.

اختيار مصدر

يجب أن تكون عمليات التثبيت المُدارة من مسار محلي أدلة Plugin أو أرشيفات. ضع ملفات Plugin المستقلة في plugins.load.paths بدلًا من تثبيتها باستخدام plugins install.

نشر الإضافات

يمثل ClawHub سطح الاكتشاف العام الأساسي لإضافات 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/your-plugin@v1.0.0

يجب أن تتضمن إضافات 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/openclaw-plugin@1.0.0

استخدم هذه الصفحات للاطلاع على عقد النشر الكامل بدلًا من التعامل مع هذه الصفحة على أنها مرجع النشر:

• يشرح النشر في ClawHub المالكين والنطاقات والإصدارات والمراجعة والتحقق من الحزم ونقل الحزم.
• تعرض بناء الإضافات الشكل الكامل لحزمة Plugin (بما في ذلك openclaw.plugin.json) وسير عمل النشر الأول.
• يعرّف بيان الـ Plugin حقول بيان الـ Plugin الأصلي.

إذا كانت الحزمة نفسها متاحة على كل من ClawHub وnpm، فاستخدم البادئة الصريحة clawhub: أو npm: لفرض مصدر واحد.

ذو صلة

• الإضافات - التثبيت والتهيئة وإعادة التشغيل واستكشاف الأخطاء وإصلاحها
• openclaw plugins - مرجع CLI الكامل
• إضافات المجتمع - الاكتشاف العام والنشر في ClawHub
• ClawHub - عمليات CLI الخاصة بالسجل
• بناء الإضافات - إنشاء حزمة Plugin
• بيان الـ Plugin - البيان والبيانات الوصفية للحزمة