حزم Plugin

يمكن لـ OpenClaw تثبيت Plugins من ثلاثة أنظمة بيئية خارجية: Codex وClaude وCursor. وتُسمى هذه حِزمًا — وهي حِزم محتوى وبيانات وصفية يربطها OpenClaw بميزات أصلية مثل Skills والخطافات وأدوات MCP.

لماذا توجد الحِزم

تُنشر العديد من Plugins المفيدة بتنسيق Codex أو Claude أو Cursor. وبدلًا من مطالبة المؤلفين بإعادة كتابتها كـ Plugins OpenClaw أصلية، يكتشف OpenClaw هذه التنسيقات ويربط محتواها المدعوم بمجموعة الميزات الأصلية. وهذا يعني أنه يمكنك تثبيت حزمة أوامر Claude أو حزمة Skills من Codex واستخدامها فورًا.

تثبيت حزمة

# Local directoryopenclaw plugins install ./my-bundle # Archiveopenclaw plugins install ./my-bundle.tgz # Claude marketplaceopenclaw plugins marketplace list <marketplace-name>openclaw plugins install <plugin-name>@<marketplace-name>

openclaw plugins listopenclaw plugins inspect <id>

openclaw gateway restart

ما الذي يربطه OpenClaw من الحِزم

لا تعمل كل ميزة في الحِزم داخل OpenClaw اليوم. إليك ما يعمل وما يُكتشف لكنه لم يُوصّل بعد.

مدعوم الآن

محتوى Skills

• تُحمّل جذور Skills في الحزمة كجذور Skills عادية في OpenClaw
• تُعامل جذور commands في Claude كجذور Skills إضافية
• تُعامل جذور .cursor/commands في Cursor كجذور Skills إضافية

وهذا يعني أن ملفات أوامر markdown في Claude تعمل عبر محمّل Skills العادي في OpenClaw. وتعمل ملفات markdown لأوامر Cursor عبر المسار نفسه.

حِزم الخطافات

• تعمل جذور الخطافات في الحزمة فقط عندما تستخدم تخطيط حزمة الخطافات العادي في OpenClaw. واليوم تكون هذه أساسًا حالة التوافق مع Codex:
  • HOOK.md
  • handler.ts أو handler.js

MCP لـ Pi

• يمكن للحِزم المفعّلة المساهمة بتهيئة خادم MCP
• يدمج OpenClaw تهيئة MCP الخاصة بالحزمة داخل إعدادات Pi المضمنة الفعالة باسم mcpServers
• يعرض OpenClaw أدوات MCP المدعومة من الحِزم أثناء أدوار وكيل Pi المضمن عبر تشغيل خوادم stdio أو الاتصال بخوادم HTTP
• يتضمن ملفا تعريف الأدوات coding وmessaging أدوات MCP الخاصة بالحِزم افتراضيًا؛ استخدم tools.deny: ["bundle-mcp"] لإلغاء الاشتراك لوكيل أو Gateway
• تظل إعدادات Pi المحلية للمشروع مطبقة بعد افتراضيات الحزمة، لذا يمكن لإعدادات مساحة العمل تجاوز إدخالات MCP الخاصة بالحزمة عند الحاجة
• تُفرز كتالوجات أدوات MCP الخاصة بالحِزم بشكل حتمي قبل التسجيل، بحيث لا تؤدي تغييرات ترتيب listTools() من المصدر إلى اضطراب كتل أدوات ذاكرة التخزين المؤقت للمطالبات

وسائل النقل

يمكن لخوادم MCP استخدام نقل stdio أو HTTP:

Stdio يشغّل عملية فرعية:

{  "mcp": {    "servers": {      "my-server": {        "command": "node",        "args": ["server.js"],        "env": { "PORT": "3000" }      }    }  }}

HTTP يتصل بخادم MCP قيد التشغيل عبر sse افتراضيًا، أو streamable-http عند طلب ذلك:

{  "mcp": {    "servers": {      "my-server": {        "url": "http://localhost:3100/mcp",        "transport": "streamable-http",        "headers": {          "Authorization": "Bearer ${MY_SECRET_TOKEN}"        },        "connectionTimeoutMs": 30000      }    }  }}

• يمكن تعيين transport إلى "streamable-http" أو "sse"؛ وعند حذفه يستخدم OpenClaw القيمة sse
• يُعد type: "http" شكلًا تابعًا أصليًا لـ CLI؛ استخدم transport: "streamable-http" في تهيئة OpenClaw. يقوم openclaw mcp set وopenclaw doctor --fix بتطبيع الاسم المستعار الشائع.
• لا يُسمح إلا بمخططات URL http: وhttps:
• تدعم قيم headers استيفاء ${ENV_VAR}
• يُرفض إدخال الخادم الذي يحتوي على كل من command وurl
• تُحجب بيانات اعتماد URL (معلومات المستخدم ومعلمات الاستعلام) من أوصاف الأدوات والسجلات
• يتجاوز connectionTimeoutMs مهلة الاتصال الافتراضية البالغة 30 ثانية لكل من نقلي stdio وHTTP

تسمية الأدوات

يسجل OpenClaw أدوات MCP الخاصة بالحِزم بأسماء آمنة للمزوّدين بالصيغة serverName__toolName. على سبيل المثال، الخادم ذي المفتاح "vigil-harbor" الذي يعرض أداة memory_search يُسجل باسم vigil-harbor__memory_search.

• تُستبدل الأحرف خارج A-Za-z0-9_- بـ -
• تحصل الأجزاء التي قد تبدأ بحرف غير أبجدي على بادئة حرف، بحيث تصبح مفاتيح الخوادم الرقمية مثل 12306 بادئات أدوات آمنة للمزوّدين
• تُحد بادئات الخوادم بـ 30 حرفًا
• تُحد أسماء الأدوات الكاملة بـ 64 حرفًا
• تعود أسماء الخوادم الفارغة إلى mcp
• تُميّز الأسماء المنقّاة المتصادمة بلاحقات رقمية
• يكون ترتيب الأدوات النهائي المعروض حتميًا حسب الاسم الآمن للحفاظ على ثبات ذاكرة التخزين المؤقت عبر أدوار Pi المتكررة
• يعامل ترشيح ملف التعريف كل الأدوات من خادم MCP واحد ضمن الحزمة كأنها مملوكة لـ Plugin باسم bundle-mcp، لذا يمكن لقوائم السماح وقوائم الرفض في ملفات التعريف تضمين أسماء الأدوات المعروضة الفردية أو مفتاح Plugin bundle-mcp

إعدادات Pi المضمنة

• تُستورد settings.json الخاصة بـ Claude كإعدادات Pi مضمنة افتراضية عندما تكون الحزمة مفعّلة
• ينقّي OpenClaw مفاتيح تجاوز shell قبل تطبيقها

المفاتيح المنقّاة:

• shellPath
• shellCommandPrefix

LSP لـ Pi المضمن

• يمكن لحِزم Claude المفعّلة المساهمة بتهيئة خادم LSP
• يحمّل OpenClaw ملف .lsp.json بالإضافة إلى أي مسارات lspServers معلنة في البيان
• تُدمج تهيئة LSP الخاصة بالحزمة داخل افتراضيات LSP الفعالة لـ Pi المضمن
• لا يمكن تشغيل إلا خوادم LSP المدعومة القائمة على stdio اليوم؛ وتظل وسائل النقل غير المدعومة ظاهرة في openclaw plugins inspect <id>

مكتشف لكنه غير منفّذ

هذه العناصر معروفة وتظهر في التشخيصات، لكن OpenClaw لا يشغّلها:

• agents في Claude، وأتمتة hooks.json، وoutputStyles
• .cursor/agents و.cursor/hooks.json و.cursor/rules في Cursor
• بيانات Codex الوصفية المضمنة/الخاصة بالتطبيق خارج تقارير القدرات

تنسيقات الحِزم

أسبقية الاكتشاف

يتحقق OpenClaw أولًا من تنسيق Plugin الأصلي:

1. openclaw.plugin.json أو package.json صالح مع openclaw.extensions — يُعامل كـ Plugin أصلي
2. علامات الحِزم (.codex-plugin/ أو .claude-plugin/ أو تخطيط Claude/Cursor الافتراضي) — تُعامل كـ حزمة

إذا احتوى دليل على كليهما، يستخدم OpenClaw المسار الأصلي. وهذا يمنع الحِزم مزدوجة التنسيق من التثبيت جزئيًا كحِزم.

تبعيات وقت التشغيل والتنظيف

• لا تحصل الحِزم المتوافقة التابعة لجهات خارجية على إصلاح npm install عند بدء التشغيل. يجب تثبيتها عبر openclaw plugins install وشحن كل ما تحتاجه في دليل Plugin المثبت.
• تكون Plugins المضمّنة المملوكة لـ OpenClaw إما مشحونة بخفة داخل النواة أو قابلة للتنزيل عبر مثبّت Plugin. لا يشغّل بدء تشغيل Gateway مدير حزم لها أبدًا.
• يزيل openclaw doctor --fix أدلة التبعيات المرحلية القديمة ويمكنه استرداد Plugins القابلة للتنزيل المفقودة من فهرس Plugin المحلي عندما تشير إليها التهيئة.

الأمان

للحِزم حد ثقة أضيق من Plugins الأصلية:

• لا يحمّل OpenClaw وحدات وقت تشغيل عشوائية من الحزمة داخل العملية
• يجب أن تبقى مسارات Skills وحِزم الخطافات داخل جذر Plugin (مع فحص الحدود)
• تُقرأ ملفات الإعدادات بفحوص الحدود نفسها
• قد تُشغّل خوادم MCP المدعومة عبر stdio كعمليات فرعية

وهذا يجعل الحِزم أكثر أمانًا افتراضيًا، لكن ينبغي لك مع ذلك التعامل مع حِزم الجهات الخارجية كمحتوى موثوق للميزات التي تعرضها.

استكشاف الأخطاء وإصلاحها

ذو صلة

• تثبيت Plugins وتهيئتها
• بناء Plugins — أنشئ Plugin أصليًا
• بيان Plugin — مخطط البيان الأصلي