Gói @openclaw/ai

@openclaw/ai là dạng thư viện có thể phát hành của lớp thực thi mô hình trong OpenClaw: các hợp đồng thông điệp/công cụ/luồng phát trực tuyến trung lập với nhà cung cấp, xác thực, chẩn đoán, luồng sự kiện, sổ đăng ký thời gian chạy biệt lập và các bộ điều hợp tải lười cho tám họ API tích hợp sẵn (Anthropic Messages, OpenAI Completions, OpenAI Responses, Azure OpenAI Responses, ChatGPT/Codex Responses, Google Generative AI, Google Vertex, Mistral Conversations).

Thư viện này được phát hành cùng gói openclaw gốc trong mỗi bản phát hành, được ghim ở cùng phiên bản và có npm-shrinkwrap.json riêng để khóa cây phụ thuộc bắc cầu tại thời điểm cài đặt. Việc cài đặt openclaw sẽ tự động cài đặt phiên bản @openclaw/ai tương ứng; người dùng thư viện có thể phụ thuộc trực tiếp vào gói này mà không cần bất kỳ mã ứng dụng OpenClaw nào.

Bắt đầu nhanh

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

Một phiên bản có thể chạy nằm trong kho lưu trữ tại examples/ai-chat.

Hợp đồng thiết kế

• Theo phạm vi thực thể theo mặc định. Việc nhập gói không đăng ký bất kỳ thứ gì trên toàn cục. createApiRegistry() / createLlmRuntime() trả về các thực thể biệt lập; registerBuiltInApiProviders(registry) chủ động bật các cơ chế truyền tải tích hợp sẵn cho một sổ đăng ký. Các mô-đun SDK của nhà cung cấp được tải lười trong lần sử dụng đầu tiên.
• Chính sách của máy chủ được đưa vào, không được đóng gói kèm. Cơ chế bảo vệ thao tác tìm nạp yêu cầu (ví dụ: chính sách SSRF), che giấu bí mật trong văn bản phát lại kết quả công cụ, các giá trị mặc định về công cụ nghiêm ngặt của OpenAI và ghi nhật ký chẩn đoán là các cổng AiTransportHost được cấu hình bằng configureAiTransportHost. Các giá trị mặc định của thư viện không thực hiện hành động nào; OpenClaw cài đặt các phần triển khai thực tế trong giao diện luồng phát trực tuyến của mình.
• Một định danh luồng sự kiện. @openclaw/ai/event-stream là hàm khởi tạo EventStream chuẩn tắc được chia sẻ bởi lõi OpenClaw, agent-core và người dùng bên ngoài.
• Các đường dẫn con internal/* không phải là API. Chúng tồn tại cho chính ứng dụng OpenClaw và không có bảo đảm về semver.
• ID nhà cung cấp, thông tin xác thực, danh mục mô hình, cơ chế thử lại và chuyển đổi dự phòng vẫn thuộc phạm vi xử lý của ứng dụng. OpenClaw bổ sung các lớp xử lý đó xung quanh gói này; người dùng thư viện cung cấp trực tiếp một đối tượng Model và các tùy chọn.

Các mục xuất theo đường dẫn con