الانتقال إلى المحتوى الرئيسي

​
openclaw plugins

إدارة إضافات/امتدادات Gateway (تُحمَّل داخل العملية). ذو صلة:

​
الأوامر

openclaw plugins list
openclaw plugins info <id>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins doctor
openclaw plugins update <id>
openclaw plugins update --all
تأتي الإضافات المضمّنة مع OpenClaw لكنها تبدأ معطّلة. استخدم plugins enable لـ تفعيلها. يجب على جميع الإضافات تضمين ملف openclaw.plugin.json مع مخطط JSON مضمن (configSchema، حتى لو كان فارغًا). تؤدي البيانات الوصفية أو المخططات المفقودة/غير الصالحة إلى منع تحميل الإضافة وفشل التحقق من التهيئة.

​
التثبيت

openclaw plugins install <path-or-spec>
ملاحظة أمنية: تعامل مع تثبيت الإضافات كما لو كنت تُشغّل شيفرة. يُفضَّل استخدام إصدارات مُثبّتة. مواصفات Npm هي registry-only (اسم الحزمة + إصدار/وسم اختياري). يتم رفض مواصفات Git/URL/file. يتم تثبيت الاعتماديات باستخدام --ignore-scripts لأسباب تتعلق بالأمان. الأرشيفات المدعومة: .zip، .tgz، .tar.gz، .tar. استخدم --link لتجنّب نسخ دليل محلي (يُضاف إلى plugins.load.paths): 
openclaw plugins install -l ./my-plugin

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

openclaw plugins uninstall <id>
openclaw plugins uninstall <id> --dry-run
openclaw plugins uninstall <id> --keep-files
يقوم uninstall بإزالة سجلات الإضافة من plugins.entries وplugins.installs، وقائمة السماح الخاصة بالإضافة، وإدخالات plugins.load.paths المرتبطة عند الاقتضاء. بالنسبة لإضافات الذاكرة النشطة، تتم إعادة تعيين فتحة الذاكرة إلى memory-core. افتراضيًا، يؤدي إلغاء التثبيت أيضًا إلى إزالة دليل تثبيت الإضافة ضمن جذر امتدادات دليل الحالة النشط ($OPENCLAW_STATE_DIR/extensions/<id>). استخدم --keep-files للاحتفاظ بالملفات على القرص. --keep-config مدعوم كاسم بديل مهمل لـ --keep-files.

​
التحديث

openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins update <id> --dry-run
تنطبق التحديثات فقط على الإضافات المُثبّتة من npm (المتتبَّعة في plugins.installs).