Paquete @openclaw/ai

@openclaw/ai es la forma de biblioteca publicable de la capa de ejecución de modelos de OpenClaw: contratos neutrales respecto al 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 versión, fijado a la misma versión, con su propio npm-shrinkwrap.json para que su árbol de dependencias transitivas quede bloqueado durante la instalación. Instalar openclaw instala automáticamente el @openclaw/ai correspondiente; quienes consumen la biblioteca pueden depender de él directamente sin código de la aplicación 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 ámbito de instancia de forma predeterminada. Importar el paquete no registra nada globalmente. createApiRegistry() / createLlmRuntime() devuelven instancias aisladas; registerBuiltInApiProviders(registry) habilita los transportes integrados en un registro. Los módulos del SDK del proveedor se cargan de forma diferida la primera vez que se usan.
• La política del host se inyecta, no se incluye. La protección de fetch para solicitudes (por ejemplo, la política de SSRF), la ocultación de secretos en el texto de repetició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 flujos.
• Una única identidad de flujo de eventos. @openclaw/ai/event-stream es el constructor canónico de EventStream compartido por el núcleo de OpenClaw, agent-core y los consumidores externos.
• Las subrutas internal/* no forman parte de la API. Existen para la propia aplicación OpenClaw y no ofrecen ninguna garantía de semver.
• Los identificadores de proveedores, las credenciales, los catálogos de modelos, los reintentos y la conmutación por error siguen siendo responsabilidad de la aplicación. OpenClaw añade esas capas alrededor de este paquete; quien consume la biblioteca proporciona directamente un objeto Model y las opciones.

Exportaciones de subrutas