Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Bu, OpenClaw çekirdek geliştiricileri için bir katkıda bulunan kılavuzudur. Harici bir Plugin geliştiriyorsanız bunun yerine Plugin oluşturma bölümüne bakın. Derin mimari başvurusu (yetenek modeli, sahiplik, yükleme hattı, çalışma zamanı yardımcıları) için Plugin iç yapısı bölümüne bakın.
Bunu, OpenClaw görüntü üretimi, video üretimi veya gelecekte tedarikçi destekli başka bir özellik alanı gibi yeni bir paylaşılan etki alanına ihtiyaç duyduğunda kullanın. Kural:
  • plugin = sahiplik sınırı
  • capability = paylaşılan çekirdek sözleşme
Bir tedarikçiyi doğrudan bir kanala veya araca bağlayarak başlamayın. Yetenek tanımlayarak başlayın.

​
Ne zaman yetenek oluşturulmalı

Aşağıdakilerin tümü doğru olduğunda yeni bir yetenek oluşturun:
  1. Birden fazla tedarikçi bunu makul biçimde uygulayabilir.
  2. Kanallar, araçlar veya özellik Plugin’leri tedarikçiyi önemsemeden bunu tüketebilmelidir.
  3. Çekirdeğin geri dönüş, ilke, yapılandırma veya teslim davranışını sahiplenmesi gerekir.
İş yalnızca tedarikçiye özgüyse ve henüz paylaşılan bir sözleşme yoksa, durun ve önce sözleşmeyi tanımlayın.

​
Standart sıra

  1. Tiplendirilmiş çekirdek sözleşmeyi tanımlayın.
  2. Bu sözleşme için Plugin kaydı ekleyin.
  3. Paylaşılan bir çalışma zamanı yardımcısı ekleyin.
  4. Kanıt olarak bir gerçek tedarikçi Plugin’i bağlayın.
  5. Özellik/kanal tüketicilerini çalışma zamanı yardımcısına taşıyın.
  6. Sözleşme testleri ekleyin.
  7. Operatöre dönük yapılandırmayı ve sahiplik modelini belgeleyin.

​
Ne nereye gider

Çekirdek:
  • İstek/yanıt tipleri.
  • Sağlayıcı kayıt defteri + çözümleme.
  • Geri dönüş davranışı.
  • İç içe nesne, joker karakter, dizi öğesi ve bileşim düğümlerinde yayılan title / description belge meta verileriyle yapılandırma şeması.
  • Çalışma zamanı yardımcısı yüzeyi.
Tedarikçi Plugin’i:
  • Tedarikçi API çağrıları.
  • Tedarikçi kimlik doğrulama işlemleri.
  • Tedarikçiye özgü istek normalleştirmesi.
  • Yetenek uygulamasının kaydı.
Özellik/kanal Plugin’i:
  • api.runtime.* veya eşleşen plugin-sdk/*-runtime yardımcısını çağırır.
  • Bir tedarikçi uygulamasını asla doğrudan çağırmaz.

​
Sağlayıcı ve harness sınırları

Davranış genel ajan döngüsü yerine model sağlayıcı sözleşmesine ait olduğunda sağlayıcı hook’ları kullanın. Örnekler arasında taşıma seçimi sonrası sağlayıcıya özgü istek parametreleri, auth-profile tercihi, istem katmanları ve model/profil failover sonrası takip geri dönüş yönlendirmesi bulunur. Davranış bir turu yürüten çalışma zamanına ait olduğunda ajan harness hook’ları kullanın. Harness’ler boş, yalnızca akıl yürütme içeren veya yalnızca planlama içeren yanıtlar gibi başarılı ama kullanılamaz deneme sonuçlarını sınıflandırabilir; böylece dış model geri dönüş ilkesi yeniden deneme kararını verebilir. Her iki sınırı da dar tutun:
  • Çekirdek yeniden deneme/geri dönüş ilkesini sahiplenir.
  • Sağlayıcı Plugin’leri sağlayıcıya özgü istek/kimlik doğrulama/yönlendirme ipuçlarını sahiplenir.
  • Harness Plugin’leri çalışma zamanına özgü deneme sınıflandırmasını sahiplenir.
  • Üçüncü taraf Plugin’ler çekirdek durumunda doğrudan değişiklikler değil, ipuçları döndürür.

​
Dosya kontrol listesi

Yeni bir yetenek için şu alanlara dokunmayı bekleyin:
  • src/<capability>/types.ts
  • src/<capability>/...registry/runtime.ts
  • src/plugins/types.ts
  • src/plugins/registry.ts
  • src/plugins/captured-registration.ts
  • src/plugins/contracts/registry.ts
  • src/plugins/runtime/types-core.ts
  • src/plugins/runtime/index.ts
  • src/plugin-sdk/<capability>.ts
  • src/plugin-sdk/<capability>-runtime.ts
  • Bir veya daha fazla paketlenmiş Plugin paketi.
  • Yapılandırma, belgeler, testler.

​
Çalışılmış örnek: görüntü üretimi

Görüntü üretimi standart şekli izler:
  1. Çekirdek ImageGenerationProvider tanımlar.
  2. Çekirdek registerImageGenerationProvider(...) sunar.
  3. Çekirdek runtime.imageGeneration.generate(...) sunar.
  4. openai, google, fal ve minimax Plugin’leri tedarikçi destekli uygulamalar kaydeder.
  5. Gelecekteki tedarikçiler kanalları/araçları değiştirmeden aynı sözleşmeyi kaydeder.
Yapılandırma anahtarı, görsel analiz yönlendirmesinden bilinçli olarak ayrıdır:
  • agents.defaults.imageModel görüntüleri analiz eder.
  • agents.defaults.imageGenerationModel görüntüler üretir.
Bunları ayrı tutun ki geri dönüş ve ilke açık kalsın.

​
İnceleme kontrol listesi

Yeni bir yeteneği yayımlamadan önce şunları doğrulayın:
  • Hiçbir kanal/araç tedarikçi kodunu doğrudan içe aktarmıyor.
  • Çalışma zamanı yardımcısı paylaşılan yoldur.
  • En az bir sözleşme testi paketlenmiş sahipliği doğrular.
  • Yapılandırma belgeleri yeni model/yapılandırma anahtarını adlandırır.
  • Plugin belgeleri sahiplik sınırını açıklar.
Bir PR yetenek katmanını atlayıp tedarikçi davranışını bir kanala/araca sabit kodlarsa, geri gönderin ve önce sözleşmeyi tanımlayın.

​
İlgili