openclaw plugins
تثبيت وإدارة وتحديث إضافات OpenClaw لتوسيع القدرات.
الاستخدام الأساسي
openclaw plugins [command] [options]
الأوامر
عرض الإضافات
# عرض الإضافات المثبتة openclaw plugins list # عرض الإضافات المتاحة openclaw plugins search # البحث عن إضافة محددة openclaw plugins search mattermost # بتنسيق JSON openclaw plugins list --json
تثبيت إضافة
# تثبيت من npm openclaw plugins install @openclaw/mattermost # تثبيت إصدار محدد openclaw plugins install @openclaw/slack@1.2.3 # تثبيت من مسار محلي openclaw plugins install ./my-plugin # تثبيت من GitHub openclaw plugins install github:user/repo
إزالة إضافة
# إزالة إضافة openclaw plugins uninstall @openclaw/mattermost # إزالة مع حذف البيانات openclaw plugins uninstall @openclaw/slack --purge # إزالة جميع الإضافات غير المستخدمة openclaw plugins clean
تحديث الإضافات
# تحديث إضافة واحدة openclaw plugins update @openclaw/mattermost # تحديث جميع الإضافات openclaw plugins update --all # التحقق من التحديثات المتاحة openclaw plugins outdated
معلومات إضافة
# عرض تفاصيل إضافة openclaw plugins info @openclaw/mattermost # عرض التكوين openclaw plugins info @openclaw/mattermost --config # عرض الوثائق openclaw plugins docs @openclaw/mattermost
الخيارات
| الخيار | الوصف |
|---|---|
| --json | إخراج بتنسيق JSON |
| --all | جميع الإضافات |
| --purge | حذف البيانات عند الإزالة |
| --global | تثبيت عام (لجميع المستخدمين) |
| --save-dev | حفظ كـ development dependency |
| --force | فرض التثبيت/التحديث |
| --verbose | عرض معلومات تفصيلية |
الإضافات الرسمية
@openclaw/mattermost
دعم قناة Mattermost
openclaw plugins install @openclaw/mattermost@openclaw/whatsapp
دعم WhatsApp عبر WhatsApp Business API
openclaw plugins install @openclaw/whatsapp@openclaw/voice
مكالمات صوتية وتحويل نص لصوت
openclaw plugins install @openclaw/voice@openclaw/calendar
تكامل مع Google Calendar وOutlook
openclaw plugins install @openclaw/calendar@openclaw/email
قراءة وإرسال البريد الإلكتروني
openclaw plugins install @openclaw/email@openclaw/homekit
التحكم في أجهزة HomeKit
openclaw plugins install @openclaw/homekitأمثلة متقدمة
تثبيت عدة إضافات
# تثبيت مجموعة من الإضافات openclaw plugins install \ @openclaw/mattermost \ @openclaw/voice \ @openclaw/calendar # من ملف package.json openclaw plugins install --from-file plugins.json
تطوير إضافة مخصصة
# إنشاء إضافة جديدة openclaw plugins create my-plugin # تثبيت من مسار محلي للتطوير openclaw plugins install ./my-plugin --link # إعادة تحميل بعد التعديلات openclaw plugins reload my-plugin
تكوين الإضافات
# عرض تكوين إضافة openclaw plugins config get @openclaw/mattermost # تعديل إعداد openclaw plugins config set @openclaw/mattermost server_url "https://chat.example.com" # استيراد تكوين من ملف openclaw plugins config import @openclaw/mattermost config.json
💡 نصائح
- افحص الإضافات من مصادر موثوقة فقط
- استخدم
--verboseلتتبع التثبيت - قم بعمل نسخة احتياطية قبل تحديث الإضافات الحرجة
- راجع وثائق الإضافة قبل التثبيت
دورة حياة الإضافة
1️⃣
التثبيت
تحميل الإضافة وتثبيت التبعيات
2️⃣
التسجيل
تسجيل الإضافة في Gateway
3️⃣
التكوين
ضبط إعدادات الإضافة
4️⃣
التفعيل
تفعيل الإضافة وبدء استخدامها
5️⃣
التحديث
تحديث دوري للإصدارات الجديدة
6️⃣
الإزالة
إلغاء التثبيت وحذف البيانات
استكشاف الأخطاء
فشل التثبيت
# محاولة مع verbose openclaw plugins install @openclaw/mattermost --verbose # حذف cache ومحاولة مجدداً openclaw plugins cache clean openclaw plugins install @openclaw/mattermost # التثبيت بالقوة openclaw plugins install @openclaw/mattermost --force
الإضافة لا تعمل
# التحقق من حالة الإضافة openclaw plugins info @openclaw/mattermost # عرض السجلات openclaw logs --source plugin:mattermost # إعادة تحميل الإضافة openclaw plugins reload @openclaw/mattermost # إعادة تشغيل Gateway openclaw gateway restart
تعارض في الإصدارات
# عرض الإصدارات المتوافقة openclaw plugins check-compat @openclaw/mattermost # تثبيت إصدار محدد openclaw plugins install @openclaw/mattermost@1.2.3 # الرجوع لإصدار سابق openclaw plugins downgrade @openclaw/mattermost 1.2.0
⚠️ تحذيرات الأمان
- لا تثبت إضافات من مصادر غير معروفة
- راجع أذونات الإضافة قبل التفعيل
- قم بعمل نسخة احتياطية قبل تحديث الإضافات الحرجة
- استخدم
--verifyللتحقق من توقيع الإضافة
إنشاء إضافة مخصصة
الهيكل الأساسي لإضافة OpenClaw:
my-plugin/
├── package.json # البيانات الوصفية
├── index.js # نقطة الدخول
├── config.schema.json # مخطط التكوين
└── README.md # الوثائق
// index.js
module.exports = {
name: 'my-plugin',
version: '1.0.0',
// دالة التهيئة
async init(openclaw) {
// تسجيل الأوامر، الأدوات، إلخ
},
// دالة التنظيف
async cleanup() {
// تنظيف الموارد
}
};الأوامر ذات الصلة
openclaw config- تكوين الإضافاتopenclaw gateway restart- إعادة تحميل الإضافاتopenclaw logs- عرض سجلات الإضافات