Пакет @openclaw/ai

@openclaw/ai — это публикуемая библиотечная форма слоя выполнения моделей OpenClaw: независимые от провайдера контракты сообщений, инструментов и потоковой передачи, валидация, диагностика, потоки событий, изолированный реестр среды выполнения и лениво загружаемые адаптеры для восьми встроенных семейств 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) явно подключает встроенные транспорты к одному реестру. Модули SDK провайдеров загружаются лениво при первом использовании.
• Политика хоста внедряется, а не встраивается. Защита запросов fetch (например, политика SSRF), редактирование секретов в тексте повторного воспроизведения результатов инструментов, настройки строгого режима инструментов OpenAI по умолчанию и журналирование диагностики представлены портами AiTransportHost, которые настраиваются через configureAiTransportHost. Настройки библиотеки по умолчанию неактивны; OpenClaw устанавливает реальные реализации в своём фасаде потоковой передачи.
• Единый тип потока событий. @openclaw/ai/event-stream предоставляет канонический конструктор EventStream, общий для ядра OpenClaw, agent-core и внешних пользователей.
• Подпути internal/* не являются API. Они предназначены для самого приложения OpenClaw и не имеют гарантий семантического версионирования.
• Идентификаторы провайдеров, учётные данные, каталоги моделей, повторные попытки и переключение при сбое остаются ответственностью приложения. OpenClaw дополняет этот пакет соответствующими слоями; пользователь библиотеки передаёт объект Model и параметры напрямую.

Экспорты подпутей