Pacchetto @openclaw/ai

@openclaw/ai è la forma di libreria pubblicabile del livello di esecuzione dei modelli di OpenClaw: contratti neutrali rispetto al provider per messaggi, strumenti e flussi, convalida, diagnostica, flussi di eventi, un registro di runtime isolato e adattatori caricati in modo differito per le otto famiglie di API integrate (Anthropic Messages, OpenAI Completions, OpenAI Responses, Azure OpenAI Responses, ChatGPT/Codex Responses, Google Generative AI, Google Vertex, Mistral Conversations).

Viene pubblicata insieme al pacchetto radice openclaw a ogni rilascio, vincolata alla stessa versione e con un proprio npm-shrinkwrap.json, affinché il relativo albero delle dipendenze transitive sia bloccato al momento dell'installazione. L'installazione di openclaw installa automaticamente la versione corrispondente di @openclaw/ai; chi utilizza la libreria può dichiararla direttamente come dipendenza senza alcun codice applicativo di OpenClaw.

Avvio rapido

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

Una versione eseguibile è disponibile nel repository in examples/ai-chat.

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