@openclaw/ai 软件包

​

快速开始

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) 让一个注册表选择启用内置传输。提供商 SDK 模块会在首次使用时延迟加载。
• 宿主策略通过注入提供，而非内置。 请求 fetch 防护（例如 SSRF 策略）、工具结果重放文本的密钥遮盖、OpenAI 严格工具默认值以及诊断日志均为 AiTransportHost 端口，并通过 configureAiTransportHost 配置。该库的默认实现不执行任何操作；OpenClaw 会在其流式传输门面中安装实际实现。
• 统一的事件流标识。 @openclaw/ai/event-stream 是 OpenClaw 核心、agent-core 和外部使用者共享的规范 EventStream 构造函数。
• internal/* 子路径并非 API。 它们仅供 OpenClaw 应用自身使用，不提供任何语义化版本保证。
• 提供商 ID、凭据、模型目录、重试和故障转移仍属于应用层关注事项。OpenClaw 会围绕此软件包添加这些功能；库使用者则直接提供 Model 对象和选项。

​

子路径导出