openclaw/plugin-sdk/. Halaman ini mengatalogkan subpath yang umum digunakan, dikelompokkan
berdasarkan tujuan. Inventaris entrypoint compiler yang dihasilkan berada di
scripts/lib/plugin-sdk-entrypoints.json; ekspor paket adalah subset publik
setelah mengurangi subpath pengujian/internal lokal repo yang tercantum di
scripts/lib/plugin-sdk-private-local-only-subpaths.json. Maintainer dapat mengaudit
jumlah ekspor publik dengan pnpm plugin-sdk:surface dan subpath helper cadangan
yang aktif dengan pnpm plugins:boundary-report:summary; ekspor helper cadangan
yang tidak digunakan akan menggagalkan laporan CI alih-alih tetap berada di SDK publik sebagai
utang kompatibilitas dorman.
Untuk panduan penulisan Plugin, lihat Ikhtisar SDK Plugin.
Entri Plugin
| Subpath | Ekspor utama |
|---|---|
plugin-sdk/plugin-entry | definePluginEntry |
plugin-sdk/core | defineChannelPluginEntry, createChatChannelPlugin, createChannelPluginBase, defineSetupPluginEntry, buildChannelConfigSchema, buildJsonChannelConfigSchema |
plugin-sdk/config-schema | OpenClawSchema |
plugin-sdk/provider-entry | defineSingleProviderPluginEntry |
plugin-sdk/migration | Helper item penyedia migrasi seperti createMigrationItem, konstanta alasan, penanda status item, helper redaksi, dan summarizeMigrationItems |
plugin-sdk/migration-runtime | Helper migrasi runtime seperti copyMigrationFileItem, resolvePlannedMigrationTargets, withCachedMigrationConfigRuntime, dan writeMigrationReport |
plugin-sdk/health | Pendaftaran, deteksi, perbaikan, pemilihan, tingkat keparahan, dan tipe temuan pemeriksaan kesehatan Doctor untuk konsumen kesehatan bawaan |
Kompatibilitas dan helper pengujian yang tidak digunakan lagi
Subpath yang tidak digunakan lagi tetap diekspor untuk Plugin lama, tetapi kode baru sebaiknya menggunakan subpath SDK terfokus di bawah ini. Daftar yang dipelihara adalahscripts/lib/plugin-sdk-deprecated-public-subpaths.json; CI menolak impor produksi
bawaan darinya. Barrel luas seperti compat, config-types,
infra-runtime, text-runtime, dan zod hanya untuk kompatibilitas. Impor zod
langsung dari zod.
Subpath helper pengujian berbasis Vitest milik OpenClaw hanya lokal repo dan tidak lagi
menjadi ekspor paket: agent-runtime-test-contracts,
channel-contract-testing, channel-target-testing, channel-test-helpers,
plugin-test-api, plugin-test-contracts, plugin-test-runtime,
provider-http-test-mocks, provider-test-contracts, test-env,
test-fixtures, test-node-mocks, dan testing.
Subpath helper Plugin bawaan yang dicadangkan
Subpath ini adalah permukaan kompatibilitas milik Plugin untuk Plugin bawaan pemiliknya, bukan API SDK umum:plugin-sdk/codex-mcp-projection dan
plugin-sdk/codex-native-task-runtime. Impor ekstensi lintas pemilik diblokir
oleh guardrail kontrak paket.
Channel subpaths
Channel subpaths
| Subjalur | Ekspor utama |
|---|---|
plugin-sdk/channel-core | defineChannelPluginEntry, defineSetupPluginEntry, createChatChannelPlugin, createChannelPluginBase |
plugin-sdk/config-schema | Ekspor skema Zod root openclaw.json (OpenClawSchema) |
plugin-sdk/json-schema-runtime | Pembantu validasi JSON Schema bercache untuk skema milik plugin |
plugin-sdk/channel-setup | createOptionalChannelSetupSurface, createOptionalChannelSetupAdapter, createOptionalChannelSetupWizard, plus DEFAULT_ACCOUNT_ID, createTopLevelChannelDmPolicy, setSetupChannelEnabled, splitSetupEntries |
plugin-sdk/setup | Pembantu wizard penyiapan bersama, penerjemah penyiapan, prompt daftar izin, pembangun status penyiapan |
plugin-sdk/setup-runtime | createSetupTranslator, createPatchedAccountSetupAdapter, createEnvPatchedAccountSetupAdapter, createSetupInputPresenceValidator, noteChannelLookupFailure, noteChannelLookupSummary, promptResolvedAllowFrom, splitSetupEntries, createAllowlistSetupWizardProxy, createDelegatedSetupWizardProxy |
plugin-sdk/setup-adapter-runtime | Alias kompatibilitas usang; gunakan plugin-sdk/setup-runtime |
plugin-sdk/setup-tools | formatCliCommand, detectBinary, extractArchive, resolveBrewExecutable, formatDocsLink, CONFIG_DIR |
plugin-sdk/account-core | Pembantu konfigurasi multi-akun/gerbang tindakan, pembantu fallback akun default |
plugin-sdk/account-id | DEFAULT_ACCOUNT_ID, pembantu normalisasi id akun |
plugin-sdk/account-resolution | Pembantu pencarian akun + fallback default |
plugin-sdk/account-helpers | Pembantu sempit daftar akun/tindakan akun |
plugin-sdk/access-groups | Pembantu parsing daftar izin grup akses dan diagnostik grup yang disunting |
plugin-sdk/channel-pairing | createChannelPairingController |
plugin-sdk/channel-reply-pipeline | Fasad kompatibilitas usang. Gunakan plugin-sdk/channel-outbound. |
plugin-sdk/channel-config-helpers | createHybridChannelConfigAdapter, resolveChannelDmAccess, resolveChannelDmAllowFrom, resolveChannelDmPolicy, normalizeChannelDmPolicy, normalizeLegacyDmAliases |
plugin-sdk/channel-config-schema | Primitif skema konfigurasi channel bersama plus pembangun Zod dan JSON/TypeBox langsung |
plugin-sdk/bundled-channel-config-schema | Skema konfigurasi channel OpenClaw bawaan hanya untuk plugin bawaan yang dipelihara |
plugin-sdk/chat-channel-ids | BUNDLED_CHAT_CHANNEL_IDS, BUNDLED_CHAT_CHANNEL_ENVELOPE_PREFIXES, ChatChannelId. Id channel chat bawaan/resmi kanonis plus label/alias pemformat untuk plugin yang perlu mengenali teks berprefiks amplop tanpa menghardcode tabel sendiri. |
plugin-sdk/channel-config-schema-legacy | Alias kompatibilitas usang untuk skema konfigurasi channel bawaan |
plugin-sdk/telegram-command-config | Pembantu normalisasi/validasi perintah kustom Telegram dengan fallback kontrak bawaan |
plugin-sdk/command-gating | Pembantu gerbang otorisasi perintah sempit |
plugin-sdk/channel-policy | resolveChannelGroupRequireMention |
plugin-sdk/channel-ingress | Fasad kompatibilitas ingress channel tingkat rendah yang usang. Jalur penerimaan baru harus menggunakan plugin-sdk/channel-ingress-runtime. |
plugin-sdk/channel-ingress-runtime | Resolver runtime ingress channel tingkat tinggi eksperimental dan pembangun fakta rute untuk jalur penerimaan channel yang dimigrasikan. Lebih pilih ini daripada merakit daftar izin efektif, daftar izin perintah, dan proyeksi lama di tiap plugin. Lihat API ingress channel. |
plugin-sdk/channel-lifecycle | Fasad kompatibilitas usang. Gunakan plugin-sdk/channel-outbound. |
plugin-sdk/channel-outbound | Kontrak siklus hidup pesan plus opsi pipeline balasan, tanda terima, pratinjau/streaming langsung, pembantu siklus hidup, identitas keluar, perencanaan payload, pengiriman tahan lama, dan pembantu konteks pengiriman pesan. Lihat API outbound channel. |
plugin-sdk/channel-message | Alias kompatibilitas usang untuk plugin-sdk/channel-outbound plus fasad dispatch balasan lama. |
plugin-sdk/channel-message-runtime | Alias kompatibilitas usang untuk plugin-sdk/channel-outbound plus fasad dispatch balasan lama. |
plugin-sdk/inbound-envelope | Pembantu bersama pembangun rute masuk + amplop |
plugin-sdk/inbound-reply-dispatch | Fasad kompatibilitas usang. Gunakan plugin-sdk/channel-inbound untuk runner masuk dan predikat dispatch, serta plugin-sdk/channel-outbound untuk pembantu pengiriman pesan. |
plugin-sdk/messaging-targets | Alias parsing target usang; gunakan plugin-sdk/channel-targets |
plugin-sdk/outbound-media | Pembantu bersama pemuatan media keluar dan status media yang dihosting |
plugin-sdk/outbound-send-deps | Fasad kompatibilitas usang. Gunakan plugin-sdk/channel-outbound. |
plugin-sdk/outbound-runtime | Fasad kompatibilitas usang. Gunakan plugin-sdk/channel-outbound. |
plugin-sdk/poll-runtime | Pembantu normalisasi polling sempit |
plugin-sdk/thread-bindings-runtime | Siklus hidup pengikatan thread dan pembantu adapter |
plugin-sdk/agent-media-payload | Pembangun payload media agen lama |
plugin-sdk/conversation-runtime | Pembantu pengikatan percakapan/thread, pemasangan, dan pengikatan yang dikonfigurasi |
plugin-sdk/runtime-config-snapshot | Pembantu snapshot konfigurasi runtime |
plugin-sdk/runtime-group-policy | Pembantu resolusi kebijakan grup runtime |
plugin-sdk/channel-status | Pembantu bersama snapshot/ringkasan status channel |
plugin-sdk/channel-config-primitives | Primitif skema konfigurasi channel sempit |
plugin-sdk/channel-config-writes | Pembantu otorisasi penulisan konfigurasi channel |
plugin-sdk/channel-plugin-common | Ekspor prelude plugin channel bersama |
plugin-sdk/allowlist-config-edit | Pembantu edit/baca konfigurasi daftar izin |
plugin-sdk/group-access | Pembantu bersama keputusan akses grup |
plugin-sdk/direct-dm, plugin-sdk/direct-dm-access | Fasad kompatibilitas usang. Gunakan plugin-sdk/channel-inbound. |
plugin-sdk/direct-dm-guard-policy | Pembantu kebijakan penjaga direct-DM pra-crypto sempit |
plugin-sdk/discord | Fasad kompatibilitas Discord usang untuk @openclaw/discord@2026.3.13 yang dipublikasikan dan kompatibilitas owner terlacak; plugin baru harus menggunakan subjalur SDK channel generik |
plugin-sdk/telegram-account | Fasad kompatibilitas resolusi akun Telegram usang untuk kompatibilitas owner terlacak; plugin baru harus menggunakan pembantu runtime yang diinjeksi atau subjalur SDK channel generik |
plugin-sdk/zalouser | Fasad kompatibilitas Zalo Personal usang untuk paket Lark/Zalo yang dipublikasikan yang masih mengimpor otorisasi perintah pengirim; plugin baru harus menggunakan plugin-sdk/command-auth |
plugin-sdk/interactive-runtime | Presentasi pesan semantik, pengiriman, dan pembantu balasan interaktif lama. Lihat Presentasi Pesan |
plugin-sdk/channel-inbound | Pembantu masuk bersama untuk klasifikasi peristiwa, pembangunan konteks, pemformatan, root, debounce, pencocokan mention, kebijakan mention, dan logging masuk |
plugin-sdk/channel-inbound-debounce | Pembantu debounce masuk sempit |
plugin-sdk/channel-mention-gating | Pembantu sempit kebijakan mention, penanda mention, dan teks mention tanpa permukaan runtime masuk yang lebih luas |
plugin-sdk/channel-envelope, plugin-sdk/channel-inbound-roots, plugin-sdk/channel-location, plugin-sdk/channel-logging | Fasad kompatibilitas usang. Gunakan plugin-sdk/channel-inbound atau plugin-sdk/channel-outbound. |
plugin-sdk/channel-pairing-paths | Fasad kompatibilitas usang. Gunakan plugin-sdk/channel-pairing. |
plugin-sdk/channel-reply-options-runtime | Fasad kompatibilitas usang. Gunakan plugin-sdk/channel-outbound. |
plugin-sdk/channel-streaming | Fasad kompatibilitas usang. Gunakan plugin-sdk/channel-outbound. |
plugin-sdk/channel-send-result | Tipe hasil balasan |
plugin-sdk/channel-actions | Pembantu tindakan pesan channel, plus pembantu skema native usang yang dipertahankan untuk kompatibilitas plugin |
plugin-sdk/channel-route | Normalisasi rute bersama, resolusi target berbasis parser, stringifikasi id thread, kunci rute dedupe/compact, tipe target terurai, dan pembantu perbandingan rute/target |
plugin-sdk/channel-targets | Pembantu parsing target; pemanggil perbandingan rute harus menggunakan plugin-sdk/channel-route |
plugin-sdk/channel-contract | Tipe kontrak channel |
plugin-sdk/channel-feedback | Pengkabelan umpan balik/reaksi |
plugin-sdk/channel-secret-runtime | Pembantu kontrak rahasia sempit seperti collectSimpleChannelFieldAssignments, getChannelSurface, pushAssignment, dan tipe target rahasia |
channel-inbound dan channel-outbound, lalu menghapus subjalur kompatibilitas
dalam pembersihan besar SDK berikutnya. Ini berlaku untuk keluarga lama pesan/runtime
channel, streaming channel, akses direct-DM, pecahan pembantu masuk, opsi balasan,
dan pairing-path.Subjalur penyedia
Subjalur penyedia
| Subjalur | Ekspor utama |
|---|---|
plugin-sdk/provider-entry | defineSingleProviderPluginEntry |
plugin-sdk/lmstudio | Fasad penyedia LM Studio yang didukung untuk penyiapan, penemuan katalog, dan persiapan model runtime |
plugin-sdk/lmstudio-runtime | Fasad runtime LM Studio yang didukung untuk default server lokal, penemuan model, header permintaan, dan helper model yang dimuat |
plugin-sdk/provider-setup | Helper penyiapan penyedia lokal/self-hosted yang dikurasi |
plugin-sdk/self-hosted-provider-setup | Helper penyiapan penyedia self-hosted yang kompatibel dengan OpenAI dan terfokus |
plugin-sdk/cli-backend | Default backend CLI + konstanta watchdog |
plugin-sdk/provider-auth-runtime | Helper resolusi kunci API runtime untuk plugin penyedia |
plugin-sdk/provider-oauth-runtime | Tipe callback OAuth penyedia generik, perenderan halaman callback, helper PKCE/state, penguraian input otorisasi, helper kedaluwarsa token, dan helper pembatalan |
plugin-sdk/provider-auth-api-key | Helper onboarding/penulisan profil kunci API seperti upsertApiKeyProfile |
plugin-sdk/provider-auth-result | Builder hasil autentikasi OAuth standar |
plugin-sdk/provider-env-vars | Helper pencarian variabel lingkungan autentikasi penyedia |
plugin-sdk/provider-auth | createProviderApiKeyAuthMethod, ensureApiKeyFromOptionEnvOrPrompt, upsertAuthProfile, upsertApiKeyProfile, writeOAuthCredentials, helper impor autentikasi OpenAI Codex, ekspor kompatibilitas resolveOpenClawAgentDir yang tidak digunakan lagi |
plugin-sdk/provider-model-shared | ProviderReplayFamily, buildProviderReplayFamilyHooks, normalizeModelCompat, builder kebijakan replay bersama, helper endpoint penyedia, dan helper normalisasi ID model bersama |
plugin-sdk/provider-catalog-live-runtime | Helper katalog model penyedia live untuk penemuan bergaya /models yang dijaga: buildLiveModelProviderConfig, fetchLiveProviderModelRows, getCachedLiveProviderModelRows, fetchLiveProviderModelIds, LiveModelCatalogHttpError, clearLiveCatalogCacheForTests, pemfilteran ID model, cache TTL, dan fallback statis |
plugin-sdk/provider-catalog-runtime | Hook runtime augmentasi katalog penyedia dan seam registri plugin-penyedia untuk uji kontrak |
plugin-sdk/provider-catalog-shared | findCatalogTemplate, buildSingleProviderApiKeyCatalog, buildManifestModelProviderConfig, supportsNativeStreamingUsageCompat, applyProviderNativeStreamingUsageCompat |
plugin-sdk/provider-http | Helper kemampuan HTTP/endpoint penyedia generik, error HTTP penyedia, dan helper formulir multipart transkripsi audio |
plugin-sdk/provider-web-fetch-contract | Helper kontrak konfigurasi/pemilihan web-fetch yang sempit seperti enablePluginInConfig dan WebFetchProviderPlugin |
plugin-sdk/provider-web-fetch | Helper registrasi/cache penyedia web-fetch |
plugin-sdk/provider-web-search-config-contract | Helper konfigurasi/kredensial web-search yang sempit untuk penyedia yang tidak memerlukan wiring pengaktifan plugin |
plugin-sdk/provider-web-search-contract | Helper kontrak konfigurasi/kredensial web-search yang sempit seperti createWebSearchProviderContractFields, enablePluginInConfig, resolveProviderWebSearchPluginConfig, dan setter/getter kredensial berlingkup |
plugin-sdk/provider-web-search | Helper registrasi/cache/runtime penyedia web-search |
plugin-sdk/embedding-providers | Tipe penyedia embedding umum dan helper baca, termasuk EmbeddingProviderAdapter, getEmbeddingProvider(...), dan listEmbeddingProviders(...); plugin mendaftarkan penyedia melalui api.registerEmbeddingProvider(...) sehingga kepemilikan manifes ditegakkan |
plugin-sdk/provider-tools | ProviderToolCompatFamily, buildProviderToolCompatFamilyHooks, dan pembersihan skema + diagnostik DeepSeek/Gemini/OpenAI |
plugin-sdk/provider-usage | Tipe snapshot penggunaan penyedia, helper pengambilan penggunaan bersama, dan pengambil penyedia seperti fetchClaudeUsage |
plugin-sdk/provider-stream | ProviderStreamFamily, buildProviderStreamFamilyHooks, composeProviderStreamWrappers, tipe wrapper stream, kompatibilitas pemanggilan tool teks biasa, dan helper wrapper bersama Anthropic/Bedrock/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
plugin-sdk/provider-stream-shared | Helper wrapper stream penyedia bersama publik termasuk composeProviderStreamWrappers, createOpenAICompatibleCompletionsThinkingOffWrapper, createPlainTextToolCallCompatWrapper, createPayloadPatchStreamWrapper, createToolStreamWrapper, normalizeOpenAICompatibleReasoningPayload, setQwenChatTemplateThinking, dan utilitas stream Anthropic/DeepSeek/kompatibel dengan OpenAI |
plugin-sdk/provider-transport-runtime | Helper transport penyedia native seperti fetch yang dijaga, ekstraksi teks hasil tool, transformasi pesan transport, dan stream peristiwa transport yang dapat ditulis |
plugin-sdk/provider-onboard | Helper patch konfigurasi onboarding |
plugin-sdk/global-singleton | Helper singleton/map/cache lokal proses |
plugin-sdk/group-activation | Helper mode aktivasi grup dan penguraian perintah yang sempit |
windows kuota, masing-masing dengan
label, persentase yang digunakan, dan waktu reset opsional. Penyedia yang mengekspos teks saldo atau
status akun alih-alih jendela kuota yang dapat direset harus mengembalikan
summary dengan array windows kosong, bukan membuat-buat persentase.
OpenClaw menampilkan teks ringkasan tersebut dalam output status; gunakan error hanya ketika
endpoint penggunaan gagal atau tidak mengembalikan data penggunaan yang dapat digunakan.Subjalur autentikasi dan keamanan
Subjalur autentikasi dan keamanan
| Subjalur | Ekspor utama |
|---|---|
plugin-sdk/command-auth | resolveControlCommandGate, helper registri perintah termasuk pemformatan menu argumen dinamis, helper otorisasi pengirim |
plugin-sdk/command-status | Builder pesan perintah/bantuan seperti buildCommandsMessagePaginated dan buildHelpMessage |
plugin-sdk/approval-auth-runtime | Resolusi pemberi persetujuan dan helper autentikasi aksi dalam chat yang sama |
plugin-sdk/approval-client-runtime | Helper profil/filter persetujuan exec native |
plugin-sdk/approval-delivery-runtime | Adapter kemampuan/pengiriman persetujuan native |
plugin-sdk/approval-gateway-runtime | Helper resolusi Gateway persetujuan bersama |
plugin-sdk/approval-handler-adapter-runtime | Helper pemuatan adapter persetujuan native ringan untuk entrypoint channel panas |
plugin-sdk/approval-handler-runtime | Helper runtime handler persetujuan yang lebih luas; pilih seam adapter/gateway yang lebih sempit saat sudah cukup |
plugin-sdk/approval-native-runtime | Helper target persetujuan native, pengikatan akun, gate rute, fallback penerusan, dan supresi prompt exec native lokal |
plugin-sdk/approval-reaction-runtime | Binding reaksi persetujuan hardcode, payload prompt reaksi, store target reaksi, helper teks petunjuk reaksi, dan ekspor kompatibilitas untuk supresi prompt exec native lokal |
plugin-sdk/approval-reply-runtime | Helper payload balasan persetujuan exec/plugin |
plugin-sdk/approval-runtime | Helper payload persetujuan exec/plugin, helper routing/runtime persetujuan native, dan helper tampilan persetujuan terstruktur seperti formatApprovalDisplayPath |
plugin-sdk/reply-dedupe | Helper reset dedupe balasan masuk yang sempit |
plugin-sdk/channel-contract-testing | Helper uji kontrak channel yang sempit tanpa barrel pengujian luas |
plugin-sdk/command-auth-native | Autentikasi perintah native, pemformatan menu argumen dinamis, dan helper target sesi native |
plugin-sdk/command-detection | Helper deteksi perintah bersama |
plugin-sdk/command-primitives-runtime | Predikat teks perintah ringan untuk jalur channel panas |
plugin-sdk/command-surface | Normalisasi isi perintah dan helper permukaan perintah |
plugin-sdk/allow-from | formatAllowFromLowercase |
plugin-sdk/provider-auth-login-flow-runtime | Helper alur login autentikasi penyedia lazy untuk channel privat dan pemasangan kode perangkat Antarmuka Web |
plugin-sdk/channel-secret-runtime | Helper pengumpulan kontrak rahasia yang sempit untuk permukaan rahasia channel/plugin |
plugin-sdk/secret-ref-runtime | Helper coerceSecretRef yang sempit dan pengetikan SecretRef untuk penguraian kontrak rahasia/konfigurasi |
plugin-sdk/secret-provider-integration | Kontrak manifes dan preset integrasi penyedia SecretRef khusus tipe untuk plugin yang menerbitkan preset penyedia rahasia eksternal |
plugin-sdk/security-runtime | Helper bersama untuk kepercayaan, gating DM, file/jalur berbatas root termasuk penulisan hanya-buat, penggantian file atomik sinkron/asinkron, penulisan temp saudara, fallback pemindahan lintas perangkat, helper penyimpanan file privat, penjaga induk symlink, konten eksternal, redaksi teks sensitif, perbandingan rahasia waktu-konstan, dan helper pengumpulan rahasia |
plugin-sdk/ssrf-policy | Helper allowlist host dan kebijakan SSRF jaringan privat |
plugin-sdk/ssrf-dispatcher | Helper pinned-dispatcher sempit tanpa permukaan runtime infra yang luas |
plugin-sdk/ssrf-runtime | Pinned-dispatcher, fetch yang dijaga SSRF, error SSRF, dan helper kebijakan SSRF |
plugin-sdk/secret-input | Helper penguraian input rahasia |
plugin-sdk/webhook-ingress | Helper permintaan/target Webhook dan koersi websocket/body mentah |
plugin-sdk/webhook-request-guards | Helper ukuran/timeout body permintaan |
Subjalur runtime dan penyimpanan
Subjalur runtime dan penyimpanan
| Subjalur | Ekspor utama |
|---|---|
plugin-sdk/runtime | Pembantu luas untuk runtime/logging/cadangan/instalasi-Plugin |
plugin-sdk/runtime-env | Pembantu sempit untuk env runtime, logger, timeout, retry, dan backoff |
plugin-sdk/browser-config | Facade konfigurasi browser yang didukung untuk profil/default yang dinormalisasi, penguraian URL CDP, dan pembantu autentikasi kontrol-browser |
plugin-sdk/agent-harness-task-runtime | Pembantu generik untuk siklus hidup tugas dan pengiriman penyelesaian bagi agen berbasis harness yang menggunakan cakupan tugas yang diterbitkan host |
plugin-sdk/codex-mcp-projection | Pembantu Codex bundel yang dicadangkan untuk memproyeksikan konfigurasi server MCP pengguna ke konfigurasi thread Codex; bukan untuk Plugin pihak ketiga |
plugin-sdk/codex-native-task-runtime | Pembantu Codex bundel privat untuk pengawatan mirror/runtime tugas native; bukan untuk Plugin pihak ketiga |
plugin-sdk/channel-runtime-context | Pembantu generik untuk pendaftaran dan lookup konteks-runtime kanal |
plugin-sdk/matrix | Facade kompatibilitas Matrix yang tidak digunakan lagi untuk paket kanal pihak ketiga lama; Plugin baru sebaiknya mengimpor plugin-sdk/run-command secara langsung |
plugin-sdk/mattermost | Facade kompatibilitas Mattermost yang tidak digunakan lagi untuk paket kanal pihak ketiga lama; Plugin baru sebaiknya mengimpor subjalur SDK generik secara langsung |
plugin-sdk/runtime-store | createPluginRuntimeStore |
plugin-sdk/plugin-runtime | Pembantu bersama untuk perintah/hook/http/interaktif Plugin |
plugin-sdk/hook-runtime | Pembantu pipeline bersama untuk hook Webhook/internal |
plugin-sdk/lazy-runtime | Pembantu impor/pengikatan runtime malas seperti createLazyRuntimeModule, createLazyRuntimeMethod, dan createLazyRuntimeSurface |
plugin-sdk/process-runtime | Pembantu eksekusi proses |
plugin-sdk/cli-runtime | Pembantu pemformatan CLI, tunggu, versi, pemanggilan-argumen, dan grup-perintah malas |
plugin-sdk/qa-live-transport-scenarios | ID skenario QA transport live bersama, pembantu cakupan baseline, dan pembantu pemilihan-skenario |
plugin-sdk/gateway-method-runtime | Pembantu dispatch metode Gateway yang dicadangkan untuk route HTTP Plugin yang mendeklarasikan contracts.gatewayMethodDispatch: ["authenticated-request"] |
plugin-sdk/gateway-runtime | Klien Gateway, pembantu start klien siap event-loop, RPC CLI gateway, error protokol gateway, resolusi host LAN yang diiklankan, dan pembantu patch status-kanal |
plugin-sdk/config-contracts | Permukaan konfigurasi type-only terfokus untuk bentuk konfigurasi Plugin seperti OpenClawConfig dan tipe konfigurasi kanal/provider |
plugin-sdk/plugin-config-runtime | Pembantu lookup konfigurasi-Plugin runtime seperti requireRuntimeConfig, resolvePluginConfigObject, dan resolveLivePluginConfigObject |
plugin-sdk/config-mutation | Pembantu mutasi konfigurasi transaksional seperti mutateConfigFile, replaceConfigFile, dan logConfigUpdated |
plugin-sdk/message-tool-delivery-hints | String petunjuk metadata pengiriman message-tool bersama |
plugin-sdk/runtime-config-snapshot | Pembantu snapshot konfigurasi proses saat ini seperti getRuntimeConfig, getRuntimeConfigSnapshot, dan setter snapshot pengujian |
plugin-sdk/telegram-command-config | Normalisasi nama/deskripsi perintah Telegram dan pemeriksaan duplikat/konflik, bahkan saat permukaan kontrak Telegram bundel tidak tersedia |
plugin-sdk/text-autolink-runtime | Deteksi autolink referensi-file tanpa barrel teks luas |
plugin-sdk/approval-reaction-runtime | Pengikatan reaksi persetujuan hardcoded, payload prompt reaksi, store target reaksi, pembantu teks petunjuk reaksi, dan ekspor kompatibilitas untuk supresi prompt eksekusi native lokal |
plugin-sdk/approval-runtime | Pembantu persetujuan exec/Plugin, builder kapabilitas-persetujuan, pembantu auth/profil, pembantu routing/runtime native, dan pemformatan path tampilan persetujuan terstruktur |
plugin-sdk/reply-runtime | Pembantu runtime inbound/balasan bersama, chunking, dispatch, Heartbeat, perencana balasan |
plugin-sdk/reply-dispatch-runtime | Pembantu sempit untuk dispatch/finalisasi balasan dan label percakapan |
plugin-sdk/reply-history | Pembantu riwayat-balasan jendela-pendek bersama. Kode giliran-pesan baru sebaiknya menggunakan createChannelHistoryWindow; pembantu map tingkat lebih rendah tetap hanya sebagai ekspor kompatibilitas yang tidak digunakan lagi |
plugin-sdk/reply-reference | createReplyReferencePlanner |
plugin-sdk/reply-chunking | Pembantu chunking teks/markdown sempit |
plugin-sdk/session-store-runtime | Pembantu alur kerja sesi (getSessionEntry, listSessionEntries, patchSessionEntry, upsertSessionEntry), pembacaan teks transkrip pengguna/asisten terbaru yang dibatasi menurut identitas sesi, pembantu path store sesi lama/kunci-sesi, pembacaan updated-at, dan pembantu kompatibilitas seluruh-store/path-file hanya untuk transisi |
plugin-sdk/session-transcript-runtime | Identitas transkrip, pembantu target/baca/tulis bercakupan, publikasi pembaruan, write lock, dan kunci hit memori transkrip |
plugin-sdk/sqlite-runtime | Pembantu skema-agen, path, dan transaksi SQLite terfokus untuk runtime pihak pertama |
plugin-sdk/cron-store-runtime | Pembantu path/load/save store Cron |
plugin-sdk/state-paths | Pembantu path dir State/OAuth |
plugin-sdk/plugin-state-runtime | Tipe keyed-state SQLite sidecar Plugin ditambah setup pragma koneksi terpusat dan pemeliharaan WAL untuk database milik Plugin |
plugin-sdk/routing | Pembantu pengikatan route/kunci-sesi/akun seperti resolveAgentRoute, buildAgentSessionKey, dan resolveDefaultAgentBoundAccountId |
plugin-sdk/status-helpers | Pembantu ringkasan status kanal/akun bersama, default state-runtime, dan pembantu metadata issue |
plugin-sdk/target-resolver-runtime | Pembantu resolver target bersama |
plugin-sdk/string-normalization-runtime | Pembantu normalisasi slug/string |
plugin-sdk/request-url | Mengekstrak URL string dari input mirip fetch/request |
plugin-sdk/run-command | Runner perintah berbatas waktu dengan hasil stdout/stderr yang dinormalisasi |
plugin-sdk/param-readers | Pembaca param tool/CLI umum |
plugin-sdk/tool-plugin | Mendefinisikan Plugin agent-tool bertipe sederhana dan mengekspos metadata statis untuk pembuatan manifest |
plugin-sdk/tool-payload | Mengekstrak payload yang dinormalisasi dari objek hasil tool |
plugin-sdk/tool-send | Mengekstrak field target kirim kanonis dari argumen tool |
plugin-sdk/sandbox | Tipe backend sandbox dan pembantu perintah SSH/OpenShell, termasuk preflight perintah exec fail-fast |
plugin-sdk/temp-path | Pembantu path temp-download bersama dan workspace temp aman privat |
plugin-sdk/logging-core | Logger subsistem dan pembantu redaksi |
plugin-sdk/markdown-table-runtime | Mode tabel Markdown dan pembantu konversi |
plugin-sdk/model-session-runtime | Pembantu override model/sesi seperti applyModelOverrideToSessionEntry dan resolveAgentMaxConcurrent |
plugin-sdk/talk-config-runtime | Pembantu resolusi konfigurasi provider Talk |
plugin-sdk/json-store | Pembantu kecil baca/tulis state JSON |
plugin-sdk/json-unsafe-integers | Pembantu penguraian JSON yang mempertahankan literal integer tidak aman sebagai string |
plugin-sdk/file-lock | Pembantu file-lock re-entrant |
plugin-sdk/persistent-dedupe | Pembantu cache dedupe berbasis disk |
plugin-sdk/acp-runtime | Pembantu runtime/sesi ACP dan dispatch-balasan |
plugin-sdk/acp-runtime-backend | Pembantu ringan pendaftaran backend ACP dan dispatch-balasan untuk Plugin yang dimuat saat startup |
plugin-sdk/acp-binding-resolve-runtime | Resolusi binding ACP baca-saja tanpa impor startup siklus hidup |
plugin-sdk/agent-config-primitives | Primitif skema-konfigurasi runtime agen yang sempit |
plugin-sdk/boolean-param | Pembaca param boolean longgar |
plugin-sdk/dangerous-name-runtime | Pembantu resolusi pencocokan nama-berbahaya |
plugin-sdk/device-bootstrap | Pembantu bootstrap perangkat dan token pairing |
plugin-sdk/extension-shared | Primitif pembantu bersama untuk kanal pasif, status, dan proksi ambient |
plugin-sdk/models-provider-runtime | Pembantu balasan perintah/provider /models |
plugin-sdk/skill-commands-runtime | Pembantu listing perintah Skill |
plugin-sdk/native-command-registry | Pembantu registry/build/serialize perintah native |
plugin-sdk/agent-harness | Permukaan Plugin tepercaya eksperimental untuk harness agen tingkat rendah: tipe harness, pembantu steer/abort active-run, pembantu bridge tool OpenClaw, pembantu kebijakan tool runtime-plan, klasifikasi hasil terminal, pembantu pemformatan/detail progres tool, dan utilitas hasil percobaan |
plugin-sdk/provider-zai-endpoint | Facade deteksi endpoint milik provider Z.AI yang tidak digunakan lagi; gunakan API publik Plugin Z.AI |
plugin-sdk/async-lock-runtime | Pembantu lock async process-local untuk file state runtime kecil |
plugin-sdk/channel-activity-runtime | Pembantu telemetri aktivitas kanal |
plugin-sdk/concurrency-runtime | Pembantu konkurensi tugas async berbatas |
plugin-sdk/dedupe-runtime | Pembantu cache dedupe dalam-memori dan berbasis persisten |
plugin-sdk/delivery-queue-runtime | Pembantu drain pending-delivery outbound |
plugin-sdk/file-access-runtime | Pembantu path file-lokal dan sumber-media yang aman |
plugin-sdk/heartbeat-runtime | Pembantu wake, event, dan visibilitas Heartbeat |
plugin-sdk/number-runtime | Pembantu koersi numerik |
plugin-sdk/secure-random-runtime | Pembantu token/UUID aman |
plugin-sdk/system-event-runtime | Pembantu antrean event sistem |
plugin-sdk/transport-ready-runtime | Pembantu tunggu kesiapan transport |
plugin-sdk/exec-approvals-runtime | Pembantu file kebijakan persetujuan exec tanpa barrel infra-runtime luas |
plugin-sdk/infra-runtime | Shim kompatibilitas yang tidak digunakan lagi; gunakan subjalur runtime terfokus di atas |
plugin-sdk/collection-runtime | Pembantu cache kecil berbatas |
plugin-sdk/diagnostic-runtime | Pembantu flag diagnostik, event, dan konteks-trace |
plugin-sdk/error-runtime | Grafik error, pemformatan, pembantu klasifikasi error bersama, isApprovalNotFoundError |
plugin-sdk/fetch-runtime | Fetch terbungkus, proksi, opsi EnvHttpProxyAgent, dan pembantu lookup yang dipin |
plugin-sdk/runtime-fetch | Fetch runtime sadar-dispatcher tanpa impor proxy/guarded-fetch |
plugin-sdk/inline-image-data-url-runtime | Sanitizer URL data gambar inline dan pembantu sniffing signature tanpa permukaan runtime media luas |
plugin-sdk/response-limit-runtime | Pembaca body respons berbatas tanpa permukaan runtime media luas |
plugin-sdk/session-binding-runtime | State binding percakapan saat ini tanpa routing binding terkonfigurasi atau store pairing |
plugin-sdk/session-store-runtime | Pembantu store-sesi tanpa impor penulisan/pemeliharaan konfigurasi luas |
plugin-sdk/sqlite-runtime | Pembantu skema-agen, path, dan transaksi SQLite terfokus tanpa kontrol siklus hidup database |
plugin-sdk/context-visibility-runtime | Resolusi visibilitas konteks dan pemfilteran konteks tambahan tanpa impor konfigurasi/keamanan luas |
plugin-sdk/string-coerce-runtime | Pembantu sempit untuk koersi dan normalisasi record/string primitif tanpa impor markdown/logging |
plugin-sdk/host-runtime | Pembantu normalisasi hostname dan host SCP |
plugin-sdk/retry-runtime | Pembantu konfigurasi retry dan runner retry |
plugin-sdk/agent-runtime | Pembantu dir/identitas/workspace agen, termasuk resolveAgentDir, resolveDefaultAgentDir, dan ekspor kompatibilitas resolveOpenClawAgentDir yang tidak digunakan lagi |
plugin-sdk/directory-runtime | Kueri/dedup direktori berbasis konfigurasi |
plugin-sdk/keyed-async-queue | KeyedAsyncQueue |
Subjalur kemampuan dan pengujian
Subjalur kemampuan dan pengujian
| Subjalur | Ekspor utama |
|---|---|
plugin-sdk/media-runtime | Helper bersama untuk mengambil/mentransformasi/menyimpan media, termasuk saveRemoteMedia, saveResponseMedia, readRemoteMediaBuffer, dan fetchRemoteMedia yang sudah usang; utamakan helper penyimpanan sebelum pembacaan buffer ketika URL harus menjadi media OpenClaw |
plugin-sdk/media-mime | Normalisasi MIME terbatas, pemetaan ekstensi file, deteksi MIME, dan helper jenis media |
plugin-sdk/media-store | Helper penyimpanan media terbatas seperti saveMediaBuffer dan saveMediaStream |
plugin-sdk/media-generation-runtime | Helper bersama untuk failover pembuatan media, pemilihan kandidat, dan pesan model yang hilang |
plugin-sdk/media-understanding | Tipe provider pemahaman media serta ekspor helper gambar/audio/ekstraksi-terstruktur untuk provider |
plugin-sdk/text-chunking | Helper pemotongan/perenderan teks dan markdown, konversi tabel markdown, penghapusan tag direktif, dan utilitas teks aman |
plugin-sdk/text-chunking | Helper pemotongan teks keluar |
plugin-sdk/speech | Tipe provider ucapan serta ekspor direktif, registry, validasi, pembangun TTS kompatibel OpenAI, dan helper ucapan untuk provider |
plugin-sdk/speech-core | Ekspor tipe provider ucapan, registry, direktif, normalisasi, dan helper ucapan bersama |
plugin-sdk/realtime-transcription | Tipe provider transkripsi waktu nyata, helper registry, dan helper sesi WebSocket bersama |
plugin-sdk/realtime-bootstrap-context | Helper bootstrap profil waktu nyata untuk injeksi konteks IDENTITY.md, USER.md, dan SOUL.md yang terbatas |
plugin-sdk/realtime-voice | Tipe provider suara waktu nyata, helper registry, dan helper perilaku suara waktu nyata bersama, termasuk pelacakan aktivitas output |
plugin-sdk/image-generation | Tipe provider pembuatan gambar serta helper aset gambar/data URL dan pembangun provider gambar kompatibel OpenAI |
plugin-sdk/image-generation-core | Helper bersama untuk tipe, failover, auth, dan registry pembuatan gambar |
plugin-sdk/music-generation | Tipe provider/permintaan/hasil pembuatan musik |
plugin-sdk/music-generation-core | Tipe pembuatan musik bersama, helper failover, pencarian provider, dan parsing referensi model |
plugin-sdk/video-generation | Tipe provider/permintaan/hasil pembuatan video |
plugin-sdk/video-generation-core | Tipe pembuatan video bersama, helper failover, pencarian provider, dan parsing referensi model |
plugin-sdk/transcripts | Tipe provider sumber transkrip bersama, helper registry, deskriptor sesi, dan metadata ujaran |
plugin-sdk/webhook-targets | Registry target Webhook dan helper pemasangan rute |
plugin-sdk/webhook-path | Alias kompatibilitas yang sudah usang; gunakan plugin-sdk/webhook-ingress |
plugin-sdk/web-media | Helper bersama untuk pemuatan media jarak jauh/lokal |
plugin-sdk/zod | Ekspor ulang kompatibilitas yang sudah usang; impor zod langsung dari zod |
plugin-sdk/testing | Barrel kompatibilitas usang lokal repo untuk pengujian OpenClaw lama. Pengujian repo baru sebaiknya mengimpor subjalur pengujian lokal yang terfokus seperti plugin-sdk/agent-runtime-test-contracts, plugin-sdk/plugin-test-runtime, plugin-sdk/channel-test-helpers, plugin-sdk/test-env, atau plugin-sdk/test-fixtures |
plugin-sdk/plugin-test-api | Helper minimal createTestPluginApi lokal repo untuk pengujian unit registrasi Plugin langsung tanpa mengimpor bridge helper pengujian repo |
plugin-sdk/agent-runtime-test-contracts | Fixture kontrak adapter runtime agen native lokal repo untuk pengujian auth, pengiriman, fallback, hook alat, overlay prompt, skema, dan proyeksi transkrip |
plugin-sdk/channel-test-helpers | Helper pengujian berorientasi channel lokal repo untuk kontrak tindakan/setup/status generik, asersi direktori, siklus hidup startup akun, threading konfigurasi pengiriman, mock runtime, masalah status, pengiriman keluar, dan registrasi hook |
plugin-sdk/channel-target-testing | Suite bersama lokal repo untuk kasus kesalahan resolusi target dalam pengujian channel |
plugin-sdk/plugin-test-contracts | Helper kontrak lokal repo untuk paket Plugin, registrasi, artefak publik, impor langsung, API runtime, dan efek samping impor |
plugin-sdk/provider-test-contracts | Helper kontrak lokal repo untuk runtime provider, auth, discovery, onboard, katalog, wizard, kemampuan media, kebijakan replay, audio langsung STT waktu nyata, pencarian/pengambilan web, dan stream |
plugin-sdk/provider-http-test-mocks | Mock HTTP/auth Vitest opt-in lokal repo untuk pengujian provider yang menjalankan plugin-sdk/provider-http |
plugin-sdk/test-fixtures | Fixture lokal repo generik untuk tangkapan runtime CLI, konteks sandbox, penulis skill, pesan agen, event sistem, pemuatan ulang modul, jalur Plugin bundel, teks terminal, pemotongan, token auth, dan kasus bertipe |
plugin-sdk/test-node-mocks | Helper mock bawaan Node terfokus lokal repo untuk digunakan di dalam factory Vitest vi.mock("node:*") |
Subjalur memori
Subjalur memori
| Subjalur | Ekspor utama |
|---|---|
plugin-sdk/memory-core | Permukaan helper memory-core bundel untuk helper pengelola/konfigurasi/file/CLI |
plugin-sdk/memory-core-engine-runtime | Facade runtime indeks/pencarian memori |
plugin-sdk/memory-core-host-embedding-registry | Helper registry provider embedding memori ringan |
plugin-sdk/memory-core-host-engine-foundation | Ekspor engine fondasi host memori |
plugin-sdk/memory-core-host-engine-embeddings | Kontrak embedding host memori, akses registry, provider lokal, dan helper batch/jarak jauh generik. registerMemoryEmbeddingProvider pada permukaan ini sudah usang; gunakan API provider embedding generik untuk provider baru. |
plugin-sdk/memory-core-host-engine-qmd | Ekspor engine QMD host memori |
plugin-sdk/memory-core-host-engine-storage | Ekspor engine penyimpanan host memori |
plugin-sdk/memory-core-host-multimodal | Helper multimodal host memori |
plugin-sdk/memory-core-host-query | Helper kueri host memori |
plugin-sdk/memory-core-host-secret | Helper secret host memori |
plugin-sdk/memory-core-host-events | Alias kompatibilitas yang sudah usang; gunakan plugin-sdk/memory-host-events |
plugin-sdk/memory-core-host-status | Helper status host memori |
plugin-sdk/memory-core-host-runtime-cli | Helper runtime CLI host memori |
plugin-sdk/memory-core-host-runtime-core | Helper runtime inti host memori |
plugin-sdk/memory-core-host-runtime-files | Helper file/runtime host memori |
plugin-sdk/memory-host-core | Alias netral vendor untuk helper runtime inti host memori |
plugin-sdk/memory-host-events | Alias netral vendor untuk helper jurnal event host memori |
plugin-sdk/memory-host-files | Alias kompatibilitas yang sudah usang; gunakan plugin-sdk/memory-core-host-runtime-files |
plugin-sdk/memory-host-markdown | Helper managed-markdown bersama untuk Plugin yang berdekatan dengan memori |
plugin-sdk/memory-host-search | Facade runtime Active Memory untuk akses pengelola pencarian |
plugin-sdk/memory-host-status | Alias kompatibilitas yang sudah usang; gunakan plugin-sdk/memory-core-host-status |
Subjalur helper bundel yang dicadangkan
Subjalur helper bundel yang dicadangkan
Subjalur SDK helper bundel yang dicadangkan adalah permukaan sempit khusus owner untuk
kode Plugin bundel. Subjalur ini dilacak dalam inventaris SDK agar build paket
dan aliasing tetap deterministik, tetapi bukan API penulisan Plugin umum.
Kontrak host baru yang dapat digunakan kembali sebaiknya menggunakan subjalur SDK generik
seperti
plugin-sdk/gateway-runtime, plugin-sdk/security-runtime, dan
plugin-sdk/plugin-config-runtime.| Subjalur | Owner dan tujuan |
|---|---|
plugin-sdk/codex-mcp-projection | Helper Plugin Codex bundel untuk memproyeksikan konfigurasi server MCP pengguna ke konfigurasi thread server aplikasi Codex |
plugin-sdk/codex-native-task-runtime | Helper Plugin Codex bundel untuk mencerminkan subagen native server aplikasi Codex ke status tugas OpenClaw |