حزمة @openclaw/ai

​

البدء السريع

import { createLlmRuntime } from "@openclaw/ai";
import { registerBuiltInApiProviders } from "@openclaw/ai/providers";

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();

​

عقد التصميم

• محدّد النطاق بالمثيل افتراضيًا. لا يؤدي استيراد الحزمة إلى تسجيل أي شيء عموميًا. تُرجع createApiRegistry() وcreateLlmRuntime() مثيلات معزولة؛ ويضيف registerBuiltInApiProviders(registry) وسائل النقل المضمّنة إلى سجل واحد اختياريًا. تُحمّل وحدات SDK الخاصة بالمزوّدين عند أول استخدام.
• تُحقن سياسة المضيف ولا تُضمّن. تُعد حماية جلب الطلبات (مثل سياسة SSRF)، وتنقيح الأسرار من نص إعادة تشغيل نتائج الأدوات، والإعدادات الافتراضية الصارمة لأدوات OpenAI، وتسجيل التشخيصات، منافذ AiTransportHost تُضبط باستخدام configureAiTransportHost. الإعدادات الافتراضية للمكتبة خاملة؛ ويثبّت OpenClaw تطبيقاته الفعلية في واجهة التدفق الخاصة به.
• هوية واحدة لتدفق الأحداث. يمثّل @openclaw/ai/event-stream مُنشئ EventStream القياسي المشترك بين نواة OpenClaw، ونواة الوكيل، والمستخدمين الخارجيين.
• المسارات الفرعية internal/* ليست واجهة API. وهي موجودة لتطبيق OpenClaw نفسه ولا تحمل أي ضمان للتوافق الدلالي بين الإصدارات.
• تظل معرّفات المزوّدين، وبيانات الاعتماد، وكتالوجات النماذج، وإعادات المحاولة، وتجاوز الأعطال من مسؤوليات التطبيق. يضيف OpenClaw هذه الطبقات حول هذه الحزمة؛ بينما يوفّر مستخدم المكتبة كائن Model والخيارات مباشرةً.

​

تصديرات المسارات الفرعية