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

`@openclaw/ai`, OpenClaw'ın model yürütme katmanının yayımlanabilir
kitaplık biçimidir: sağlayıcıdan bağımsız ileti/araç/akış sözleşmeleri, doğrulama,
tanılama, olay akışları, yalıtılmış bir çalışma zamanı kayıt defteri ve sekiz
yerleşik API ailesi (Anthropic Messages, OpenAI Completions, OpenAI
Responses, Azure OpenAI Responses, ChatGPT/Codex Responses, Google Generative
AI, Google Vertex, Mistral Conversations) için tembel bağdaştırıcılar.

Her sürümde kök `openclaw` paketiyle birlikte, aynı sürüme sabitlenmiş
olarak yayımlanır ve geçişli bağımlılık ağacının kurulum sırasında kilitlenmesi
için kendi `npm-shrinkwrap.json` dosyasına sahiptir. `openclaw` kurulunca
eşleşen `@openclaw/ai` otomatik olarak kurulur; kitaplık kullanıcıları
herhangi bir OpenClaw uygulama kodu olmadan doğrudan buna bağımlı olabilir.

## Hızlı başlangıç

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

Çalıştırılabilir bir sürüm, depodaki `examples/ai-chat` konumunda bulunur.

## Tasarım sözleşmesi

* **Varsayılan olarak örnek kapsamlıdır.** Paketin içe aktarılması,
  küresel olarak hiçbir şeyi kaydetmez. `createApiRegistry()` / `createLlmRuntime()`
  yalıtılmış örnekler döndürür; `registerBuiltInApiProviders(registry)`, bir kayıt defterini yerleşik
  taşımalara dahil eder. Sağlayıcı SDK modülleri ilk kullanımda tembel olarak yüklenir.
* **Ana makine politikası paketlenmez, dışarıdan sağlanır.**
  İstek getirme koruması (örneğin SSRF politikası), araç sonucu yeniden oynatma
  metnindeki gizli bilgilerin maskelenmesi, OpenAI katı araç varsayılanları ve
  tanılama günlük kaydı, `configureAiTransportHost` ile yapılandırılan `AiTransportHost`
  portlarıdır. Kitaplığın varsayılanları etkisizdir; OpenClaw, gerçek
  uygulamalarını akış cephesine kurar.
* **Tek bir olay akışı kimliği.** `@openclaw/ai/event-stream`, OpenClaw
  çekirdeği, agent-core ve harici kullanıcılar tarafından paylaşılan standart
  `EventStream` oluşturucusudur.
* **`internal/*` alt yolları API değildir.** Bunlar
  OpenClaw uygulamasının kendisi için bulunur ve herhangi bir semver garantisi taşımaz.
* Sağlayıcı kimlikleri, kimlik bilgileri, model katalogları,
  yeniden denemeler ve yük devretme uygulamanın sorumluluğunda kalır. OpenClaw
  bunları bu paketin çevresinde katmanlandırır; bir kitaplık kullanıcısı doğrudan
  bir `Model` nesnesi ve seçenekler sağlar.

## Alt yol dışa aktarımları

| Alt yol          | İçerik                                                                           |
| ---------------- | -------------------------------------------------------------------------------- |
| `.`              | Sözleşmeler, `createApiRegistry`, `createLlmRuntime`, `configureAiTransportHost` |
| `./providers`    | `registerBuiltInApiProviders`, `resetApiProviders`                               |
| `./types`        | Model/ileti/araç/akış türleri                                                    |
| `./validation`   | Araç bağımsız değişkeni doğrulaması                                              |
| `./diagnostics`  | Tanılama sözleşmeleri                                                            |
| `./event-stream` | Paylaşılan `EventStream` uygulaması                                              |
| `./internal/*`   | OpenClaw'a özel dahili kullanım, semver garantisi yok                            |