Plugin SDK माइग्रेशन

​

क्या बदला

• 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 जैसे एम्बेडेड-रनर इवेंट देखता था। इसके बजाय एजेंट टूल-रिज़ल्ट मिडलवेयर का उपयोग करें (एम्बेडेड टूल-रिज़ल्ट एक्सटेंशन को मिडलवेयर में माइग्रेट करें देखें)।

​

क्यों

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

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

​

संगतता नीति

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

​

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

​

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

​

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

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 आर्टिफ़ैक्ट उसे न पढ़ता हो। बनाए रखी गई फ़ील्ड और कुंजी सूचियों के पास कोड टिप्पणियों में दिए रीडर नामों को स्वीप के साथ सिंक्रनाइज़ रखें।

​

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

import { toInboundMediaFacts } from "openclaw/plugin-sdk/channel-inbound";

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

const ctx = finalizeInboundContext({ Body: caption, media });

​

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

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 build
pnpm test my-plugin/

​

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

​

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

​

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

​

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

​

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

// पहले
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 और रियलटाइम वॉइस माइग्रेशन

// 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" });

​

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

​

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

OPENCLAW_SUPPRESS_PLUGIN_SDK_COMPAT_WARNING=1 openclaw gateway run
OPENCLAW_SUPPRESS_EXTENSION_API_WARNING=1 openclaw gateway run

​

संबंधित

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