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

Documentation Index

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

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

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

​
إدخال Plugin

المسار الفرعيالصادرات الرئيسية
plugin-sdk/plugin-entrydefinePluginEntry
plugin-sdk/coredefineChannelPluginEntry, createChatChannelPlugin, createChannelPluginBase, defineSetupPluginEntry, buildChannelConfigSchema, buildJsonChannelConfigSchema
plugin-sdk/config-schemaOpenClawSchema
plugin-sdk/provider-entrydefineSingleProviderPluginEntry
plugin-sdk/migrationمساعدات عناصر مزوّد الترحيل مثل createMigrationItem، وثوابت الأسباب، ومؤشرات حالة العناصر، ومساعدات التنقيح، وsummarizeMigrationItems
plugin-sdk/migration-runtimeمساعدات ترحيل وقت التشغيل مثل copyMigrationFileItem، وwithCachedMigrationConfigRuntime، وwriteMigrationReport

​
مساعدات التوافق والاختبار المهملة

تبقى هذه المسارات الفرعية صادرات حزمة من أجل Plugins الأقدم ومجموعات اختبارات OpenClaw، لكن يجب ألا تضيف الشيفرة الجديدة عمليات استيراد منها: agent-runtime-test-contracts, channel-contract-testing, channel-target-testing, channel-test-helpers, plugin-test-api, plugin-test-contracts, provider-http-test-mocks, provider-test-contracts, test-env, test-fixtures, test-node-mocks, testing, channel-runtime, compat, config-types, infra-runtime, text-runtime, وzod. استورد zod مباشرة من zod في شيفرة Plugin الجديدة. لا يزال plugin-test-runtime مسارًا فرعيًا مساعدًا نشطًا ومركّزًا للاختبار.

​
المسارات الفرعية العامة المهملة غير المستخدمة

وُجدت هذه المسارات الفرعية العامة لمدة شهر واحد على الأقل ولا تحتوي حاليًا على عمليات استيراد إنتاجية من الإضافات المضمّنة. تبقى قابلة للاستيراد من أجل التوافق، لكن يجب أن تستخدم شيفرة Plugin الجديدة مسارات SDK فرعية مركّزة ومستهلكة بفعالية بدلًا منها: agent-config-primitives, channel-config-schema-legacy, channel-reply-pipeline, channel-runtime, channel-secret-runtime, command-auth, compat, config-runtime, config-schema, discord, group-access, infra-runtime, matrix, mattermost, media-generation-runtime-shared, memory-core-engine-runtime, memory-core-host-multimodal, memory-core-host-query, music-generation-core, self-hosted-provider-setup, telegram-account, telegram-command-config, وzalouser.

​
المسارات الفرعية العامة النادرة المهملة

المسارات الفرعية العامة المستخدمة حاليًا من قِبل مالك أو مالكين فقط من مالكي Plugin المضمّنة مهملة أيضًا لشيفرة Plugin الجديدة. تبقى صادرات حزمة من أجل التوافق، لكن يجب أن تفضّل الشيفرة الجديدة وصلات SDK المشتركة النشطة أو APIs الحزم المملوكة من Plugin. يتتبع المشرفون المجموعة الدقيقة في scripts/lib/plugin-sdk-deprecated-public-subpaths.json والميزانية الحالية باستخدام pnpm plugin-sdk:surface.

​
البراميل الواسعة المهملة

تبقى براميل إعادة التصدير الواسعة هذه قابلة للبناء لمصدر OpenClaw وفحوصات التوافق، لكن يجب أن تفضّل الشيفرة الجديدة مسارات SDK فرعية مركّزة: agent-runtime, channel-lifecycle, channel-runtime, cli-runtime, compat, config-types, conversation-runtime, hook-runtime, infra-runtime, media-runtime, plugin-runtime, security-runtime, و text-runtime. تبقى channel-runtime, وcompat, وconfig-types, وinfra-runtime, وtext-runtime صادرات حزمة فقط للتوافق مع الإصدارات السابقة؛ استخدم بدلًا منها مسارات channel/runtime الفرعية المركّزة، وconfig-contracts, وstring-coerce-runtime, وtext-chunking, وtext-utility-runtime, وlogging-core.
المسار الفرعيالتصديرات الأساسية
plugin-sdk/channel-coredefineChannelPluginEntry, defineSetupPluginEntry, createChatChannelPlugin, createChannelPluginBase
plugin-sdk/config-schemaتصدير مخطط Zod الجذري openclaw.json (OpenClawSchema)
plugin-sdk/json-schema-runtimeمساعد تحقق JSON Schema مخزن مؤقتا للمخططات المملوكة للـ Plugin
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-runtimeاسم مستعار مهمل للتوافق؛ استخدم plugin-sdk/setup-runtime
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/access-groupsمساعدات تحليل قائمة سماح مجموعة الوصول وتشخيصات المجموعات المنقحة
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-ingressواجهة توافق مهملة ومنخفضة المستوى لدخول القنوات. يجب أن تستخدم مسارات الاستقبال الجديدة plugin-sdk/channel-ingress-runtime.
plugin-sdk/channel-ingress-runtimeمحلل وقت تشغيل تجريبي وعالي المستوى لدخول القنوات ومنشئو حقائق المسار لمسارات استقبال القنوات المرحلة. فضّل هذا على تجميع قوائم السماح الفعالة، وقوائم سماح الأوامر، والإسقاطات القديمة في كل Plugin. راجع واجهة برمجة تطبيقات دخول القنوات.
plugin-sdk/channel-lifecyclecreateAccountStatusSink, createChannelRunQueue، ومساعدات دورة حياة تدفق المسودة القديمة. يجب أن تستخدم شيفرة إنهاء المعاينة الجديدة plugin-sdk/channel-message.
plugin-sdk/channel-messageمساعدات عقد دورة حياة الرسائل الخفيفة مثل defineChannelMessageAdapter, createChannelMessageAdapterFromOutbound, createChannelMessageReplyPipeline, createReplyPrefixContext, resolveChannelMessageSourceReplyDeliveryMode، واشتقاق إمكانية الإنهاء الدائم، ومساعدات إثبات الإمكانات لإمكانات الإرسال/الإيصال/الأثر الجانبي، وMessageReceiveContext، وإثباتات سياسة إقرار الاستلام، وdefineFinalizableLivePreviewAdapter, deliverWithFinalizableLivePreviewAdapter، وإثباتات إمكانات المعاينة الحية والمنهي الحي، وحالة الاسترداد الدائمة، وRenderedMessageBatch، وأنواع إيصال الرسائل، ومساعدات معرّف الإيصال. راجع واجهة برمجة تطبيقات رسائل القناة. واجهات إرسال الردود القديمة مخصصة للتوافق المهمل فقط.
plugin-sdk/channel-message-runtimeمساعدات تسليم وقت التشغيل التي قد تحمّل التسليم الصادر، بما في ذلك deliverInboundReplyWithMessageSendContext, sendDurableMessageBatch, وwithDurableMessageSendContext. تبقى جسور إرسال الردود المهملة قابلة للاستيراد لمرسلات التوافق فقط. استخدمها من وحدات وقت تشغيل المراقبة/الإرسال، وليس من ملفات تمهيد Plugin الساخنة.
plugin-sdk/inbound-envelopeمساعدات مشتركة لبناء المسار الوارد + الغلاف
plugin-sdk/inbound-reply-dispatchمساعدات مشتركة قديمة للتسجيل والإرسال الوارد، ومسندات الإرسال المرئية/النهائية، وتوافق deliverDurableInboundReplyPayload المهمل لمرسلات القنوات المحضّرة. يجب أن تستورد شيفرة استقبال/إرسال القناة الجديدة مساعدات دورة حياة وقت التشغيل من plugin-sdk/channel-message-runtime.
plugin-sdk/messaging-targetsمساعدات تحليل/مطابقة الهدف
plugin-sdk/outbound-mediaمساعدات مشتركة لتحميل الوسائط الصادرة
plugin-sdk/outbound-send-depsبحث خفيف عن تبعيات الإرسال الصادر لمهايئات القنوات
plugin-sdk/outbound-runtimeمساعدات الهوية الصادرة، ومفوّض الإرسال، والجلسة، والتنسيق، وتخطيط الحمولة. مساعدات التسليم المباشر مثل deliverOutboundPayloads هي طبقة توافق أساسية مهملة؛ استخدم plugin-sdk/channel-message-runtime لمسارات الإرسال الجديدة.
plugin-sdk/poll-runtimeمساعدات محدودة لتطبيع الاستطلاعات
plugin-sdk/thread-bindings-runtimeمساعدات دورة حياة ربط السلاسل والمهايئ
plugin-sdk/agent-media-payloadمنشئ حمولة وسائط الوكيل القديم
plugin-sdk/conversation-runtimeمساعدات ربط المحادثة/السلسلة، والاقتران، والربط المهيأ
plugin-sdk/runtime-config-snapshotمساعد لقطة إعدادات وقت التشغيل
plugin-sdk/runtime-group-policyمساعدات حل سياسة المجموعة في وقت التشغيل
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مساعدات مشتركة لمصادقة/حراسة الرسائل المباشرة
plugin-sdk/discordواجهة توافق Discord مهملة لـ @openclaw/discord@2026.3.13 المنشورة وتوافق المالك المتتبع؛ يجب أن تستخدم Plugins الجديدة المسارات الفرعية العامة لـ SDK القنوات
plugin-sdk/telegram-accountواجهة توافق Telegram مهملة لحل الحسابات من أجل توافق المالك المتتبع؛ يجب أن تستخدم Plugins الجديدة مساعدات وقت التشغيل المحقونة أو المسارات الفرعية العامة لـ 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مساعدات محدودة لسياسة الإشارات، وعلامة الإشارة، ونص الإشارة دون سطح وقت التشغيل الوارد الأوسع
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 في وقت التشغيل لـ Plugins المزوّدين
plugin-sdk/provider-auth-api-keyمساعدات الإلحاق/كتابة ملف التعريف لمفتاح API مثل upsertApiKeyProfile
plugin-sdk/provider-auth-resultمنشئ نتيجة مصادقة OAuth القياسي
plugin-sdk/provider-env-varsمساعدات البحث عن متغيرات بيئة مصادقة المزوّد
plugin-sdk/provider-authcreateProviderApiKeyAuthMethod, ensureApiKeyFromOptionEnvOrPrompt, upsertAuthProfile, upsertApiKeyProfile, writeOAuthCredentials, تصدير توافق مهمل resolveOpenClawAgentDir
plugin-sdk/provider-model-sharedProviderReplayFamily, buildProviderReplayFamilyHooks, normalizeModelCompat, منشئات سياسة إعادة التشغيل المشتركة، ومساعدات نقطة نهاية المزوّد، ومساعدات تطبيع معرّف النموذج المشتركة
plugin-sdk/provider-catalog-runtimeخطاف وقت تشغيل تعزيز كتالوج المزوّد وواجهات سجل Plugin-المزوّد لاختبارات العقد
plugin-sdk/provider-catalog-sharedfindCatalogTemplate, buildSingleProviderApiKeyCatalog, buildManifestModelProviderConfig, supportsNativeStreamingUsageCompat, applyProviderNativeStreamingUsageCompat
plugin-sdk/provider-httpمساعدات قدرات HTTP/نقاط النهاية العامة للمزوّد، وأخطاء HTTP للمزوّد، ومساعدات نماذج multipart لنسخ الصوت
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 + التشخيصات
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/map/cache المحلية للعملية
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/الجسم الخام
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مساعدات مشتركة لأوامر وخطافات وHTTP والتفاعل الخاصة بـ Plugin
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، وأخطاء بروتوكول Gateway، ومساعدات تصحيح حالة القناة
plugin-sdk/config-contractsسطح إعداد يركز على الأنواع فقط لأشكال إعداد 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اكتشاف الربط التلقائي لمراجع الملفات من دون حزمة النصوص الواسعة
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مساعدات تطبيع المعرّفات النصية/السلاسل
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؛ استخدم واجهة API العامة لـ Plugin الخاصة بـ 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 لوقت التشغيل مدرك للموزّع من دون استيرادات الوكيل/guarded-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-mimeتطبيع MIME محدود، وربط امتدادات الملفات، واكتشاف MIME، ومساعدات نوع الوسائط
plugin-sdk/media-storeمساعدات محدودة لمخزن الوسائط مثل saveMediaBuffer
plugin-sdk/media-generation-runtimeمساعدات مشتركة للتجاوز عند فشل إنشاء الوسائط، واختيار المرشحين، ورسائل النموذج المفقود
plugin-sdk/media-understandingأنواع مزودي فهم الوسائط بالإضافة إلى صادرات مساعدات الصور/الصوت/الاستخراج المنظم الموجهة للمزود
plugin-sdk/text-chunkingمساعدات تقسيم/عرض النصوص و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اسم توافق بديل مهمل؛ استخدم plugin-sdk/webhook-ingress
plugin-sdk/web-mediaمساعدات مشتركة لتحميل الوسائط البعيدة/المحلية
plugin-sdk/zodإعادة تصدير توافق مهملة؛ استورد zod من zod مباشرة
plugin-sdk/testingحاوية توافق مهملة محلية للمستودع لاختبارات OpenClaw القديمة. يجب أن تستورد اختبارات المستودع الجديدة مسارات اختبار محلية مركزة مثل 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تجهيزات عقود محول agent-runtime الأصلية المحلية للمستودع لاختبارات المصادقة، والتسليم، والاحتياط، وخطاف الأدوات، وتراكب الموجه، والمخطط، وإسقاط النص
plugin-sdk/channel-test-helpersمساعدات اختبار موجهة للقنوات ومحلية للمستودع لعقود الإجراءات/الإعداد/الحالة العامة، وتأكيدات الأدلة، ودورة حياة بدء الحساب، وترابط إعدادات الإرسال، ومحاكيات وقت التشغيل، ومشكلات الحالة، والتسليم الصادر، وتسجيل الخطافات
plugin-sdk/channel-target-testingمجموعة مشتركة محلية للمستودع لحالات أخطاء حل الأهداف لاختبارات القنوات
plugin-sdk/plugin-test-contractsمساعدات محلية للمستودع لعقود حزمة Plugin، والتسجيل، والأثر العام، والاستيراد المباشر، وواجهة برمجة تطبيقات وقت التشغيل، والآثار الجانبية للاستيراد
plugin-sdk/provider-test-contractsمساعدات محلية للمستودع لعقود وقت تشغيل المزود، والمصادقة، والاكتشاف، والإعداد، والفهرس، والمعالج، وقدرة الوسائط، وسياسة إعادة التشغيل، وSTT للصوت الحي في الوقت الفعلي، والبحث/الجلب عبر الويب، والبث
plugin-sdk/provider-http-test-mocksمحاكيات HTTP/المصادقة اختيارية ومحلية للمستودع في Vitest لاختبارات المزود التي تمرن plugin-sdk/provider-http
plugin-sdk/test-fixturesتجهيزات محلية للمستودع لالتقاط وقت تشغيل CLI عام، وسياق sandbox، وكاتب skill، ورسالة الوكيل، وحدث النظام، وإعادة تحميل الوحدة، ومسار 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-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-core-host-runtime-files
plugin-sdk/memory-host-markdownمساعدات managed-markdown مشتركة للـ plugins المجاورة للذاكرة
plugin-sdk/memory-host-searchواجهة وقت تشغيل Active Memory للوصول إلى مدير البحث
plugin-sdk/memory-host-statusاسم توافق بديل مهمل؛ استخدم plugin-sdk/memory-core-host-status
لا توجد حاليا مسارات فرعية محجوزة لـ SDK للمساعدات المضمنة. توجد المساعدات الخاصة بالمالك داخل حزمة Plugin المالكة، بينما تستخدم عقود المضيف القابلة لإعادة الاستخدام مسارات SDK فرعية عامة مثل plugin-sdk/gateway-runtime، وplugin-sdk/security-runtime، وplugin-sdk/plugin-config-runtime.

​
ذات صلة