Skip to main content
SDK plugin berisi subjalur publik yang terbatas dan helper terbundel khusus repositori di bawah openclaw/plugin-sdk/. Halaman ini mengatalogkan keduanya dan memberi label secara eksplisit pada entri privat-lokal. Tiga file mendefinisikan batas tersebut:
  • scripts/lib/plugin-sdk-entrypoints.json: inventaris titik masuk yang dipelihara dan dikompilasi oleh build.
  • scripts/lib/plugin-sdk-private-local-only-subpaths.json: subjalur internal yang dikecualikan dari SDK bertipe dan terdokumentasi. Entri produksi tetap tersedia sebagai ekspor runtime host khusus JavaScript untuk plugin resmi yang diterbitkan secara terpisah; entri khusus pengujian tetap tidak diekspor.
  • src/plugin-sdk/entrypoints.ts: metadata klasifikasi untuk subjalur yang tidak digunakan lagi, helper terbundel yang dicadangkan, fasad terbundel yang didukung, dan permukaan publik milik plugin.
Pemelihara mengaudit jumlah ekspor publik dengan pnpm plugin-sdk:surface dan subjalur helper cadangan yang aktif dengan pnpm plugins:boundary-report:summary; ekspor helper cadangan yang tidak digunakan menyebabkan laporan CI gagal alih-alih tetap berada dalam SDK publik sebagai utang kompatibilitas yang tidak aktif. Untuk panduan penulisan plugin, lihat Ikhtisar SDK Plugin.

Entri plugin

Kompatibilitas dan helper privat-lokal

Hanya subjalur yang tidak digunakan lagi dari rentang waktu yang lebih akhir yang tetap diekspor. Alias Juli 2026 dan subjalur yang tidak digunakan telah dihapus, sedangkan helper khusus terbundel telah dihapus dari paket publik dan diberi label privat-lokal di bawah. Daftar yang dipelihara adalah scripts/lib/plugin-sdk-deprecated-public-subpaths.json; CI menolak subjalur terbundel. plugin-sdk/text-runtime hanya untuk kompatibilitas, dan plugin-sdk/zod adalah ekspor ulang kompatibilitas: impor zod secara langsung dari zod. Barrel domain luas plugin-sdk/agent-runtime, plugin-sdk/channel-lifecycle, plugin-sdk/conversation-runtime, plugin-sdk/hook-runtime, plugin-sdk/media-runtime, plugin-sdk/plugin-runtime, dan plugin-sdk/security-runtime juga tidak digunakan lagi dan digantikan oleh subjalur yang terfokus. Subjalur helper pengujian OpenClaw yang didukung Vitest hanya bersifat lokal repositori dan tidak lagi menjadi ekspor paket: 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, dan testing. Permukaan helper terbundel privat ssrf-runtime-internal dan codex-native-task-runtime juga hanya bersifat lokal repositori.

Subjalur helper plugin terbundel

Modul helper khusus terbundel bersifat privat-lokal setelah penyisiran Juli 2026. Impor lintas pemilik diblokir oleh pagar pengaman kontrak paket. src/plugin-sdk/entrypoints.ts secara terpisah melacak fasad terbundel yang didukung dan tetap publik, yaitu titik masuk SDK yang didukung oleh plugin terbundelnya hingga kontrak generik menggantikan plugin-sdk/qa-runner-runtime, plugin-sdk/telegram-account, yang tidak digunakan lagi untuk kode baru; lihat catatan per baris di bawah.
Subjalur kompatibilitas saluran dari rentang waktu yang lebih akhir tetap publik hanya hingga tanggal registrinya. Alias Juli seperti akses DM langsung, opsi balasan, jalur pemasangan, dan pecahan runtime saluran telah dihapus; helper khusus terbundel bersifat privat-lokal.
Snapshot penggunaan penyedia biasanya melaporkan satu atau beberapa windows kuota, masing-masing dengan label, persentase yang digunakan, dan waktu pengaturan ulang opsional. Penyedia yang mengekspos teks saldo atau status akun alih-alih jendela kuota yang dapat diatur ulang harus mengembalikan summary dengan larik windows kosong, bukan membuat-buat persentase. OpenClaw menampilkan teks ringkasan tersebut dalam keluaran status; gunakan error hanya saat titik akhir penggunaan gagal atau tidak mengembalikan data penggunaan yang dapat digunakan.
Subpath SDK helper bawaan yang dicadangkan merupakan permukaan sempit khusus pemilik untuk kode plugin bawaan. Subpath tersebut dilacak dalam inventaris SDK agar pembangunan paket dan pemberian alias tetap deterministik, tetapi bukan API umum untuk pembuatan plugin. Kontrak host baru yang dapat digunakan kembali harus menggunakan subpath SDK generik seperti plugin-sdk/gateway-runtime dan plugin-sdk/ssrf-runtime.

Terkait