@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
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 mitconfigureAiTransportHostkonfiguriert werden. Die Bibliotheksstandardwerte sind inaktiv; OpenClaw installiert seine tatsächlichen Implementierungen in seiner Stream-Fassade. - Eine Ereignisstromidentität.
@openclaw/ai/event-streamist der kanonischeEventStream-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.