@openclaw/ai パッケージ

@openclaw/ai は、OpenClaw のモデル実行レイヤーを公開可能なライブラリ形式にしたものです。 プロバイダーに依存しないメッセージ/ツール/ストリーム契約、検証、診断、 イベントストリーム、分離されたランタイムレジストリ、そして 8 つの 組み込み API ファミリー (Anthropic Messages、OpenAI Completions、OpenAI Responses、Azure OpenAI Responses、ChatGPT/Codex Responses、Google Generative AI、Google Vertex、Mistral Conversations) 向けの遅延アダプターを提供します。

これはすべてのリリースでルートの openclaw パッケージと一緒に公開され、 同じバージョンに固定されます。また、独自の npm-shrinkwrap.json を持つため、 推移的な依存関係ツリーはインストール時にロックされます。openclaw を インストールすると、対応する @openclaw/ai が自動的にインストールされます。 ライブラリ利用者は、OpenClaw アプリケーションコードなしでこれに直接依存できます。

クイックスタート

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

実行可能なバージョンは、リポジトリの examples/ai-chat にあります。

設計契約

• デフォルトでインスタンススコープです。 パッケージをインポートしても、 グローバルには何も登録されません。createApiRegistry() / createLlmRuntime() は 分離されたインスタンスを返します。registerBuiltInApiProviders(registry) は、 1 つのレジストリを組み込みトランスポートにオプトインします。プロバイダー SDK モジュールは初回使用時に遅延ロードされます。
• ホストポリシーは注入され、バンドルされません。 リクエスト fetch のガード (たとえば SSRF ポリシー)、ツール結果リプレイテキストのシークレット秘匿、 OpenAI strict-tool のデフォルト、診断ロギングは、 configureAiTransportHost で構成される AiTransportHost ポートです。 ライブラリのデフォルトは何もしません。OpenClaw は、ストリームファサード内で 実際の実装をインストールします。
• イベントストリームの同一性は 1 つです。 @openclaw/ai/event-stream は、 OpenClaw core、agent-core、外部利用者が共有する正規の EventStream コンストラクターです。
• internal/* サブパスは API ではありません。 これらは OpenClaw アプリケーション自体のために存在し、semver の保証はありません。
• プロバイダー ID、認証情報、モデルカタログ、リトライ、フェイルオーバーは、 引き続きアプリケーションの関心事です。OpenClaw はこのパッケージの周囲に それらを重ねます。ライブラリ利用者は Model オブジェクトとオプションを 直接指定します。

サブパスエクスポート