> ## 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.

# حزمة @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.

## البدء السريع

```js theme={"theme":{"light":"min-light","dark":"min-dark"}}
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();
```

توجد نسخة قابلة للتشغيل في المستودع ضمن `examples/ai-chat`.

## عقد التصميم

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

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

| المسار الفرعي    | المحتويات                                                                      |
| ---------------- | ------------------------------------------------------------------------------ |
| `.`              | العقود، و`createApiRegistry`، و`createLlmRuntime`، و`configureAiTransportHost` |
| `./providers`    | `registerBuiltInApiProviders`، و`resetApiProviders`                            |
| `./types`        | أنواع النماذج والرسائل والأدوات والتدفقات                                      |
| `./validation`   | التحقق من وسائط الأدوات                                                        |
| `./diagnostics`  | عقود التشخيصات                                                                 |
| `./event-stream` | التنفيذ المشترك لـ`EventStream`                                                |
| `./internal/*`   | داخلي في OpenClaw، من دون ضمان للتوافق الدلالي بين الإصدارات                   |