داخليات بنية 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.

​

مسار التحميل

1. يكتشف جذور Plugin المرشحة
2. يقرأ بيانات manifest للحزم الأصلية أو المتوافقة وبيانات package الوصفية
3. يرفض المرشحين غير الآمنين
4. يطبّع إعدادات Plugin (plugins.enabled، allow، deny، entries، slots، load.paths)
5. يقرر التمكين لكل مرشح
6. يحمّل الوحدات الأصلية الممكّنة: تستخدم الوحدات المضمّنة المبنية محمّلًا أصليًا؛ ويستخدم مصدر TypeScript المحلي التابع لجهات خارجية مسار Jiti الاحتياطي الطارئ
7. يستدعي خطافات register(api) الأصلية ويجمع التسجيلات في سجل Plugin
8. يعرّض السجل للأوامر/أسطح وقت التشغيل

​

سلوك manifest أولًا

• تحديد Plugin
• اكتشاف القنوات/Skills/مخطط الإعدادات المصرّح بها أو إمكانات الحزمة
• التحقق من plugins.entries.<id>.config
• تعزيز تسميات/عناصر نائبة في واجهة التحكم
• عرض بيانات التثبيت/الفهرس الوصفية
• الاحتفاظ بواصفات التنشيط والإعداد الرخيصة دون تحميل وقت تشغيل Plugin

• يضيّق تحميل CLI إلى Plugins التي تملك الأمر الأساسي المطلوب
• يضيّق إعداد القناة/حل Plugin إلى Plugins التي تملك معرّف القناة المطلوب
• يضيّق إعداد/حل وقت تشغيل المزوّد الصريح إلى Plugins التي تملك معرّف المزوّد المطلوب
• يستخدم تخطيط بدء تشغيل Gateway ‏activation.onStartup لعمليات استيراد بدء التشغيل الصريحة وإلغاء الاشتراك في بدء التشغيل؛ ولا تُحمّل Plugins التي لا تحتوي على بيانات وصفية لبدء التشغيل إلا عبر مشغلات تنشيط أضيق

​

حد ذاكرة Plugin المؤقتة

• PluginLoaderCacheState وسجلات وقت التشغيل النشطة المتوافقة
• ذاكرات jiti/الوحدات المؤقتة وذاكرات محمّل السطح العام المستخدمة لتجنب استيراد سطح وقت التشغيل نفسه مرارًا
• ذاكرات filesystem المؤقتة لـ artifacts الخاصة بـ Plugin المثبتة
• خرائط قصيرة العمر لكل استدعاء لتطبيع المسارات أو حل التكرارات

• نتائج الاكتشاف
• سجلات manifest المباشرة
• سجلات manifest المعاد بناؤها من فهرس Plugin المثبت
• بحث مالك المزوّد، أو كبت النموذج، أو سياسة المزوّد، أو بيانات artifact العامة الوصفية
• أي إجابة أخرى مشتقة من manifest حيث ينبغي أن يكون manifest متغير، أو فهرس مثبت، أو مسار تحميل مرئيًا عند القراءة التالية للبيانات الوصفية

​

نموذج السجل

• سجلات Plugin (الهوية، المصدر، الأصل، الحالة، التشخيصات)
• الأدوات
• الخطافات القديمة والخطافات المعرّفة النوع
• القنوات
• المزوّدين
• معالجات RPC في Gateway
• مسارات HTTP
• مسجلات CLI
• خدمات الخلفية
• الأوامر المملوكة لـ Plugin

• وحدة Plugin -> تسجيل في السجل
• وقت تشغيل core -> استهلاك السجل

​

استدعاءات ربط المحادثة

export default {
  id: "my-plugin",
  register(api) {
    api.onConversationBindingResolved(async (event) => {
      if (event.status === "approved") {
        // A binding now exists for this plugin + conversation.
        console.log(event.binding?.conversationId);
        return;
      }

      // The request was denied; clear any local pending state.
      console.log(event.request.conversation.conversationId);
    });
  },
};

• status: "approved" أو "denied"
• decision: "allow-once" أو "allow-always" أو "deny"
• binding: الربط المحلول للطلبات الموافق عليها
• request: ملخص الطلب الأصلي، وتلميح الفصل، ومعرّف المرسل، و بيانات المحادثة الوصفية

​

خطافات وقت تشغيل المزوّد

• بيانات manifest الوصفية للبحث الرخيص قبل وقت التشغيل: setup.providers[].envVars، وتوافق providerAuthEnvVars المهمل، وproviderAuthAliases، وproviderAuthChoices، وchannelEnvVars.
• خطافات وقت الإعدادات: catalog (القديم discovery) بالإضافة إلى applyConfigDefaults.
• خطافات وقت التشغيل: أكثر من 40 خطافًا اختياريًا تغطي المصادقة، وحل النماذج، وتغليف التدفق، ومستويات التفكير، وسياسة الإعادة، ونقاط نهاية الاستخدام. راجع القائمة الكاملة ضمن ترتيب الخطافات واستخدامها.

​

ترتيب الخطافات واستخدامها

​

مثال موفر

api.registerProvider({
  id: "example-proxy",
  label: "Example Proxy",
  auth: [],
  catalog: {
    order: "simple",
    run: async (ctx) => {
      const apiKey = ctx.resolveProviderApiKey("example-proxy").apiKey;
      if (!apiKey) {
        return null;
      }
      return {
        provider: {
          baseUrl: "https://proxy.example.com/v1",
          apiKey,
          api: "openai-completions",
          models: [{ id: "auto", name: "Auto" }],
        },
      };
    },
  },
  resolveDynamicModel: (ctx) => ({
    id: ctx.modelId,
    name: ctx.modelId,
    provider: "example-proxy",
    api: "openai-completions",
    baseUrl: "https://proxy.example.com/v1",
    reasoning: false,
    input: ["text"],
    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
    contextWindow: 128000,
    maxTokens: 8192,
  }),
  prepareRuntimeAuth: async (ctx) => {
    const exchanged = await exchangeToken(ctx.apiKey);
    return {
      apiKey: exchanged.token,
      baseUrl: exchanged.baseUrl,
      expiresAt: exchanged.expiresAt,
    };
  },
  resolveUsageAuth: async (ctx) => {
    const auth = await ctx.resolveOAuthToken();
    return auth ? { token: auth.token } : null;
  },
  fetchUsageSnapshot: async (ctx) => {
    return await fetchExampleProxyUsage(ctx.token, ctx.timeoutMs, ctx.fetchFn);
  },
});

​

أمثلة مضمنة

​

مساعدات وقت التشغيل

const clip = await api.runtime.tts.textToSpeech({
  text: "Hello from OpenClaw",
  cfg: api.config,
});

const result = await api.runtime.tts.textToSpeechTelephony({
  text: "Hello from OpenClaw",
  cfg: api.config,
});

const voices = await api.runtime.tts.listVoices({
  provider: "elevenlabs",
  cfg: api.config,
});

• يعيد textToSpeech حمولة إخراج TTS الأساسية العادية لأسطح الملف/الملاحظة الصوتية.
• يستخدم إعداد messages.tts الأساسي واختيار الموفر.
• يعيد مخزن صوت PCM + معدل العينة. يجب على Plugins إعادة أخذ العينات/الترميز للموفرين.
• listVoices اختياري لكل موفر. استخدمه لمنتقيات الأصوات أو تدفقات الإعداد التي يملكها المورّد.
• يمكن أن تتضمن قوائم الأصوات بيانات وصفية أغنى مثل اللغة، والجنس، ووسوم الشخصية للمنتقيات الواعية بالموفر.
• يدعم OpenAI وElevenLabs الاتصال الهاتفي اليوم. لا يدعمه Microsoft.

api.registerSpeechProvider({
  id: "acme-speech",
  label: "Acme Speech",
  isConfigured: ({ config }) => Boolean(config.messages?.tts),
  synthesize: async (req) => {
    return {
      audioBuffer: Buffer.from([]),
      outputFormat: "mp3",
      fileExtension: ".mp3",
      voiceCompatible: false,
    };
  },
});

• أبقِ سياسة TTS، والرجوع الاحتياطي، وتسليم الرد في النواة.
• استخدم موفري الكلام لسلوك التوليف الذي يملكه المورّد.
• يتم تطبيع إدخال Microsoft القديم edge إلى معرّف الموفر microsoft.
• نموذج الملكية المفضل موجّه للشركات: يمكن لـ Plugin مورّد واحد أن يملك موفري النص، والكلام، والصور، والوسائط المستقبلية بينما يضيف OpenClaw عقود القدرات هذه.

api.registerMediaUnderstandingProvider({
  id: "google",
  capabilities: ["image", "audio", "video"],
  describeImage: async (req) => ({ text: "..." }),
  transcribeAudio: async (req) => ({ text: "..." }),
  describeVideo: async (req) => ({ text: "..." }),
});

• أبقِ التنسيق، والرجوع الاحتياطي، والإعداد، وتوصيل القنوات في النواة.
• أبقِ سلوك المورّد في Plugin الموفر.
• يجب أن يبقى التوسع الإضافي ذا نوع محدد: طرق اختيارية جديدة، وحقول نتائج اختيارية جديدة، وقدرات اختيارية جديدة.
• يتبع توليد الفيديو بالفعل النمط نفسه:
  • تملك النواة عقد القدرة ومساعد وقت التشغيل
  • تسجّل Plugins المورّدين api.registerVideoGenerationProvider(...)
  • تستهلك Plugins الميزات/القنوات api.runtime.videoGeneration.*

const image = await api.runtime.mediaUnderstanding.describeImageFile({
  filePath: "/tmp/inbound-photo.jpg",
  cfg: api.config,
  agentDir: "/tmp/agent",
});

const video = await api.runtime.mediaUnderstanding.describeVideoFile({
  filePath: "/tmp/inbound-video.mp4",
  cfg: api.config,
});

const { text } = await api.runtime.mediaUnderstanding.transcribeAudioFile({
  filePath: "/tmp/inbound-audio.ogg",
  cfg: api.config,
  // Optional when MIME cannot be inferred reliably:
  mime: "audio/ogg",
});

• api.runtime.mediaUnderstanding.* هو السطح المشترك المفضل لفهم الصور/الصوت/الفيديو.
• يستخدم إعداد الصوت الأساسي لفهم الوسائط (tools.media.audio) وترتيب الرجوع الاحتياطي للموفرين.
• يعيد { text: undefined } عندما لا يتم إنتاج مخرج نسخ (مثلًا عند تخطي الإدخال أو عدم دعمه).
• يبقى api.runtime.stt.transcribeAudioFile(...) كاسم مستعار للتوافق.

const result = await api.runtime.subagent.run({
  sessionKey: "agent:main:subagent:search-helper",
  message: "Expand this query into focused follow-up searches.",
  provider: "openai",
  model: "gpt-4.1-mini",
  deliver: false,
});

• provider وmodel تجاوزات اختيارية لكل تشغيل، وليست تغييرات جلسة دائمة.
• يحترم OpenClaw حقول التجاوز هذه فقط للمتصلين الموثوقين.
• بالنسبة إلى تشغيلات الرجوع الاحتياطي التي يملكها Plugin، يجب أن يشترك المشغلون باستخدام plugins.entries.<id>.subagent.allowModelOverride: true.
• استخدم plugins.entries.<id>.subagent.allowedModels لتقييد Plugins الموثوقة على أهداف provider/model قانونية محددة، أو "*" للسماح صراحة بأي هدف.
• لا تزال تشغيلات الوكيل الفرعي من Plugins غير الموثوقة تعمل، لكن طلبات التجاوز تُرفض بدلًا من الرجوع بصمت.
• تُوسم جلسات الوكيل الفرعي التي تنشئها Plugins بمعرّف Plugin المنشئ. قد يحذف الرجوع الاحتياطي api.runtime.subagent.deleteSession(...) تلك الجلسات المملوكة فقط؛ ولا يزال حذف الجلسات العشوائي يتطلب طلب Gateway بنطاق مسؤول.

const providers = api.runtime.webSearch.listProviders({
  config: api.config,
});

const result = await api.runtime.webSearch.search({
  config: api.config,
  args: {
    query: "OpenClaw plugin runtime helpers",
    count: 5,
  },
});

• أبقِ اختيار الموفر، وحل بيانات الاعتماد، ودلالات الطلب المشتركة في النواة.
• استخدم موفري بحث الويب لنواقل البحث الخاصة بالمورّد.
• api.runtime.webSearch.* هو السطح المشترك المفضل لـ Plugins الميزات/القنوات التي تحتاج إلى سلوك بحث دون الاعتماد على غلاف أداة الوكيل.

​

api.runtime.imageGeneration

const result = await api.runtime.imageGeneration.generate({
  config: api.config,
  args: { prompt: "A friendly lobster mascot", size: "1024x1024" },
});

const providers = api.runtime.imageGeneration.listProviders({
  config: api.config,
});

• generate(...): ولّد صورة باستخدام سلسلة موفري توليد الصور المضبوطة.
• listProviders(...): اسرد موفري توليد الصور المتاحين وقدراتهم.

​

مسارات HTTP الخاصة بـ Gateway

api.registerHttpRoute({
  path: "/acme/webhook",
  auth: "plugin",
  match: "exact",
  handler: async (_req, res) => {
    res.statusCode = 200;
    res.end("ok");
    return true;
  },
});

• path: مسار التوجيه تحت خادم HTTP الخاص بالـ gateway.
• auth: مطلوب. استخدم "gateway" لاشتراط مصادقة gateway العادية، أو "plugin" للمصادقة/التحقق من Webhook الذي يديره Plugin.
• match: اختياري. "exact" (الافتراضي) أو "prefix".
• replaceExisting: اختياري. يسمح لنفس Plugin باستبدال تسجيل المسار الموجود الخاص به.
• handler: أعد true عندما يعالج المسار الطلب.

• تمت إزالة api.registerHttpHandler(...) وسيؤدي إلى خطأ عند تحميل Plugin. استخدم api.registerHttpRoute(...) بدلاً منه.
• يجب أن تعلن مسارات Plugin عن auth صراحةً.
• تُرفض تعارضات path + match الدقيقة ما لم تكن replaceExisting: true، ولا يمكن لـ Plugin واحد أن يستبدل مسار Plugin آخر.
• تُرفض المسارات المتداخلة ذات مستويات auth المختلفة. أبقِ سلاسل التمرير الاحتياطي exact/prefix على مستوى المصادقة نفسه فقط.
• لا تتلقى مسارات auth: "plugin" نطاقات تشغيل المشغّل تلقائياً. فهي مخصصة لـ webhooks التي يديرها Plugin/التحقق من التوقيعات، وليست لاستدعاءات مساعد Gateway ذات الامتيازات.
• تعمل مسارات auth: "gateway" داخل نطاق تشغيل طلب Gateway، لكن هذا النطاق محافظ عمداً:
  • مصادقة الحامل ذات السر المشترك (gateway.auth.mode = "token" / "password") تُبقي نطاقات تشغيل مسارات Plugin مثبتة على operator.write، حتى إذا أرسل المستدعي x-openclaw-scopes
  • أوضاع HTTP الموثوقة الحاملة للهوية (مثل trusted-proxy أو gateway.auth.mode = "none" على مدخل خاص) تحترم x-openclaw-scopes فقط عندما يكون الرأس موجوداً صراحةً
  • إذا كان x-openclaw-scopes غائباً في طلبات مسارات Plugin الحاملة للهوية هذه، يعود نطاق التشغيل إلى operator.write
• قاعدة عملية: لا تفترض أن مسار Plugin بمصادقة Gateway هو سطح إدارة ضمني. إذا كان مسارك يحتاج إلى سلوك مخصص للمسؤولين فقط، فاشترط وضع مصادقة حامل للهوية ووثّق عقد الرأس الصريح x-openclaw-scopes.

​

مسارات استيراد Plugin SDK

• index.js — مدخل Plugin مضمّن
• api.js — برميل مساعدات/أنواع
• runtime-api.js — برميل خاص بالتشغيل فقط
• setup-entry.js — مدخل Plugin الإعداد

​

مخططات أداة الرسائل

• presentation لكتل العرض الدلالية (text, context, divider, buttons, select)
• delivery-pin لطلبات التسليم المثبت

​

حل أهداف القنوات

• يقرر messaging.inferTargetChatType({ to }) ما إذا كان ينبغي التعامل مع هدف مطبّع باعتباره direct أو group أو channel قبل البحث في الدليل.
• يخبر messaging.targetResolver.looksLikeId(raw, normalized) النواة ما إذا كان الإدخال يجب أن يتجاوز مباشرةً إلى حل شبيه بالمعرّف بدلاً من البحث في الدليل.
• messaging.targetResolver.resolveTarget(...) هو الرجوع الاحتياطي الخاص بـ Plugin عندما تحتاج النواة إلى حل نهائي مملوك للمزوّد بعد التطبيع أو بعد فشل الدليل.
• يمتلك messaging.resolveOutboundSessionRoute(...) بناء مسار الجلسة الخاص بالمزوّد بمجرد حل الهدف.

• استخدم inferTargetChatType لقرارات الفئة التي يجب أن تحدث قبل البحث في النظراء/المجموعات.
• استخدم looksLikeId لفحوصات “تعامل مع هذا كمعرّف هدف صريح/أصلي”.
• استخدم resolveTarget كرجوع احتياطي للتطبيع الخاص بالمزوّد، وليس للبحث الواسع في الدليل.
• أبقِ المعرّفات الأصلية للمزوّد مثل معرّفات الدردشة، ومعرّفات الخيوط، وJIDs، والمقابض، ومعرّفات الغرف داخل قيم target أو المعاملات الخاصة بالمزوّد، لا في حقول SDK العامة.

​

أدلة مدعومة بالإعدادات

• نظراء الرسائل المباشرة المحكومون بقائمة سماح
• خرائط القنوات/المجموعات المضبوطة
• بدائل دليل ثابتة ضمن نطاق الحساب

• ترشيح الاستعلامات
• تطبيق الحدود
• مساعدات إزالة التكرار/التطبيع
• بناء ChannelDirectoryEntry[]

​

كتالوجات المزوّدين

• { provider } لإدخال مزوّد واحد
• { providers } لعدة إدخالات مزوّدين

• simple: مزوّدون مدفوعون بمفتاح API عادي أو بالبيئة
• profile: مزوّدون يظهرون عند وجود ملفات تعريف مصادقة
• paired: مزوّدون يركّبون عدة إدخالات مزوّدين مترابطة
• late: المرور الأخير، بعد المزوّدين الضمنيين الآخرين

• لا يزال discovery يعمل كاسم مستعار قديم، لكنه يصدر تحذير إهمال
• إذا سُجّل كل من catalog وdiscovery، يستخدم OpenClaw catalog
• augmentModelCatalog مهمل؛ يجب أن تنشر المزوّدات المضمّنة الصفوف التكميلية عبر registerModelCatalogProvider

​

فحص القنوات للقراءة فقط

• resolveAccount(...) هو مسار التشغيل. يُسمح له بافتراض أن بيانات الاعتماد مكتملة التجسيد ويمكنه الفشل سريعاً عند غياب الأسرار المطلوبة.
• يجب ألا تحتاج مسارات الأوامر للقراءة فقط مثل openclaw status وopenclaw status --all وopenclaw channels status وopenclaw channels resolve وتدفقات إصلاح doctor/config إلى تجسيد بيانات اعتماد التشغيل لمجرد وصف الإعدادات.

• أعد حالة حساب وصفية فقط.
• حافظ على enabled وconfigured.
• ضمّن حقول مصدر/حالة بيانات الاعتماد عند الاقتضاء، مثل:
  • tokenSource, tokenStatus
  • botTokenSource, botTokenStatus
  • appTokenSource, appTokenStatus
  • signingSecretSource, signingSecretStatus
• لا تحتاج إلى إعادة قيم الرموز الخام لمجرد الإبلاغ عن التوفر للقراءة فقط. إعادة tokenStatus: "available" (وحقل المصدر المطابق) كافية لأوامر نمط الحالة.
• استخدم configured_unavailable عندما تكون بيانات الاعتماد مضبوطة عبر SecretRef لكنها غير متاحة في مسار الأمر الحالي.

​

حزم packages

{
  "name": "my-pack",
  "openclaw": {
    "extensions": ["./src/safety.ts", "./src/tools.ts"],
    "setupEntry": "./src/setup-entry.ts"
  }
}

• تسجيل القناة نفسه
• أي مسارات HTTP يجب أن تكون متاحة قبل أن يبدأ Gateway في الاستماع
• أي طرق أو أدوات أو خدمات Gateway يجب أن تكون موجودة خلال النافذة نفسها

• singleAccountKeysToMove
• namedAccountPromotionKeys
• resolveSingleAccountPromotionTarget(...)

{
  "name": "@scope/my-channel",
  "openclaw": {
    "extensions": ["./index.ts"],
    "setupEntry": "./setup-entry.ts",
    "startup": {
      "deferConfiguredChannelFullLoadUntilAfterListen": true
    }
  }
}

​

بيانات وصف كتالوج القنوات

{
  "name": "@openclaw/nextcloud-talk",
  "openclaw": {
    "extensions": ["./index.ts"],
    "channel": {
      "id": "nextcloud-talk",
      "label": "Nextcloud Talk",
      "selectionLabel": "Nextcloud Talk (self-hosted)",
      "docsPath": "/channels/nextcloud-talk",
      "docsLabel": "nextcloud-talk",
      "blurb": "Self-hosted chat via Nextcloud Talk webhook bots.",
      "order": 65,
      "aliases": ["nc-talk", "nc"]
    },
    "install": {
      "npmSpec": "@openclaw/nextcloud-talk",
      "localPath": "<bundled-plugin-local-path>",
      "defaultChoice": "npm"
    }
  }
}

• detailLabel: تسمية ثانوية لأسطح كتالوج/حالة أغنى
• docsLabel: تجاوز نص الرابط لرابط الوثائق
• preferOver: معرّفات Plugin/قناة ذات أولوية أدنى يجب أن يتفوق عليها إدخال الكتالوج هذا
• selectionDocsPrefix, selectionDocsOmitLabel, selectionExtras: عناصر تحكم في نص سطح الاختيار
• markdownCapable: يعلّم القناة بأنها قادرة على Markdown لقرارات تنسيق الرسائل الصادرة
• exposure.configured: إخفاء القناة من أسطح سرد القنوات المكوّنة عند ضبطه على false
• exposure.setup: إخفاء القناة من أدوات اختيار الإعداد/التكوين التفاعلية عند ضبطه على false
• exposure.docs: تعليم القناة بأنها داخلية/خاصة لأسطح تنقل الوثائق
• showConfigured / showInSetup: أسماء بديلة قديمة لا تزال مقبولة للتوافق؛ فضّل exposure
• quickstartAllowFrom: إدخال القناة في مسار البدء السريع القياسي allowFrom
• forceAccountBinding: طلب ربط حساب صريح حتى عندما يوجد حساب واحد فقط
• preferSessionLookupForAnnounceTarget: تفضيل البحث في الجلسة عند حل أهداف الإعلان

• ~/.openclaw/mpm/plugins.json
• ~/.openclaw/mpm/catalog.json
• ~/.openclaw/plugins/catalog.json

​

Plugins محرك السياق

import { buildMemorySystemPromptAddition } from "openclaw/plugin-sdk/core";

export default function (api) {
  api.registerContextEngine("lossless-claw", (ctx) => ({
    info: { id: "lossless-claw", name: "Lossless Claw", ownsCompaction: true },
    async ingest() {
      return { ingested: true };
    },
    async assemble({ messages, availableTools, citationsMode }) {
      return {
        messages,
        estimatedTokens: 0,
        systemPromptAddition: buildMemorySystemPromptAddition({
          availableTools: availableTools ?? new Set(),
          citationsMode,
        }),
      };
    },
    async compact() {
      return { ok: true, compacted: false };
    },
  }));
}

import {
  buildMemorySystemPromptAddition,
  delegateCompactionToRuntime,
} from "openclaw/plugin-sdk/core";

export default function (api) {
  api.registerContextEngine("my-memory-engine", (ctx) => ({
    info: {
      id: "my-memory-engine",
      name: "My Memory Engine",
      ownsCompaction: false,
    },
    async ingest() {
      return { ingested: true };
    },
    async assemble({ messages, availableTools, citationsMode }) {
      return {
        messages,
        estimatedTokens: 0,
        systemPromptAddition: buildMemorySystemPromptAddition({
          availableTools: availableTools ?? new Set(),
          citationsMode,
        }),
      };
    },
    async compact(params) {
      return await delegateCompactionToRuntime(params);
    },
  }));
}

​

إضافة قدرة جديدة

1. عرّف عقد النواة قرر ما السلوك المشترك الذي يجب أن تملكه النواة: السياسة، والاحتياط، ودمج الإعدادات، ودورة الحياة، والدلالات المواجهة للقنوات، وشكل مساعد وقت التشغيل.
2. أضف أسطح تسجيل/وقت تشغيل PluginTyped وسّع OpenClawPluginApi و/أو api.runtime بأصغر سطح قدرة typed مفيد.
3. صِل مستهلكي النواة + القناة/الميزة يجب أن تستهلك القنوات وPlugins الميزات القدرة الجديدة عبر النواة، لا عبر استيراد تنفيذ مورّد مباشرة.
4. سجّل تنفيذات المورّدين تسجل Plugins المورّدين بعد ذلك واجهاتها الخلفية مقابل القدرة.
5. أضف تغطية العقد أضف اختبارات حتى يبقى شكل الملكية والتسجيل صريحًا بمرور الوقت.

​

قائمة تحقق القدرة

• أنواع عقد النواة في src/<capability>/types.ts
• مساعد مشغّل/وقت تشغيل النواة في src/<capability>/runtime.ts
• سطح تسجيل Plugin API في src/plugins/types.ts
• توصيل سجل Plugin في src/plugins/registry.ts
• تعريض وقت تشغيل Plugin في src/plugins/runtime/* عندما تحتاج Plugins الميزات/القنوات إلى استهلاكه
• مساعدات الالتقاط/الاختبار في src/test-utils/plugin-registration.ts
• تأكيدات الملكية/العقد في src/plugins/contracts/registry.ts
• وثائق المشغل/Plugin في docs/

​

قالب القدرة

// core contract
export type VideoGenerationProviderPlugin = {
  id: string;
  label: string;
  generateVideo: (req: VideoGenerationRequest) => Promise<VideoGenerationResult>;
};

// plugin API
api.registerVideoGenerationProvider({
  id: "openai",
  label: "OpenAI",
  async generateVideo(req) {
    return await generateOpenAiVideo(req);
  },
});

// shared runtime helper for feature/channel plugins
const clip = await api.runtime.videoGeneration.generate({
  prompt: "Show the robot walking through the lab.",
  cfg,
});

expect(findVideoGenerationProviderIdsForPlugin("openai")).toEqual(["openai"]);

• تملك النواة عقد القدرة + التنسيق
• تملك Plugins المورّدين تنفيذات المورّدين
• تستهلك Plugins الميزات/القنوات مساعدات وقت التشغيل
• تُبقي اختبارات العقد الملكية صريحة

​

ذات صلة

• بنية Plugin — نموذج القدرة العام وأشكاله
• مسارات فرعية لـ Plugin SDK
• إعداد Plugin SDK
• بناء Plugins