@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

  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