Skip to main content
SDK plugin chứa các đường dẫn con công khai có phạm vi hẹp và các trình trợ giúp đi kèm chỉ dùng trong kho lưu trữ thuộc openclaw/plugin-sdk/. Trang này lập danh mục cả hai và gắn nhãn rõ ràng cho các mục private-local. Ba tệp xác định ranh giới:
  • scripts/lib/plugin-sdk-entrypoints.json: danh mục điểm vào được duy trì mà bản dựng biên dịch.
  • scripts/lib/plugin-sdk-private-local-only-subpaths.json: các đường dẫn con nội bộ bị loại khỏi SDK có kiểu và được lập tài liệu. Các mục production vẫn khả dụng dưới dạng các bản xuất runtime máy chủ chỉ có JavaScript cho các plugin chính thức được phát hành riêng; các mục chỉ dùng cho kiểm thử vẫn không được xuất.
  • src/plugin-sdk/entrypoints.ts: siêu dữ liệu phân loại cho các đường dẫn con đã ngừng dùng, các trình trợ giúp đi kèm được dành riêng, các facade đi kèm được hỗ trợ và các bề mặt công khai do plugin sở hữu.
Người duy trì kiểm tra số lượng bản xuất công khai bằng pnpm plugin-sdk:surface và các đường dẫn con của trình trợ giúp dành riêng đang hoạt động bằng pnpm plugins:boundary-report:summary; các bản xuất trình trợ giúp dành riêng không được sử dụng khiến báo cáo CI thất bại thay vì tiếp tục nằm trong SDK công khai dưới dạng nợ tương thích không hoạt động. Để xem hướng dẫn tạo plugin, hãy xem Tổng quan về SDK plugin.

Mục plugin

Các trình trợ giúp tương thích và private-local

Chỉ các đường dẫn con đã ngừng dùng thuộc cửa sổ muộn hơn vẫn được xuất. Các bí danh tháng 7 năm 2026 và đường dẫn con không được sử dụng đã bị xóa, còn các trình trợ giúp chỉ dùng đi kèm đã bị loại khỏi gói công khai và được gắn nhãn private-local bên dưới. Danh sách được duy trì là scripts/lib/plugin-sdk-deprecated-public-subpaths.json; CI từ chối các mục đi kèm plugin-sdk/text-runtime chỉ dành cho khả năng tương thích, và plugin-sdk/zod là một bản tái xuất tương thích: nhập trực tiếp zod từ zod. Các barrel miền rộng plugin-sdk/agent-runtime, plugin-sdk/channel-lifecycle, plugin-sdk/conversation-runtime, plugin-sdk/hook-runtime, plugin-sdk/media-runtime, plugin-sdk/plugin-runtimeplugin-sdk/security-runtime cũng đã ngừng dùng để chuyển sang các đường dẫn con chuyên biệt. Các đường dẫn con của trình trợ giúp kiểm thử dựa trên Vitest của OpenClaw chỉ dùng cục bộ trong kho lưu trữ và không còn là bản xuất của gói: agent-runtime-test-contracts, channel-contract-testing, channel-target-testing, channel-test-helpers, plugin-state-test-runtime, plugin-test-api, plugin-test-contracts, plugin-test-runtime, provider-http-test-mocks, provider-test-contracts, reply-payload-testing, sqlite-runtime-testing, test-env, test-fixtures, test-live, test-live-auth, test-media-generation, test-media-understanding, test-node-mockstesting. Các bề mặt trình trợ giúp đi kèm riêng tư ssrf-runtime-internalcodex-native-task-runtime cũng chỉ dùng cục bộ trong kho lưu trữ.

Các đường dẫn con của trình trợ giúp plugin đi kèm

Các mô-đun trợ giúp chỉ dùng đi kèm là private-local sau đợt rà soát tháng 7 năm 2026. Các thao tác nhập xuyên chủ sở hữu bị chặn bởi các rào chắn hợp đồng gói. src/plugin-sdk/entrypoints.ts theo dõi riêng các facade đi kèm được hỗ trợ vẫn giữ trạng thái công khai, các điểm vào SDK được plugin đi kèm tương ứng hỗ trợ cho đến khi các hợp đồng chung thay thế plugin-sdk/qa-runner-runtime, plugin-sdk/telegram-account, đã ngừng dùng cho mã mới; xem ghi chú theo từng hàng bên dưới.
Các đường dẫn con tương thích của kênh thuộc cửa sổ muộn hơn chỉ duy trì công khai đến các ngày tương ứng trong registry. Các bí danh tháng 7 như quyền truy cập DM trực tiếp, tùy chọn trả lời, đường dẫn ghép nối và các nhánh runtime kênh đã bị loại bỏ; các trình trợ giúp chỉ dùng đi kèm là private-local.
Ảnh chụp nhanh mức sử dụng của nhà cung cấp thường báo cáo một hoặc nhiều windows hạn ngạch, mỗi mục có nhãn, phần trăm đã sử dụng và thời gian đặt lại tùy chọn. Các nhà cung cấp cung cấp văn bản số dư hoặc trạng thái tài khoản thay vì các khoảng hạn ngạch có thể đặt lại nên trả về summary với mảng windows trống thay vì tạo ra các tỷ lệ phần trăm giả. OpenClaw hiển thị văn bản tóm tắt đó trong đầu ra trạng thái; chỉ sử dụng error khi endpoint mức sử dụng gặp lỗi hoặc không trả về dữ liệu mức sử dụng có thể dùng được.
Các đường dẫn con SDK của helper đi kèm được dành riêng là những bề mặt hẹp dành riêng cho chủ sở hữu đối với mã Plugin đi kèm. Chúng được theo dõi trong danh mục SDK để các bản dựng gói và việc đặt bí danh luôn xác định, nhưng không phải là API chung để xây dựng Plugin. Các hợp đồng máy chủ có thể tái sử dụng mới nên dùng các đường dẫn con SDK chung như plugin-sdk/gateway-runtimeplugin-sdk/ssrf-runtime.

Liên quan