Skip to main content
@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

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