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 - عرض سجلات الإضافات