@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ıç

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

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

@openclaw/ai paketi

Hızlı başlangıç

Tasarım sözleşmesi

Alt yol dışa aktarımları

​Hızlı başlangıç

​Tasarım sözleşmesi

​Alt yol dışa aktarımları

Hızlı başlangıç

Tasarım sözleşmesi

Alt yol dışa aktarımları