Package @openclaw/ai

@openclaw/ai est la forme publiable sous forme de bibliothèque de la couche d’exécution des modèles d’OpenClaw : contrats indépendants des fournisseurs pour les messages, les outils et les flux, validation, diagnostics, flux d’événements, registre d’exécution isolé et adaptateurs chargés à la demande pour les huit familles d’API intégrées (Anthropic Messages, OpenAI Completions, OpenAI Responses, Azure OpenAI Responses, ChatGPT/Codex Responses, Google Generative AI, Google Vertex, Mistral Conversations).

Elle est publiée avec le paquet racine openclaw à chaque version, épinglée à la même version, avec son propre npm-shrinkwrap.json afin que son arborescence de dépendances transitives soit verrouillée lors de l’installation. L’installation d’openclaw installe automatiquement la version correspondante de @openclaw/ai ; les utilisateurs de la bibliothèque peuvent en dépendre directement sans aucun code de l’application OpenClaw.

Démarrage rapide

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

Une version exécutable se trouve dans le dépôt à l’emplacement examples/ai-chat.

Contrat de conception

• Portée limitée à l’instance par défaut. L’importation du paquet n’enregistre rien globalement. createApiRegistry() / createLlmRuntime() renvoient des instances isolées ; registerBuiltInApiProviders(registry) active les transports intégrés pour un registre donné. Les modules SDK des fournisseurs sont chargés à la demande lors de leur première utilisation.
• La politique de l’hôte est injectée, pas intégrée. La protection des requêtes fetch (par exemple, la politique SSRF), la suppression des secrets dans le texte de relecture des résultats d’outils, les valeurs par défaut du mode strict des outils OpenAI et la journalisation des diagnostics sont des ports AiTransportHost configurés avec configureAiTransportHost. Les valeurs par défaut de la bibliothèque sont inertes ; OpenClaw installe ses implémentations réelles dans sa façade de flux.
• Une identité unique pour le flux d’événements. @openclaw/ai/event-stream est le constructeur EventStream canonique partagé par le cœur d’OpenClaw, agent-core et les utilisateurs externes.
• Les sous-chemins internal/* ne font pas partie de l’API. Ils existent pour l’application OpenClaw elle-même et n’offrent aucune garantie semver.
• Les identifiants des fournisseurs, les identifiants d’authentification, les catalogues de modèles, les nouvelles tentatives et le basculement restent du ressort de l’application. OpenClaw ajoute ces couches autour de ce paquet ; l’utilisateur d’une bibliothèque fournit directement un objet Model et des options.

Exportations des sous-chemins