Chuyển đến nội dung chính
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 đóng gói chỉ dùng trong kho lưu trữ dưới openclaw/plugin-sdk/. Trang này lập danh mục cả hai và ghi nhãn rõ ràng cho các mục riêng tư cục bộ. 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 kiểm thử/nội bộ cục bộ của kho lưu trữ. Các mục xuất của gói là danh mục trừ đi danh sách này.
  • src/plugin-sdk/entrypoints.ts: siêu dữ liệu phân loại cho các đường dẫn con không còn được khuyến nghị, các trình trợ giúp đóng gói dành riêng, các facade đóng gói được hỗ trợ và các bề mặt công khai do plugin sở hữu.
Người bảo trì kiểm tra số lượng mục xuất công khai bằng pnpm plugin-sdk:surface và các đường dẫn con trình trợ giúp dành riêng đang hoạt động bằng pnpm plugins:boundary-report:summary; các mục xuất trình trợ giúp dành riêng không được sử dụng sẽ khiến báo cáo Pipeline 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 SDK Plugin.

​
Điểm vào plugin

​
Trình trợ giúp tương thích và riêng tư cục bộ

Chỉ các đường dẫn con không còn được khuyến nghị thuộc giai đoạn sau 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, trong khi các trình trợ giúp chỉ dành cho bản đóng gói đã bị loại khỏi gói công khai và được ghi nhãn riêng tư cục bộ 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 đóng gói plugin-sdk/text-runtime chỉ dành cho tương thích, và plugin-sdk/zod là một mục 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-runtime và plugin-sdk/security-runtime cũng không còn được khuyến nghị; hãy dùng các đường dẫn con chuyên biệt thay thế. Các đường dẫn con 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à mục 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-mocks và testing. Các bề mặt trình trợ giúp đóng gói riêng tư ssrf-runtime-internal và codex-native-task-runtime cũng chỉ dùng cục bộ trong kho lưu trữ.

​
Các đường dẫn con trình trợ giúp plugin đóng gói

Các mô-đun trình trợ giúp chỉ dành cho bản đóng gói là riêng tư cục bộ sau đợt rà soát tháng 7 năm 2026. Các mụ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 đóng gói được hỗ trợ vẫn còn công khai, tức các điểm vào SDK được plugin đóng gói 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, không còn được khuyến nghị 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 kênh thuộc giai đoạn sau chỉ tiếp tục công khai đến các ngày trong sổ đăng ký tương ứng. Các bí danh tháng 7 như quyền truy cập DM trực tiếp, tùy chọn phản hồi, đường dẫn ghép nối và các phần tách thời gian chạy kênh đã bị loại bỏ; các trình trợ giúp chỉ dành cho bản đóng gói là riêng tư cục bộ.
Ả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. Những nhà cung cấp hiển thị số dư hoặc văn bản trạng thái tài khoản thay vì các khoảng hạn ngạch có thể đặt lại phải trả về summary với mảng windows trống thay vì tạo ra các tỷ lệ phần trăm không có thật. 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 khả dụng.
Các đường dẫn con SDK helper đi kèm được dành riêng là những bề mặt chuyên biệt hẹp theo chủ sở hữu dành cho mã plugin đi kèm. Chúng được theo dõi trong kho kiểm kê SDK để các bản dựng gói và việc đặt bí danh luôn có tính 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-runtime và plugin-sdk/ssrf-runtime.

​
Liên quan