@openclaw/ai पैकेज

@openclaw/ai, OpenClaw की मॉडल निष्पादन परत का प्रकाशित किया जा सकने वाला लाइब्रेरी रूप है: प्रदाता-निरपेक्ष संदेश/टूल/स्ट्रीम अनुबंध, सत्यापन, निदान, इवेंट स्ट्रीम, एक पृथक रनटाइम रजिस्ट्री और आठ अंतर्निहित API परिवारों के लिए लेज़ी अडैप्टर (Anthropic Messages, OpenAI Completions, OpenAI Responses, Azure OpenAI Responses, ChatGPT/Codex Responses, Google Generative AI, Google Vertex, Mistral Conversations)।

यह प्रत्येक रिलीज़ में रूट openclaw पैकेज के साथ प्रकाशित होता है, समान संस्करण पर पिन किया हुआ, और इसका अपना npm-shrinkwrap.json होता है ताकि इसका ट्रांज़िटिव डिपेंडेंसी ट्री इंस्टॉल के समय लॉक हो जाए। openclaw को इंस्टॉल करने पर संगत @openclaw/ai अपने-आप इंस्टॉल हो जाता है; लाइब्रेरी उपभोक्ता किसी भी OpenClaw एप्लिकेशन कोड के बिना सीधे इस पर निर्भर हो सकते हैं।

त्वरित शुरुआत

  const runtime = createLlmRuntime();registerBuiltInApiProviders(runtime.registry); const stream = runtime.streamSimple(model, { messages }, { apiKey });for await (const event of stream) {  if (event.type === "text_delta") process.stdout.write(event.delta);}const result = await stream.result();

इसका चलाने योग्य संस्करण रिपॉज़िटरी में examples/ai-chat पर उपलब्ध है।

डिज़ाइन अनुबंध

• डिफ़ॉल्ट रूप से इंस्टेंस-स्कोप्ड। पैकेज को इंपोर्ट करने पर वैश्विक रूप से कुछ भी पंजीकृत नहीं होता। createApiRegistry() / createLlmRuntime() पृथक इंस्टेंस लौटाते हैं; registerBuiltInApiProviders(registry) एक रजिस्ट्री को अंतर्निहित ट्रांसपोर्ट के उपयोग हेतु चुनता है। प्रदाता SDK मॉड्यूल पहले उपयोग पर लेज़ी रूप से लोड होते हैं।
• होस्ट नीति इंजेक्ट की जाती है, बंडल नहीं। अनुरोध फ़ेच सुरक्षा (उदाहरण के लिए SSRF नीति), टूल-परिणाम रीप्ले टेक्स्ट में सीक्रेट हटाना, OpenAI के स्ट्रिक्ट-टूल डिफ़ॉल्ट और निदान लॉगिंग, AiTransportHost पोर्ट हैं, जिन्हें configureAiTransportHost से कॉन्फ़िगर किया जाता है। लाइब्रेरी के डिफ़ॉल्ट निष्क्रिय हैं; OpenClaw अपने स्ट्रीम फ़साड में इनके वास्तविक कार्यान्वयन इंस्टॉल करता है।
• एक इवेंट-स्ट्रीम पहचान। @openclaw/ai/event-stream, OpenClaw कोर, agent-core और बाहरी उपभोक्ताओं द्वारा साझा किया जाने वाला प्रामाणिक EventStream कंस्ट्रक्टर है।
• internal/* सबपाथ API नहीं हैं। वे स्वयं OpenClaw एप्लिकेशन के लिए मौजूद हैं और कोई semver गारंटी नहीं देते।
• प्रदाता आईडी, क्रेडेंशियल, मॉडल कैटलॉग, पुनः प्रयास और फ़ेलओवर एप्लिकेशन की जिम्मेदारियाँ बने रहते हैं। OpenClaw इस पैकेज के इर्द-गिर्द उन परतों को जोड़ता है; लाइब्रेरी उपभोक्ता सीधे एक Model ऑब्जेक्ट और विकल्प प्रदान करता है।

सबपाथ एक्सपोर्ट