> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```js theme={"theme":{"light":"min-light","dark":"min-dark"}}
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();
```

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

| Subruta          | Contenido                                                                      |
| ---------------- | ------------------------------------------------------------------------------ |
| `.`              | Contratos, `createApiRegistry`, `createLlmRuntime`, `configureAiTransportHost` |
| `./providers`    | `registerBuiltInApiProviders`, `resetApiProviders`                             |
| `./types`        | Tipos de modelo/mensaje/herramienta/flujo                                      |
| `./validation`   | Validación de argumentos de herramientas                                       |
| `./diagnostics`  | Contratos de diagnósticos                                                      |
| `./event-stream` | Implementación compartida de `EventStream`                                     |
| `./internal/*`   | Interno de OpenClaw, sin garantía semver                                       |