Migrasi Plugin SDK

OpenClaw telah beralih dari lapisan kompatibilitas mundur yang luas ke arsitektur plugin modern dengan import yang terfokus dan terdokumentasi. Jika plugin Anda dibuat sebelum arsitektur baru, panduan ini membantu Anda bermigrasi.

Apa yang berubah

Sistem plugin lama menyediakan dua permukaan terbuka lebar yang memungkinkan plugin mengimpor apa pun yang mereka butuhkan dari satu entry point:

openclaw/plugin-sdk/compat — satu import yang mengekspor ulang puluhan helper. Ini diperkenalkan untuk menjaga plugin berbasis hook lama tetap berfungsi sementara arsitektur plugin baru sedang dibangun.
openclaw/extension-api — jembatan yang memberi plugin akses langsung ke helper sisi host seperti embedded agent runner.

Kedua permukaan kini deprecated. Keduanya masih berfungsi saat runtime, tetapi plugin baru tidak boleh menggunakannya, dan plugin yang ada harus bermigrasi sebelum rilis mayor berikutnya menghapusnya.

Lapisan kompatibilitas mundur akan dihapus pada rilis mayor mendatang. Plugin yang masih mengimpor dari permukaan ini akan rusak saat itu terjadi.

Mengapa ini berubah

Pendekatan lama menimbulkan masalah:

Startup lambat — mengimpor satu helper memuat puluhan modul yang tidak terkait
Dependensi sirkular — ekspor ulang yang luas memudahkan terciptanya siklus import
Permukaan API tidak jelas — tidak ada cara untuk mengetahui ekspor mana yang stabil vs internal

Plugin SDK modern memperbaiki hal ini: setiap path import (openclaw/plugin-sdk/\<subpath\>) adalah modul kecil yang berdiri sendiri dengan tujuan yang jelas dan kontrak yang terdokumentasi. Seam kenyamanan provider lama untuk channel bawaan juga telah dihapus. Import seperti openclaw/plugin-sdk/slack, openclaw/plugin-sdk/discord, openclaw/plugin-sdk/signal, openclaw/plugin-sdk/whatsapp, seam helper berlabel channel, dan openclaw/plugin-sdk/telegram-core adalah shortcut mono-repo privat, bukan kontrak plugin yang stabil. Gunakan subpath SDK generik yang sempit sebagai gantinya. Di dalam workspace plugin bawaan, simpan helper milik provider dalam api.ts atau runtime-api.ts milik plugin itu sendiri. Contoh provider bawaan saat ini:

Anthropic menyimpan helper stream khusus Claude di seam api.ts / contract-api.ts miliknya sendiri
OpenAI menyimpan builder provider, helper model default, dan builder provider realtime di api.ts miliknya sendiri
OpenRouter menyimpan builder provider dan helper onboarding/config di api.ts miliknya sendiri

Cara bermigrasi

Migrasikan handler native approval ke fakta kapabilitas

Plugin channel yang mendukung approval kini mengekspos perilaku approval native melalui approvalCapability.nativeRuntime serta registry konteks runtime bersama.Perubahan utama:

Ganti approvalCapability.handler.loadRuntime(...) dengan approvalCapability.nativeRuntime
Pindahkan auth/pengiriman khusus approval dari wiring lama plugin.auth / plugin.approvals ke approvalCapability
ChannelPlugin.approvals telah dihapus dari kontrak publik plugin channel; pindahkan field delivery/native/render ke approvalCapability
plugin.auth tetap ada hanya untuk alur login/logout channel; hook auth approval di sana tidak lagi dibaca oleh core
Daftarkan objek runtime milik channel seperti klien, token, atau aplikasi Bolt melalui openclaw/plugin-sdk/channel-runtime-context
Jangan kirim pemberitahuan reroute milik plugin dari handler approval native; core kini memiliki notifikasi diarahkan-ke-tempat-lain dari hasil pengiriman yang sebenarnya
Saat meneruskan channelRuntime ke createChannelManager(...), sediakan permukaan createPluginRuntime().channel yang nyata. Stub parsial akan ditolak.

Lihat /plugins/sdk-channel-plugins untuk tata letak kapabilitas approval saat ini.

Audit perilaku fallback wrapper Windows

Jika plugin Anda menggunakan openclaw/plugin-sdk/windows-spawn, wrapper Windows .cmd/.bat yang tidak ter-resolve kini gagal tertutup kecuali Anda secara eksplisit meneruskan allowShellFallback: true.

// Sebelumnya
const program = applyWindowsSpawnProgramPolicy({ candidate });

// Sesudahnya
const program = applyWindowsSpawnProgramPolicy({
  candidate,
  // Setel ini hanya untuk pemanggil kompatibilitas tepercaya yang memang
  // menerima fallback yang dimediasi shell.
  allowShellFallback: true,
});

Jika pemanggil Anda tidak sengaja bergantung pada fallback shell, jangan setel allowShellFallback dan tangani error yang dilempar sebagai gantinya.

Temukan import yang deprecated

Cari dalam plugin Anda import dari salah satu permukaan deprecated:

grep -r "plugin-sdk/compat" my-plugin/
grep -r "openclaw/extension-api" my-plugin/

Ganti dengan import yang terfokus

Setiap ekspor dari permukaan lama dipetakan ke path import modern tertentu:

// Sebelumnya (lapisan kompatibilitas mundur yang deprecated)
import {
  createChannelReplyPipeline,
  createPluginRuntimeStore,
  resolveControlCommandGate,
} from "openclaw/plugin-sdk/compat";

// Sesudahnya (import modern yang terfokus)
import { createChannelReplyPipeline } from "openclaw/plugin-sdk/channel-reply-pipeline";
import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
import { resolveControlCommandGate } from "openclaw/plugin-sdk/command-auth";

Untuk helper sisi host, gunakan runtime plugin yang diinjeksi alih-alih mengimpor secara langsung:

// Sebelumnya (jembatan extension-api yang deprecated)
import { runEmbeddedPiAgent } from "openclaw/extension-api";
const result = await runEmbeddedPiAgent({ sessionId, prompt });

// Sesudahnya (runtime yang diinjeksi)
const result = await api.runtime.agent.runEmbeddedPiAgent({ sessionId, prompt });

Pola yang sama berlaku untuk helper jembatan lama lainnya:

Import lama	Padanan modern
`resolveAgentDir`	`api.runtime.agent.resolveAgentDir`
`resolveAgentWorkspaceDir`	`api.runtime.agent.resolveAgentWorkspaceDir`
`resolveAgentIdentity`	`api.runtime.agent.resolveAgentIdentity`
`resolveThinkingDefault`	`api.runtime.agent.resolveThinkingDefault`
`resolveAgentTimeoutMs`	`api.runtime.agent.resolveAgentTimeoutMs`
`ensureAgentWorkspace`	`api.runtime.agent.ensureAgentWorkspace`
helper penyimpanan sesi	`api.runtime.agent.session.*`

Build dan uji

pnpm build
pnpm test -- my-plugin/

Referensi path import

Tabel path import umum

Path import	Tujuan	Ekspor utama
`plugin-sdk/plugin-entry`	Helper entri plugin kanonis	`definePluginEntry`
`plugin-sdk/core`	Ekspor ulang umbrella lama untuk definisi/builder entri channel	`defineChannelPluginEntry`, `createChatChannelPlugin`
`plugin-sdk/config-schema`	Ekspor skema konfigurasi root	`OpenClawSchema`
`plugin-sdk/provider-entry`	Helper entri provider tunggal	`defineSingleProviderPluginEntry`
`plugin-sdk/channel-core`	Definisi dan builder entri channel yang terfokus	`defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`
`plugin-sdk/setup`	Helper wizard setup bersama	Prompt allowlist, builder status setup
`plugin-sdk/setup-runtime`	Helper runtime saat setup	Adaptor patch setup yang aman untuk import, helper catatan lookup, `promptResolvedAllowFrom`, `splitSetupEntries`, proxy setup terdelegasi
`plugin-sdk/setup-adapter-runtime`	Helper adaptor setup	`createEnvPatchedAccountSetupAdapter`
`plugin-sdk/setup-tools`	Helper tooling setup	`formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR`
`plugin-sdk/account-core`	Helper multi-akun	Helper daftar akun/konfigurasi/action-gate
`plugin-sdk/account-id`	Helper account-id	`DEFAULT_ACCOUNT_ID`, normalisasi account-id
`plugin-sdk/account-resolution`	Helper lookup akun	Helper lookup akun + fallback default
`plugin-sdk/account-helpers`	Helper akun sempit	Helper daftar akun/aksi akun
`plugin-sdk/channel-setup`	Adaptor wizard setup	`createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, plus `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries`
`plugin-sdk/channel-pairing`	Primitive pairing DM	`createChannelPairingController`
`plugin-sdk/channel-reply-pipeline`	Wiring prefiks balasan + typing	`createChannelReplyPipeline`
`plugin-sdk/channel-config-helpers`	Factory adaptor konfigurasi	`createHybridChannelConfigAdapter`
`plugin-sdk/channel-config-schema`	Builder skema konfigurasi	Tipe skema konfigurasi channel
`plugin-sdk/telegram-command-config`	Helper konfigurasi perintah Telegram	Normalisasi nama perintah, pemangkasan deskripsi, validasi duplikat/konflik
`plugin-sdk/channel-policy`	Resolusi kebijakan grup/DM	`resolveChannelGroupRequireMention`
`plugin-sdk/channel-lifecycle`	Pelacakan status akun	`createAccountStatusSink`
`plugin-sdk/inbound-envelope`	Helper inbound envelope	Route bersama + helper builder envelope
`plugin-sdk/inbound-reply-dispatch`	Helper balasan inbound	Helper record-and-dispatch bersama
`plugin-sdk/messaging-targets`	Parsing target pesan	Helper parsing/pencocokan target
`plugin-sdk/outbound-media`	Helper media outbound	Pemuatan media outbound bersama
`plugin-sdk/outbound-runtime`	Helper runtime outbound	Helper identitas outbound/delegasi pengiriman
`plugin-sdk/thread-bindings-runtime`	Helper binding thread	Siklus hidup thread-binding dan helper adaptor
`plugin-sdk/agent-media-payload`	Helper payload media lama	Builder payload media agen untuk tata letak field lama
`plugin-sdk/channel-runtime`	Shim kompatibilitas deprecated	Hanya utilitas runtime channel lama
`plugin-sdk/channel-send-result`	Tipe hasil pengiriman	Tipe hasil balasan
`plugin-sdk/runtime-store`	Penyimpanan plugin persisten	`createPluginRuntimeStore`
`plugin-sdk/runtime`	Helper runtime yang luas	Helper runtime/logging/backup/instalasi plugin
`plugin-sdk/runtime-env`	Helper env runtime sempit	Logger/runtime env, timeout, retry, dan helper backoff
`plugin-sdk/plugin-runtime`	Helper runtime plugin bersama	Helper plugin command/hook/http/interaktif
`plugin-sdk/hook-runtime`	Helper pipeline hook	Helper pipeline webhook/internal hook bersama
`plugin-sdk/lazy-runtime`	Helper runtime lazy	`createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface`
`plugin-sdk/process-runtime`	Helper proses	Helper exec bersama
`plugin-sdk/cli-runtime`	Helper runtime CLI	Pemformatan perintah, wait, helper versi
`plugin-sdk/gateway-runtime`	Helper gateway	Klien gateway dan helper patch status channel
`plugin-sdk/config-runtime`	Helper konfigurasi	Helper muat/tulis konfigurasi
`plugin-sdk/telegram-command-config`	Helper perintah Telegram	Helper validasi perintah Telegram yang stabil sebagai fallback saat permukaan kontrak Telegram bawaan tidak tersedia
`plugin-sdk/approval-runtime`	Helper prompt approval	Payload approval exec/plugin, helper kapabilitas/profil approval, helper routing/runtime approval native
`plugin-sdk/approval-auth-runtime`	Helper auth approval	Resolusi approver, auth aksi obrolan yang sama
`plugin-sdk/approval-client-runtime`	Helper klien approval	Helper profil/filter approval exec native
`plugin-sdk/approval-delivery-runtime`	Helper pengiriman approval	Adaptor pengiriman/kapabilitas approval native
`plugin-sdk/approval-gateway-runtime`	Helper gateway approval	Helper resolusi gateway approval bersama
`plugin-sdk/approval-handler-adapter-runtime`	Helper adaptor approval	Helper pemuatan adaptor approval native yang ringan untuk hot channel entrypoint
`plugin-sdk/approval-handler-runtime`	Helper handler approval	Helper runtime handler approval yang lebih luas; pilih seam adaptor/gateway yang lebih sempit jika sudah cukup
`plugin-sdk/approval-native-runtime`	Helper target approval	Helper binding target/akun approval native
`plugin-sdk/approval-reply-runtime`	Helper balasan approval	Helper payload balasan approval exec/plugin
`plugin-sdk/channel-runtime-context`	Helper konteks runtime channel	Helper register/get/watch konteks runtime channel generik
`plugin-sdk/security-runtime`	Helper keamanan	Helper trust, gating DM, konten eksternal, dan pengumpulan secret bersama
`plugin-sdk/ssrf-policy`	Helper kebijakan SSRF	Helper allowlist host dan kebijakan jaringan privat
`plugin-sdk/ssrf-runtime`	Helper runtime SSRF	Pinned-dispatcher, fetch terlindungi, helper kebijakan SSRF
`plugin-sdk/collection-runtime`	Helper cache terbatas	`pruneMapToMaxSize`
`plugin-sdk/diagnostic-runtime`	Helper gating diagnostik	`isDiagnosticFlagEnabled`, `isDiagnosticsEnabled`
`plugin-sdk/error-runtime`	Helper pemformatan error	`formatUncaughtError`, `isApprovalNotFoundError`, helper graph error
`plugin-sdk/fetch-runtime`	Helper fetch/proxy terbungkus	`resolveFetch`, helper proxy
`plugin-sdk/host-runtime`	Helper normalisasi host	`normalizeHostname`, `normalizeScpRemoteHost`
`plugin-sdk/retry-runtime`	Helper retry	`RetryConfig`, `retryAsync`, runner kebijakan
`plugin-sdk/allow-from`	Pemformatan allowlist	`formatAllowFromLowercase`
`plugin-sdk/allowlist-resolution`	Pemetaan input allowlist	`mapAllowlistResolutionInputs`
`plugin-sdk/command-auth`	Helper gating perintah dan permukaan perintah	`resolveControlCommandGate`, helper otorisasi pengirim, helper registry perintah
`plugin-sdk/secret-input`	Parsing input secret	Helper input secret
`plugin-sdk/webhook-ingress`	Helper permintaan webhook	Utilitas target webhook
`plugin-sdk/webhook-request-guards`	Helper guard body webhook	Helper baca/batas body permintaan
`plugin-sdk/reply-runtime`	Runtime balasan bersama	Inbound dispatch, heartbeat, perencana balasan, chunking
`plugin-sdk/reply-dispatch-runtime`	Helper dispatch balasan sempit	Helper finalisasi + dispatch provider
`plugin-sdk/reply-history`	Helper riwayat balasan	`buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled`
`plugin-sdk/reply-reference`	Perencanaan referensi balasan	`createReplyReferencePlanner`
`plugin-sdk/reply-chunking`	Helper chunk balasan	Helper chunking teks/markdown
`plugin-sdk/session-store-runtime`	Helper penyimpanan sesi	Helper path store + updated-at
`plugin-sdk/state-paths`	Helper path status	Helper status dan direktori OAuth
`plugin-sdk/routing`	Helper routing/session-key	`resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, helper normalisasi session-key
`plugin-sdk/status-helpers`	Helper status channel	Builder ringkasan/snapshot status channel/akun, default status runtime, helper metadata isu
`plugin-sdk/target-resolver-runtime`	Helper target resolver	Helper target resolver bersama
`plugin-sdk/string-normalization-runtime`	Helper normalisasi string	Helper normalisasi slug/string
`plugin-sdk/request-url`	Helper URL permintaan	Mengekstrak URL string dari input mirip-request
`plugin-sdk/run-command`	Helper perintah berjangka waktu	Runner perintah berjangka waktu dengan stdout/stderr yang dinormalisasi
`plugin-sdk/param-readers`	Pembaca parameter	Pembaca parameter tool/CLI umum
`plugin-sdk/tool-send`	Ekstraksi pengiriman tool	Mengekstrak field target pengiriman kanonis dari argumen tool
`plugin-sdk/temp-path`	Helper path sementara	Helper path unduhan sementara bersama
`plugin-sdk/logging-core`	Helper logging	Logger subsistem dan helper redaksi
`plugin-sdk/markdown-table-runtime`	Helper tabel Markdown	Helper mode tabel Markdown
`plugin-sdk/reply-payload`	Tipe balasan pesan	Tipe payload balasan
`plugin-sdk/provider-setup`	Helper setup provider lokal/self-hosted yang dikurasi	Helper penemuan/konfigurasi provider self-hosted
`plugin-sdk/self-hosted-provider-setup`	Helper setup provider self-hosted yang kompatibel dengan OpenAI dan terfokus	Helper penemuan/konfigurasi provider self-hosted yang sama
`plugin-sdk/provider-auth-runtime`	Helper auth runtime provider	Helper resolusi API key runtime
`plugin-sdk/provider-auth-api-key`	Helper setup API key provider	Helper onboarding/penulisan profil API key
`plugin-sdk/provider-auth-result`	Helper hasil auth provider	Builder hasil auth OAuth standar
`plugin-sdk/provider-auth-login`	Helper login interaktif provider	Helper login interaktif bersama
`plugin-sdk/provider-env-vars`	Helper env-var provider	Helper lookup env-var auth provider
`plugin-sdk/provider-model-shared`	Helper model/replay provider bersama	`ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, builder kebijakan replay bersama, helper endpoint provider, dan helper normalisasi model-id
`plugin-sdk/provider-catalog-shared`	Helper katalog provider bersama	`findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat`
`plugin-sdk/provider-onboard`	Patch onboarding provider	Helper konfigurasi onboarding
`plugin-sdk/provider-http`	Helper HTTP provider	Helper kemampuan HTTP/endpoint provider generik
`plugin-sdk/provider-web-fetch`	Helper web-fetch provider	Helper registrasi/cache provider web-fetch
`plugin-sdk/provider-web-search-contract`	Helper kontrak web-search provider	Helper kontrak konfigurasi/kredensial web-search yang sempit seperti `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig`, dan setter/getter kredensial dengan cakupan tertentu
`plugin-sdk/provider-web-search`	Helper web-search provider	Helper registrasi/cache/runtime provider web-search
`plugin-sdk/provider-tools`	Helper kompatibilitas tool/skema provider	`ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, pembersihan skema Gemini + diagnostik, dan helper kompatibilitas xAI seperti `resolveXaiModelCompatPatch` / `applyXaiModelCompat`
`plugin-sdk/provider-usage`	Helper penggunaan provider	`fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage`, dan helper penggunaan provider lainnya
`plugin-sdk/provider-stream`	Helper wrapper stream provider	`ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, tipe wrapper stream, dan helper wrapper bersama Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot
`plugin-sdk/keyed-async-queue`	Antrean async berurutan	`KeyedAsyncQueue`
`plugin-sdk/media-runtime`	Helper media bersama	Helper fetch/transform/store media serta builder payload media
`plugin-sdk/media-generation-runtime`	Helper media-generation bersama	Helper failover bersama, pemilihan kandidat, dan pesan model hilang untuk pembuatan gambar/video/musik
`plugin-sdk/media-understanding`	Helper media-understanding	Tipe provider media understanding serta ekspor helper gambar/audio yang menghadap provider
`plugin-sdk/text-runtime`	Helper teks bersama	Penghapusan teks yang terlihat oleh asisten, helper render/chunking/tabel markdown, helper redaksi, helper tag direktif, utilitas teks aman, serta helper teks/logging terkait
`plugin-sdk/text-chunking`	Helper chunking teks	Helper chunking teks outbound
`plugin-sdk/speech`	Helper speech	Tipe provider speech serta helper direktif, registry, dan validasi yang menghadap provider
`plugin-sdk/speech-core`	Core speech bersama	Tipe provider speech, registry, direktif, normalisasi
`plugin-sdk/realtime-transcription`	Helper transkripsi realtime	Tipe provider dan helper registry
`plugin-sdk/realtime-voice`	Helper suara realtime	Tipe provider dan helper registry
`plugin-sdk/image-generation-core`	Core image-generation bersama	Tipe image-generation, failover, auth, dan helper registry
`plugin-sdk/music-generation`	Helper music-generation	Tipe provider/permintaan/hasil music-generation
`plugin-sdk/music-generation-core`	Core music-generation bersama	Tipe music-generation, helper failover, lookup provider, dan parsing model-ref
`plugin-sdk/video-generation`	Helper video-generation	Tipe provider/permintaan/hasil video-generation
`plugin-sdk/video-generation-core`	Core video-generation bersama	Tipe video-generation, helper failover, lookup provider, dan parsing model-ref
`plugin-sdk/interactive-runtime`	Helper balasan interaktif	Normalisasi/reduksi payload balasan interaktif
`plugin-sdk/channel-config-primitives`	Primitive konfigurasi channel	Primitive config-schema channel yang sempit
`plugin-sdk/channel-config-writes`	Helper penulisan konfigurasi channel	Helper otorisasi penulisan konfigurasi channel
`plugin-sdk/channel-plugin-common`	Prelude channel bersama	Ekspor prelude plugin channel bersama
`plugin-sdk/channel-status`	Helper status channel	Helper snapshot/ringkasan status channel bersama
`plugin-sdk/allowlist-config-edit`	Helper konfigurasi allowlist	Helper edit/baca konfigurasi allowlist
`plugin-sdk/group-access`	Helper akses grup	Helper keputusan akses grup bersama
`plugin-sdk/direct-dm`	Helper direct-DM	Helper auth/guard direct-DM bersama
`plugin-sdk/extension-shared`	Helper extension bersama	Primitive channel/status pasif dan ambient proxy helper
`plugin-sdk/webhook-targets`	Helper target webhook	Registry target webhook dan helper instalasi route
`plugin-sdk/webhook-path`	Helper path webhook	Helper normalisasi path webhook
`plugin-sdk/web-media`	Helper media web bersama	Helper pemuatan media remote/lokal
`plugin-sdk/zod`	Ekspor ulang Zod	`zod` yang diekspor ulang untuk konsumen plugin SDK
`plugin-sdk/memory-core`	Helper memory-core bawaan	Permukaan helper memory manager/config/file/CLI
`plugin-sdk/memory-core-engine-runtime`	Fasad runtime engine memori	Fasad runtime indeks/pencarian memori
`plugin-sdk/memory-core-host-engine-foundation`	Engine fondasi host memori	Ekspor engine fondasi host memori
`plugin-sdk/memory-core-host-engine-embeddings`	Engine embedding host memori	Ekspor engine embedding host memori
`plugin-sdk/memory-core-host-engine-qmd`	Engine QMD host memori	Ekspor engine QMD host memori
`plugin-sdk/memory-core-host-engine-storage`	Engine penyimpanan host memori	Ekspor engine penyimpanan host memori
`plugin-sdk/memory-core-host-multimodal`	Helper multimodal host memori	Helper multimodal host memori
`plugin-sdk/memory-core-host-query`	Helper kueri host memori	Helper kueri host memori
`plugin-sdk/memory-core-host-secret`	Helper secret host memori	Helper secret host memori
`plugin-sdk/memory-core-host-events`	Helper jurnal event host memori	Helper jurnal event host memori
`plugin-sdk/memory-core-host-status`	Helper status host memori	Helper status host memori
`plugin-sdk/memory-core-host-runtime-cli`	Runtime CLI host memori	Helper runtime CLI host memori
`plugin-sdk/memory-core-host-runtime-core`	Runtime core host memori	Helper runtime core host memori
`plugin-sdk/memory-core-host-runtime-files`	Helper file/runtime host memori	Helper file/runtime host memori
`plugin-sdk/memory-host-core`	Alias runtime core host memori	Alias netral-vendor untuk helper runtime core host memori
`plugin-sdk/memory-host-events`	Alias jurnal event host memori	Alias netral-vendor untuk helper jurnal event host memori
`plugin-sdk/memory-host-files`	Alias file/runtime host memori	Alias netral-vendor untuk helper file/runtime host memori
`plugin-sdk/memory-host-markdown`	Helper markdown terkelola	Helper managed-markdown bersama untuk plugin yang berdekatan dengan memori
`plugin-sdk/memory-host-search`	Fasad pencarian memori aktif	Fasad runtime lazy active-memory search-manager
`plugin-sdk/memory-host-status`	Alias status host memori	Alias netral-vendor untuk helper status host memori
`plugin-sdk/memory-lancedb`	Helper memory-lancedb bawaan	Permukaan helper memory-lancedb
`plugin-sdk/testing`	Utilitas pengujian	Helper dan mock pengujian

Tabel ini sengaja merupakan subset migrasi umum, bukan permukaan SDK penuh. Daftar lengkap 200+ entrypoint ada di scripts/lib/plugin-sdk-entrypoints.json. Daftar itu masih mencakup beberapa seam helper bundled-plugin seperti plugin-sdk/feishu, plugin-sdk/feishu-setup, plugin-sdk/zalo, plugin-sdk/zalo-setup, dan plugin-sdk/matrix*. Itu tetap diekspor untuk pemeliharaan bundled-plugin dan kompatibilitas, tetapi sengaja dihilangkan dari tabel migrasi umum dan bukan target yang direkomendasikan untuk kode plugin baru. Aturan yang sama berlaku untuk keluarga helper bawaan lainnya seperti:

helper dukungan browser: plugin-sdk/browser-cdp, plugin-sdk/browser-config-runtime, plugin-sdk/browser-config-support, plugin-sdk/browser-control-auth, plugin-sdk/browser-node-runtime, plugin-sdk/browser-profiles, plugin-sdk/browser-security-runtime, plugin-sdk/browser-setup-tools, plugin-sdk/browser-support
Matrix: plugin-sdk/matrix*
LINE: plugin-sdk/line*
IRC: plugin-sdk/irc*
permukaan helper/plugin bawaan seperti plugin-sdk/googlechat, plugin-sdk/zalouser, plugin-sdk/bluebubbles*, plugin-sdk/mattermost*, plugin-sdk/msteams, plugin-sdk/nextcloud-talk, plugin-sdk/nostr, plugin-sdk/tlon, plugin-sdk/twitch, plugin-sdk/github-copilot-login, plugin-sdk/github-copilot-token, plugin-sdk/diagnostics-otel, plugin-sdk/diffs, plugin-sdk/llm-task, plugin-sdk/thread-ownership, dan plugin-sdk/voice-call

plugin-sdk/github-copilot-token saat ini mengekspos permukaan helper token yang sempit DEFAULT_COPILOT_API_BASE_URL, deriveCopilotApiBaseUrlFromToken, dan resolveCopilotApiToken. Gunakan import yang paling sempit yang sesuai dengan pekerjaan tersebut. Jika Anda tidak dapat menemukan ekspor, periksa sumber di src/plugin-sdk/ atau tanyakan di Discord.

Linimasa penghapusan

Kapan	Apa yang terjadi
Sekarang	Permukaan deprecated memunculkan peringatan runtime
Rilis mayor berikutnya	Permukaan deprecated akan dihapus; plugin yang masih menggunakannya akan gagal

Semua plugin core sudah dimigrasikan. Plugin eksternal harus bermigrasi sebelum rilis mayor berikutnya.

Menyembunyikan peringatan untuk sementara

Setel variabel environment ini saat Anda sedang mengerjakan migrasi:

OPENCLAW_SUPPRESS_PLUGIN_SDK_COMPAT_WARNING=1 openclaw gateway run
OPENCLAW_SUPPRESS_EXTENSION_API_WARNING=1 openclaw gateway run

Ini adalah jalur keluar sementara, bukan solusi permanen.

Terkait

Memulai — bangun plugin pertama Anda
Ikhtisar SDK — referensi import subpath lengkap
Plugin Channel — membangun plugin channel
Plugin Provider — membangun plugin provider
Internal Plugin — pendalaman arsitektur
Manifest Plugin — referensi skema manifest

Overview

Plugins

Skills

Automation & Tasks

Tools

Agent coordination

Migrasi Plugin SDK

Migrasi Plugin SDK

Apa yang berubah

Mengapa ini berubah

Cara bermigrasi

Referensi path import

Linimasa penghapusan

Menyembunyikan peringatan untuk sementara

Terkait

Overview

Plugins

Skills

Automation & Tasks

Tools

Agent coordination

​Migrasi Plugin SDK

​Apa yang berubah

​Mengapa ini berubah

​Cara bermigrasi

​Referensi path import

​Linimasa penghapusan

​Menyembunyikan peringatan untuk sementara

​Terkait

Migrasi Plugin SDK

Apa yang berubah

Mengapa ini berubah

Cara bermigrasi

Referensi path import

Linimasa penghapusan

Menyembunyikan peringatan untuk sementara

Terkait