@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 严格工具默认值，以及诊断日志，都是通过 configureAiTransportHost 配置的 AiTransportHost 端口。库默认值是惰性的；OpenClaw 会在它的流式传输门面中安装真实实现。
• 一个事件流身份。 @openclaw/ai/event-stream 是 OpenClaw 核心、agent-core 和外部消费者共享的规范 EventStream 构造函数。
• internal/* 子路径不是 API。 它们仅供 OpenClaw 应用自身使用，不提供任何 semver 保证。
• 提供商 ID、凭证、模型目录、重试和故障转移仍然是应用关注点。OpenClaw 会围绕此包叠加这些能力；库消费者则直接提供 Model 对象和选项。

子路径导出