Ikhtisar SDK Plugin

SDK Plugin adalah kontrak bertipe antara plugin dan inti. Halaman ini merupakan referensi untuk apa yang harus diimpor dan apa yang dapat Anda daftarkan.

Konvensi impor

Selalu impor dari subjalur tertentu:

Setiap subjalur merupakan modul kecil yang mandiri. Hal ini menjaga agar proses awal tetap cepat dan mencegah masalah dependensi melingkar. Untuk pembantu entri/build khusus saluran, utamakan openclaw/plugin-sdk/channel-core; gunakan openclaw/plugin-sdk/core untuk permukaan payung yang lebih luas dan pembantu bersama seperti buildChannelConfigSchema.

Untuk konfigurasi saluran, publikasikan JSON Schema milik saluran melalui openclaw.plugin.json#channelConfigs. Subjalur plugin-sdk/channel-config-schema ditujukan untuk primitif skema bersama dan pembangun generik. Plugin bawaan OpenClaw menggunakan plugin-sdk/bundled-channel-config-schema untuk skema saluran bawaan yang dipertahankan. Ekspor kompatibilitas yang tidak digunakan lagi tetap tersedia di plugin-sdk/channel-config-schema-legacy; kedua subjalur skema bawaan tersebut bukan pola untuk plugin baru.

Referensi subjalur

SDK Plugin ditampilkan sebagai sekumpulan subjalur sempit yang dikelompokkan berdasarkan area (entri plugin, saluran, penyedia, autentikasi, runtime, kapabilitas, memori, dan pembantu plugin bawaan yang dicadangkan). Untuk katalog lengkap — yang dikelompokkan dan ditautkan — lihat Subjalur SDK Plugin.

Inventaris titik masuk kompilator berada di scripts/lib/plugin-sdk-entrypoints.json; ekspor paket dihasilkan dari subset publik setelah mengurangi subjalur pengujian/internal lokal repositori yang tercantum di scripts/lib/plugin-sdk-private-local-only-subpaths.json. Jalankan pnpm plugin-sdk:surface untuk mengaudit jumlah ekspor publik. Subjalur publik yang tidak digunakan lagi, cukup lama, dan tidak digunakan oleh kode produksi ekstensi bawaan dilacak di scripts/lib/plugin-sdk-deprecated-public-subpaths.json; barrel ekspor ulang luas yang tidak digunakan lagi dilacak di scripts/lib/plugin-sdk-deprecated-barrel-subpaths.json.

API pendaftaran

Callback register(api) menerima objek OpenClawPluginApi dengan metode-metode berikut:

Pendaftaran kapabilitas

Penyedia pekerja juga harus mendeklarasikan ID-nya dalam contracts.workerProviders. Inti menyimpan intensi persisten sebelum provision(profile, operationId). Penyedia memvalidasi pengaturan sebelum alokasi eksternal dan melempar WorkerProviderError untuk penolakan profil permanen. provision harus menggunakan kembali sewa yang sama saat ID operasi diulangi. Inti menyimpan pengaturan profil yang telah divalidasi bersama sewa dan memberikan snapshot tersebut kepada destroy({ leaseId, profile }), yang harus idempoten, serta inspect({ leaseId, profile }), yang mengembalikan active, destroyed, atau unknown. Hal ini memungkinkan penyedia merutekan panggilan siklus hidup setelah Gateway dimulai ulang atau profil bernama dihapus. Titik akhir SSH menggunakan SecretRef untuk keyRef, bukan materi kunci sebaris, dan menyertakan hostKey dari keluaran penyediaan tepercaya dalam format persis algorithm base64, tanpa nama host atau komentar. Inti menyematkan hostKey dan tidak pernah memercayai kunci dari koneksi pertama. Penyedia yang membuat keyRef dinamis dapat mengimplementasikan resolveSshIdentity({ leaseId, profile, keyRef }); jika tersedia, resolver tersebut bersifat otoritatif, sedangkan penyedia tanpa resolver tersebut menggunakan resolver rahasia generik yang dikonfigurasi. Penyedia dengan sewa yang dapat diperpanjang juga dapat mengimplementasikan renew(leaseId). inspect harus melempar galat pada kegagalan sementara atau yang tidak dapat ditentukan; kembalikan unknown hanya untuk ketiadaan yang bersifat otoritatif. Inti menandai catatan lokal aktif sebagai yatim, atau menganggap ketiadaan tersebut sebagai penyelesaian pembongkaran setelah permintaan pemusnahan tersimpan.

Penyedia embedding yang didaftarkan dengan api.registerEmbeddingProvider(...) juga harus dicantumkan dalam contracts.embeddingProviders di manifes plugin. Ini adalah permukaan embedding generik untuk pembuatan vektor yang dapat digunakan kembali. Pencarian memori dapat menggunakan permukaan penyedia generik ini. Antarmuka lama api.registerMemoryEmbeddingProvider(...) dan contracts.memoryEmbeddingProviders merupakan kompatibilitas yang tidak digunakan lagi sementara penyedia khusus memori yang ada bermigrasi.

Penyedia khusus memori yang masih mengekspos batchEmbed(...) saat runtime tetap menggunakan kontrak batching per berkas yang ada, kecuali runtime-nya secara eksplisit menetapkan sourceWideBatchEmbed: true. Keikutsertaan ini memungkinkan host memori mengirimkan potongan dari beberapa berkas memori kotor dan sumber yang diaktifkan dalam satu panggilan batchEmbed(...) hingga batas batch host. Adaptor batch yang mengunggah berkas permintaan JSONL harus membagi pekerjaan penyedia sebelum mencapai batas ukuran unggahan maupun batas jumlah permintaan. Penyedia harus mengembalikan satu embedding untuk setiap potongan masukan dalam urutan yang sama dengan batch.chunks; hilangkan tanda tersebut jika penyedia mengharapkan batch lokal per berkas atau tidak dapat mempertahankan urutan masukan dalam pekerjaan lingkup sumber yang lebih besar.

Alat dan perintah

Gunakan defineToolPlugin untuk plugin sederhana yang hanya berisi alat dengan nama alat tetap. Gunakan api.registerTool(...) secara langsung untuk plugin campuran atau pendaftaran alat yang sepenuhnya dinamis.

Perintah plugin dapat menetapkan agentPromptGuidance ketika agen memerlukan petunjuk perutean singkat milik perintah. Jaga agar teks tersebut membahas perintah itu sendiri; jangan tambahkan kebijakan khusus penyedia atau plugin ke pembangun prompt inti.

Entri panduan dapat berupa string lama, yang berlaku untuk setiap permukaan prompt, atau entri terstruktur:

agentPromptGuidance: [  "Global command hint.",  { text: "Only show this in the main OpenClaw prompt.", surfaces: ["openclaw_main"] },];

surfaces terstruktur dapat mencakup openclaw_main, codex_app_server, cli_backend, acp_backend, atau subagent. pi_main tetap merupakan alias yang tidak digunakan lagi untuk openclaw_main. Hilangkan surfaces untuk panduan yang sengaja berlaku pada semua permukaan. Jangan meneruskan array surfaces kosong; array tersebut ditolak agar hilangnya cakupan secara tidak sengaja tidak menjadi teks prompt global.

Instruksi pengembang app-server Codex native lebih ketat daripada permukaan prompt lainnya: hanya panduan yang secara eksplisit dicakupkan ke codex_app_server yang dipromosikan ke jalur berprioritas lebih tinggi tersebut. Panduan string lama dan panduan terstruktur tanpa cakupan tetap tersedia bagi permukaan prompt non-Codex demi kompatibilitas.

Perintah host Node dijalankan pada host Node yang terhubung, bukan di dalam proses Gateway. Jika agentTool tersedia, Node menerbitkan deskriptor setelah berhasil terhubung ke Gateway; Gateway menyediakannya untuk eksekusi agen hanya selama Node tersebut terhubung dan hanya jika command milik deskriptor berada dalam permukaan perintah Node yang disetujui. Atur agentTool.defaultPlatforms untuk memasukkan perintah yang tidak berbahaya ke dalam daftar izin perintah Node default; jika tidak, wajibkan gateway.nodes.allowCommands eksplisit atau kebijakan pemanggilan Node. agentTool.name harus aman bagi penyedia: diawali dengan huruf, hanya menggunakan huruf, angka, garis bawah, atau tanda hubung, dan tidak melebihi 64 karakter. Alat Node yang didukung MCP dapat menetapkan metadata agentTool.mcp agar permukaan katalog dan pencarian alat dapat menampilkan identitas server/alat MCP jarak jauh, tetapi eksekusi tetap dilakukan melalui perintah Node yang diumumkan.

Infrastruktur

Pembangun suplemen prompt memori menerima konteks opsional agentId, agentSessionKey, dan sandboxed. Panggilan search dan get pada suplemen korpus memori menerima konteks opsional agentId dan sandboxed. Plugin dengan penyimpanan milik agen harus menyelesaikan penyimpanan tersebut untuk setiap panggilan, bukan menangkap satu jalur global saat pendaftaran. Jika ID agen diwajibkan tetapi tidak tersedia dalam operasi multiagen, gagal secara tertutup alih-alih memilih agen sembarang.

Penangan interaktif Telegram dapat mengembalikan { submitText } untuk merutekan teks melalui jalur agen masuk normal Telegram setelah penangan berhasil. OpenClaw mempertahankan tombol panggilan balik ketika kebijakan masuk melewati teks atau pemrosesan gagal, sehingga pengguna dapat mencoba lagi setelah kondisi yang menghalangi berubah. Bidang hasil ini khusus untuk Telegram; saluran lain mempertahankan kontrak hasil interaktifnya sendiri.

Hook host untuk Plugin alur kerja

Hook host adalah sambungan SDK bagi Plugin yang perlu berpartisipasi dalam siklus hidup host, bukan hanya menambahkan penyedia, saluran, atau alat. Hook ini merupakan kontrak generik; Mode Rencana dapat menggunakannya, begitu pula alur kerja persetujuan, gerbang kebijakan ruang kerja, pemantau latar belakang, wisaya penyiapan, dan Plugin pendamping UI.

Deskriptor surface: "tab" menambahkan tab bilah sisi ke UI Kontrol. Deskriptor tab milik Plugin yang aktif diumumkan kepada klien dasbor dalam sapaan gateway (controlUiTabs), sehingga tab hanya muncul ketika Plugin diaktifkan. Plugin bawaan dapat menyediakan tampilan dasbor kelas satu untuk tabnya; Plugin lain dapat menetapkan path ke rute HTTP Plugin (lihat api.registerHttpRoute(...)) yang dirender dasbor dalam bingkai terisolasi. icon adalah petunjuk nama ikon dasbor, group memilih bagian bilah sisi (control atau agent), order mengurutkan di antara tab Plugin, dan requiredScopes menyembunyikan tab dari koneksi yang tidak memiliki cakupan operator tersebut:

api.session.controls.registerControlUiDescriptor({  surface: "tab",  id: "logbook",  label: "Logbook",  description: "Your day as a timeline, built from screen snapshots.",  icon: "sun",  group: "control",  requiredScopes: ["operator.write"],});

Gunakan namespace yang dikelompokkan untuk kode Plugin baru:

• api.session.state.registerSessionExtension(...)
• api.session.workflow.enqueueNextTurnInjection(...)
• api.session.workflow.registerSessionSchedulerJob(...)
• api.session.workflow.sendSessionAttachment(...)
• api.session.workflow.scheduleSessionTurn(...)
• api.session.workflow.unscheduleSessionTurnsByTag(...)
• api.session.controls.registerSessionAction(...)
• api.session.controls.registerControlUiDescriptor(...)
• api.agent.events.registerAgentEventSubscription(...)
• api.agent.events.emitAgentEvent(...)
• api.runContext.setRunContext(...) / getRunContext(...) / clearRunContext(...)
• api.lifecycle.registerRuntimeLifecycle(...)

Metode datar yang ekuivalen tetap tersedia sebagai alias kompatibilitas yang sudah tidak dianjurkan bagi Plugin yang ada. Jangan tambahkan kode Plugin baru yang memanggil api.registerSessionExtension, api.enqueueNextTurnInjection, api.registerControlUiDescriptor, api.registerRuntimeLifecycle, api.registerAgentEventSubscription, api.emitAgentEvent, api.setRunContext, api.getRunContext, api.clearRunContext, api.registerSessionSchedulerJob, api.registerSessionAction, api.sendSessionAttachment, api.scheduleSessionTurn, atau api.unscheduleSessionTurnsByTag secara langsung.

scheduleSessionTurn(...) adalah kemudahan yang tercakup sesi di atas penjadwal Cron Gateway. Cron memiliki pengaturan waktu dan membuat catatan tugas latar belakang ketika giliran dijalankan; SDK Plugin hanya membatasi sesi target, penamaan milik Plugin, dan pembersihan. Gunakan api.runtime.tasks.managedFlows di dalam giliran terjadwal ketika pekerjaan itu sendiri memerlukan status Alur Tugas multilangkah yang tahan lama.

Kontrak-kontrak tersebut sengaja memisahkan kewenangan:

• Plugin eksternal dapat memiliki ekstensi sesi, deskriptor UI, perintah, metadata alat, injeksi giliran berikutnya, dan hook normal.
• Kebijakan alat tepercaya dijalankan sebelum hook before_tool_call biasa dan dipercaya oleh host. Kebijakan bawaan dijalankan terlebih dahulu; kebijakan Plugin terpasang memerlukan pengaktifan eksplisit beserta ID lokalnya dalam contracts.trustedToolPolicies, lalu dijalankan berikutnya sesuai urutan pemuatan Plugin. ID kebijakan tercakup pada Plugin yang mendaftarkannya.
• Kepemilikan perintah yang dicadangkan hanya untuk bawaan. Plugin eksternal harus menggunakan nama perintah atau aliasnya sendiri.
• allowPromptInjection=false menonaktifkan hook yang memodifikasi prompt, termasuk agent_turn_prepare, before_prompt_build, heartbeat_prompt_contribution, bidang prompt dari before_agent_start lama, dan enqueueNextTurnInjection.

Contoh konsumen non-Rencana:

Pendaftaran penemuan Gateway

api.registerGatewayDiscoveryService(...) memungkinkan sebuah Plugin mengiklankan Gateway aktif melalui transport penemuan lokal seperti mDNS/Bonjour. OpenClaw memanggil layanan tersebut selama proses mulai Gateway ketika penemuan lokal diaktifkan, meneruskan port Gateway saat ini dan data petunjuk TXT yang tidak bersifat rahasia, lalu memanggil handler stop yang dikembalikan selama penghentian Gateway.

api.registerGatewayDiscoveryService({  id: "my-discovery",  async advertise(ctx) {    const handle = await startMyAdvertiser({      gatewayPort: ctx.gatewayPort,      tls: ctx.gatewayTlsEnabled,      displayName: ctx.machineDisplayName,    });    return { stop: () => handle.stop() };  },});

Plugin penemuan Gateway tidak boleh memperlakukan nilai TXT yang diiklankan sebagai rahasia atau autentikasi. Penemuan adalah petunjuk perutean; autentikasi Gateway dan penyematan TLS tetap menjadi pemilik kepercayaan.

Metadata pendaftaran CLI

api.registerCli(registrar, opts?) menerima dua jenis metadata perintah:

• commands: nama perintah eksplisit yang dimiliki pendaftar
• descriptors: deskriptor perintah saat penguraian yang digunakan untuk bantuan CLI, perutean, dan pendaftaran CLI Plugin secara malas
• parentPath: jalur perintah induk opsional untuk grup perintah bertingkat, seperti ["nodes"]

Untuk fitur Node berpasangan, utamakan api.registerNodeCliFeature(registrar, opts?). Ini adalah pembungkus kecil untuk api.registerCli(..., { parentPath: ["nodes"] }) dan menjadikan perintah seperti openclaw nodes canvas sebagai fitur Node milik Plugin secara eksplisit.

Jika Anda ingin perintah Plugin tetap dimuat secara malas di jalur CLI akar normal, berikan descriptors yang mencakup setiap akar perintah tingkat atas yang diekspos oleh pendaftar tersebut.

api.registerCli(  async ({ program }) => {    const { registerMatrixCli } = await import("./src/cli.js");    registerMatrixCli({ program });  },  {    descriptors: [      {        name: "matrix",        description: "Kelola akun Matrix, verifikasi, perangkat, dan status profil",        hasSubcommands: true,      },    ],  },);

Perintah bertingkat menerima perintah induk yang telah diresolusi sebagai program:

api.registerCli(  async ({ program }) => {    const { registerNodesCanvasCommands } = await import("./src/cli.js");    registerNodesCanvasCommands(program);  },  {    parentPath: ["nodes"],    descriptors: [      {        name: "canvas",        description: "Tangkap atau render konten kanvas dari Node berpasangan",        hasSubcommands: true,      },    ],  },);

Gunakan commands saja hanya jika Anda tidak memerlukan pendaftaran CLI akar secara malas. Jalur kompatibilitas eager tersebut tetap didukung, tetapi tidak memasang placeholder berbasis deskriptor untuk pemuatan malas saat penguraian.

Pendaftaran backend CLI

api.registerCliBackend(...) memungkinkan sebuah Plugin memiliki konfigurasi bawaan untuk backend CLI AI lokal seperti claude-cli atau my-cli.

• id backend menjadi prefiks penyedia dalam referensi model seperti my-cli/gpt-5.
• config backend menggunakan bentuk yang sama dengan agents.defaults.cliBackends.<id>.
• Konfigurasi pengguna tetap diutamakan. OpenClaw menggabungkan agents.defaults.cliBackends.<id> di atas nilai bawaan Plugin sebelum menjalankan CLI.
• Gunakan normalizeConfig ketika backend memerlukan penulisan ulang kompatibilitas setelah penggabungan (misalnya menormalkan bentuk flag lama).
• Gunakan resolveExecutionArgs untuk penulisan ulang argv bercakupan permintaan yang merupakan bagian dari dialek CLI, seperti memetakan tingkat penalaran OpenClaw ke flag upaya native. Hook menerima ctx.executionMode; gunakan "side-question" untuk menambahkan flag isolasi native backend bagi pemanggilan /btw sementara. Jika flag tersebut secara andal menonaktifkan alat native untuk CLI yang selain itu selalu aktif, deklarasikan juga sideQuestionToolMode: "disabled".
• Backend yang dapat menonaktifkan semua alat native untuk eksekusi tertentu dapat mendeklarasikan nativeToolMode: "selectable". Pemanggilan terbatas meneruskan tuple ctx.toolAvailability.native kosong beserta daftar izin MCP yang diisolasi secara tepat oleh host; resolveExecutionArgs harus memberlakukan keduanya pada argv akhir untuk eksekusi baru maupun lanjutan. OpenClaw menolak secara tertutup jika backend tidak dapat melakukannya.

Untuk panduan penulisan menyeluruh, lihat Plugin backend CLI.

Slot eksklusif

Adaptor embedding memori yang tidak digunakan lagi

• registerMemoryCapability adalah API Plugin memori eksklusif yang diutamakan.
• registerMemoryCapability juga dapat mengekspos publicArtifacts.listArtifacts(...) sehingga Plugin pendamping dapat menggunakan artefak memori yang diekspor melalui openclaw/plugin-sdk/memory-host-core, alih-alih mengakses tata letak privat Plugin memori tertentu.
• registerMemoryPromptSection, registerMemoryFlushPlan, dan registerMemoryRuntime adalah API Plugin memori eksklusif yang kompatibel dengan sistem lama.
• MemoryFlushPlan.model dapat menyematkan giliran flush ke referensi provider/model yang tepat, seperti ollama/qwen3:8b, tanpa mewarisi rantai fallback aktif.
• registerMemoryEmbeddingProvider tidak digunakan lagi. Penyedia embedding baru harus menggunakan api.registerEmbeddingProvider(...) dan contracts.embeddingProviders.
• Penyedia khusus memori yang sudah ada tetap berfungsi selama jendela migrasi, tetapi inspeksi Plugin melaporkan hal ini sebagai utang kompatibilitas untuk Plugin yang bukan bawaan.

Peristiwa dan siklus hidup

Lihat Hook Plugin untuk contoh, nama hook umum, dan semantik pengaman.

Semantik keputusan hook

before_install adalah hook siklus hidup runtime Plugin, bukan permukaan kebijakan instalasi operator. Gunakan security.installPolicy ketika keputusan izinkan/blokir harus mencakup jalur instalasi atau pembaruan yang didukung CLI dan Gateway.

• before_tool_call: mengembalikan { block: true } bersifat terminal. Setelah handler mana pun menetapkannya, handler dengan prioritas lebih rendah akan dilewati.
• before_tool_call: mengembalikan { block: false } dianggap tidak memberikan keputusan (sama seperti menghilangkan block), bukan sebagai penimpaan.
• before_install: mengembalikan { block: true } bersifat terminal. Setelah handler mana pun menetapkannya, handler dengan prioritas lebih rendah akan dilewati.
• before_install: mengembalikan { block: false } dianggap tidak memberikan keputusan (sama seperti menghilangkan block), bukan sebagai penimpaan.
• reply_dispatch: mengembalikan { handled: true, ... } bersifat terminal. Setelah handler mana pun mengambil alih pengiriman, handler dengan prioritas lebih rendah dan jalur pengiriman model bawaan akan dilewati.
• message_sending: mengembalikan { cancel: true } bersifat terminal. Setelah handler mana pun menetapkannya, handler dengan prioritas lebih rendah akan dilewati.
• message_sending: mengembalikan { cancel: false } dianggap tidak memberikan keputusan (sama seperti menghilangkan cancel), bukan sebagai penimpaan.
• message_received: gunakan bidang bertipe threadId saat Anda memerlukan perutean utas/topik masuk. Gunakan metadata untuk data tambahan khusus kanal.
• message_sending: gunakan bidang perutean bertipe replyToId / threadId sebelum beralih ke metadata khusus kanal.
• gateway_start: gunakan ctx.config, ctx.workspaceDir, dan ctx.getCron?.() untuk status awal yang dimiliki Gateway, alih-alih mengandalkan hook internal gateway:startup. Cron mungkin masih dalam proses pemuatan pada tahap ini.
• cron_reconciled: bangun ulang proyeksi cron eksternal lengkap setelah pemuatan awal atau pemuatan ulang penjadwal. Ini mencakup reason dan status efektif enabled, termasuk enabled: false, sedangkan ctx.getCron?.() mengembalikan penjadwal yang telah direkonsiliasi secara persis. Teruskan ctx.abortSignal ke pekerjaan proyeksi persisten; pekerjaan tersebut dibatalkan ketika snapshot penjadwal itu digantikan atau Gateway ditutup.
• cron_changed: amati perubahan siklus hidup cron yang dimiliki Gateway. Peristiwa scheduled dan removed merupakan petunjuk rekonsiliasi pascakomit, bukan log delta berurutan. event.nextRunAtMs pada peristiwa terjadwal tidak ada ketika pekerjaan tersebut tidak memiliki waktu aktivasi berikutnya; peristiwa penghapusan tetap membawa snapshot pekerjaan yang dihapus.

Penjadwal aktivasi eksternal harus melakukan debounce atau menggabungkan peristiwa cron_changed, lalu membaca ulang tampilan persisten lengkap dari penjadwal yang terakhir ditangkap oleh cron_reconciled. Jangan mengambil penjadwal dari konteks cron_changed: petunjuk terlepas dari penjadwal lama dapat tumpang-tindih dengan pemuatan ulang yang lebih baru.

Gunakan cron_reconciled sebagai pemicu snapshot lengkap untuk status persisten yang dimuat saat Gateway dimulai atau penjadwal diganti. Peristiwa ini tidak diputar ulang untuk pemuatan ulang langsung yang hanya mencakup Plugin. Handler pengamatan berjalan secara paralel, dan pengiriman tanpa menunggu hasil dapat tumpang-tindih, sehingga konsumen tidak boleh bergantung pada urutan penyelesaian peristiwa. Pertahankan OpenClaw sebagai sumber kebenaran untuk pemeriksaan jatuh tempo dan eksekusi.

Untuk adaptor eksekusi tunggal dengan penggantian persisten, percobaan ulang/jeda bertahap, dan penghentian yang bersih, lihat Proyeksi cron eksternal yang aman.

Bidang objek API

Konvensi modul internal

Di dalam Plugin Anda, gunakan berkas barrel lokal untuk impor internal:

my-plugin/  api.ts            # Ekspor publik untuk konsumen eksternal  runtime-api.ts    # Ekspor runtime khusus internal  index.ts          # Titik masuk Plugin  setup-entry.ts    # Entri ringan khusus penyiapan (opsional)

Permukaan publik Plugin bawaan yang dimuat melalui fasad (api.ts, runtime-api.ts, index.ts, setup-entry.ts, dan berkas entri publik serupa) memprioritaskan snapshot konfigurasi runtime aktif ketika OpenClaw sudah berjalan. Jika snapshot runtime belum tersedia, permukaan tersebut beralih ke berkas konfigurasi terselesaikan di disk. Fasad Plugin bawaan yang dikemas harus dimuat melalui pemuat fasad Plugin milik OpenClaw; impor langsung dari dist/extensions/... melewati pemeriksaan manifes dan sidecar runtime yang digunakan instalasi terkemas untuk kode milik Plugin.

Plugin penyedia dapat mengekspos barrel kontrak lokal Plugin yang terbatas ketika suatu pembantu memang khusus untuk penyedia dan belum semestinya berada dalam subjalur SDK generik. Contoh bawaan:

• Anthropic: batas publik api.ts / contract-api.ts untuk pembantu aliran header beta Claude dan service_tier.
• @openclaw/openai-provider: api.ts mengekspor pembangun penyedia, pembantu model bawaan, dan pembangun penyedia waktu nyata.
• @openclaw/openrouter-provider: api.ts mengekspor pembangun penyedia beserta pembantu orientasi awal/konfigurasi.

Terkait