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

​
Plugins

توسّع Plugins إمكانات OpenClaw بقدرات جديدة: القنوات، وموفري النماذج، والأدوات، وSkills، والكلام، والنسخ الفوري، والصوت الفوري، وفهم الوسائط، وتوليد الصور، وتوليد الفيديو، وجلب الويب، والبحث على الويب، وغير ذلك. بعض plugins تكون أساسية (تأتي مع OpenClaw)، وأخرى خارجية (ينشرها المجتمع على npm).

​
بدء سريع

1

اطلع على ما تم تحميله

openclaw plugins list
2

ثبّت plugin

# من npm
openclaw plugins install @openclaw/voice-call

# من دليل محلي أو أرشيف
openclaw plugins install ./my-plugin
openclaw plugins install ./my-plugin.tgz
3

أعد تشغيل Gateway

openclaw gateway restart
ثم قم بالتهيئة ضمن plugins.entries.\<id\>.config في ملف التهيئة الخاص بك.
إذا كنت تفضّل التحكم مباشرة من الدردشة، فعِّل commands.plugins: true واستخدم: 
/plugin install clawhub:@openclaw/voice-call
/plugin show voice-call
/plugin enable voice-call
يستخدم مسار التثبيت نفس محلّل CLI: مسار/أرشيف محلي، أو clawhub:<pkg> صريح، أو مواصفة حزمة مجردة (ClawHub أولًا، ثم fallback إلى npm). إذا كانت التهيئة غير صالحة، يفشل التثبيت عادةً بشكل مغلق ويوجهك إلى openclaw doctor --fix. والاستثناء الوحيد للاسترداد هو مسار ضيق لإعادة تثبيت plugin مضمّن لـ plugins التي تختار الاشتراك في openclaw.install.allowInvalidConfigRecovery.

​
أنواع plugins

يتعرف OpenClaw على تنسيقين من plugins:
التنسيقكيف يعملأمثلة
Nativeopenclaw.plugin.json + وحدة runtime؛ يُنفّذ داخل العمليةplugins الرسمية، وحزم npm المجتمعية
Bundleتخطيط متوافق مع Codex/Claude/Cursor؛ يُربط بميزات OpenClaw.codex-plugin/، .claude-plugin/، .cursor-plugin/
يظهر كلاهما ضمن openclaw plugins list. راجع Plugin Bundles لمعرفة تفاصيل الحزم. إذا كنت تكتب plugin native، فابدأ من بناء Plugins ونظرة عامة على Plugin SDK.

​
plugins الرسمية

​
قابلة للتثبيت (npm)

Pluginالحزمةالوثائق
Matrix@openclaw/matrixMatrix
Microsoft Teams@openclaw/msteamsMicrosoft Teams
Nostr@openclaw/nostrNostr
Voice Call@openclaw/voice-callVoice Call
Zalo@openclaw/zaloZalo
Zalo Personal@openclaw/zalouserZalo Personal

​
أساسية (تأتي مع OpenClaw)

anthropic وbyteplus وcloudflare-ai-gateway وgithub-copilot وgoogle، وhuggingface وkilocode وkimi-coding وminimax وmistral وqwen، وmoonshot وnvidia وopenai وopencode وopencode-go وopenrouter، وqianfan وsynthetic وtogether وvenice، وvercel-ai-gateway وvolcengine وxiaomi وzai
  • memory-core — بحث الذاكرة المضمّن (الافتراضي عبر plugins.slots.memory)
  • memory-lancedb — ذاكرة طويلة المدى تُثبَّت عند الطلب مع auto-recall/capture (عيّن plugins.slots.memory = "memory-lancedb")
elevenlabs وmicrosoft
  • browser — plugin متصفح مضمّنة لأداة المتصفح، وCLI ‏openclaw browser، وطريقة gateway ‏browser.request، وruntime المتصفح، وخدمة التحكم الافتراضية في المتصفح (مفعّلة افتراضيًا؛ عطّلها قبل استبدالها)
  • copilot-proxy — جسر VS Code Copilot Proxy ‏(معطّل افتراضيًا)
هل تبحث عن plugins من جهات خارجية؟ راجع Community Plugins.

​
التهيئة

{
  plugins: {
    enabled: true,
    allow: ["voice-call"],
    deny: ["untrusted-plugin"],
    load: { paths: ["~/Projects/oss/voice-call-extension"] },
    entries: {
      "voice-call": { enabled: true, config: { provider: "twilio" } },
    },
  },
}
الحقلالوصف
enabledمفتاح تشغيل رئيسي (الافتراضي: true)
allowallowlist لـ plugins (اختياري)
denydenylist لـ plugins (اختياري؛ deny له الأولوية)
load.pathsملفات/أدلة plugins إضافية
slotsمحددات خانات حصرية (مثل memory وcontextEngine)
entries.\<id\>مفاتيح التشغيل + التهيئة لكل plugin
تتطلب تغييرات التهيئة إعادة تشغيل gateway. إذا كان Gateway يعمل مع مراقبة التهيئة + إعادة تشغيل داخل العملية مفعّلة (وهو المسار الافتراضي لـ openclaw gateway)، فعادةً ما يتم تنفيذ إعادة التشغيل هذه تلقائيًا بعد لحظات من وصول كتابة التهيئة.
  • معطّلة: plugin موجودة لكن قواعد التمكين عطّلتها. يتم الاحتفاظ بالتهيئة.
  • مفقودة: تشير التهيئة إلى معرّف plugin لم يعثر عليه الاكتشاف.
  • غير صالحة: plugin موجودة لكن تهيئتها لا تطابق المخطط المعلن.

​
الاكتشاف والأولوية

يفحص OpenClaw plugins بهذا الترتيب (أول تطابق يفوز):
1

مسارات التهيئة

plugins.load.paths — مسارات ملفات أو أدلة صريحة.
2

امتدادات مساحة العمل

\<workspace\>/.openclaw/<plugin-root>/*.ts و \<workspace\>/.openclaw/<plugin-root>/*/index.ts.
3

الامتدادات العامة

~/.openclaw/<plugin-root>/*.ts و ~/.openclaw/<plugin-root>/*/index.ts.
4

Plugins المضمّنة

تأتي مع OpenClaw. كثير منها مفعّل افتراضيًا (موفرو النماذج، والكلام). ويتطلب بعضها الآخر تمكينًا صريحًا.

​
قواعد التمكين

  • يؤدي plugins.enabled: false إلى تعطيل جميع plugins
  • يتغلب plugins.deny دائمًا على allow
  • يؤدي plugins.entries.\<id\>.enabled: false إلى تعطيل تلك plugin
  • plugins ذات المصدر من مساحة العمل تكون معطّلة افتراضيًا (ويجب تمكينها صراحةً)
  • تتبع plugins المضمّنة مجموعة التفعيل الافتراضية المدمجة ما لم يتم تجاوزها
  • يمكن للخانات الحصرية فرض تمكين plugin المحددة لتلك الخانة

​
خانات plugin (فئات حصرية)

بعض الفئات حصرية (واحدة فقط تكون نشطة في كل مرة): 
{
  plugins: {
    slots: {
      memory: "memory-core", // أو "none" للتعطيل
      contextEngine: "legacy", // أو معرّف plugin
    },
  },
}
الخانةما الذي تتحكم فيهالافتراضي
memoryplugin الذاكرة النشطةmemory-core
contextEngineمحرك السياق النشطlegacy (مضمّن)

​
مرجع CLI

openclaw plugins list                       # جرد مضغوط
openclaw plugins list --enabled            # plugins المحمّلة فقط
openclaw plugins list --verbose            # أسطر تفاصيل لكل plugin
openclaw plugins list --json               # جرد قابل للقراءة الآلية
openclaw plugins inspect <id>              # تفاصيل عميقة
openclaw plugins inspect <id> --json       # قابل للقراءة الآلية
openclaw plugins inspect --all             # جدول على مستوى المجموعة
openclaw plugins info <id>                 # اسم بديل لـ inspect
openclaw plugins doctor                    # تشخيصات

openclaw plugins install <package>         # تثبيت (ClawHub أولًا، ثم npm)
openclaw plugins install clawhub:<pkg>     # تثبيت من ClawHub فقط
openclaw plugins install <spec> --force    # الكتابة فوق تثبيت موجود
openclaw plugins install <path>            # تثبيت من مسار محلي
openclaw plugins install -l <path>         # ربط (من دون نسخ) للتطوير
openclaw plugins install <plugin> --marketplace <source>
openclaw plugins install <plugin> --marketplace https://github.com/<owner>/<repo>
openclaw plugins install <spec> --pin      # تسجيل مواصفة npm الدقيقة المحلولة
openclaw plugins install <spec> --dangerously-force-unsafe-install
openclaw plugins update <id>             # تحديث plugin واحدة
openclaw plugins update <id> --dangerously-force-unsafe-install
openclaw plugins update --all            # تحديث الجميع
openclaw plugins uninstall <id>          # إزالة سجلات التهيئة/التثبيت
openclaw plugins uninstall <id> --keep-files
openclaw plugins marketplace list <source>
openclaw plugins marketplace list <source> --json

openclaw plugins enable <id>
openclaw plugins disable <id>
تأتي plugins المضمّنة مع OpenClaw. وكثير منها مفعّل افتراضيًا (مثل موفري النماذج المضمّنين، وموفري الكلام المضمّنين، وplugin المتصفح المضمّنة). بينما لا تزال plugins المضمّنة الأخرى تتطلب openclaw plugins enable <id>. يقوم --force بالكتابة فوق plugin مثبتة موجودة أو حزمة hooks موجودة في مكانها. وهو غير مدعوم مع --link، الذي يعيد استخدام مسار المصدر بدلًا من النسخ فوق هدف تثبيت مُدار. --pin خاص بـ npm فقط. وهو غير مدعوم مع --marketplace، لأن تثبيتات marketplace تحفظ بيانات مصدر marketplace الوصفية بدلًا من مواصفة npm. يُعد --dangerously-force-unsafe-install تجاوزًا طارئًا لكسر الزجاج من أجل النتائج الإيجابية الكاذبة من الماسح المدمج للكود الخطير. فهو يسمح باستمرار تثبيتات plugins وتحديثاتها بعد نتائج critical المدمجة، لكنه لا يتجاوز مع ذلك كتل سياسة plugin ‏before_install أو حظر فشل الفحص. تنطبق راية CLI هذه على تدفقات تثبيت/تحديث plugins فقط. أما تثبيتات تبعيات skill المعتمدة على Gateway فتستخدم بدلًا من ذلك تجاوز الطلب المطابق dangerouslyForceUnsafeInstall، بينما يظل openclaw skills install تدفق تنزيل/تثبيت Skills منفصلًا عبر ClawHub. تشارك الحزم المتوافقة في نفس تدفق list/inspect/enable/disable الخاص بـ plugins. يشمل دعم runtime الحالي Skills الخاصة بالحزم، وClaude command-skills، وإعدادات Claude الافتراضية في settings.json، والإعدادات الافتراضية لـ Claude في .lsp.json وخوادم lspServers المعلنة في manifest، وCursor command-skills، وأدلة hooks المتوافقة مع Codex. يعرض openclaw plugins inspect <id> أيضًا القدرات المكتشفة الخاصة بالحزمة، إضافةً إلى إدخالات MCP وLSP server المدعومة أو غير المدعومة للـ plugins المعتمدة على الحزم. يمكن أن تكون مصادر Marketplace اسم marketplace معروفًا لدى Claude من ~/.claude/plugins/known_marketplaces.json، أو جذر marketplace محليًا أو مسار marketplace.json، أو اختصار GitHub مثل owner/repo، أو عنوان URL لمستودع GitHub، أو عنوان URL لـ git. بالنسبة إلى marketplaces البعيدة، يجب أن تبقى إدخالات plugins داخل مستودع marketplace المستنسخ وأن تستخدم مصادر مسارات نسبية فقط. راجع مرجع CLI ‏openclaw plugins للحصول على التفاصيل الكاملة.

​
نظرة عامة على Plugin API

تصدّر plugins native كائن entry يكشف register(api). وقد لا تزال plugins الأقدم تستخدم activate(api) كاسم بديل قديم، لكن plugins الجديدة ينبغي أن تستخدم register. 
export default definePluginEntry({
  id: "my-plugin",
  name: "My Plugin",
  register(api) {
    api.registerProvider({
      /* ... */
    });
    api.registerTool({
      /* ... */
    });
    api.registerChannel({
      /* ... */
    });
  },
});
يقوم OpenClaw بتحميل كائن entry واستدعاء register(api) أثناء تفعيل plugin. ولا يزال المحمّل يرجع إلى activate(api) للـ plugins الأقدم، لكن plugins المضمّنة وplugins الخارجية الجديدة ينبغي أن تتعامل مع register بوصفه العقد العام. طرق التسجيل الشائعة:
الطريقةما الذي تسجّله
registerProviderموفّر نماذج (LLM)
registerChannelقناة دردشة
registerToolأداة عامل
registerHook / on(...)hooks دورة الحياة
registerSpeechProviderتحويل النص إلى كلام / STT
registerRealtimeTranscriptionProviderSTT متدفق
registerRealtimeVoiceProviderصوت فوري ثنائي الاتجاه
registerMediaUnderstandingProviderتحليل الصور/الصوت
registerImageGenerationProviderتوليد الصور
registerVideoGenerationProviderتوليد الفيديو
registerWebFetchProviderموفّر جلب / scrape للويب
registerWebSearchProviderبحث على الويب
registerHttpRouteنقطة نهاية HTTP
registerCommand / registerCliأوامر CLI
registerContextEngineمحرك سياق
registerServiceخدمة خلفية
سلوك حواجز hooks الخاصة بـ hooks دورة الحياة المTypedة:
  • before_tool_call: تكون { block: true } نهائية؛ ويتم تخطي المعالِجات ذات الأولوية الأقل.
  • before_tool_call: تكون { block: false } بلا تأثير ولا تزيل حظرًا سابقًا.
  • before_install: تكون { block: true } نهائية؛ ويتم تخطي المعالِجات ذات الأولوية الأقل.
  • before_install: تكون { block: false } بلا تأثير ولا تزيل حظرًا سابقًا.
  • message_sending: تكون { cancel: true } نهائية؛ ويتم تخطي المعالِجات ذات الأولوية الأقل.
  • message_sending: تكون { cancel: false } بلا تأثير ولا تزيل إلغاءً سابقًا.
للاطلاع على السلوك الكامل المTyped للـ hooks، راجع نظرة عامة على SDK.

​
ذو صلة