Skip to main content
Plugin SDK, dar kapsamlı herkese açık alt yolları ve openclaw/plugin-sdk/ altındaki yalnızca depoya özgü paketlenmiş yardımcıları içerir. Bu sayfa her ikisini de kataloglar ve özel-yerel girdileri açıkça etiketler. Sınırı üç dosya tanımlar:
  • scripts/lib/plugin-sdk-entrypoints.json: derlemenin derlediği, bakımı yapılan giriş noktası envanteri.
  • scripts/lib/plugin-sdk-private-local-only-subpaths.json: türleri tanımlanmış ve belgelenmiş SDK’nın dışında tutulan dahili alt yollar. Üretim girdileri, ayrı olarak yayımlanan resmî pluginler için yalnızca JavaScript ana bilgisayar çalışma zamanı dışa aktarımları olarak kullanılabilir kalır; yalnızca test girdileri dışa aktarılmaz.
  • src/plugin-sdk/entrypoints.ts: kullanımdan kaldırılmış alt yollar, ayrılmış paketlenmiş yardımcılar, desteklenen paketlenmiş cepheler ve plugine ait herkese açık yüzeyler için sınıflandırma meta verileri.
Bakımcılar, herkese açık dışa aktarım sayısını pnpm plugin-sdk:surface ile ve etkin ayrılmış yardımcı alt yollarını pnpm plugins:boundary-report:summary ile denetler; kullanılmayan ayrılmış yardımcı dışa aktarımlar, herkese açık SDK’da atıl uyumluluk borcu olarak kalmak yerine CI raporunun başarısız olmasına neden olur. Plugin yazma kılavuzu için Plugin SDK’ya genel bakış bölümüne bakın.

Plugin girişi

Uyumluluk ve özel-yerel yardımcılar

Yalnızca daha sonraki dönem için kullanımdan kaldırılmış alt yollar dışa aktarılmaya devam eder. Temmuz 2026 takma adları ve kullanılmayan alt yollar silinirken yalnızca paketlenmiş yardımcılar herkese açık paketten kaldırılmış ve aşağıda özel-yerel olarak etiketlenmiştir. Bakımı yapılan liste scripts/lib/plugin-sdk-deprecated-public-subpaths.json; CI, paketlenmiş plugin-sdk/text-runtime yalnızca uyumluluk içindir ve plugin-sdk/zod bir uyumluluk yeniden dışa aktarımıdır: zod öğesini doğrudan zod konumundan içe aktarın. Geniş kapsamlı etki alanı varilleri plugin-sdk/agent-runtime, plugin-sdk/channel-lifecycle, plugin-sdk/conversation-runtime, plugin-sdk/hook-runtime, plugin-sdk/media-runtime, plugin-sdk/plugin-runtime ve plugin-sdk/security-runtime de odaklanmış alt yollar lehine kullanımdan kaldırılmıştır. OpenClaw’ın Vitest destekli test yardımcısı alt yolları yalnızca depoya özgüdür ve artık paket dışa aktarımları değildir: 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 ve testing. Özel paketlenmiş yardımcı yüzeyleri ssrf-runtime-internal ve codex-native-task-runtime da yalnızca depoya özgüdür.

Paketlenmiş plugin yardımcı alt yolları

Yalnızca paketlenmiş yardımcı modüller, Temmuz 2026 taramasından sonra özel-yereldir. Sahipler arası içe aktarımlar paket sözleşmesi korumalarıyla engellenir. src/plugin-sdk/entrypoints.ts, genel sözleşmeler plugin-sdk/qa-runner-runtime, plugin-sdk/telegram-account öğelerinin yerini alana kadar paketlenmiş pluginleri tarafından desteklenen, herkese açık kalmaya devam eden SDK giriş noktaları olan desteklenen paketlenmiş cepheleri ayrıca izler; yeni kod için kullanımdan kaldırılmıştır; aşağıdaki satır bazındaki notlara bakın.
Daha sonraki dönem kanal uyumluluk alt yolları yalnızca kayıt tarihlerine kadar herkese açık kalır. Doğrudan DM erişimi, yanıt seçenekleri, eşleştirme yolları ve kanal çalışma zamanı parçaları gibi Temmuz takma adları kaldırılmıştır; yalnızca paketlenmiş yardımcılar özel-yereldir.
Sağlayıcı kullanım anlık görüntüleri normalde her biri bir etiket, kullanılan yüzde ve isteğe bağlı sıfırlama zamanı içeren bir veya daha fazla kota windows bildirir. Sıfırlanabilir kota pencereleri yerine bakiye veya hesap durumu metni sunan sağlayıcılar, yüzdeler uydurmak yerine boş bir windows dizisiyle summary döndürmelidir. OpenClaw bu özet metnini durum çıktısında gösterir; error yalnızca kullanım uç noktası başarısız olduğunda veya kullanılabilir kullanım verisi döndürmediğinde kullanılmalıdır.
Ayrılmış paketlenmiş yardımcı SDK alt yolları, paketlenmiş Plugin kodu için dar kapsamlı, sahibe özgü yüzeylerdir. Paket derlemelerinin ve takma adlandırmanın belirlenimci kalması için SDK envanterinde izlenirler, ancak genel Plugin geliştirme API’leri değildirler. Yeniden kullanılabilir yeni ana bilgisayar sözleşmeleri, plugin-sdk/gateway-runtime ve plugin-sdk/ssrf-runtime gibi genel SDK alt yollarını kullanmalıdır.

İlgili