Plugin SDK माइग्रेशन

OpenClaw ने व्यापक पश्च-संगतता परत को छोटे, केंद्रित इम्पोर्ट से निर्मित आधुनिक Plugin आर्किटेक्चर से बदल दिया। यदि आपका Plugin उस बदलाव से पहले का है, तो यह गाइड उसे वर्तमान अनुबंधों पर लाने में सहायता करती है।

क्या बदला

पहले कई अत्यधिक खुले इम्पोर्ट सरफ़ेस Plugin को एक ही एंट्री पॉइंट से लगभग किसी भी चीज़ तक पहुँचने देते थे:

• openclaw/plugin-sdk और openclaw/plugin-sdk/compat - केंद्रित SDK बनाए जाने के दौरान दर्जनों हेल्पर को पुनः एक्सपोर्ट करते थे। अब दोनों रूट हटा दिए गए हैं; इसके बजाय दस्तावेज़ीकृत सबपाथ इम्पोर्ट करें।
• openclaw/plugin-sdk/infra-runtime - एक व्यापक बैरल, जिसमें सिस्टम इवेंट, Heartbeat स्थिति, डिलीवरी क्यू, फ़ेच/प्रॉक्सी हेल्पर, फ़ाइल हेल्पर, अनुमोदन प्रकार और असंबंधित उपयोगिताएँ मिश्रित थीं।
• openclaw/plugin-sdk/config-runtime - एक व्यापक कॉन्फ़िग बैरल, जिसे केवल इसकी बाद की संगतता अवधि के लिए बनाए रखा गया था; सीधे रनटाइम लोड/राइट हेल्पर हटा दिए गए हैं।
• openclaw/extension-api - हटाया गया एक ब्रिज, जो Plugin को एम्बेडेड एजेंट रनर जैसे होस्ट-साइड हेल्पर तक सीधी पहुँच देता था।
• api.registerEmbeddedExtensionFactory(...) - हटाया गया केवल-एम्बेडेड-रनर हुक, जो tool_result जैसे एम्बेडेड-रनर इवेंट देखता था। इसके बजाय एजेंट टूल-रिज़ल्ट मिडलवेयर का उपयोग करें (एम्बेडेड टूल-रिज़ल्ट एक्सटेंशन को मिडलवेयर में माइग्रेट करें देखें)।

रूट SDK, कॉम्पैट बैरल, एक्सटेंशन ब्रिज और एम्बेडेड एक्सटेंशन फ़ैक्टरी हटा दिए गए हैं। infra-runtime और config-runtime केवल अपनी अलग से दर्ज बाद की अवधियों के लिए शेष हैं; नए Plugin को केंद्रित सबपाथ का उपयोग करना चाहिए।

OpenClaw किसी प्रतिस्थापन को प्रस्तुत करने वाले उसी बदलाव में दस्तावेज़ीकृत Plugin व्यवहार को हटाता या उसकी पुनर्व्याख्या नहीं करता। अनुबंध तोड़ने वाले बदलाव पहले एक संगतता अडैप्टर, निदान, दस्तावेज़ और बहिष्करण अवधि से होकर गुजरते हैं। यह SDK इम्पोर्ट, मैनिफ़ेस्ट फ़ील्ड, सेटअप API, हुक और रनटाइम पंजीकरण व्यवहार पर लागू होता है।

क्यों

• धीमा स्टार्टअप - एक हेल्पर इम्पोर्ट करने पर दर्जनों असंबंधित मॉड्यूल लोड हो जाते थे।
• चक्रीय निर्भरताएँ - व्यापक पुनः एक्सपोर्ट के कारण इम्पोर्ट चक्र बनाना आसान था।
• अस्पष्ट API सरफ़ेस - स्थिर एक्सपोर्ट को आंतरिक एक्सपोर्ट से अलग पहचानने का कोई तरीका नहीं था।

अब प्रत्येक openclaw/plugin-sdk/<subpath> दस्तावेज़ीकृत अनुबंध वाला एक छोटा, स्व-निहित मॉड्यूल है।

बंडल किए गए चैनलों के लिए पुराने प्रोवाइडर सुविधा सीम भी हट गए हैं - चैनल-ब्रांडेड हेल्पर शॉर्टकट निजी मोनो-रेपो सुविधाएँ थे, स्थिर Plugin अनुबंध नहीं। इसके बजाय संकीर्ण सामान्य SDK सबपाथ का उपयोग करें। बंडल किए गए Plugin वर्कस्पेस के भीतर, प्रोवाइडर-स्वामित्व वाले हेल्पर को उसी Plugin के api.ts या runtime-api.ts में रखें:

• Anthropic Claude-विशिष्ट स्ट्रीम हेल्पर को अपने api.ts / contract-api.ts सीम में रखता है।
• OpenAI प्रोवाइडर बिल्डर, डिफ़ॉल्ट-मॉडल हेल्पर और रियलटाइम प्रोवाइडर बिल्डर को अपने api.ts में रखता है।
• OpenRouter प्रोवाइडर बिल्डर और ऑनबोर्डिंग/कॉन्फ़िग हेल्पर को अपने api.ts में रखता है।

संगतता नीति

बाहरी-Plugin संगतता कार्य इस क्रम का पालन करता है:

1. नया अनुबंध जोड़ें।
2. पुराने व्यवहार को संगतता अडैप्टर के माध्यम से जोड़े रखें।
3. पुराने पाथ और उसके प्रतिस्थापन का नाम बताने वाला निदान या चेतावनी जारी करें।
4. परीक्षणों में दोनों पाथ को कवर करें।
5. बहिष्करण और माइग्रेशन पाथ का दस्तावेज़ीकरण करें।
6. घोषित माइग्रेशन अवधि के बाद ही हटाएँ, सामान्यतः किसी प्रमुख रिलीज़ में।

यदि कोई मैनिफ़ेस्ट फ़ील्ड अभी भी स्वीकार की जाती है, तो दस्तावेज़ और निदान द्वारा अन्यथा बताए जाने तक उसका उपयोग जारी रखें। नए कोड को दस्तावेज़ीकृत प्रतिस्थापन को प्राथमिकता देनी चाहिए; सामान्य लघु रिलीज़ के दौरान मौजूदा Plugin नहीं टूटने चाहिए।

प्रकाशित चैनल सेटअप संगतता

2026.7.1 के माध्यम से प्रकाशित Slack, Discord, Signal और Microsoft Teams पैकेज openclaw/plugin-sdk/bundled-channel-config-schema से चैनल-विशिष्ट कॉन्फ़िग स्कीमा इम्पोर्ट करते हैं। प्रकाशित Slack और Discord पैकेज openclaw/plugin-sdk/setup-runtime से createLegacyCompatChannelDmPolicy और promptLegacyChannelAllowFromForAccount भी इम्पोर्ट करते हैं।

वे एक्सपोर्ट बहिष्कृत रनटाइम संगतता अडैप्टर के रूप में उपलब्ध रहते हैं। नए और पुनः प्रकाशित Plugin को channel-config-schema और setup-runtime के सामान्य प्रिमिटिव का उपयोग करके अपने कॉन्फ़िग स्कीमा और सेटअप नीति का स्वामित्व स्थानीय रूप से रखना चाहिए। संगतता एक्सपोर्ट केवल तभी हटाए जा सकते हैं, जब न्यूनतम समर्थित प्रकाशित पैकेज संस्करण उन्हें इम्पोर्ट करना बंद कर दें।

चैनल सेटअप इनपुट फ़ील्ड संगतता

ChannelSetupInput अब केवल क्रॉस-चैनल सेटअप एनवलप को स्थायी रूप से टाइप किया हुआ रखता है। चैनल-विशिष्ट फ़ील्ड एक बहिष्कृत संगतता स्तर में टाइप की हुई रहती हैं, ताकि मौजूदा बाहरी Plugin अब भी कम्पाइल हों, जबकि Plugin लेखक उन फ़ील्ड को Plugin-स्थानीय सेटअप इनपुट प्रकारों में ले जाते हैं।

OpenClaw प्रमुख रिलीज़ जारी नहीं करता। 2026-07-22 को रजिस्ट्री के एक स्वीप ने 426 प्रकाशित आउट-ऑफ़-ट्री चैनल Plugin की जाँच की और बिना किसी रीडर वाली 21 फ़ील्ड हटा दीं। बनाए रखी गई 22 फ़ील्ड में से प्रत्येक का एक ज्ञात प्रकाशित रीडर है। प्रत्येक अगली फ़ील्ड जैसे ही किसी प्रकाशित Plugin द्वारा पढ़ी नहीं जाती, हटा दी जाती है; Plugin लेखक जैसे-जैसे Plugin-स्थानीय सेटअप इनपुट प्रकारों पर माइग्रेट करते हैं, बनाए रखा गया सेट छोटा होता जाता है।

उसी स्वीप ने बिना किसी प्रकाशित आश्रित वाली 23 पुरानी अघोषित-अडैप्टर प्रमोशन कुंजियाँ हटा दीं। छह सामान्य कुंजियाँ और केवल-सेटअप rooms कुंजी शेष हैं। प्रकाशित Plugin द्वारा singleAccountKeysToMove घोषित किए जाने के साथ वह सेट भी छोटा होता जाता है।

साझा प्रकार में कोई इंडेक्स सिग्नेचर नहीं है। Plugin-स्वामित्व वाली कुंजियाँ अब भी रनटाइम इनपुट ऑब्जेक्ट पर मौजूद हो सकती हैं; उन्हें Plugin-स्थानीय इंटरसेक्शन में घोषित करें या स्वामी Plugin के सेटअप स्कीमा के माध्यम से संकीर्ण करें।

पुराना अघोषित-अडैप्टर प्रमोशन स्तर उसी रीडर-संचालित नीति का पालन करता है। singleAccountKeysToMove घोषित करें, जिसमें तब एक खाली ऐरे भी शामिल हो जब Plugin को किसी अतिरिक्त प्रमोशन कुंजी की आवश्यकता न हो, ताकि साझा फ़ॉलबैक को एक समय में एक कुंजी करके हटाया जा सके।

रीडर का सत्यापन

1. प्रत्येक nextCursor के साथ https://clawhub.ai/api/v1/packages?family=code-plugin&limit=100 के पृष्ठों से गुजरें और वे पैकेज रखें जिनके categories में channels शामिल है।
2. npm search --json --searchlimit=1000 "openclaw channel plugin" से npm उम्मीदवार जोड़ें। openclaw/plugin-sdk/channel-setup, openclaw/plugin-sdk/setup और openclaw/plugin-sdk/core के लिए GitHub कोड खोजों से केवल-स्रोत उम्मीदवार जोड़ें।
3. प्रत्येक उम्मीदवार का नवीनतम प्रकाशित संस्करण निर्धारित करें। npm pack <package>@<version> --json --pack-destination <temp-dir> चलाएँ, उसे अनपैक करें और प्रत्यक्ष या डिस्ट्रक्चर्ड फ़ील्ड रीड के लिए भेजे गए dist JavaScript और घोषणाओं की जाँच करें। जब किसी पैकेज का कोई npm रिलीज़ न हो, तो ClawHub आर्टिफ़ैक्ट डाउनलोड करें।
4. पैकेज, संस्करण, फ़ील्ड या प्रमोशन कुंजी और मेल खाने वाली फ़ाइल दर्ज करें। कोई फ़ील्ड या कुंजी केवल तभी हटाई जा सकती है, जब कोई प्रकाशित Plugin आर्टिफ़ैक्ट उसे न पढ़ता हो। बनाए रखी गई फ़ील्ड और कुंजी सूचियों के पास कोड टिप्पणियों में दिए रीडर नामों को स्वीप के साथ सिंक्रनाइज़ रखें।

यह केवल एक स्रोत/प्रकार संगतता रिकॉर्ड है। इसमें कोई रनटाइम अडैप्टर या संगतता-रजिस्ट्री प्रविष्टि नहीं है, क्योंकि रनटाइम सेटअप इनपुट ऑब्जेक्ट और सेटअप व्यवहार अपरिवर्तित हैं।

pnpm plugins:boundary-report के साथ वर्तमान माइग्रेशन क्यू का ऑडिट करें:

pnpm plugins:boundary-report:ci तीनों विफलता फ़्लैग के साथ चलता है। बहिष्कृत रिकॉर्ड में सामान्यतः अस्पष्ट "अगली प्रमुख रिलीज़" के बजाय एक स्पष्ट removeAfter तिथि होती है। जिस रिकॉर्ड के स्वामी ने किसी तिथि को अनुमोदित नहीं किया है, उसमें removeAfter अनुपस्थित रहता है, वह no-date के रूप में दिखाई देता है और कभी भी हटाए जाने योग्य नहीं होता। रिपोर्ट बहिष्कृत रिकॉर्ड को तिथि के अनुसार समूहित करती है, स्थानीय कोड/दस्तावेज़ संदर्भों की गणना करती है, क्रॉस-ओनर आरक्षित SDK इम्पोर्ट सामने लाती है और निजी मेमोरी-होस्ट SDK ब्रिज का सारांश देती है। आरक्षित SDK सबपाथ में ट्रैक किया गया स्वामी उपयोग होना चाहिए; अप्रयुक्त आरक्षित एक्सपोर्ट को सार्वजनिक SDK से हटा देना चाहिए।

पुराना मीडिया प्रोजेक्शन

media-legacy-projection संगतता रिकॉर्ड पुरानी समानांतर मीडिया फ़ील्ड, पेलोड बिल्डर, हुक मेटाडेटा उपनाम और मीडिया टेम्पलेट नामों को कवर करता है। इसकी अनुमोदित removeAfter तिथि 2026-10-01 है (फ़ैक्ट्स-फ़र्स्ट प्रतिस्थापन भेजे जाने के दो रिलीज़ क्रम बाद)। हटाने के लिए उस समय प्रकाशित-Plugin आर्टिफ़ैक्ट का स्वच्छ स्वीप भी आवश्यक है; तिथि से पहले माइग्रेट करें।

चैनल इनग्रेस के लिए, एकवचन/बहुवचन MediaPath, MediaUrl, MediaType, MediaPaths, MediaUrls, MediaTypes, MediaTranscribedIndexes, MediaWorkspaceDir और MediaStaged को क्रमबद्ध फ़ैक्ट से बदलें:

 const media = toInboundMediaFacts([  { path: saved.path, url: nativeUrl, contentType: saved.contentType, messageId },]); const ctx = finalizeInboundContext({ Body: caption, media });

inbound_claim और message_received हुक में event.media का उपयोग करें। यदि रिमोट मीडिया स्थानीय रूप से स्टेज नहीं किया गया है, तो पहचान/निदान के लिए event.originalMedia का उपयोग करें और event.media की प्रतीक्षा करें; event.mediaStagingPending उस स्थिति को अलग करता है। event.metadata से बहिष्कृत एकवचन/बहुवचन गुण न पढ़ें।

CLI मीडिया मॉडल के लिए, {{MediaPath}}, {{MediaUrl}}, {{MediaType}} और {{MediaDir}} को {{AttachmentPath}}, {{AttachmentUrl}}, {{AttachmentContentType}} और {{AttachmentDir}} से बदलें। जब अटैचमेंट की स्थिति महत्त्वपूर्ण हो, तो {{AttachmentIndex}} का उपयोग करें।

स्थानीय मीडिया रीड नीति के लिए, openclaw/plugin-sdk/media-local-roots से getAgentScopedMediaLocalRoots(...) या getAgentScopedMediaLocalRootsForSources(...) इम्पोर्ट करें। openclaw/plugin-sdk/agent-media-payload फ़साड और उसका buildAgentMediaPayload(...) प्रोजेक्शन बहिष्कृत हैं।

माइग्रेट कैसे करें

await api.runtime.config.mutateConfigFile({  afterWrite: { mode: "auto" },  mutate(draft) {    draft.plugins ??= {};  },});

// OpenClaw रनटाइम टूल और Codex रनटाइम डायनेमिक टूल (परिणाम को// रूपांतरित किया जा सकता है)। Codex-नेटिव टूल परिणाम भी अवलोकन के लिए रिले किए जाते हैं,// लेकिन उनका रूपांतरित आउटपुट मॉडल तक कभी नहीं पहुँचता: Codex// PostToolUse हुक अनुबंध किसी नेटिव टूल प्रतिक्रिया को प्रतिस्थापित नहीं कर सकता।api.registerAgentToolResultMiddleware(async (event) => {  return compactToolResult(event);}, {  runtimes: ["openclaw", "codex"],});

{  "contracts": {    "agentToolResultMiddleware": ["openclaw", "codex"]  }}

// पहलेconst program = applyWindowsSpawnProgramPolicy({ candidate }); // बाद मेंconst program = applyWindowsSpawnProgramPolicy({  candidate,  // इसे केवल उन विश्वसनीय संगतता कॉलर के लिए सेट करें जो जानबूझकर  // शेल-मध्यस्थ फ़ॉलबैक स्वीकार करते हैं।  allowShellFallback: true,});

grep -r "plugin-sdk/compat" my-plugin/grep -r "plugin-sdk/infra-runtime" my-plugin/grep -r "plugin-sdk/config-runtime" my-plugin/grep -r "openclaw/extension-api" my-plugin/

// पहले (अप्रचलित पश्च-संगतता परत)import {  createChannelReplyPipeline,  createPluginRuntimeStore,  resolveControlCommandGate,} from "openclaw/plugin-sdk/compat"; // बाद में (आधुनिक केंद्रित आयात)import { createChannelReplyPipeline } from "openclaw/plugin-sdk/channel-reply-pipeline";import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";import { resolveControlCommandGate } from "openclaw/plugin-sdk/command-auth";

// पहले (अप्रचलित extension-api ब्रिज)import { runEmbeddedAgent } from "openclaw/extension-api";const result = await runEmbeddedAgent({ sessionId, prompt }); // बाद में (इंजेक्ट किया गया रनटाइम)const result = await api.runtime.agent.runEmbeddedAgent({ sessionId, prompt });

pnpm buildpnpm test my-plugin/

आयात पथ संदर्भ

सार्वजनिक पैकेज निर्यात मैप आयात योग्य SDK उपपथों के लिए सत्य का स्रोत है। SDK अवलोकन से लिंक की गई विषयगत SDK मार्गदर्शिकाओं का उपयोग करें और सबसे संकीर्ण दस्तावेज़ीकृत सार्वजनिक उपपथ को प्राथमिकता दें। scripts/lib/plugin-sdk-entrypoints.json की कंपाइलर सूची में बंडल किए गए Plugins बनाने के लिए उपयोग की जाने वाली निजी-स्थानीय प्रविष्टियाँ भी हैं; वहाँ उनकी उपस्थिति उन्हें सार्वजनिक पैकेज निर्यात नहीं बनाती।

यह तालिका सामान्य माइग्रेशन उपसमुच्चय है, संपूर्ण SDK सतह नहीं। कंपाइलर प्रवेश-बिंदु सूची scripts/lib/plugin-sdk-entrypoints.json में है; पैकेज निर्यात सार्वजनिक उपसमुच्चय से जनरेट किए जाते हैं।

आरक्षित बंडल-Plugin सहायक सीमों को सार्वजनिक SDK निर्यात मैप से हटा दिया गया है, सिवाय स्पष्ट रूप से दस्तावेज़ीकृत संगतता फ़साड के, जैसे कि अप्रचलित plugin-sdk/discord शिम, जिसे उन बाहरी Plugins के लिए बनाए रखा गया है जो अब भी प्रकाशित @openclaw/discord पैकेज को सीधे आयात करते हैं। स्वामी-विशिष्ट सहायक स्वामी Plugin पैकेज के भीतर रहते हैं; साझा होस्ट व्यवहार plugin-sdk/gateway-runtime, plugin-sdk/security-runtime और इंजेक्ट किए गए Plugin API जैसे जेनेरिक SDK अनुबंधों के माध्यम से जाता है।

कार्य से मेल खाने वाले सबसे संकीर्ण आयात का उपयोग करें। यदि आपको कोई निर्यात नहीं मिलता, तो src/plugin-sdk/ पर स्रोत जाँचें या अनुरक्षकों से पूछें कि उसका स्वामी कौन-सा जेनेरिक अनुबंध होना चाहिए।

हटाई गई संगतता सतहें

जुलाई 2026 की छँटाई में रूट SDK और संगतता बैरल, एक्सटेंशन API ब्रिज, समाप्त SDK उपपथ उपनाम, अप्रयुक्त SDK उपपथ और केवल बंडल के लिए बने SDK मॉड्यूल के सार्वजनिक निर्यात हटा दिए गए। केवल बंडल वाले मॉड्यूल निजी-स्थानीय बिल्ड मैपिंग के माध्यम से उनके रिपॉज़िटरी स्वामियों के लिए उपलब्ध रहते हैं; उन्हें प्रकाशित पैकेज से आयात नहीं किया जा सकता।

प्रक्रिया-वैश्विक API-प्रदाता प्रकाशन

registerApiProvider(...) और unregisterApiProviders(...) को openclaw/plugin-sdk/llm से हटा दिया गया। वे API ट्रांसपोर्ट को प्रक्रिया-वैश्विक स्थिति में प्रकाशित करते थे, जिसे जीवनचक्र-स्वामित्व वाले मॉडल रनटाइम को फिर प्रत्येक तैयार रजिस्ट्री में कॉपी करना पड़ता था।

प्रदाता Plugins को टेक्स्ट-इन्फ़रेंस प्रदाताओं को api.registerProvider(...) के माध्यम से पंजीकृत करना चाहिए। ApiRegistry बनाने वाले होस्ट-स्वामित्व वाले कोड और परीक्षणों को सीधे उस रजिस्ट्री पर पंजीकरण करना चाहिए, ताकि प्रदाता स्वामित्व और टियरडाउन तैयार रनटाइम तक सीमित रहें।

निजी परीक्षण बैरल

openclaw/plugin-sdk/testing रिपॉज़िटरी-स्थानीय था और वितरित पैकेज आर्टिफ़ैक्ट से बाहर रखा गया था, इसलिए इसे इसकी 2026-07-28 removeAfter तिथि से पहले हटा दिया गया। रिपॉज़िटरी परीक्षण plugin-sdk/plugin-test-runtime, plugin-sdk/channel-test-helpers, plugin-sdk/channel-target-testing, plugin-sdk/test-env और plugin-sdk/test-fixtures जैसे केंद्रित उपपथों का उपयोग करते हैं।

माइग्रेशन संदर्भ

ये मैपिंग जुलाई 2026 में हटाई गई सतहों और बाद की समयावधि में सक्रिय बहिष्करणों, दोनों को कवर करती हैं। कोई मैपिंग माइग्रेशन मार्गदर्शन है, इसका प्रमाण नहीं कि पुरानी सतह अब भी उपलब्ध है; वर्तमान स्थिति के लिए संगतता रजिस्ट्री और हटाने की समयरेखा देखें।

// पहलेimport { buildHelpMessage } from "openclaw/plugin-sdk/command-auth"; // बाद मेंimport { buildHelpMessage } from "openclaw/plugin-sdk/command-status";

// पहलेapi.on("deactivate", async (event, ctx) => {  await stopPluginService(ctx);}); // बाद मेंapi.on("gateway_stop", async (event, ctx) => {  await stopPluginService(ctx);});

// पहलेapi.on("subagent_spawning", async () => ({  status: "ok",  threadBindingReady: true,  deliveryOrigin: { channel: "discord", to: "channel:123", threadId: "456" },})); // बाद मेंapi.on("subagent_spawned", async (event) => {  await observeSubagentLaunch(event);});

{  "contracts": {    "externalAuthProviders": ["anthropic", "openai"]  }}

// पहलेconst flow = api.runtime.tasks.flow.fromToolContext(ctx);// बाद मेंconst flow = api.runtime.tasks.managedFlows.fromToolContext(ctx);

// पहलेimport type { OpenClawSchemaType } from "openclaw/plugin-sdk";// बाद मेंimport type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";

Talk और रियलटाइम वॉइस माइग्रेशन

रियलटाइम वॉइस, टेलीफ़ोनी, मीटिंग और ब्राउज़र Talk कोड, openclaw/plugin-sdk/realtime-voice द्वारा निर्यात किए गए एक Talk सेशन कंट्रोलर को साझा करते हैं। कंट्रोलर सामान्य Talk इवेंट एनवेलप, सक्रिय टर्न स्थिति, कैप्चर स्थिति, आउटपुट-ऑडियो स्थिति, हालिया इवेंट इतिहास और पुराने टर्न की अस्वीकृति का स्वामी है। प्रोवाइडर Plugins वेंडर-विशिष्ट रियलटाइम सेशन के स्वामी हैं। ब्राउज़र-मीटिंग Plugins सेशन, ब्राउज़र, ऑडियो, Node-होस्ट, एजेंट-परामर्श और वॉइस-कॉल तंत्र के लिए openclaw/plugin-sdk/meeting-runtime का उपयोग करते हैं, फिर URL नियमों, DOM स्क्रिप्ट, मैन्युअल-कार्रवाई मैपिंग, कैप्शन, निर्माण और डायल-इन योजनाओं के लिए MeetingPlatformAdapter लागू करते हैं। प्लेटफ़ॉर्म REST API, OAuth, आर्टिफ़ैक्ट, सेलेक्टर और वायर नाम Plugin में रहते हैं। ब्राउज़र अनुमति योजनाओं को अनुरोधित मीटिंग URL मिलता है, ताकि प्रत्येक प्लेटफ़ॉर्म केवल अपने सटीक समर्थित ओरिजिन की अनुमति दे सके। ब्राउज़र से प्रस्थान की पुष्टि होने के बाद सेशन रनटाइम को प्लेटफ़ॉर्म-विशिष्ट लाइव स्वास्थ्य भी सामान्यीकृत करना होगा; ऐतिहासिक ट्रांसक्रिप्ट फ़ील्ड बने रह सकते हैं, लेकिन निकलने के बाद कैप्शन और ऑडियो की तत्परता सक्रिय नहीं रहनी चाहिए।

सभी बंडल किए गए सरफ़ेस साझा कंट्रोलर पर चलते हैं: ब्राउज़र रिले, प्रबंधित-रूम हैंडऑफ़, वॉइस-कॉल रियलटाइम, वॉइस-कॉल स्ट्रीमिंग STT, Google Meet रियलटाइम और नेटिव पुश-टू-टॉक। Gateway, hello-ok.features.events में एक लाइव Talk इवेंट चैनल घोषित करता है: talk.event।

नए कोड को createTalkEventSequencer(...) को सीधे कॉल नहीं करना चाहिए, जब तक कि निम्न-स्तरीय अडैप्टर या टेस्ट फ़िक्स्चर लागू न किया जा रहा हो। साझा कंट्रोलर का उपयोग करें, ताकि टर्न आईडी के बिना टर्न-स्कोप्ड इवेंट उत्सर्जित न किए जा सकें, पुराने turnEnd / turnCancel कॉल किसी नए सक्रिय टर्न को साफ़ न कर सकें, और आउटपुट-ऑडियो जीवनचक्र इवेंट टेलीफ़ोनी, मीटिंग, ब्राउज़र रिले, प्रबंधित-रूम हैंडऑफ़ और नेटिव Talk क्लाइंट में सुसंगत रहें।

सार्वजनिक API का स्वरूप:

// Gateway के स्वामित्व वाला Talk सेशन API।await gateway.request("talk.session.create", {  mode: "realtime",  transport: "gateway-relay",  brain: "agent-consult",  sessionKey: "main",});await gateway.request("talk.session.appendAudio", { sessionId, audioBase64 });await gateway.request("talk.session.cancelOutput", { sessionId, reason: "barge-in" });await gateway.request("talk.session.submitToolResult", {  sessionId,  callId,  result: { status: "working" },  options: { willContinue: true },});await gateway.request("talk.session.submitToolResult", {  sessionId,  callId,  result: { status: "already_delivered" },  options: { suppressResponse: true },});await gateway.request("talk.session.submitToolResult", { sessionId, callId, result });await gateway.request("talk.session.close", { sessionId }); // क्लाइंट के स्वामित्व वाला प्रोवाइडर सेशन API।await gateway.request("talk.client.create", {  mode: "realtime",  transport: "webrtc",  brain: "agent-consult",  sessionKey: "main",});await gateway.request("talk.client.toolCall", { sessionKey, callId, name, args });await gateway.request("talk.client.steer", { sessionKey, text, mode: "steer" });

ब्राउज़र के स्वामित्व वाले WebRTC/प्रोवाइडर-वेबसॉकेट सेशन talk.client.create का उपयोग करते हैं, क्योंकि ब्राउज़र प्रोवाइडर नेगोशिएशन और मीडिया ट्रांसपोर्ट का स्वामी है, जबकि Gateway क्रेडेंशियल, निर्देश और टूल नीति का स्वामी है। talk.session.* Gateway द्वारा प्रबंधित सामान्य सरफ़ेस है, जिसका उपयोग Gateway-रिले रियलटाइम, Gateway-रिले ट्रांसक्रिप्शन और प्रबंधित-रूम नेटिव STT/TTS सेशन के लिए होता है।

talk.provider / talk.providers के पास रियलटाइम सेलेक्टर रखने वाले पुराने कॉन्फ़िग को openclaw doctor --fix से सुधारा जाना चाहिए; रनटाइम Talk, स्पीच/TTS प्रोवाइडर कॉन्फ़िग को रियलटाइम प्रोवाइडर कॉन्फ़िग के रूप में फिर से व्याख्यायित नहीं करता।

समर्थित talk.session.create संयोजन जानबूझकर सीमित हैं:

पुराने talk.realtime.* / talk.transcription.* / talk.handoff.* परिवारों (सभी हटाए गए) से माइग्रेट करने वाले पाठकों के लिए मेथड मैप:

एकीकृत नियंत्रण शब्दावली भी जानबूझकर सीमित है:

इसे कार्यशील बनाने के लिए कोर में प्रोवाइडर या प्लेटफ़ॉर्म के विशेष मामले प्रस्तुत न करें। कोर Talk सेशन के अर्थ-विज्ञान का स्वामी है। प्रोवाइडर Plugins वेंडर सेशन सेटअप के स्वामी हैं। वॉइस-कॉल और Google Meet टेलीफ़ोनी/मीटिंग अडैप्टर के स्वामी हैं। ब्राउज़र और नेटिव ऐप डिवाइस कैप्चर/प्लेबैक UX के स्वामी हैं।

हटाने की समयरेखा

नीचे दिए गए शेष सार्वजनिक SDK उपपथों के लिए रजिस्ट्री-समर्थित निष्कासन अवधियाँ हैं। 30 जुलाई वाली पंक्तियाँ, अनुरक्षकों द्वारा अधिकृत उनकी शुरुआती समीक्षा के बाद हटा दी गईं: अप्रयुक्त उपपथ हटा दिए गए, पहले के संगतता उपनाम हटा दिए गए, और केवल-बंडल मॉड्यूल को निजी-स्थानीय बिल्ड मैपिंग में अवनत कर दिया गया।

सभी कोर plugins पहले ही माइग्रेट हो चुके हैं। बाहरी plugins को अगले प्रमुख रिलीज़ से पहले माइग्रेट करना चाहिए। आपका plugin जिन सतहों का उपयोग करता है, उनके संगतता रिकॉर्ड में से कौन-से सबसे जल्द देय हैं, यह देखने के लिए pnpm plugins:boundary-report चलाएँ।

चेतावनियों को अस्थायी रूप से दबाना

OPENCLAW_SUPPRESS_PLUGIN_SDK_COMPAT_WARNING=1 openclaw gateway runOPENCLAW_SUPPRESS_EXTENSION_API_WARNING=1 openclaw gateway run

यह एक अस्थायी बचाव-मार्ग है, स्थायी समाधान नहीं।

संबंधित

• शुरुआत करें - अपना पहला plugin बनाएँ
• SDK अवलोकन - संपूर्ण उपपथ इंपोर्ट संदर्भ
• चैनल Plugins - चैनल plugins बनाना
• प्रदाता Plugins - प्रदाता plugins बनाना
• Plugin की आंतरिक संरचना - आर्किटेक्चर का गहन विश्लेषण
• Plugin मैनिफ़ेस्ट - मैनिफ़ेस्ट स्कीमा संदर्भ