Paket @openclaw/ai

@openclaw/ai adalah bentuk pustaka yang dapat dipublikasikan dari lapisan eksekusi model OpenClaw: kontrak pesan/alat/aliran yang netral terhadap penyedia, validasi, diagnostik, aliran peristiwa, registri runtime terisolasi, dan adaptor yang dimuat secara bertahap untuk delapan keluarga API bawaan (Anthropic Messages, OpenAI Completions, OpenAI Responses, Azure OpenAI Responses, ChatGPT/Codex Responses, Google Generative AI, Google Vertex, Mistral Conversations).

Pustaka ini dipublikasikan bersama paket akar openclaw pada setiap rilis, disematkan ke versi yang sama, dengan npm-shrinkwrap.json sendiri sehingga pohon dependensi transitifnya dikunci saat instalasi. Menginstal openclaw akan menginstal @openclaw/ai yang sesuai secara otomatis; pengguna pustaka dapat menjadikannya dependensi secara langsung tanpa kode aplikasi OpenClaw apa pun.

Mulai cepat

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

Versi yang dapat dijalankan tersedia di repositori pada examples/ai-chat.

Kontrak desain

• Secara bawaan tercakup per instans. Mengimpor paket tidak mendaftarkan apa pun secara global. createApiRegistry() / createLlmRuntime() mengembalikan instans terisolasi; registerBuiltInApiProviders(registry) mengikutsertakan satu registri ke dalam transport bawaan. Modul SDK penyedia dimuat secara bertahap saat pertama kali digunakan.
• Kebijakan host disuntikkan, bukan dibundel. Perlindungan pengambilan permintaan (misalnya kebijakan SSRF), penyamaran rahasia pada teks pemutaran ulang hasil alat, nilai bawaan alat ketat OpenAI, dan pencatatan diagnostik merupakan port AiTransportHost yang dikonfigurasi dengan configureAiTransportHost. Nilai bawaan pustaka tidak aktif; OpenClaw memasang implementasi nyatanya di fasad alirannya.
• Satu identitas aliran peristiwa. @openclaw/ai/event-stream adalah konstruktor EventStream kanonis yang digunakan bersama oleh inti OpenClaw, inti agen, dan pengguna eksternal.
• Subjalur internal/* bukan API. Subjalur tersebut tersedia untuk aplikasi OpenClaw itu sendiri dan tidak memiliki jaminan semver.
• ID penyedia, kredensial, katalog model, percobaan ulang, dan pengalihan saat kegagalan tetap menjadi urusan aplikasi. OpenClaw melapiskan hal-hal tersebut di sekitar paket ini; pengguna pustaka menyediakan objek Model dan opsi secara langsung.

Ekspor subjalur