إدارة plugins

استخدم هذه الصفحة لأوامر إدارة Plugin الشائعة. للاطلاع على عقد الأمر الكامل، والرايات، وقواعد اختيار المصدر، والحالات الطرفية، راجع openclaw plugins.

معظم مسارات عمل التثبيت تكون كالتالي:

1. العثور على حزمة
2. تثبيتها من ClawHub، أو npm، أو git، أو مسار محلي
3. السماح لـ Gateway المُدار بإعادة التشغيل تلقائيًا، أو إعادة تشغيله يدويًا عندما لا يكون مُدارًا
4. التحقق من تسجيلات وقت تشغيل Plugin

سرد 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 عندما تعلن حزمة Plugin عن dependencies أو optionalDependencies.

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

تثبيت Plugins

# 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 أثناء انتقال الإطلاق. استخدم clawhub: أو npm: أو git: أو npm-pack: عندما تحتاج إلى اختيار مصدر حتمي. إذا كان الاسم العاري يطابق معرّف Plugin رسميًا، يستطيع OpenClaw تثبيت إدخال الفهرس مباشرة.

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

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

بعد تثبيت أو تحديث أو إلغاء تثبيت كود Plugin، يعيد Gateway المُدار قيد التشغيل مع تمكين إعادة تحميل الإعدادات تشغيل نفسه تلقائيًا. إذا لم يكن 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، يعيد OpenClaw استخدام مواصفة التثبيت المتتبعة. تظل وسوم التوزيع المخزنة مثل @beta والإصدارات الدقيقة المثبتة مستخدمة في تشغيلات update <plugin-id> اللاحقة.

openclaw plugins update --all هو مسار الصيانة المجمّعة. لا يزال يحترم مواصفات التثبيت المتتبعة العادية، لكن سجلات Plugin الرسمية الموثوقة الخاصة بـ OpenClaw يمكن أن تتزامن مع هدف الفهرس الرسمي الحالي بدل البقاء على حزمة رسمية دقيقة قديمة. إذا تم ضبط update.channel على beta، فستستخدم المزامنة الرسمية المجمّعة هذه سياق قناة beta. استخدم update <plugin-id> المستهدف عندما تريد عن قصد إبقاء مواصفة رسمية دقيقة أو موسومة دون تغيير.

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

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

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

عندما يعمل openclaw update على قناة beta، يمكن لسجلات Plugin تفضيل إصدارات @beta المطابقة. للاطلاع على قواعد الرجوع والتثبيت الدقيقة، راجع openclaw plugins.

إلغاء تثبيت Plugins

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

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

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

اختيار مصدر

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

نشر Plugins

ClawHub هو سطح الاكتشاف العام الأساسي لـ OpenClaw Plugins. انشر هناك عندما تريد أن يعثر المستخدمون على بيانات 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

يجب أن تتضمن Plugins الأصلية في npm ملف بيان Plugin وبيانات وصفية للحزمة قبل النشر:

{  "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 المالكين، والنطاقات، والإصدارات، والمراجعة، والتحقق من الحزمة، ونقل الحزمة.
• تعرض بناء Plugins شكل حزمة Plugin ومسار عمل النشر الأول.
• يعرّف ملف بيان Plugin حقول ملف بيان Plugin الأصلية.

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

ذات صلة

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