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

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.

يُعرَض SDK الخاص بـ Plugin كمجموعة من المسارات الفرعية الضيقة ضمن openclaw/plugin-sdk/. تسرد هذه الصفحة المسارات الفرعية شائعة الاستخدام مجمّعة حسب الغرض. توجد القائمة الكاملة المولّدة التي تضم أكثر من 200 مسار فرعي في scripts/lib/plugin-sdk-entrypoints.json؛ وتظهر هناك المسارات الفرعية المحجوزة لمساعدي Plugin المضمّنة، لكنها تُعدّ تفاصيل تنفيذية ما لم تُبرزها صفحة توثيق صراحة. يمكن للمشرفين تدقيق المسارات الفرعية النشطة المحجوزة للمساعدين باستخدام pnpm plugins:boundary-report:summary؛ وتفشل تصديرات المساعدين المحجوزة غير المستخدمة في تقرير CI بدلاً من بقائها في SDK العام كدَين توافق كامن. لدليل تأليف Plugin، راجع نظرة عامة على SDK الخاص بـ Plugin.

​
مدخل Plugin

المسار الفرعيالتصديرات الرئيسية
plugin-sdk/plugin-entrydefinePluginEntry
plugin-sdk/coredefineChannelPluginEntry, createChatChannelPlugin, createChannelPluginBase, defineSetupPluginEntry, buildChannelConfigSchema, buildJsonChannelConfigSchema
plugin-sdk/config-schemaOpenClawSchema
plugin-sdk/provider-entrydefineSingleProviderPluginEntry
plugin-sdk/testingتجميعة توافق واسعة لاختبارات Plugin القديمة؛ فضّل المسارات الفرعية المركّزة للاختبارات في اختبارات Plugin الجديدة
plugin-sdk/plugin-test-apiمنشئ محاكاة OpenClawPluginApi حدّ أدنى لاختبارات الوحدة المباشرة لتسجيل Plugin
plugin-sdk/agent-runtime-test-contractsأدوات اختبار عقود محوّل وقت تشغيل الوكيل الأصلي لملفات تعريف المصادقة، ومنع التسليم، وتصنيف الرجوع الاحتياطي، وخطافات الأدوات، وتراكبات الموجّه، والمخططات، وإصلاح النص
plugin-sdk/channel-test-helpersمساعدو اختبارات دورة حياة حساب القناة، والدليل، وإعداد الإرسال، ومحاكاة وقت التشغيل، والخطاف، ومدخل القناة المضمّنة، والطابع الزمني للغلاف، ورد الاقتران، وعقد القناة العام
plugin-sdk/channel-target-testingحزمة اختبارات مشتركة لحالات أخطاء حلّ هدف القناة
plugin-sdk/plugin-test-contractsمساعدو عقود تسجيل Plugin، وبيان الحزمة، والأثر العام، وواجهة برمجة وقت التشغيل، والأثر الجانبي للاستيراد، والاستيراد المباشر
plugin-sdk/plugin-test-runtimeأدوات اختبار وقت تشغيل Plugin، والسجل، وتسجيل المزوّد، ومعالج الإعداد، وتدفق المهام في وقت التشغيل للاختبارات
plugin-sdk/provider-test-contractsمساعدو عقود وقت تشغيل المزوّد، والمصادقة، والاكتشاف، والتهيئة، والفهرس، وإمكانات الوسائط، وسياسة إعادة التشغيل، والصوت الحي لـ STT في الزمن الفعلي، والبحث/الجلب عبر الويب، والمعالج
plugin-sdk/provider-http-test-mocksمحاكيات HTTP/المصادقة الاختيارية في Vitest لاختبارات المزوّد التي تمرّن plugin-sdk/provider-http
plugin-sdk/test-envأدوات اختبار بيئة الاختبار، والجلب/الشبكة، وخادم HTTP القابل للتخلص منه، والطلب الوارد، والاختبار الحي، ونظام الملفات المؤقت، والتحكم بالوقت
plugin-sdk/test-fixturesأدوات اختبار عامة لـ CLI، وصندوق العزل، والمهارة، ورسالة الوكيل، وحدث النظام، وإعادة تحميل الوحدة، ومسار Plugin المضمّن، والطرفية، والتقسيم إلى مقاطع، ورمز المصادقة، والحالة ذات الأنواع
plugin-sdk/test-node-mocksمساعدو محاكاة مركّزون للمدمج في Node للاستخدام داخل مصانع Vitest vi.mock("node:*")
plugin-sdk/migrationمساعدو عناصر مزوّد الترحيل مثل createMigrationItem، وثوابت السبب، وعلامات حالة العنصر، ومساعدي التنقيح، وsummarizeMigrationItems
plugin-sdk/migration-runtimeمساعدو ترحيل وقت التشغيل مثل copyMigrationFileItem، وwithCachedMigrationConfigRuntime، وwriteMigrationReport
المسار الفرعيالصادرات الرئيسية
plugin-sdk/channel-coredefineChannelPluginEntry, defineSetupPluginEntry, createChatChannelPlugin, createChannelPluginBase
plugin-sdk/config-schemaتصدير مخطط Zod الجذري لـ openclaw.json (OpenClawSchema)
plugin-sdk/channel-setupcreateOptionalChannelSetupSurface, createOptionalChannelSetupAdapter, createOptionalChannelSetupWizard، بالإضافة إلى DEFAULT_ACCOUNT_ID, createTopLevelChannelDmPolicy, setSetupChannelEnabled, splitSetupEntries
plugin-sdk/setupمساعدات معالج الإعداد المشتركة، ومطالبات قائمة السماح، وبناة حالة الإعداد
plugin-sdk/setup-runtimecreatePatchedAccountSetupAdapter, createEnvPatchedAccountSetupAdapter, createSetupInputPresenceValidator, noteChannelLookupFailure, noteChannelLookupSummary, promptResolvedAllowFrom, splitSetupEntries, createAllowlistSetupWizardProxy, createDelegatedSetupWizardProxy
plugin-sdk/setup-adapter-runtimecreateEnvPatchedAccountSetupAdapter
plugin-sdk/setup-toolsformatCliCommand, detectBinary, extractArchive, resolveBrewExecutable, formatDocsLink, CONFIG_DIR
plugin-sdk/account-coreمساعدات تهيئة/بوابة إجراءات الحسابات المتعددة، ومساعدات الرجوع إلى الحساب الافتراضي
plugin-sdk/account-idDEFAULT_ACCOUNT_ID، ومساعدات تطبيع معرف الحساب
plugin-sdk/account-resolutionمساعدات البحث عن الحساب + الرجوع الافتراضي
plugin-sdk/account-helpersمساعدات محدودة لقائمة الحسابات/إجراءات الحساب
plugin-sdk/channel-pairingcreateChannelPairingController
plugin-sdk/channel-reply-pipelineمساعدات مسار الرد القديمة. يجب أن تستخدم شيفرة مسار ردود القنوات الجديدة createChannelMessageReplyPipeline وresolveChannelMessageSourceReplyDeliveryMode من plugin-sdk/channel-message.
plugin-sdk/channel-config-helperscreateHybridChannelConfigAdapter, resolveChannelDmAccess, resolveChannelDmAllowFrom, resolveChannelDmPolicy, normalizeChannelDmPolicy, normalizeLegacyDmAliases
plugin-sdk/channel-config-schemaأوليات مخطط تهيئة القنوات المشتركة بالإضافة إلى بناة Zod وJSON/TypeBox المباشرين
plugin-sdk/bundled-channel-config-schemaمخططات تهيئة قنوات OpenClaw المضمّنة للـ Plugins المضمّنة المُصانة فقط
plugin-sdk/channel-config-schema-legacyاسم توافق بديل مهمل لمخططات تهيئة القنوات المضمّنة
plugin-sdk/telegram-command-configمساعدات تطبيع/تحقق الأوامر المخصصة في Telegram مع رجوع إلى العقد المضمّن
plugin-sdk/command-gatingمساعدات محدودة لبوابة تفويض الأوامر
plugin-sdk/channel-policyresolveChannelGroupRequireMention
plugin-sdk/channel-lifecyclecreateAccountStatusSink, createChannelRunQueue، ومساعدات دورة حياة دفق المسودات القديمة. يجب أن تستخدم شيفرة إنهاء المعاينة الجديدة plugin-sdk/channel-message.
plugin-sdk/channel-messageمساعدات عقود دورة حياة الرسائل منخفضة التكلفة مثل defineChannelMessageAdapter, createChannelMessageAdapterFromOutbound, createReplyPrefixContext, resolveChannelMessageSourceReplyDeliveryMode، وواجهات التوافق، واشتقاق قابلية الإنهاء الدائم، ومساعدات إثبات القابلية لقدرات الإرسال/الإيصال/الأثر الجانبي، وMessageReceiveContext، وإثباتات سياسة إقرار الاستلام، وdefineFinalizableLivePreviewAdapter, deliverWithFinalizableLivePreviewAdapter، وإثباتات قابلية المعاينة الحية والمُنهي الحي، وحالة الاسترداد الدائم، وRenderedMessageBatch، وأنواع إيصالات الرسائل، ومساعدات معرف الإيصال. راجع واجهة برمجة تطبيقات رسائل القنوات. يبقى createChannelTurnReplyPipeline القديم لموزعات التوافق فقط.
plugin-sdk/channel-message-runtimeمساعدات تسليم Runtime قد تحمّل التسليم الصادر، بما في ذلك deliverInboundReplyWithMessageSendContext, sendDurableMessageBatch, withDurableMessageSendContext, dispatchChannelMessageReplyWithBase، وrecordChannelMessageReplyDispatch. استخدمها من وحدات Runtime للمراقبة/الإرسال، وليس من ملفات تمهيد Plugin الساخنة.
plugin-sdk/inbound-envelopeمساعدات مشتركة لبناء المسار الوارد + المغلف
plugin-sdk/inbound-reply-dispatchمساعدات قديمة مشتركة للتسجيل الوارد والتوزيع، ومسندات التوزيع المرئي/النهائي، وتوافق deliverDurableInboundReplyPayload المهمل لموزعات القنوات المُحضّرة. يجب أن تستورد شيفرة استقبال/توزيع القنوات الجديدة مساعدات دورة حياة Runtime من plugin-sdk/channel-message-runtime.
plugin-sdk/messaging-targetsمساعدات تحليل/مطابقة الأهداف
plugin-sdk/outbound-mediaمساعدات مشتركة لتحميل الوسائط الصادرة
plugin-sdk/outbound-send-depsبحث خفيف عن تبعيات الإرسال الصادر لمحولات القنوات
plugin-sdk/outbound-runtimeمساعدات التسليم الصادر، والهوية، ومفوّض الإرسال، والجلسة، والتنسيق، وتخطيط الحمولة
plugin-sdk/poll-runtimeمساعدات محدودة لتطبيع الاستطلاعات
plugin-sdk/thread-bindings-runtimeمساعدات دورة حياة ربط سلاسل المحادثة والمحولات
plugin-sdk/agent-media-payloadباني حمولة وسائط الوكيل القديم
plugin-sdk/conversation-runtimeمساعدات ربط المحادثة/سلسلة المحادثة، والإقران، والربط المهيأ
plugin-sdk/runtime-config-snapshotمساعد لقطة تهيئة Runtime
plugin-sdk/runtime-group-policyمساعدات حل سياسة المجموعات في Runtime
plugin-sdk/channel-statusمساعدات مشتركة للقطات/ملخصات حالة القنوات
plugin-sdk/channel-config-primitivesأوليات محدودة لمخطط تهيئة القنوات
plugin-sdk/channel-config-writesمساعدات تفويض كتابة تهيئة القنوات
plugin-sdk/channel-plugin-commonصادرات تمهيدية مشتركة لـ Plugin القنوات
plugin-sdk/allowlist-config-editمساعدات تعديل/قراءة تهيئة قائمة السماح
plugin-sdk/group-accessمساعدات مشتركة لقرار الوصول إلى المجموعات
plugin-sdk/direct-dmمساعدات مشتركة لمصادقة/حراسة الرسائل المباشرة DM
plugin-sdk/discordواجهة توافق Discord مهملة للحزمة المنشورة @openclaw/discord@2026.3.13 وتوافق المالك المتتبّع؛ يجب أن تستخدم Plugins الجديدة المسارات الفرعية العامة لـ SDK القنوات
plugin-sdk/telegram-accountواجهة توافق مهملة لحل حسابات Telegram لتوافق المالك المتتبّع؛ يجب أن تستخدم Plugins الجديدة مساعدات Runtime المحقونة أو المسارات الفرعية العامة لـ SDK القنوات
plugin-sdk/zalouserواجهة توافق Zalo Personal مهملة لحزم Lark/Zalo المنشورة التي لا تزال تستورد تفويض أوامر المرسل؛ يجب أن تستخدم Plugins الجديدة plugin-sdk/command-auth
plugin-sdk/interactive-runtimeعرض الرسائل الدلالي، والتسليم، ومساعدات الرد التفاعلي القديمة. راجع عرض الرسائل
plugin-sdk/channel-inboundحاوية توافق لإزالة تكرار الوارد، ومطابقة الإشارات، ومساعدات سياسة الإشارة، ومساعدات المغلفات
plugin-sdk/channel-inbound-debounceمساعدات محدودة لإزالة تكرار الوارد
plugin-sdk/channel-mention-gatingمساعدات محدودة لسياسة الإشارة، وعلامة الإشارة، ونص الإشارة دون سطح Runtime الوارد الأوسع
plugin-sdk/channel-envelopeمساعدات محدودة لتنسيق المغلف الوارد
plugin-sdk/channel-locationمساعدات سياق موقع القناة وتنسيقه
plugin-sdk/channel-loggingمساعدات تسجيل القنوات للإسقاطات الواردة وإخفاقات الكتابة/الإقرار
plugin-sdk/channel-send-resultأنواع نتائج الرد
plugin-sdk/channel-actionsمساعدات إجراءات رسائل القنوات، بالإضافة إلى مساعدات المخطط الأصلي المهملة المحفوظة لتوافق Plugin
plugin-sdk/channel-routeمساعدات مشتركة لتطبيع المسارات، وحل الأهداف المدفوع بالمحلل، وتحويل معرف سلسلة المحادثة إلى سلسلة نصية، ومفاتيح المسار لإزالة التكرار/الضغط، وأنواع الأهداف المحللة، ومساعدات مقارنة المسارات/الأهداف
plugin-sdk/channel-targetsمساعدات تحليل الأهداف؛ يجب أن يستخدم مستدعو مقارنة المسارات plugin-sdk/channel-route
plugin-sdk/channel-contractأنواع عقود القنوات
plugin-sdk/channel-feedbackتوصيلات التعليقات/التفاعلات
plugin-sdk/channel-secret-runtimeمساعدات محدودة لعقود الأسرار مثل collectSimpleChannelFieldAssignments, getChannelSurface, pushAssignment، وأنواع أهداف الأسرار
المسار الفرعيالصادرات الرئيسية
plugin-sdk/provider-entrydefineSingleProviderPluginEntry
plugin-sdk/lmstudioواجهة موفّر LM Studio المدعومة للإعداد، واكتشاف الفهرس، وتحضير نموذج وقت التشغيل
plugin-sdk/lmstudio-runtimeواجهة وقت تشغيل LM Studio المدعومة لافتراضيات الخادم المحلي، واكتشاف النماذج، وترويسات الطلبات، ومساعدات النماذج المحمّلة
plugin-sdk/provider-setupمساعدات إعداد الموفّرات المحلية/ذاتية الاستضافة المنتقاة
plugin-sdk/self-hosted-provider-setupمساعدات إعداد موفّر ذاتي الاستضافة ومتوافق مع OpenAI ومركّزة
plugin-sdk/cli-backendافتراضيات خلفية CLI + ثوابت المراقب
plugin-sdk/provider-auth-runtimeمساعدات حل مفاتيح API وقت التشغيل لإضافات الموفّرات
plugin-sdk/provider-auth-api-keyمساعدات إعداد مفاتيح API وكتابة الملفات الشخصية مثل upsertApiKeyProfile
plugin-sdk/provider-auth-resultباني نتيجة مصادقة OAuth القياسي
plugin-sdk/provider-auth-loginمساعدات تسجيل الدخول التفاعلي المشتركة لإضافات الموفّرات
plugin-sdk/provider-env-varsمساعدات البحث عن متغيرات بيئة مصادقة الموفّر
plugin-sdk/provider-authcreateProviderApiKeyAuthMethod، وensureApiKeyFromOptionEnvOrPrompt، وupsertAuthProfile، وupsertApiKeyProfile، وwriteOAuthCredentials، وتصدير توافق resolveOpenClawAgentDir المهمل
plugin-sdk/provider-model-sharedProviderReplayFamily، وbuildProviderReplayFamilyHooks، وnormalizeModelCompat، وبُنّاة سياسة إعادة التشغيل المشتركة، ومساعدات نقطة نهاية الموفّر، ومساعدات تطبيع معرّف النموذج مثل normalizeNativeXaiModelId
plugin-sdk/provider-catalog-runtimeخطاف وقت تشغيل تعزيز فهرس الموفّر ودرزات سجل موفّر Plugin لاختبارات العقد
plugin-sdk/provider-catalog-sharedfindCatalogTemplate، وbuildSingleProviderApiKeyCatalog، وbuildManifestModelProviderConfig، وsupportsNativeStreamingUsageCompat، وapplyProviderNativeStreamingUsageCompat
plugin-sdk/provider-httpمساعدات عامة لقدرات HTTP/نقاط النهاية للموفّر، وأخطاء HTTP للموفّر، ومساعدات نماذج الأجزاء المتعددة لتفريغ الصوت نصيًا
plugin-sdk/provider-web-fetch-contractمساعدات عقد محدودة لتهيئة/اختيار جلب الويب مثل enablePluginInConfig وWebFetchProviderPlugin
plugin-sdk/provider-web-fetchمساعدات تسجيل/ذاكرة التخزين المؤقت لموفّر جلب الويب
plugin-sdk/provider-web-search-config-contractمساعدات محدودة لتهيئة/اعتمادات بحث الويب للموفّرات التي لا تحتاج إلى توصيل تمكين Plugin
plugin-sdk/provider-web-search-contractمساعدات عقد محدودة لتهيئة/اعتمادات بحث الويب مثل createWebSearchProviderContractFields، وenablePluginInConfig، وresolveProviderWebSearchPluginConfig، ومحدّدات/جالبات الاعتمادات محددة النطاق
plugin-sdk/provider-web-searchمساعدات تسجيل/ذاكرة التخزين المؤقت/وقت التشغيل لموفّر بحث الويب
plugin-sdk/provider-toolsProviderToolCompatFamily، وbuildProviderToolCompatFamilyHooks، وتنظيف مخطط Gemini + التشخيصات، ومساعدات توافق xAI مثل resolveXaiModelCompatPatch / applyXaiModelCompat
plugin-sdk/provider-usagefetchClaudeUsage وما شابه
plugin-sdk/provider-streamProviderStreamFamily، وbuildProviderStreamFamilyHooks، وcomposeProviderStreamWrappers، وأنواع مغلّفات التدفق، ومساعدات مغلّفات Anthropic/Bedrock/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot المشتركة
plugin-sdk/provider-transport-runtimeمساعدات نقل الموفّر الأصلية مثل الجلب المحمي، وتحويلات رسائل النقل، وتدفقات أحداث النقل القابلة للكتابة
plugin-sdk/provider-onboardمساعدات تصحيح تهيئة الإعداد
plugin-sdk/global-singletonمساعدات singleton/خريطة/ذاكرة تخزين مؤقت محلية للعملية
plugin-sdk/group-activationمساعدات محدودة لوضع تنشيط المجموعة وتحليل الأوامر
المسار الفرعيالصادرات الرئيسية
plugin-sdk/command-authresolveControlCommandGate، ومساعدات سجل الأوامر بما في ذلك تنسيق قائمة الوسيطات الديناميكية، ومساعدات تفويض المرسِل
plugin-sdk/command-statusبُنّاة رسائل الأوامر/المساعدة مثل buildCommandsMessagePaginated وbuildHelpMessage
plugin-sdk/approval-auth-runtimeمساعدات حل المعتمِد ومصادقة الإجراءات في المحادثة نفسها
plugin-sdk/approval-client-runtimeمساعدات ملفات/مرشحات موافقة التنفيذ الأصلية
plugin-sdk/approval-delivery-runtimeمحوّلات قدرات/تسليم الموافقة الأصلية
plugin-sdk/approval-gateway-runtimeمساعد مشترك لحل Gateway الموافقة
plugin-sdk/approval-handler-adapter-runtimeمساعدات خفيفة لتحميل محوّل الموافقة الأصلي لنقاط دخول القنوات الساخنة
plugin-sdk/approval-handler-runtimeمساعدات وقت تشغيل أوسع لمعالج الموافقة؛ فضّل درزات المحوّل/Gateway الأضيق عندما تكون كافية
plugin-sdk/approval-native-runtimeمساعدات هدف الموافقة الأصلي + ربط الحساب
plugin-sdk/approval-reply-runtimeمساعدات حمولة رد موافقة التنفيذ/Plugin
plugin-sdk/approval-runtimeمساعدات حمولة موافقة التنفيذ/Plugin، ومساعدات توجيه/وقت تشغيل الموافقة الأصلية، ومساعدات عرض الموافقة المنظّمة مثل formatApprovalDisplayPath
plugin-sdk/reply-dedupeمساعدات محدودة لإعادة ضبط إزالة تكرار الردود الواردة
plugin-sdk/channel-contract-testingمساعدات محدودة لاختبار عقد القناة بدون برميل الاختبار الواسع
plugin-sdk/command-auth-nativeمصادقة الأوامر الأصلية، وتنسيق قائمة الوسيطات الديناميكية، ومساعدات هدف الجلسة الأصلية
plugin-sdk/command-detectionمساعدات مشتركة لاكتشاف الأوامر
plugin-sdk/command-primitives-runtimeمسندات نص أوامر خفيفة لمسارات القنوات الساخنة
plugin-sdk/command-surfaceمساعدات تطبيع جسم الأمر وسطح الأمر
plugin-sdk/allow-fromformatAllowFromLowercase
plugin-sdk/channel-secret-runtimeمساعدات محدودة لجمع عقد الأسرار لأسطح أسرار القناة/Plugin
plugin-sdk/secret-ref-runtimeمساعدات محدودة لـ coerceSecretRef وكتابة SecretRef لتحليل عقد الأسرار/التهيئة
plugin-sdk/security-runtimeمساعدات مشتركة للثقة، وبوابة الرسائل المباشرة، والملفات/المسارات المحدودة بالجذر بما في ذلك عمليات الكتابة للإنشاء فقط، والاستبدال الذري المتزامن/غير المتزامن للملفات، وعمليات الكتابة المؤقتة الشقيقة، والرجوع الاحتياطي للنقل عبر الأجهزة، ومساعدات مخزن الملفات الخاصة، وحراس أصل الروابط الرمزية، والمحتوى الخارجي، وتنقيح النصوص الحساسة، ومقارنة الأسرار بزمن ثابت، ومساعدات جمع الأسرار
plugin-sdk/ssrf-policyمساعدات قائمة السماح للمضيف وسياسة SSRF للشبكات الخاصة
plugin-sdk/ssrf-dispatcherمساعدات محدودة للموزّع المثبّت بدون سطح وقت تشغيل البنية التحتية الواسع
plugin-sdk/ssrf-runtimeالموزّع المثبّت، والجلب المحمي من SSRF، وخطأ SSRF، ومساعدات سياسة SSRF
plugin-sdk/secret-inputمساعدات تحليل إدخال الأسرار
plugin-sdk/webhook-ingressمساعدات طلب/هدف Webhook وإكراه websocket/body الخام
plugin-sdk/webhook-request-guardsمساعدات حجم/مهلة جسم الطلب
المسار الفرعيالتصديرات الرئيسية
plugin-sdk/runtimeمساعدات واسعة لوقت التشغيل والتسجيل والنسخ الاحتياطي وتثبيت Plugin
plugin-sdk/runtime-envمساعدات محددة لبيئة وقت التشغيل والمسجل والمهلة وإعادة المحاولة والتراجع
plugin-sdk/browser-configواجهة إعدادات متصفح مدعومة للملف الشخصي/الإعدادات الافتراضية المطَبَّعة، وتحليل URL الخاص بـ CDP، ومساعدات مصادقة التحكم بالمتصفح
plugin-sdk/channel-runtime-contextمساعدات عامة لتسجيل سياق وقت تشغيل القناة والبحث عنه
plugin-sdk/matrixواجهة توافق Matrix مهملة لحزم قنوات الجهات الخارجية الأقدم؛ يجب أن تستورد Plugins الجديدة plugin-sdk/run-command مباشرة
plugin-sdk/mattermostواجهة توافق Mattermost مهملة لحزم قنوات الجهات الخارجية الأقدم؛ يجب أن تستورد Plugins الجديدة مسارات SDK الفرعية العامة مباشرة
plugin-sdk/runtime-storecreatePluginRuntimeStore
plugin-sdk/plugin-runtimeمساعدات مشتركة لأوامر Plugin والخطافات وHTTP والتفاعل
plugin-sdk/hook-runtimeمساعدات مشتركة لمسار Webhook/الخطافات الداخلية
plugin-sdk/lazy-runtimeمساعدات استيراد/ربط وقت التشغيل الكسول مثل createLazyRuntimeModule وcreateLazyRuntimeMethod وcreateLazyRuntimeSurface
plugin-sdk/process-runtimeمساعدات تنفيذ العمليات
plugin-sdk/cli-runtimeمساعدات تنسيق CLI والانتظار والإصدار واستدعاء الوسيطات ومجموعة الأوامر الكسولة
plugin-sdk/gateway-runtimeعميل Gateway، ومساعد بدء العميل الجاهز لحلقة الأحداث، وRPC عبر CLI للبوابة، وأخطاء بروتوكول Gateway، ومساعدات تصحيح حالة القناة
plugin-sdk/config-typesسطح إعدادات مخصص للأنواع فقط لأشكال إعدادات Plugin مثل OpenClawConfig وأنواع إعدادات القنوات/المزودين
plugin-sdk/plugin-config-runtimeمساعدات البحث عن إعدادات Plugin في وقت التشغيل مثل requireRuntimeConfig وresolvePluginConfigObject وresolveLivePluginConfigObject
plugin-sdk/config-mutationمساعدات تعديل الإعدادات ضمن معاملة مثل mutateConfigFile وreplaceConfigFile وlogConfigUpdated
plugin-sdk/runtime-config-snapshotمساعدات لقطة إعدادات العملية الحالية مثل getRuntimeConfig وgetRuntimeConfigSnapshot ومعيّنات لقطات الاختبار
plugin-sdk/telegram-command-configتطبيع اسم/وصف أمر Telegram وفحوصات التكرار/التعارض، حتى عندما يكون سطح عقد Telegram المضمّن غير متاح
plugin-sdk/text-autolink-runtimeكشف الربط التلقائي لمراجع الملفات بدون حزمة text-runtime الواسعة
plugin-sdk/approval-runtimeمساعدات الموافقة على التنفيذ/Plugin، وبناة قدرات الموافقة، ومساعدات المصادقة/الملف الشخصي، ومساعدات التوجيه/وقت التشغيل الأصلية، وتنسيق مسار عرض الموافقة المنظم
plugin-sdk/reply-runtimeمساعدات مشتركة لوقت تشغيل الوارد/الرد، والتقسيم، والإرسال، وHeartbeat، ومخطط الردود
plugin-sdk/reply-dispatch-runtimeمساعدات محددة لإرسال/إنهاء الرد وتسميات المحادثات
plugin-sdk/reply-historyمساعدات ومؤشرات مشتركة لتاريخ الردود ضمن نافذة قصيرة مثل buildHistoryContext وHISTORY_CONTEXT_MARKER وrecordPendingHistoryEntry وclearHistoryEntriesIfEnabled
plugin-sdk/reply-referencecreateReplyReferencePlanner
plugin-sdk/reply-chunkingمساعدات محددة لتقسيم النص/Markdown
plugin-sdk/session-store-runtimeمساعدات مسار مخزن الجلسات، ومفتاح الجلسة، ووقت التحديث، وتعديل المخزن
plugin-sdk/cron-store-runtimeمساعدات مسار/تحميل/حفظ مخزن Cron
plugin-sdk/state-pathsمساعدات مسارات دليل الحالة/OAuth
plugin-sdk/routingمساعدات توجيه/مفتاح جلسة/ربط حساب مثل resolveAgentRoute وbuildAgentSessionKey وresolveDefaultAgentBoundAccountId
plugin-sdk/status-helpersمساعدات مشتركة لملخص حالة القناة/الحساب، وإعدادات الحالة الافتراضية لوقت التشغيل، ومساعدات بيانات تعريف المشكلات
plugin-sdk/target-resolver-runtimeمساعدات مشتركة لحل الأهداف
plugin-sdk/string-normalization-runtimeمساعدات تطبيع slug/السلاسل النصية
plugin-sdk/request-urlاستخراج عناوين URL النصية من مدخلات شبيهة بـ fetch/request
plugin-sdk/run-commandمشغل أوامر موقّت مع نتائج stdout/stderr مطبّعة
plugin-sdk/param-readersقارئات مشتركة لمعاملات الأدوات/CLI
plugin-sdk/tool-payloadاستخراج الحمولات المطَبَّعة من كائنات نتائج الأدوات
plugin-sdk/tool-sendاستخراج حقول هدف الإرسال القانونية من وسيطات الأداة
plugin-sdk/temp-pathمساعدات مشتركة لمسارات التنزيل المؤقت ومساحات عمل مؤقتة آمنة خاصة
plugin-sdk/logging-coreمساعدات مسجل النظام الفرعي والتنقيح
plugin-sdk/markdown-table-runtimeمساعدات وضع جدول Markdown والتحويل
plugin-sdk/model-session-runtimeمساعدات تجاوز النموذج/الجلسة مثل applyModelOverrideToSessionEntry وresolveAgentMaxConcurrent
plugin-sdk/talk-config-runtimeمساعدات حل إعدادات مزود المحادثة
plugin-sdk/json-storeمساعدات صغيرة لقراءة/كتابة حالة JSON
plugin-sdk/file-lockمساعدات قفل ملفات قابلة لإعادة الدخول
plugin-sdk/persistent-dedupeمساعدات ذاكرة تخزين مؤقت لإزالة التكرار مدعومة بالقرص
plugin-sdk/acp-runtimeمساعدات وقت تشغيل/جلسة ACP وإرسال الردود
plugin-sdk/acp-runtime-backendمساعدات خفيفة لتسجيل خلفية ACP وإرسال الردود لـ Plugins المحمّلة عند بدء التشغيل
plugin-sdk/acp-binding-resolve-runtimeحل ربط ACP للقراءة فقط بدون استيرادات بدء دورة الحياة
plugin-sdk/agent-config-primitivesبدائيات محددة لمخطط إعدادات وقت تشغيل الوكيل
plugin-sdk/boolean-paramقارئ معامل منطقي مرن
plugin-sdk/dangerous-name-runtimeمساعدات حل مطابقة الأسماء الخطرة
plugin-sdk/device-bootstrapمساعدات تمهيد الجهاز ورموز الاقتران
plugin-sdk/extension-sharedبدائيات مشتركة لمساعدات القناة السلبية والحالة والوكيل المحيط
plugin-sdk/models-provider-runtimeمساعدات ردود أمر/مزود /models
plugin-sdk/skill-commands-runtimeمساعدات سرد أوامر Skills
plugin-sdk/native-command-registryمساعدات سجل الأوامر الأصلية/بنائها/تسلسلها
plugin-sdk/agent-harnessسطح تجريبي لـ Plugin موثوق لأدوات تسخير الوكيل منخفضة المستوى: أنواع التسخير، ومساعدات توجيه/إحباط التشغيل النشط، ومساعدات جسر أدوات OpenClaw، ومساعدات سياسة أدوات خطة وقت التشغيل، وتصنيف نتائج الطرفية، ومساعدات تنسيق/تفصيل تقدم الأداة، وأدوات نتائج المحاولة
plugin-sdk/provider-zai-endpointمساعدات كشف نقطة نهاية Z.AI
plugin-sdk/async-lock-runtimeمساعد قفل غير متزامن محلي للعملية لملفات حالة وقت التشغيل الصغيرة
plugin-sdk/channel-activity-runtimeمساعد قياسات نشاط القناة
plugin-sdk/concurrency-runtimeمساعد تزامن المهام غير المتزامنة المحدود
plugin-sdk/dedupe-runtimeمساعدات ذاكرة تخزين مؤقت لإزالة التكرار داخل الذاكرة
plugin-sdk/delivery-queue-runtimeمساعد تصريف التسليمات الصادرة المعلقة
plugin-sdk/file-access-runtimeمساعدات آمنة لمسارات الملفات المحلية ومصادر الوسائط
plugin-sdk/heartbeat-runtimeمساعدات حدث Heartbeat ورؤيته
plugin-sdk/number-runtimeمساعد تحويل رقمي
plugin-sdk/secure-random-runtimeمساعدات رموز/UUID آمنة
plugin-sdk/system-event-runtimeمساعدات طابور أحداث النظام
plugin-sdk/transport-ready-runtimeمساعد انتظار جاهزية النقل
plugin-sdk/infra-runtimeطبقة توافق مهملة؛ استخدم مسارات وقت التشغيل الفرعية المركزة أعلاه
plugin-sdk/collection-runtimeمساعدات صغيرة لذاكرة تخزين مؤقت محدودة
plugin-sdk/diagnostic-runtimeمساعدات علم التشخيص والحدث وسياق التتبع
plugin-sdk/error-runtimeمساعدات مخطط الأخطاء والتنسيق وتصنيف الأخطاء المشتركة، isApprovalNotFoundError
plugin-sdk/fetch-runtimeمساعدات fetch مغلّفة، ووكيل، وخيار EnvHttpProxyAgent، وبحث مثبّت
plugin-sdk/runtime-fetchfetch لوقت التشغيل مدرك للموزّع بدون استيرادات وكيل/fetch محمي
plugin-sdk/response-limit-runtimeقارئ محدود لجسم الاستجابة بدون سطح وقت تشغيل الوسائط الواسع
plugin-sdk/session-binding-runtimeحالة ربط المحادثة الحالية بدون توجيه الربط المكوّن أو مخازن الاقتران
plugin-sdk/session-store-runtimeمساعدات مخزن الجلسات بدون استيرادات واسعة لكتابات/صيانة الإعدادات
plugin-sdk/context-visibility-runtimeحل رؤية السياق وتصفية السياق التكميلي بدون استيرادات واسعة للإعدادات/الأمان
plugin-sdk/string-coerce-runtimeمساعدات محددة لإكراه وتطبيع السجلات/السلاسل النصية البدائية بدون استيرادات Markdown/التسجيل
plugin-sdk/host-runtimeمساعدات تطبيع اسم المضيف ومضيف SCP
plugin-sdk/retry-runtimeمساعدات إعدادات إعادة المحاولة ومشغل إعادة المحاولة
plugin-sdk/agent-runtimeمساعدات دليل/هوية/مساحة عمل الوكيل، بما في ذلك resolveAgentDir وresolveDefaultAgentDir وتصدير التوافق المهمل resolveOpenClawAgentDir
plugin-sdk/directory-runtimeاستعلام/إزالة تكرار دليل مدعوم بالإعدادات
plugin-sdk/keyed-async-queueKeyedAsyncQueue
المسار الفرعيالصادرات الرئيسية
plugin-sdk/media-runtimeمساعدات مشتركة لجلب/تحويل/تخزين الوسائط، واستكشاف أبعاد الفيديو المدعوم بـ ffprobe، وبناة حمولات الوسائط
plugin-sdk/media-storeمساعدات ضيقة لمخزن الوسائط مثل saveMediaBuffer
plugin-sdk/media-generation-runtimeمساعدات مشتركة للتجاوز عند فشل توليد الوسائط، واختيار المرشحين، ورسائل النماذج المفقودة
plugin-sdk/media-understandingأنواع موفري فهم الوسائط بالإضافة إلى صادرات مساعدات الصور/الصوت الموجهة إلى الموفرين
plugin-sdk/text-runtimeمساعدات مشتركة للنص/Markdown/التسجيل مثل تجريد النص المرئي للمساعد، ومساعدات عرض/تقطيع/جداول Markdown، ومساعدات التنقيح، ومساعدات وسوم التوجيه، وأدوات النص الآمن
plugin-sdk/text-chunkingمساعد لتقطيع النص الصادر
plugin-sdk/speechأنواع موفري الكلام بالإضافة إلى صادرات التوجيه، والسجل، والتحقق، وباني TTS المتوافق مع OpenAI، ومساعدات الكلام الموجهة إلى الموفرين
plugin-sdk/speech-coreأنواع موفري الكلام المشتركة، والسجل، والتوجيه، والتطبيع، وصادرات مساعدات الكلام
plugin-sdk/realtime-transcriptionأنواع موفري النسخ الفوري، ومساعدات السجل، ومساعد جلسات WebSocket المشترك
plugin-sdk/realtime-voiceأنواع موفري الصوت الفوري ومساعدات السجل
plugin-sdk/image-generationأنواع موفري توليد الصور بالإضافة إلى مساعدات أصول الصور/عناوين URL للبيانات وباني موفر الصور المتوافق مع OpenAI
plugin-sdk/image-generation-coreأنواع توليد الصور المشتركة، والتجاوز عند الفشل، والمصادقة، ومساعدات السجل
plugin-sdk/music-generationأنواع موفري/طلبات/نتائج توليد الموسيقى
plugin-sdk/music-generation-coreأنواع توليد الموسيقى المشتركة، ومساعدات التجاوز عند الفشل، والبحث عن الموفر، وتحليل مراجع النماذج
plugin-sdk/video-generationأنواع موفري/طلبات/نتائج توليد الفيديو
plugin-sdk/video-generation-coreأنواع توليد الفيديو المشتركة، ومساعدات التجاوز عند الفشل، والبحث عن الموفر، وتحليل مراجع النماذج
plugin-sdk/webhook-targetsسجل أهداف Webhook ومساعدات تثبيت المسارات
plugin-sdk/webhook-pathمساعدات تطبيع مسار Webhook
plugin-sdk/web-mediaمساعدات مشتركة لتحميل الوسائط البعيدة/المحلية
plugin-sdk/zodإعادة تصدير zod لمستهلكي SDK الخاص بالـ Plugin
plugin-sdk/testingتجميعة توافق واسعة لاختبارات الـ Plugin القديمة. يجب أن تستورد اختبارات الإضافات الجديدة مسارات فرعية مركزة من SDK مثل plugin-sdk/agent-runtime-test-contracts أو plugin-sdk/plugin-test-runtime أو plugin-sdk/channel-test-helpers أو plugin-sdk/test-env أو plugin-sdk/test-fixtures بدلا من ذلك
plugin-sdk/plugin-test-apiمساعد createTestPluginApi بالحد الأدنى لاختبارات الوحدة الخاصة بتسجيل الـ Plugin مباشرة من دون استيراد جسور مساعدات اختبار المستودع
plugin-sdk/agent-runtime-test-contractsتجهيزات عقود محول تشغيل الوكيل الأصلية لاختبارات المصادقة، والتسليم، والرجوع الاحتياطي، وخطافات الأدوات، وتراكب المطالبة، والمخطط، وإسقاط النص الحواري
plugin-sdk/channel-test-helpersمساعدات اختبار موجهة إلى القنوات لعقود الإجراءات/الإعداد/الحالة العامة، وتأكيدات الدليل، ودورة حياة بدء الحساب، وتسلسل إعدادات الإرسال، ومحاكيات وقت التشغيل، ومشكلات الحالة، والتسليم الصادر، وتسجيل الخطافات
plugin-sdk/channel-target-testingمجموعة مشتركة لحالات أخطاء حل الأهداف لاختبارات القنوات
plugin-sdk/plugin-test-contractsمساعدات عقود حزمة الـ Plugin، والتسجيل، والأثر العام، والاستيراد المباشر، وواجهة API وقت التشغيل، والآثار الجانبية للاستيراد
plugin-sdk/provider-test-contractsمساعدات عقود تشغيل الموفر، والمصادقة، والاكتشاف، والإعداد الأولي، والفهرس، والمعالج، وإمكانات الوسائط، وسياسة إعادة التشغيل، وSTT الصوت الحي الفوري، وبحث/جلب الويب، والبث
plugin-sdk/provider-http-test-mocksمحاكيات HTTP/المصادقة اختيارية في Vitest لاختبارات الموفرين التي تمرن plugin-sdk/provider-http
plugin-sdk/test-fixturesتجهيزات عامة لالتقاط وقت تشغيل CLI، وسياق صندوق الرمل، وكاتب Skills، ورسائل الوكيل، وأحداث النظام، وإعادة تحميل الوحدات، ومسار الـ Plugin المضمن، ونص الطرفية، والتقطيع، ورمز المصادقة، والحالات المكتوبة
plugin-sdk/test-node-mocksمساعدات محاكاة مركزة للمكونات المضمنة في Node للاستخدام داخل مصانع Vitest vi.mock("node:*")
المسار الفرعيالصادرات الرئيسية
plugin-sdk/memory-coreسطح مساعد memory-core مضمن لمساعدات المدير/الإعدادات/الملفات/CLI
plugin-sdk/memory-core-engine-runtimeواجهة وقت تشغيل لفهرس/بحث الذاكرة
plugin-sdk/memory-core-host-engine-foundationصادرات محرك أساس مضيف الذاكرة
plugin-sdk/memory-core-host-engine-embeddingsعقود تضمينات مضيف الذاكرة، والوصول إلى السجل، والموفر المحلي، ومساعدات الدُفعات/البعيد العامة
plugin-sdk/memory-core-host-engine-qmdصادرات محرك QMD لمضيف الذاكرة
plugin-sdk/memory-core-host-engine-storageصادرات محرك تخزين مضيف الذاكرة
plugin-sdk/memory-core-host-multimodalمساعدات مضيف الذاكرة متعدد الوسائط
plugin-sdk/memory-core-host-queryمساعدات استعلام مضيف الذاكرة
plugin-sdk/memory-core-host-secretمساعدات أسرار مضيف الذاكرة
plugin-sdk/memory-core-host-eventsمساعدات سجل أحداث مضيف الذاكرة
plugin-sdk/memory-core-host-statusمساعدات حالة مضيف الذاكرة
plugin-sdk/memory-core-host-runtime-cliمساعدات وقت تشغيل CLI لمضيف الذاكرة
plugin-sdk/memory-core-host-runtime-coreمساعدات وقت التشغيل الأساسية لمضيف الذاكرة
plugin-sdk/memory-core-host-runtime-filesمساعدات الملفات/وقت التشغيل لمضيف الذاكرة
plugin-sdk/memory-host-coreاسم بديل محايد للمورد لمساعدات وقت التشغيل الأساسية لمضيف الذاكرة
plugin-sdk/memory-host-eventsاسم بديل محايد للمورد لمساعدات سجل أحداث مضيف الذاكرة
plugin-sdk/memory-host-filesاسم بديل محايد للمورد لمساعدات الملفات/وقت التشغيل لمضيف الذاكرة
plugin-sdk/memory-host-markdownمساعدات Markdown مُدارة مشتركة للـ plugins المجاورة للذاكرة
plugin-sdk/memory-host-searchواجهة وقت تشغيل الذاكرة النشطة للوصول إلى مدير البحث
plugin-sdk/memory-host-statusاسم بديل محايد للمورد لمساعدات حالة مضيف الذاكرة
لا توجد حاليا مسارات فرعية محجوزة في SDK للمساعدات المضمنة. توجد المساعدات الخاصة بالمالك داخل حزمة الـ Plugin المالكة، بينما تستخدم عقود المضيف القابلة لإعادة الاستخدام مسارات فرعية عامة من SDK مثل plugin-sdk/gateway-runtime وplugin-sdk/security-runtime وplugin-sdk/plugin-config-runtime.

​
ذات صلة