توافق Plugin

​

سجل التوافق

• رمز توافق ثابت
• الحالة: active أو deprecated أو removal-pending أو removed
• المالك: sdk أو config أو setup أو channel أو provider أو plugin-execution أو agent-runtime أو core
• تواريخ الإدخال والإهمال عند الاقتضاء
• إرشادات البديل
• الوثائق والتشخيصات والاختبارات التي تغطي السلوك القديم والجديد

​

سياسة الإهمال

1. أضف العقد الجديد.
2. أبقِ السلوك القديم موصولًا عبر محوّل توافق مسمّى.
3. أصدر تشخيصات أو تحذيرات عندما يستطيع مؤلفو Plugin اتخاذ إجراء.
4. وثّق البديل والجدول الزمني.
5. اختبر المسارين القديم والجديد.
6. انتظر حتى انقضاء نافذة الترحيل المُعلنة.
7. لا تُزل العقد إلا بموافقة صريحة لإصدار كاسر للتوافق.

​

مجالات التوافق الحالية

• عمليات استيراد SDK العامة القديمة مثل openclaw/plugin-sdk/compat
• أشكال Plugin القديمة التي تقتصر على الخطافات وbefore_agent_start
• أسماء خطافات التنظيف القديمة api.on("deactivate", ...) أثناء انتقال Plugins إلى gateway_stop
• نقاط دخول Plugin القديمة activate(api) أثناء انتقال Plugins إلى register(api)
• الأسماء المستعارة القديمة في SDK مثل openclaw/extension-api، وopenclaw/plugin-sdk/channel-runtime، ومنشئات الحالة في openclaw/plugin-sdk/command-auth، وopenclaw/plugin-sdk/test-utils (التي استُبدلت بمسارات اختبار فرعية متخصصة ضمن openclaw/plugin-sdk/*)، والاسمين المستعارين للنوعين ClawdbotConfig / OpenClawSchemaType
• قائمة السماح وسلوك التمكين لـ Plugins المضمّنة
• بيانات بيان متغيرات البيئة القديمة للمزوّد/القناة
• خطافات Plugin القديمة للمزوّد والأسماء المستعارة للأنواع أثناء انتقال المزوّدين إلى خطافات صريحة للفهرس والمصادقة والتفكير وإعادة التشغيل والنقل
• الأسماء المستعارة القديمة لبيئة التشغيل مثل api.runtime.taskFlow، وapi.runtime.subagent.getSession، وapi.runtime.stt، والدالتين المهملتين api.runtime.config.loadConfig() / api.runtime.config.writeConfigFile(...)
• حقول الاستدعاء المسطّحة في WebInboundMessage لـ WhatsApp (انظر أدناه)
• حقول القبول ذات المستوى الأعلى في WebInboundMessage لـ WhatsApp (انظر أدناه)
• التسجيل المنقسم القديم لـ Plugin الذاكرة أثناء انتقال Plugins الذاكرة إلى registerMemoryCapability
• التسجيل القديم لمزوّد التضمين الخاص بالذاكرة أثناء انتقال مزوّدي التضمين إلى api.registerEmbeddingProvider(...) و contracts.embeddingProviders
• مساعدات SDK القديمة للقنوات لمخططات الرسائل الأصلية، وبوابة الإشارات، وتنسيق مغلف الوارد، وتداخل قدرات الموافقة
• الأسماء المستعارة القديمة لمفتاح مسار القناة ومساعدات الأهداف القابلة للمقارنة أثناء انتقال Plugins إلى openclaw/plugin-sdk/channel-route
• استبدال تلميحات التفعيل بملكية مساهمات البيان
• المسار الاحتياطي لبيئة تشغيل setup-api أثناء انتقال واصفات الإعداد إلى بيانات setup.requiresRuntime: false الوصفية الباردة
• خطافات discovery للمزوّد أثناء انتقال خطافات فهرس المزوّد إلى catalog.run(...)
• بيانات showConfigured / showInSetup الوصفية للقناة أثناء انتقال حزم القنوات إلى openclaw.channel.exposure
• مفاتيح تهيئة سياسة بيئة التشغيل القديمة أثناء ترحيل Doctor للمشغّلين إلى agentRuntime
• المسار الاحتياطي لبيانات تهيئة القنوات المضمّنة المُنشأة أثناء اعتماد بيانات channelConfigs الوصفية القائمة على السجل أولًا
• أعلام البيئة المستديمة لتعطيل سجل Plugin وترحيل التثبيت أثناء ترحيل تدفقات الإصلاح للمشغّلين إلى openclaw plugins registry --refresh وopenclaw doctor --fix
• مسارات التهيئة القديمة المملوكة لـ Plugin للبحث في الويب وجلب محتوى الويب وx_search أثناء ترحيل Doctor لها إلى plugins.entries.<plugin>.config
• تهيئة plugins.installs القديمة التي يكتبها المستخدم والأسماء المستعارة لمسارات تحميل Plugin المضمّنة أثناء انتقال بيانات التثبيت الوصفية إلى سجل Plugin المُدار بالحالة

​

الأسماء المستعارة المسطّحة لاستدعاء WhatsApp الوارد

• تنتقل id وtimestamp وisBatched إلى داخل event.
• تنتقل body وmediaPath وmediaType وmediaFileName وmediaUrl وlocation وuntrustedStructuredContext إلى داخل payload.
• تنتقل to وchatId وحقول المرسل/الذات وsendComposing وreply(...) وsendMedia(...) إلى داخل platform.
• تنتقل حقول replyTo* إلى داخل quote؛ وتنتقل حقول موضوع المجموعة والمشاركين والإشارات إلى داخل group.

​

حقول قبول WhatsApp الواردة

• ينتقل from وconversationId إلى admission.conversation.id.
• ينتقل accountId إلى admission.accountId.
• يُعد accessControlPassed عرض توافق مشتقًا من admission.ingress.decision === "allow"؛ وفي الرسائل التي تحمل admission بالفعل، لا تؤدي كتابة القيمة المنطقية القديمة إلى إعادة كتابة مخطط الدخول.
• ينتقل chatType إلى admission.conversation.kind.

​

حزمة أداة فحص Plugin

openclaw-plugin-inspector ./my-plugin

​

مسار قبول المشرفين

pnpm crabbox:run -- --provider blacksmith-testbox --timing-json --shell -- "pnpm install && pnpm build && npm exec --yes @openclaw/plugin-inspector@0.1.0 -- ./extensions/telegram --json"
pnpm crabbox:run -- --provider blacksmith-testbox --timing-json --shell -- "npm exec --yes @openclaw/plugin-inspector@0.1.0 -- ./extensions/discord --json"
pnpm crabbox:run -- --provider blacksmith-testbox --timing-json --shell -- "npm exec --yes @openclaw/plugin-inspector@0.1.0 -- <clawhub-plugin-dir> --json"

​

ملاحظات الإصدار