paquete @openclaw/ai

@openclaw/ai es la forma de biblioteca publicable de la capa de ejecución de modelos de OpenClaw: contratos neutrales respecto del proveedor para mensajes/herramientas/flujos, validación, diagnósticos, flujos de eventos, un registro de runtime aislado y adaptadores de carga diferida para las ocho familias de API integradas (Anthropic Messages, OpenAI Completions, OpenAI Responses, Azure OpenAI Responses, ChatGPT/Codex Responses, Google Generative AI, Google Vertex, Mistral Conversations).

Se publica junto con el paquete raíz openclaw en cada lanzamiento, fijado a la misma versión, con su propio npm-shrinkwrap.json para que su árbol de dependencias transitivas quede bloqueado en el momento de la instalación. Instalar openclaw instala automáticamente el @openclaw/ai correspondiente; los consumidores de la biblioteca pueden depender de él directamente sin ningún código de aplicación de OpenClaw.

Inicio rápido

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

Hay una versión ejecutable en el repositorio en examples/ai-chat.

Contrato de diseño

• Con alcance de instancia de forma predeterminada. Importar el paquete no registra nada globalmente. createApiRegistry() / createLlmRuntime() devuelven instancias aisladas; registerBuiltInApiProviders(registry) opta por habilitar los transportes integrados en un registro. Los módulos SDK de proveedor se cargan de forma diferida en el primer uso.
• La política del host se inyecta, no se empaqueta. La protección de fetch de solicitudes (por ejemplo, la política SSRF), la redacción de secretos del texto de reproducción de resultados de herramientas, los valores predeterminados de herramientas estrictas de OpenAI y el registro de diagnósticos son puertos AiTransportHost configurados con configureAiTransportHost. Los valores predeterminados de la biblioteca son inertes; OpenClaw instala sus implementaciones reales en su fachada de flujo.
• Una identidad de flujo de eventos. @openclaw/ai/event-stream es el constructor EventStream canónico compartido por el núcleo de OpenClaw, agent-core y consumidores externos.
• Las subrutas internal/* no son API. Existen para la propia aplicación OpenClaw y no tienen garantía semver.
• Los ids de proveedor, las credenciales, los catálogos de modelos, los reintentos y la conmutación por error siguen siendo responsabilidades de la aplicación. OpenClaw superpone esas capas alrededor de este paquete; un consumidor de la biblioteca proporciona directamente un objeto Model y opciones.

Exportaciones de subruta