@openclaw/ai package

​

快速开始

import { createLlmRuntime } from "@openclaw/ai";
import { registerBuiltInApiProviders } from "@openclaw/ai/providers";

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

​

设计契约

• 默认按实例作用域。 导入该包不会在全局注册任何内容。createApiRegistry() / createLlmRuntime() 返回隔离的实例；registerBuiltInApiProviders(registry) 会让某个 registry 使用内置传输层。Provider SDK 模块会在首次使用时按需懒加载。
• 宿主策略是注入的，不是打包进来的。 请求 fetch 保护（例如 SSRF 策略）、工具结果回放文本的密钥脱敏、OpenAI 严格工具默认值，以及诊断日志记录，都是通过 configureAiTransportHost 配置的 AiTransportHost 端口。库的默认实现是无操作的；OpenClaw 会在其流式外观层中安装真实实现。
• 只有一个事件流身份。 @openclaw/ai/event-stream 是由 OpenClaw core、agent-core 和外部消费者共享的规范 EventStream 构造函数。
• internal/* 子路径不属于 API。 它们仅供 OpenClaw 应用自身使用，不提供任何语义化版本保证。
• Provider id、凭据、模型目录、重试和故障转移仍然属于应用层职责。OpenClaw 在该包之上封装这些能力；库的使用者直接提供一个 Model 对象和选项。

​

Subpath Exports