@openclaw/ai paketi

@openclaw/ai, OpenClaw'ın model yürütme katmanının yayımlanabilir kütüphane biçimidir: sağlayıcıdan bağımsız mesaj/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 gecikmeli 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 kurulduğunda eşleşen @openclaw/ai otomatik olarak kurulur; kütüphane kullanıcıları herhangi bir OpenClaw uygulama kodu olmadan doğrudan buna bağımlı olabilir.

Hızlı başlangıç

  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, depoda 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 gecikmeli olarak yüklenir.
• Ana makine politikası pakete dahil edilmez, dışarıdan sağlanır. İstek getirme koruması (örneğin SSRF politikası), araç sonucu yeniden oynatma metnindeki gizli bilgilerin sansürlenmesi, OpenAI katı araç varsayılanları ve tanılama günlük kaydı, configureAiTransportHost ile yapılandırılan AiTransportHost bağlantı noktalarıdır. Kütüphane varsayılanları etkisizdir; OpenClaw gerçek uygulamalarını akış cephesine kurar.
• Tek 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 vardır ve 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; kütüphane kullanıcısı doğrudan bir Model nesnesi ve seçenekleri sağlar.

Alt yol dışa aktarımları