Pacchetto @openclaw/ai

​

Avvio rapido

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

​

Contratto di progettazione

• Con ambito limitato all’istanza per impostazione predefinita. L’importazione del pacchetto non registra nulla globalmente. createApiRegistry() / createLlmRuntime() restituiscono istanze isolate; registerBuiltInApiProviders(registry) abilita i trasporti integrati per un singolo registro. I moduli SDK dei provider vengono caricati in modo differito al primo utilizzo.
• I criteri dell’host vengono inseriti, non incorporati. La protezione delle richieste fetch (ad esempio i criteri SSRF), l’occultamento dei segreti nel testo riprodotto dei risultati degli strumenti, le impostazioni predefinite per gli strumenti in modalità rigorosa di OpenAI e la registrazione della diagnostica sono porte AiTransportHost configurate con configureAiTransportHost. Le impostazioni predefinite della libreria sono inerti; OpenClaw installa le proprie implementazioni effettive nella sua facciata dei flussi.
• Un’unica identità per i flussi di eventi. @openclaw/ai/event-stream è il costruttore canonico EventStream condiviso dal nucleo di OpenClaw, da agent-core e dagli utenti esterni.
• I sottopercorsi internal/* non fanno parte dell’API. Esistono per l’applicazione OpenClaw stessa e non offrono alcuna garanzia semver.
• Gli ID dei provider, le credenziali, i cataloghi dei modelli, i nuovi tentativi e il failover rimangono responsabilità dell’applicazione. OpenClaw aggiunge questi livelli attorno al pacchetto; chi utilizza la libreria fornisce direttamente un oggetto Model e le relative opzioni.

​

Esportazioni dei sottopercorsi