> ## 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.

# @openclaw/ai-Paket

`@openclaw/ai` ist die veröffentlichbare Bibliotheksform der Modellausführungsschicht
von OpenClaw: Provider-neutrale Nachrichten-, Tool- und Stream-Verträge, Validierung, Diagnose,
Ereignisströme, eine isolierte Runtime-Registry und verzögert geladene Adapter für die acht
integrierten API-Familien (Anthropic Messages, OpenAI Completions, OpenAI
Responses, Azure OpenAI Responses, ChatGPT/Codex Responses, Google Generative
AI, Google Vertex, Mistral Conversations).

Sie wird bei jeder Veröffentlichung zusammen mit dem Root-Paket `openclaw` veröffentlicht und ist
auf dieselbe Version festgelegt. Sie verfügt über eine eigene `npm-shrinkwrap.json`, sodass ihr transitiver
Abhängigkeitsbaum zum Installationszeitpunkt gesperrt wird. Bei der Installation von `openclaw` wird
die passende Version von `@openclaw/ai` automatisch installiert; Bibliotheksnutzer können sie
direkt als Abhängigkeit verwenden, ohne Anwendungscode von OpenClaw einzubeziehen.

## Schnellstart

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

Eine ausführbare Version befindet sich im Repository unter `examples/ai-chat`.

## Designvertrag

* **Standardmäßig instanzbezogen.** Beim Importieren des Pakets wird nichts
  global registriert. `createApiRegistry()` / `createLlmRuntime()` geben isolierte
  Instanzen zurück; `registerBuiltInApiProviders(registry)` bindet eine Registry an die
  integrierten Transportmechanismen an. Provider-SDK-Module werden bei der ersten Verwendung verzögert geladen.
* **Host-Richtlinien werden injiziert, nicht gebündelt.** Die Absicherung des Request-Abrufs (zum
  Beispiel SSRF-Richtlinien), die Schwärzung geheimer Daten im wiedergegebenen Text von Tool-Ergebnissen, die
  OpenAI-Standardwerte für strikte Tools und die Diagnoseprotokollierung sind `AiTransportHost`-Ports,
  die mit `configureAiTransportHost` konfiguriert werden. Die Bibliotheksstandardwerte sind inaktiv;
  OpenClaw installiert seine tatsächlichen Implementierungen in seiner Stream-Fassade.
* **Eine Ereignisstromidentität.** `@openclaw/ai/event-stream` ist der kanonische
  `EventStream`-Konstruktor, den OpenClaw Core, Agent Core und externe
  Nutzer gemeinsam verwenden.
* **`internal/*`-Unterpfade sind keine API.** Sie sind für die OpenClaw-
  Anwendung selbst vorgesehen und bieten keine SemVer-Garantie.
* Provider-IDs, Zugangsdaten, Modellkataloge, Wiederholungsversuche und Failover bleiben
  Belange der Anwendung. OpenClaw legt diese Schichten um dieses Paket; Bibliotheksnutzer
  stellen direkt ein `Model`-Objekt und Optionen bereit.

## Unterpfad-Exporte

| Unterpfad        | Inhalt                                                                        |
| ---------------- | ----------------------------------------------------------------------------- |
| `.`              | Verträge, `createApiRegistry`, `createLlmRuntime`, `configureAiTransportHost` |
| `./providers`    | `registerBuiltInApiProviders`, `resetApiProviders`                            |
| `./types`        | Modell-, Nachrichten-, Tool- und Stream-Typen                                 |
| `./validation`   | Validierung von Tool-Argumenten                                               |
| `./diagnostics`  | Diagnoseverträge                                                              |
| `./event-stream` | Gemeinsame `EventStream`-Implementierung                                      |
| `./internal/*`   | OpenClaw-intern, keine SemVer-Garantie                                        |