حزم Plugin

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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

​

تثبيت حزمة

# Local directory
openclaw plugins install ./my-bundle

# Archive
openclaw plugins install ./my-bundle.tgz

# Claude marketplace
openclaw plugins marketplace list <marketplace-name>
openclaw plugins install <plugin-name>@<marketplace-name>

openclaw plugins list
openclaw plugins inspect <id>

openclaw gateway restart

​

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

​

مدعوم الآن

​

محتوى Skills

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

​

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

• تعمل جذور الخطافات في الحزمة فقط عندما تستخدم تخطيط حزمة الخطافات العادي في 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": {
    "servers": {
      "my-server": {
        "command": "node",
        "args": ["server.js"],
        "env": { "PORT": "3000" }
      }
    }
  }
}

{
  "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

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

• تُستبدل الأحرف خارج 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>

​

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

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

​

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

​

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

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

​

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

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

​

الأمان

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

​

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

​

ذو صلة

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