chore(i18n): refresh tr translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
9c41bed757
commit
4ae90d76fc
File diff suppressed because it is too large
Load Diff
@ -2,23 +2,23 @@
|
||||
read_when:
|
||||
- Bellek yükseltmenin otomatik olarak çalışmasını istiyorsunuz
|
||||
- Her rüya görme aşamasının ne yaptığını anlamak istiyorsunuz
|
||||
- Pekiştirmeyi `MEMORY.md` dosyasını kirletmeden ayarlamak istiyorsunuz
|
||||
summary: Hafif, derin ve REM aşamaları ile bir Rüya Günlüğünü içeren arka plan bellek pekiştirmesi
|
||||
- Birleştirmeyi `MEMORY.md` dosyasını kirletmeden ayarlamak istiyorsunuz
|
||||
summary: Hafif, derin ve REM aşamalarıyla arka plan bellek birleştirmesi ve bir Rüya Günlüğü
|
||||
title: Rüya Görme (deneysel)
|
||||
x-i18n:
|
||||
generated_at: "2026-04-06T08:49:09Z"
|
||||
generated_at: "2026-04-08T08:43:28Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 36c4b1e70801d662090dc8ce20608c2f141c23cd7ce53c54e3dcf332c801fd4e
|
||||
source_hash: 0254f3b0949158264e583c12f36f2b1a83d1b44dc4da01a1b272422d38e8655d
|
||||
source_path: concepts/dreaming.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Rüya Görme (deneysel)
|
||||
|
||||
Rüya görme, `memory-core` içindeki arka plan bellek pekiştirme sistemidir.
|
||||
Rüya görme, `memory-core` içindeki arka plan bellek birleştirme sistemidir.
|
||||
OpenClaw'ın güçlü kısa süreli sinyalleri kalıcı belleğe taşımasına yardımcı olurken
|
||||
sürecin açıklanabilir ve incelenebilir kalmasını sağlar.
|
||||
süreci açıklanabilir ve gözden geçirilebilir tutar.
|
||||
|
||||
Rüya görme **isteğe bağlıdır** ve varsayılan olarak devre dışıdır.
|
||||
|
||||
@ -26,81 +26,87 @@ Rüya görme **isteğe bağlıdır** ve varsayılan olarak devre dışıdır.
|
||||
|
||||
Rüya görme iki tür çıktı tutar:
|
||||
|
||||
- `memory/.dreams/` içinde **makine durumu** (hatırlama deposu, aşama sinyalleri, içe aktarma denetim noktaları, kilitler).
|
||||
- `DREAMS.md` içinde (veya mevcut `dreams.md` içinde) **insan tarafından okunabilir çıktı** ve `memory/dreaming/<phase>/YYYY-MM-DD.md` altındaki isteğe bağlı aşama raporu dosyaları.
|
||||
- `memory/.dreams/` içinde **Makine durumu** (anımsama deposu, aşama sinyalleri, içe alma denetim noktaları, kilitler).
|
||||
- `DREAMS.md` içinde (veya mevcut `dreams.md`) **İnsan tarafından okunabilir çıktı** ve `memory/dreaming/<phase>/YYYY-MM-DD.md` altında isteğe bağlı aşama raporu dosyaları.
|
||||
|
||||
Uzun vadeli yükseltme yine yalnızca `MEMORY.md` dosyasına yazar.
|
||||
|
||||
## Aşama modeli
|
||||
|
||||
Rüya görme üç işbirlikçi aşama kullanır:
|
||||
Rüya görme üç iş birliği yapan aşama kullanır:
|
||||
|
||||
| Aşama | Amaç | Kalıcı yazma |
|
||||
| ----- | ----------------------------------------- | ----------------- |
|
||||
| Hafif | Son kısa süreli materyali sıralamak ve hazırlamak | Hayır |
|
||||
| Aşama | Amaç | Kalıcı yazım |
|
||||
| ----- | ----------------------------------------- | ------------------ |
|
||||
| Hafif | Son kısa süreli materyali sıralamak ve hazırlamak | Hayır |
|
||||
| Derin | Kalıcı adayları puanlamak ve yükseltmek | Evet (`MEMORY.md`) |
|
||||
| REM | Temalar ve tekrarlayan fikirler üzerine düşünmek | Hayır |
|
||||
| REM | Temalar ve tekrar eden fikirler üzerine düşünmek | Hayır |
|
||||
|
||||
Bu aşamalar, ayrı kullanıcı tarafından yapılandırılan
|
||||
"modlar" değil, dahili uygulama ayrıntılarıdır.
|
||||
Bu aşamalar ayrı kullanıcı tarafından yapılandırılan
|
||||
"modlar" değil, iç uygulama ayrıntılarıdır.
|
||||
|
||||
### Hafif aşama
|
||||
|
||||
Hafif aşama, son günlük bellek sinyallerini ve hatırlama izlerini içe alır, bunları yinelenenlerden arındırır
|
||||
ve aday satırları hazırlar.
|
||||
Hafif aşama son günlük bellek sinyallerini ve anımsama izlerini içe alır, bunların
|
||||
yinelenenlerini kaldırır ve aday satırları hazırlar.
|
||||
|
||||
- Kısa süreli hatırlama durumundan ve son günlük bellek dosyalarından okur.
|
||||
- Kısa süreli anımsama durumundan, son günlük bellek dosyalarından ve mevcut olduğunda sansürlenmiş oturum dökümlerinden okur.
|
||||
- Depolama satır içi çıktı içerdiğinde yönetilen bir `## Light Sleep` bloğu yazar.
|
||||
- Daha sonraki derin sıralama için pekiştirme sinyallerini kaydeder.
|
||||
- Daha sonra derin sıralama için pekiştirme sinyalleri kaydeder.
|
||||
- Asla `MEMORY.md` dosyasına yazmaz.
|
||||
|
||||
### Derin aşama
|
||||
|
||||
Derin aşama, neyin uzun vadeli belleğe dönüşeceğine karar verir.
|
||||
Derin aşama neyin uzun vadeli bellek olacağına karar verir.
|
||||
|
||||
- Adayları ağırlıklı puanlama ve eşik kapıları kullanarak sıralar.
|
||||
- Adayları ağırlıklı puanlama ve eşik geçitleri kullanarak sıralar.
|
||||
- Geçmek için `minScore`, `minRecallCount` ve `minUniqueQueries` gerektirir.
|
||||
- Yazmadan önce parçacıkları canlı günlük dosyalardan yeniden yükler; bu nedenle eski/silinmiş parçacıklar atlanır.
|
||||
- Yazmadan önce parçaları canlı günlük dosyalardan yeniden alır; böylece eski/silinmiş parçalar atlanır.
|
||||
- Yükseltilen girdileri `MEMORY.md` dosyasına ekler.
|
||||
- `DREAMS.md` içine bir `## Deep Sleep` özeti yazar ve isteğe bağlı olarak `memory/dreaming/deep/YYYY-MM-DD.md` dosyasını yazar.
|
||||
- `DREAMS.md` içine bir `## Deep Sleep` özeti yazar ve isteğe bağlı olarak `memory/dreaming/deep/YYYY-MM-DD.md` dosyasına yazar.
|
||||
|
||||
### REM aşaması
|
||||
|
||||
REM aşaması kalıpları ve yansıtıcı sinyalleri çıkarır.
|
||||
REM aşaması örüntüleri ve yansıtıcı sinyalleri çıkarır.
|
||||
|
||||
- Son kısa süreli izlerden tema ve düşünsel özetler oluşturur.
|
||||
- Son kısa süreli izlerden tema ve düşünüm özetleri oluşturur.
|
||||
- Depolama satır içi çıktı içerdiğinde yönetilen bir `## REM Sleep` bloğu yazar.
|
||||
- Derin sıralamada kullanılan REM pekiştirme sinyallerini kaydeder.
|
||||
- Asla `MEMORY.md` dosyasına yazmaz.
|
||||
|
||||
## Oturum dökümü içe alma
|
||||
|
||||
Rüya görme, sansürlenmiş oturum dökümlerini rüya görme bütüncesine içe alabilir. Dökümler
|
||||
mevcut olduğunda, bunlar günlük bellek sinyalleri ve anımsama izleriyle birlikte hafif
|
||||
aşamaya beslenir. Kişisel ve hassas içerik içe almadan önce sansürlenir.
|
||||
|
||||
## Rüya Günlüğü
|
||||
|
||||
Rüya görme ayrıca `DREAMS.md` içinde anlatı biçiminde bir **Rüya Günlüğü** tutar.
|
||||
Her aşama yeterli materyale sahip olduktan sonra `memory-core`, en iyi çaba ilkesine dayalı bir arka plan
|
||||
alt aracı turu çalıştırır (varsayılan çalışma zamanı modeli kullanılarak) ve kısa bir günlük girdisi ekler.
|
||||
Rüya görme ayrıca `DREAMS.md` içinde anlatı tarzında bir **Rüya Günlüğü** tutar.
|
||||
Her aşama yeterli materyale sahip olduktan sonra, `memory-core` en iyi çaba ile bir arka plan
|
||||
alt ajan dönüşü çalıştırır (varsayılan çalışma zamanı modeli kullanılarak) ve kısa bir günlük girdisi ekler.
|
||||
|
||||
Bu günlük, yükseltme kaynağı değil, Dreams kullanıcı arayüzünde insan tarafından okunmak içindir.
|
||||
Bu günlük, yükseltme kaynağı değil, Dreams kullanıcı arayüzünde insanlar tarafından okunmak içindir.
|
||||
|
||||
## Derin sıralama sinyalleri
|
||||
|
||||
Derin sıralama, aşama pekiştirmesine ek olarak altı ağırlıklı temel sinyal kullanır:
|
||||
Derin sıralama altı ağırlıklı temel sinyal ve aşama pekiştirmesi kullanır:
|
||||
|
||||
| Sinyal | Ağırlık | Açıklama |
|
||||
| ------------------- | ------ | ------------------------------------------------ |
|
||||
| Sıklık | 0.24 | Girdinin biriktirdiği kısa süreli sinyal sayısı |
|
||||
| İlgililik | 0.30 | Girdi için ortalama alma kalitesi |
|
||||
| Sıklık | 0.24 | Girdinin kaç kısa süreli sinyal biriktirdiği |
|
||||
| İlgililik | 0.30 | Girdi için ortalama geri getirme kalitesi |
|
||||
| Sorgu çeşitliliği | 0.15 | Onu ortaya çıkaran farklı sorgu/gün bağlamları |
|
||||
| Yakınlık | 0.15 | Zamana göre azalan tazelik puanı |
|
||||
| Pekiştirme | 0.10 | Çok günlük tekrar gücü |
|
||||
| Kavramsal zenginlik | 0.06 | Parçacık/yoldan kavram etiketi yoğunluğu |
|
||||
| Güncellik | 0.15 | Zamana göre azalan tazelik puanı |
|
||||
| Birleştirme | 0.10 | Çok günlük tekrar gücü |
|
||||
| Kavramsal zenginlik | 0.06 | Parça/yoldan gelen kavram etiketi yoğunluğu |
|
||||
|
||||
Hafif ve REM aşaması isabetleri,
|
||||
`memory/.dreams/phase-signals.json` içinden yakınlığa göre azalan küçük bir artış ekler.
|
||||
`memory/.dreams/phase-signals.json` içinden güncelliğe göre azalan küçük bir artış ekler.
|
||||
|
||||
## Zamanlama
|
||||
|
||||
Etkinleştirildiğinde `memory-core`, tam bir rüya görme
|
||||
taraması için tek bir cron job'ı otomatik olarak yönetir. Her tarama aşamaları sırayla çalıştırır: hafif -> REM -> derin.
|
||||
Etkinleştirildiğinde, `memory-core` tam bir rüya görme
|
||||
taraması için bir cron işini otomatik olarak yönetir. Her tarama aşamaları sırayla çalıştırır: hafif -> REM -> derin.
|
||||
|
||||
Varsayılan sıklık davranışı:
|
||||
|
||||
@ -128,7 +134,7 @@ Rüya görmeyi etkinleştirin:
|
||||
}
|
||||
```
|
||||
|
||||
Özel bir tarama sıklığı ile rüya görmeyi etkinleştirin:
|
||||
Özel bir tarama sıklığıyla rüya görmeyi etkinleştirin:
|
||||
|
||||
```json
|
||||
{
|
||||
@ -148,7 +154,7 @@ Rüya görmeyi etkinleştirin:
|
||||
}
|
||||
```
|
||||
|
||||
## Slash komutu
|
||||
## Eğik çizgi komutu
|
||||
|
||||
```
|
||||
/dreaming status
|
||||
@ -159,7 +165,7 @@ Rüya görmeyi etkinleştirin:
|
||||
|
||||
## CLI iş akışı
|
||||
|
||||
Önizleme veya manuel uygulama için CLI yükseltmesini kullanın:
|
||||
Önizleme veya elle uygulama için CLI yükseltmesini kullanın:
|
||||
|
||||
```bash
|
||||
openclaw memory promote
|
||||
@ -168,18 +174,16 @@ openclaw memory promote --limit 5
|
||||
openclaw memory status --deep
|
||||
```
|
||||
|
||||
Manuel `memory promote`, CLI bayraklarıyla geçersiz kılınmadığı sürece varsayılan olarak
|
||||
derin aşama eşiklerini kullanır.
|
||||
Elle `memory promote`, CLI bayraklarıyla geçersiz kılınmadıkça varsayılan olarak derin aşama eşiklerini kullanır.
|
||||
|
||||
Belirli bir adayın neden yükseltileceğini veya yükseltilmeyeceğini açıklayın:
|
||||
Belirli bir adayın neden yükseleceğini veya yükselmeyeceğini açıklayın:
|
||||
|
||||
```bash
|
||||
openclaw memory promote-explain "router vlan"
|
||||
openclaw memory promote-explain "router vlan" --json
|
||||
```
|
||||
|
||||
REM yansımalarını, aday gerçekleri ve derin yükseltme çıktısını
|
||||
hiçbir şey yazmadan önizleyin:
|
||||
Hiçbir şey yazmadan REM düşüncelerini, aday doğruları ve derin yükseltme çıktısını önizleyin:
|
||||
|
||||
```bash
|
||||
openclaw memory rem-harness
|
||||
@ -195,20 +199,20 @@ Tüm ayarlar `plugins.entries.memory-core.config.dreaming` altında bulunur.
|
||||
| `enabled` | `false` |
|
||||
| `frequency` | `0 3 * * *` |
|
||||
|
||||
Aşama politikası, eşikler ve depolama davranışı dahili uygulama
|
||||
ayrıntılarıdır (kullanıcıya dönük yapılandırma değildir).
|
||||
Aşama ilkesi, eşikler ve depolama davranışı iç uygulama
|
||||
ayrıntılarıdır (kullanıcıya yönelik yapılandırma değildir).
|
||||
|
||||
Tam anahtar listesi için [Bellek yapılandırma başvurusu](/tr/reference/memory-config#dreaming-experimental) bölümüne bakın.
|
||||
Tam anahtar listesi için [Bellek yapılandırma başvurusu](/tr/reference/memory-config#dreaming-experimental) sayfasına bakın.
|
||||
|
||||
## Dreams kullanıcı arayüzü
|
||||
|
||||
Etkinleştirildiğinde Gateway **Dreams** sekmesi şunları gösterir:
|
||||
Etkinleştirildiğinde, Gateway içindeki **Dreams** sekmesi şunları gösterir:
|
||||
|
||||
- geçerli rüya görme etkin durumunu
|
||||
- aşama düzeyi durumu ve yönetilen tarama varlığını
|
||||
- kısa vadeli, uzun vadeli ve bugün yükseltilen sayıları
|
||||
- bir sonraki zamanlanmış çalıştırmanın zamanlamasını
|
||||
- `doctor.memory.dreamDiary` tarafından desteklenen genişletilebilir bir Rüya Günlüğü okuyucusunu
|
||||
- mevcut rüya görme etkin durumu
|
||||
- aşama düzeyinde durum ve yönetilen tarama varlığı
|
||||
- kısa süreli, uzun süreli ve bugün yükseltilen sayıları
|
||||
- bir sonraki zamanlanmış çalıştırmanın zamanı
|
||||
- `doctor.memory.dreamDiary` tarafından desteklenen genişletilebilir bir Rüya Günlüğü okuyucusu
|
||||
|
||||
## İlgili
|
||||
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -3,109 +3,105 @@ read_when:
|
||||
- OPENCLAW_PLUGIN_SDK_COMPAT_DEPRECATED uyarısını görüyorsunuz
|
||||
- OPENCLAW_EXTENSION_API_DEPRECATED uyarısını görüyorsunuz
|
||||
- Bir plugin'i modern plugin mimarisine güncelliyorsunuz
|
||||
- Harici bir OpenClaw plugin'inin bakımını yapıyorsunuz
|
||||
- Harici bir OpenClaw plugin'ini sürdürüyorsunuz
|
||||
sidebarTitle: Migrate to SDK
|
||||
summary: Eski geriye dönük uyumluluk katmanından modern plugin SDK'ye geçiş yapın
|
||||
summary: Eski geriye dönük uyumluluk katmanından modern plugin SDK'ya geçiş yapın
|
||||
title: Plugin SDK Geçişi
|
||||
x-i18n:
|
||||
generated_at: "2026-04-08T02:17:18Z"
|
||||
generated_at: "2026-04-08T08:45:14Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 155a8b14bc345319c8516ebdb8a0ccdea2c5f7fa07dad343442996daee21ecad
|
||||
source_hash: d9a2ce7f5553563516a549ca87e776a6a71e8dd8533a773c5ddbecfae43e7b77
|
||||
source_path: plugins/sdk-migration.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Plugin SDK Geçişi
|
||||
|
||||
OpenClaw, geniş bir geriye dönük uyumluluk katmanından, odaklı ve belgelenmiş
|
||||
import'lara sahip modern bir plugin mimarisine geçti. Plugin'iniz yeni
|
||||
OpenClaw, geniş bir geriye dönük uyumluluk katmanından, odaklanmış ve
|
||||
belgelendirilmiş içe aktarmalara sahip modern bir plugin mimarisine geçti. Plugin'iniz yeni
|
||||
mimariden önce oluşturulduysa, bu kılavuz geçiş yapmanıza yardımcı olur.
|
||||
|
||||
## Neler değişiyor
|
||||
|
||||
Eski plugin sistemi, plugin'lerin tek bir giriş noktasından ihtiyaç duydukları
|
||||
her şeyi içe aktarmasına izin veren iki geniş açık yüzey sağlıyordu:
|
||||
her şeyi içe aktarmasına izin veren iki geniş yüzey sağlıyordu:
|
||||
|
||||
- **`openclaw/plugin-sdk/compat`** — onlarca yardımcıyı yeniden dışa aktaran
|
||||
tek bir import. Yeni plugin mimarisi oluşturulurken eski hook tabanlı
|
||||
plugin'lerin çalışmaya devam etmesi için sunuldu.
|
||||
- **`openclaw/extension-api`** — plugin'lere gömülü agent runner gibi
|
||||
ana makine tarafı yardımcılarına doğrudan erişim veren bir köprü.
|
||||
- **`openclaw/plugin-sdk/compat`** — düzinelerce yardımcıyı yeniden dışa aktaran
|
||||
tek bir içe aktarma. Yeni plugin mimarisi oluşturulurken eski hook tabanlı
|
||||
plugin'lerin çalışmasını sürdürmek için tanıtıldı.
|
||||
- **`openclaw/extension-api`** — plugin'lere gömülü ajan çalıştırıcısı gibi
|
||||
host tarafı yardımcılarına doğrudan erişim veren bir köprü.
|
||||
|
||||
Bu iki yüzey artık **kullanımdan kaldırılmıştır**. Çalışma zamanında hâlâ
|
||||
çalışırlar, ancak yeni plugin'ler bunları kullanmamalıdır ve mevcut plugin'ler
|
||||
çalışırlar, ancak yeni plugin'ler bunları kullanmamalı ve mevcut plugin'ler
|
||||
bir sonraki büyük sürüm bunları kaldırmadan önce geçiş yapmalıdır.
|
||||
|
||||
<Warning>
|
||||
Geriye dönük uyumluluk katmanı gelecekteki bir büyük sürümde kaldırılacaktır.
|
||||
Bu yüzeylerden hâlâ import yapan plugin'ler bu olduğunda bozulacaktır.
|
||||
Bu yüzeylerden hâlâ içe aktarma yapan plugin'ler bu gerçekleştiğinde bozulacaktır.
|
||||
</Warning>
|
||||
|
||||
## Bunun nedeni nedir
|
||||
## Bu neden değişti
|
||||
|
||||
Eski yaklaşım bazı sorunlara neden oluyordu:
|
||||
Eski yaklaşım sorunlara neden oluyordu:
|
||||
|
||||
- **Yavaş başlangıç** — tek bir yardımcıyı içe aktarmak onlarca ilgisiz modülü yüklüyordu
|
||||
- **Döngüsel bağımlılıklar** — geniş yeniden dışa aktarmalar import döngüleri oluşturmayı kolaylaştırıyordu
|
||||
- **Belirsiz API yüzeyi** — hangi dışa aktarımların kararlı, hangilerinin dahili olduğunu ayırt etmenin yolu yoktu
|
||||
- **Yavaş başlangıç** — tek bir yardımcıyı içe aktarmak düzinelerce alakasız modülü yüklüyordu
|
||||
- **Döngüsel bağımlılıklar** — geniş yeniden dışa aktarmalar içe aktarma döngüleri oluşturmayı kolaylaştırıyordu
|
||||
- **Belirsiz API yüzeyi** — hangi dışa aktarmaların kararlı, hangilerinin iç kullanım için olduğunu ayırt etmenin bir yolu yoktu
|
||||
|
||||
Modern plugin SDK bunu düzeltir: her import yolu (`openclaw/plugin-sdk/\<subpath\>`)
|
||||
net bir amaca ve belgelenmiş bir sözleşmeye sahip, küçük ve kendi içinde yeterli
|
||||
bir modüldür.
|
||||
Modern plugin SDK bunu düzeltir: her içe aktarma yolu (`openclaw/plugin-sdk/\<subpath\>`)
|
||||
küçük, kendi içinde yeterli, açık amaçlı ve belgelenmiş sözleşmeye sahip bir modüldür.
|
||||
|
||||
Paketlenmiş kanallar için eski sağlayıcı kolaylık yüzeyleri de kaldırıldı.
|
||||
`openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
|
||||
`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`,
|
||||
kanal markalı yardımcı yüzeyler ve
|
||||
`openclaw/plugin-sdk/telegram-core` gibi import'lar özel mono-repo kısayollarıydı,
|
||||
kararlı plugin sözleşmeleri değildi. Bunun yerine dar ve genel SDK alt yollarını kullanın. Paketlenmiş
|
||||
plugin çalışma alanı içinde, sağlayıcıya ait yardımcıları ilgili plugin'in kendi
|
||||
Paketlenmiş kanallar için eski sağlayıcı kolaylık seam'leri de kaldırıldı. `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`, `openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`,
|
||||
kanal markalı yardımcı seam'leri ve
|
||||
`openclaw/plugin-sdk/telegram-core` gibi içe aktarmalar, kararlı plugin sözleşmeleri değil,
|
||||
özel mono-repo kısayollarıydı. Bunun yerine dar kapsamlı genel SDK alt yollarını kullanın. Paketlenmiş
|
||||
plugin çalışma alanı içinde, sağlayıcıya ait yardımcıları o plugin'in kendi
|
||||
`api.ts` veya `runtime-api.ts` dosyasında tutun.
|
||||
|
||||
Geçerli paketlenmiş sağlayıcı örnekleri:
|
||||
Güncel paketlenmiş sağlayıcı örnekleri:
|
||||
|
||||
- Anthropic, Claude'a özgü akış yardımcılarını kendi `api.ts` /
|
||||
`contract-api.ts` yüzeyinde tutar
|
||||
- OpenAI, sağlayıcı oluşturucularını, varsayılan model yardımcılarını ve realtime sağlayıcı
|
||||
`contract-api.ts` seam'inde tutar
|
||||
- OpenAI, sağlayıcı oluşturucuları, varsayılan model yardımcılarını ve gerçek zamanlı sağlayıcı
|
||||
oluşturucularını kendi `api.ts` dosyasında tutar
|
||||
- OpenRouter, sağlayıcı oluşturucu ile onboarding/yapılandırma yardımcılarını kendi
|
||||
- OpenRouter, sağlayıcı oluşturucu ile ilk kurulum/yapılandırma yardımcılarını kendi
|
||||
`api.ts` dosyasında tutar
|
||||
|
||||
## Nasıl geçiş yapılır
|
||||
|
||||
<Steps>
|
||||
<Step title="Yerel onay işleyicilerini capability facts'e taşıyın">
|
||||
Onay yetenekli kanal plugin'leri artık yerel onay davranışını
|
||||
`approvalCapability.nativeRuntime` ve paylaşılan runtime-context kayıt defteri aracılığıyla açığa çıkarır.
|
||||
<Step title="Onay yerel işleyicilerini yetenek olgularına taşıyın">
|
||||
Onay yeteneğine sahip kanal plugin'leri artık yerel onay davranışını
|
||||
`approvalCapability.nativeRuntime` ve paylaşılan çalışma zamanı bağlamı kaydı aracılığıyla sunuyor.
|
||||
|
||||
Temel değişiklikler:
|
||||
|
||||
- `approvalCapability.handler.loadRuntime(...)` yerine
|
||||
`approvalCapability.nativeRuntime` kullanın
|
||||
- Onaya özgü auth/delivery mantığını eski `plugin.auth` /
|
||||
`plugin.approvals` bağlantısından çıkarıp `approvalCapability` üzerine taşıyın
|
||||
- `ChannelPlugin.approvals`, genel channel-plugin
|
||||
- Onaya özgü kimlik doğrulama/teslim mantığını eski `plugin.auth` /
|
||||
`plugin.approvals` kablolamasından çıkarıp `approvalCapability` üzerine taşıyın
|
||||
- `ChannelPlugin.approvals` genel kanal-plugin
|
||||
sözleşmesinden kaldırıldı; delivery/native/render alanlarını `approvalCapability` üzerine taşıyın
|
||||
- `plugin.auth`, yalnızca kanal login/logout akışları için kalır; oradaki
|
||||
onay auth hook'ları artık core tarafından okunmaz
|
||||
- İstemciler, token'lar veya Bolt
|
||||
uygulamaları gibi kanala ait runtime nesnelerini `openclaw/plugin-sdk/channel-runtime-context`
|
||||
aracılığıyla kaydedin
|
||||
- Yerel onay işleyicilerinden plugin'e ait reroute bildirimleri göndermeyin;
|
||||
yönlendirilmiş-başka-yerde bildirimleri artık core gerçek delivery sonuçlarından sahiplenir
|
||||
- `channelRuntime` değerini `createChannelManager(...)` içine geçirirken,
|
||||
gerçek bir `createPluginRuntime().channel` yüzeyi sağlayın. Kısmi stub'lar reddedilir.
|
||||
- `plugin.auth` yalnızca kanal giriş/çıkış akışları için kalır; oradaki onay kimlik doğrulama
|
||||
hook'ları artık çekirdek tarafından okunmaz
|
||||
- İstemciler, belirteçler veya Bolt
|
||||
uygulamaları gibi kanala ait çalışma zamanı nesnelerini `openclaw/plugin-sdk/channel-runtime-context` aracılığıyla kaydedin
|
||||
- Yerel onay işleyicilerinden plugin'e ait yeniden yönlendirme bildirimleri göndermeyin;
|
||||
çekirdek artık gerçek teslim sonuçlarından gelen başka yere yönlendirilmiş bildirimlerin sahibidir
|
||||
- `createChannelManager(...)` içine `channelRuntime` geçirirken gerçek bir
|
||||
`createPluginRuntime().channel` yüzeyi sağlayın. Kısmi taslaklar reddedilir.
|
||||
|
||||
Geçerli approval capability
|
||||
düzeni için `/plugins/sdk-channel-plugins` sayfasına bakın.
|
||||
Geçerli onay yeteneği
|
||||
düzeni için `/plugins/sdk-channel-plugins` bölümüne bakın.
|
||||
|
||||
</Step>
|
||||
|
||||
<Step title="Windows wrapper geri dönüş davranışını denetleyin">
|
||||
Plugin'iniz `openclaw/plugin-sdk/windows-spawn` kullanıyorsa,
|
||||
çözümlenmemiş Windows `.cmd`/`.bat` wrapper'ları artık siz açıkça
|
||||
`allowShellFallback: true` vermediğiniz sürece kapalı hata verir.
|
||||
<Step title="Windows sarmalayıcı geri dönüş davranışını denetleyin">
|
||||
Plugin'iniz `openclaw/plugin-sdk/windows-spawn` kullanıyorsa, çözümlenemeyen Windows
|
||||
`.cmd`/`.bat` sarmalayıcıları artık siz açıkça
|
||||
`allowShellFallback: true` geçmediğiniz sürece kapalı şekilde başarısız olur.
|
||||
|
||||
```typescript
|
||||
// Önce
|
||||
@ -114,19 +110,19 @@ Geçerli paketlenmiş sağlayıcı örnekleri:
|
||||
// Sonra
|
||||
const program = applyWindowsSpawnProgramPolicy({
|
||||
candidate,
|
||||
// Bunu yalnızca bilerek shell aracılı geri dönüşü kabul eden
|
||||
// Bunu yalnızca kasıtlı olarak kabuk aracılı geri dönüşü kabul eden
|
||||
// güvenilir uyumluluk çağıranları için ayarlayın.
|
||||
allowShellFallback: true,
|
||||
});
|
||||
```
|
||||
|
||||
Çağıranınız bilerek shell fallback'e güvenmiyorsa `allowShellFallback`
|
||||
ayarlamayın ve bunun yerine fırlatılan hatayı işleyin.
|
||||
Çağıranınız kasıtlı olarak kabuk geri dönüşüne dayanmıyorsa,
|
||||
`allowShellFallback` ayarlamayın ve bunun yerine fırlatılan hatayı işleyin.
|
||||
|
||||
</Step>
|
||||
|
||||
<Step title="Kullanımdan kaldırılmış import'ları bulun">
|
||||
Plugin'inizde bu kullanımdan kaldırılmış yüzeylerden yapılan import'ları arayın:
|
||||
<Step title="Kullanımdan kaldırılmış içe aktarmaları bulun">
|
||||
Plugin'inizde, kullanımdan kaldırılmış bu yüzeylerden herhangi birinden yapılan içe aktarmaları arayın:
|
||||
|
||||
```bash
|
||||
grep -r "plugin-sdk/compat" my-plugin/
|
||||
@ -135,8 +131,8 @@ Geçerli paketlenmiş sağlayıcı örnekleri:
|
||||
|
||||
</Step>
|
||||
|
||||
<Step title="Bunları odaklı import'larla değiştirin">
|
||||
Eski yüzeydeki her dışa aktarma belirli bir modern import yoluna eşlenir:
|
||||
<Step title="Bunları odaklanmış içe aktarmalarla değiştirin">
|
||||
Eski yüzeydeki her dışa aktarma, belirli bir modern içe aktarma yoluna eşlenir:
|
||||
|
||||
```typescript
|
||||
// Önce (kullanımdan kaldırılmış geriye dönük uyumluluk katmanı)
|
||||
@ -146,27 +142,27 @@ Geçerli paketlenmiş sağlayıcı örnekleri:
|
||||
resolveControlCommandGate,
|
||||
} from "openclaw/plugin-sdk/compat";
|
||||
|
||||
// Sonra (modern odaklı import'lar)
|
||||
// Sonra (modern odaklanmış içe aktarmalar)
|
||||
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";
|
||||
```
|
||||
|
||||
Ana makine tarafı yardımcıları için doğrudan import etmek yerine enjekte edilen
|
||||
plugin runtime'ını kullanın:
|
||||
Host tarafı yardımcılar için doğrudan içe aktarmak yerine eklenen
|
||||
plugin çalışma zamanını kullanın:
|
||||
|
||||
```typescript
|
||||
// Önce (kullanımdan kaldırılmış extension-api köprüsü)
|
||||
import { runEmbeddedPiAgent } from "openclaw/extension-api";
|
||||
const result = await runEmbeddedPiAgent({ sessionId, prompt });
|
||||
|
||||
// Sonra (enjekte edilmiş runtime)
|
||||
// Sonra (eklenen çalışma zamanı)
|
||||
const result = await api.runtime.agent.runEmbeddedPiAgent({ sessionId, prompt });
|
||||
```
|
||||
|
||||
Aynı desen diğer eski köprü yardımcıları için de geçerlidir:
|
||||
|
||||
| Eski import | Modern karşılığı |
|
||||
| Eski içe aktarma | Modern karşılığı |
|
||||
| --- | --- |
|
||||
| `resolveAgentDir` | `api.runtime.agent.resolveAgentDir` |
|
||||
| `resolveAgentWorkspaceDir` | `api.runtime.agent.resolveAgentWorkspaceDir` |
|
||||
@ -186,206 +182,206 @@ Geçerli paketlenmiş sağlayıcı örnekleri:
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
## Import yolu başvurusu
|
||||
## İçe aktarma yolu başvurusu
|
||||
|
||||
<Accordion title="Yaygın import yolu tablosu">
|
||||
| Import path | Amaç | Temel dışa aktarımlar |
|
||||
<Accordion title="Yaygın içe aktarma yolu tablosu">
|
||||
| İçe aktarma yolu | Amaç | Temel dışa aktarmalar |
|
||||
| --- | --- | --- |
|
||||
| `plugin-sdk/plugin-entry` | Kanonik plugin giriş yardımcısı | `definePluginEntry` |
|
||||
| `plugin-sdk/core` | Kanal giriş tanımları/oluşturucuları için eski şemsiye yeniden dışa aktarma | `defineChannelPluginEntry`, `createChatChannelPlugin` |
|
||||
| `plugin-sdk/config-schema` | Kök yapılandırma şeması dışa aktarımı | `OpenClawSchema` |
|
||||
| `plugin-sdk/config-schema` | Kök yapılandırma şeması dışa aktarması | `OpenClawSchema` |
|
||||
| `plugin-sdk/provider-entry` | Tek sağlayıcılı giriş yardımcısı | `defineSingleProviderPluginEntry` |
|
||||
| `plugin-sdk/channel-core` | Odaklı kanal giriş tanımları ve oluşturucuları | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
|
||||
| `plugin-sdk/channel-core` | Odaklanmış kanal giriş tanımları ve oluşturucular | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
|
||||
| `plugin-sdk/setup` | Paylaşılan kurulum sihirbazı yardımcıları | Allowlist istemleri, kurulum durumu oluşturucuları |
|
||||
| `plugin-sdk/setup-runtime` | Kurulum zamanı runtime yardımcıları | Import-safe kurulum yama bağdaştırıcıları, lookup-note yardımcıları, `promptResolvedAllowFrom`, `splitSetupEntries`, devredilmiş kurulum proxy'leri |
|
||||
| `plugin-sdk/setup-adapter-runtime` | Kurulum bağdaştırıcı yardımcıları | `createEnvPatchedAccountSetupAdapter` |
|
||||
| `plugin-sdk/setup-runtime` | Kurulum zamanı çalışma zamanı yardımcıları | İçe aktarması güvenli kurulum yama bağdaştırıcıları, lookup-note yardımcıları, `promptResolvedAllowFrom`, `splitSetupEntries`, devredilmiş kurulum vekilleri |
|
||||
| `plugin-sdk/setup-adapter-runtime` | Kurulum bağdaştırıcısı yardımcıları | `createEnvPatchedAccountSetupAdapter` |
|
||||
| `plugin-sdk/setup-tools` | Kurulum araç yardımcıları | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
|
||||
| `plugin-sdk/account-core` | Çoklu hesap yardımcıları | Hesap listesi/yapılandırma/eylem kapısı yardımcıları |
|
||||
| `plugin-sdk/account-id` | Hesap kimliği yardımcıları | `DEFAULT_ACCOUNT_ID`, hesap kimliği normalleştirme |
|
||||
| `plugin-sdk/account-core` | Çoklu hesap yardımcıları | Hesap listeleme/yapılandırma/eylem kapısı yardımcıları |
|
||||
| `plugin-sdk/account-id` | Hesap kimliği yardımcıları | `DEFAULT_ACCOUNT_ID`, hesap kimliği normalizasyonu |
|
||||
| `plugin-sdk/account-resolution` | Hesap arama yardımcıları | Hesap arama + varsayılan geri dönüş yardımcıları |
|
||||
| `plugin-sdk/account-helpers` | Dar hesap yardımcıları | Hesap listesi/hesap eylemi yardımcıları |
|
||||
| `plugin-sdk/account-helpers` | Dar kapsamlı hesap yardımcıları | Hesap listesi/hesap eylemi yardımcıları |
|
||||
| `plugin-sdk/channel-setup` | Kurulum sihirbazı bağdaştırıcıları | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, ayrıca `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
|
||||
| `plugin-sdk/channel-pairing` | DM eşleştirme ilkel öğeleri | `createChannelPairingController` |
|
||||
| `plugin-sdk/channel-reply-pipeline` | Yanıt öneki + yazıyor bağlantısı | `createChannelReplyPipeline` |
|
||||
| `plugin-sdk/channel-config-helpers` | Yapılandırma bağdaştırıcı fabrikaları | `createHybridChannelConfigAdapter` |
|
||||
| `plugin-sdk/channel-pairing` | DM eşleme ilkelleri | `createChannelPairingController` |
|
||||
| `plugin-sdk/channel-reply-pipeline` | Yanıt öneki + yazıyor göstergesi kablolaması | `createChannelReplyPipeline` |
|
||||
| `plugin-sdk/channel-config-helpers` | Yapılandırma bağdaştırıcısı fabrikaları | `createHybridChannelConfigAdapter` |
|
||||
| `plugin-sdk/channel-config-schema` | Yapılandırma şeması oluşturucuları | Kanal yapılandırma şeması türleri |
|
||||
| `plugin-sdk/telegram-command-config` | Telegram komut yapılandırma yardımcıları | Komut adı normalleştirme, açıklama kırpma, yinelenen/çakışma doğrulaması |
|
||||
| `plugin-sdk/channel-policy` | Grup/DM ilke çözümleme | `resolveChannelGroupRequireMention` |
|
||||
| `plugin-sdk/telegram-command-config` | Telegram komut yapılandırma yardımcıları | Komut adı normalizasyonu, açıklama kırpma, yinelenen/çakışma doğrulaması |
|
||||
| `plugin-sdk/channel-policy` | Grup/DM ilkesi çözümlemesi | `resolveChannelGroupRequireMention` |
|
||||
| `plugin-sdk/channel-lifecycle` | Hesap durumu izleme | `createAccountStatusSink` |
|
||||
| `plugin-sdk/inbound-envelope` | Gelen zarf yardımcıları | Paylaşılan route + zarf oluşturucu yardımcıları |
|
||||
| `plugin-sdk/inbound-reply-dispatch` | Gelen yanıt yardımcıları | Paylaşılan record-and-dispatch yardımcıları |
|
||||
| `plugin-sdk/inbound-envelope` | Gelen zarf yardımcıları | Paylaşılan rota + zarf oluşturucu yardımcıları |
|
||||
| `plugin-sdk/inbound-reply-dispatch` | Gelen yanıt yardımcıları | Paylaşılan kaydetme ve dağıtım yardımcıları |
|
||||
| `plugin-sdk/messaging-targets` | Mesajlaşma hedefi ayrıştırma | Hedef ayrıştırma/eşleştirme yardımcıları |
|
||||
| `plugin-sdk/outbound-media` | Giden medya yardımcıları | Paylaşılan giden medya yükleme |
|
||||
| `plugin-sdk/outbound-runtime` | Giden runtime yardımcıları | Giden kimlik/gönderme delege yardımcıları |
|
||||
| `plugin-sdk/thread-bindings-runtime` | Thread-binding yardımcıları | Thread-binding yaşam döngüsü ve bağdaştırıcı yardımcıları |
|
||||
| `plugin-sdk/agent-media-payload` | Eski medya payload yardımcıları | Eski alan düzenleri için agent medya payload oluşturucu |
|
||||
| `plugin-sdk/channel-runtime` | Kullanımdan kaldırılmış uyumluluk shim'i | Yalnızca eski kanal runtime yardımcıları |
|
||||
| `plugin-sdk/outbound-runtime` | Giden çalışma zamanı yardımcıları | Giden kimlik/gönderim delege yardımcıları |
|
||||
| `plugin-sdk/thread-bindings-runtime` | İş parçacığı bağlama yardımcıları | İş parçacığı bağlama yaşam döngüsü ve bağdaştırıcı yardımcıları |
|
||||
| `plugin-sdk/agent-media-payload` | Eski medya payload yardımcıları | Eski alan düzenleri için ajan medya payload oluşturucusu |
|
||||
| `plugin-sdk/channel-runtime` | Kullanımdan kaldırılmış uyumluluk shim'i | Yalnızca eski kanal çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/channel-send-result` | Gönderim sonucu türleri | Yanıt sonuç türleri |
|
||||
| `plugin-sdk/runtime-store` | Kalıcı plugin depolama | `createPluginRuntimeStore` |
|
||||
| `plugin-sdk/runtime` | Geniş runtime yardımcıları | Runtime/logging/backup/plugin-install yardımcıları |
|
||||
| `plugin-sdk/runtime-env` | Dar runtime env yardımcıları | Logger/runtime env, timeout, retry ve backoff yardımcıları |
|
||||
| `plugin-sdk/plugin-runtime` | Paylaşılan plugin runtime yardımcıları | Plugin komutları/hook'lar/http/interactive yardımcıları |
|
||||
| `plugin-sdk/hook-runtime` | Hook pipeline yardımcıları | Paylaşılan webhook/internal hook pipeline yardımcıları |
|
||||
| `plugin-sdk/lazy-runtime` | Lazy runtime yardımcıları | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` |
|
||||
| `plugin-sdk/runtime-store` | Kalıcı plugin depolaması | `createPluginRuntimeStore` |
|
||||
| `plugin-sdk/runtime` | Geniş çalışma zamanı yardımcıları | Çalışma zamanı/günlükleme/yedekleme/plugin yükleme yardımcıları |
|
||||
| `plugin-sdk/runtime-env` | Dar kapsamlı çalışma zamanı ortamı yardımcıları | Logger/çalışma zamanı ortamı, zaman aşımı, yeniden deneme ve backoff yardımcıları |
|
||||
| `plugin-sdk/plugin-runtime` | Paylaşılan plugin çalışma zamanı yardımcıları | Plugin komutları/hook'ları/http/etkileşimli yardımcıları |
|
||||
| `plugin-sdk/hook-runtime` | Hook ardışık düzen yardımcıları | Paylaşılan webhook/dahili hook ardışık düzen yardımcıları |
|
||||
| `plugin-sdk/lazy-runtime` | Tembel çalışma zamanı yardımcıları | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` |
|
||||
| `plugin-sdk/process-runtime` | Süreç yardımcıları | Paylaşılan exec yardımcıları |
|
||||
| `plugin-sdk/cli-runtime` | CLI runtime yardımcıları | Komut biçimlendirme, beklemeler, sürüm yardımcıları |
|
||||
| `plugin-sdk/gateway-runtime` | Gateway yardımcıları | Gateway istemcisi ve channel-status yama yardımcıları |
|
||||
| `plugin-sdk/cli-runtime` | CLI çalışma zamanı yardımcıları | Komut biçimlendirme, beklemeler, sürüm yardımcıları |
|
||||
| `plugin-sdk/gateway-runtime` | Gateway yardımcıları | Gateway istemcisi ve kanal durumu yama yardımcıları |
|
||||
| `plugin-sdk/config-runtime` | Yapılandırma yardımcıları | Yapılandırma yükleme/yazma yardımcıları |
|
||||
| `plugin-sdk/telegram-command-config` | Telegram komut yardımcıları | Paketlenmiş Telegram sözleşme yüzeyi kullanılamadığında geri dönüşte kararlı Telegram komut doğrulama yardımcıları |
|
||||
| `plugin-sdk/approval-runtime` | Onay istemi yardımcıları | Exec/plugin onay payload'ı, approval capability/profile yardımcıları, yerel onay yönlendirme/runtime yardımcıları |
|
||||
| `plugin-sdk/approval-auth-runtime` | Onay auth yardımcıları | Onaylayıcı çözümleme, aynı sohbette eylem auth |
|
||||
| `plugin-sdk/approval-client-runtime` | Onay istemci yardımcıları | Yerel exec onay profile/filter yardımcıları |
|
||||
| `plugin-sdk/approval-delivery-runtime` | Onay delivery yardımcıları | Yerel approval capability/delivery bağdaştırıcıları |
|
||||
| `plugin-sdk/approval-runtime` | Onay istemi yardımcıları | Exec/plugin onay payload'ı, onay yeteneği/profil yardımcıları, yerel onay yönlendirme/çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/approval-auth-runtime` | Onay kimlik doğrulama yardımcıları | Onaylayıcı çözümleme, aynı sohbet eylem kimlik doğrulaması |
|
||||
| `plugin-sdk/approval-client-runtime` | Onay istemci yardımcıları | Yerel exec onay profili/filtre yardımcıları |
|
||||
| `plugin-sdk/approval-delivery-runtime` | Onay teslim yardımcıları | Yerel onay yeteneği/teslim bağdaştırıcıları |
|
||||
| `plugin-sdk/approval-gateway-runtime` | Onay gateway yardımcıları | Paylaşılan onay gateway çözümleme yardımcısı |
|
||||
| `plugin-sdk/approval-handler-adapter-runtime` | Onay bağdaştırıcı yardımcıları | Sıcak kanal giriş noktaları için hafif yerel onay bağdaştırıcısı yükleme yardımcıları |
|
||||
| `plugin-sdk/approval-handler-runtime` | Onay işleyici yardımcıları | Daha geniş onay işleyici runtime yardımcıları; dar bağdaştırıcı/gateway yüzeyleri yeterliyse onları tercih edin |
|
||||
| `plugin-sdk/approval-native-runtime` | Onay hedef yardımcıları | Yerel onay hedefi/hesap bağlama yardımcıları |
|
||||
| `plugin-sdk/approval-reply-runtime` | Onay yanıt yardımcıları | Exec/plugin onay yanıt payload yardımcıları |
|
||||
| `plugin-sdk/channel-runtime-context` | Kanal runtime-context yardımcıları | Genel kanal runtime-context register/get/watch yardımcıları |
|
||||
| `plugin-sdk/security-runtime` | Güvenlik yardımcıları | Paylaşılan trust, DM gating, external-content ve secret-collection yardımcıları |
|
||||
| `plugin-sdk/ssrf-policy` | SSRF ilke yardımcıları | Ana makine izin listesi ve özel ağ ilke yardımcıları |
|
||||
| `plugin-sdk/ssrf-runtime` | SSRF runtime yardımcıları | Pinned-dispatcher, guarded fetch, SSRF ilke yardımcıları |
|
||||
| `plugin-sdk/collection-runtime` | Sınırlı önbellek yardımcıları | `pruneMapToMaxSize` |
|
||||
| `plugin-sdk/diagnostic-runtime` | Tanılama geçidi yardımcıları | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` |
|
||||
| `plugin-sdk/error-runtime` | Hata biçimlendirme yardımcıları | `formatUncaughtError`, `isApprovalNotFoundError`, hata grafı yardımcıları |
|
||||
| `plugin-sdk/fetch-runtime` | Sarmalanmış fetch/proxy yardımcıları | `resolveFetch`, proxy yardımcıları |
|
||||
| `plugin-sdk/host-runtime` | Ana makine normalleştirme yardımcıları | `normalizeHostname`, `normalizeScpRemoteHost` |
|
||||
| `plugin-sdk/retry-runtime` | Retry yardımcıları | `RetryConfig`, `retryAsync`, ilke çalıştırıcıları |
|
||||
| `plugin-sdk/approval-handler-adapter-runtime` | Onay bağdaştırıcısı yardımcıları | Sıcak kanal giriş noktaları için hafif yerel onay bağdaştırıcısı yükleme yardımcıları |
|
||||
| `plugin-sdk/approval-handler-runtime` | Onay işleyici yardımcıları | Daha geniş onay işleyici çalışma zamanı yardımcıları; yeterli olduklarında daha dar bağdaştırıcı/gateway seam'lerini tercih edin |
|
||||
| `plugin-sdk/approval-native-runtime` | Onay hedefi yardımcıları | Yerel onay hedefi/hesap bağlama yardımcıları |
|
||||
| `plugin-sdk/approval-reply-runtime` | Onay yanıtı yardımcıları | Exec/plugin onay yanıt payload yardımcıları |
|
||||
| `plugin-sdk/channel-runtime-context` | Kanal çalışma zamanı bağlamı yardımcıları | Genel kanal çalışma zamanı bağlamı kaydetme/alma/izleme yardımcıları |
|
||||
| `plugin-sdk/security-runtime` | Güvenlik yardımcıları | Paylaşılan güven, DM geçitleme, harici içerik ve gizli bilgi toplama yardımcıları |
|
||||
| `plugin-sdk/ssrf-policy` | SSRF ilke yardımcıları | Host allowlist ve özel ağ ilkesi yardımcıları |
|
||||
| `plugin-sdk/ssrf-runtime` | SSRF çalışma zamanı yardımcıları | Sabitlenmiş dispatcher, korumalı fetch, SSRF ilkesi yardımcıları |
|
||||
| `plugin-sdk/collection-runtime` | Sınırlandırılmış önbellek yardımcıları | `pruneMapToMaxSize` |
|
||||
| `plugin-sdk/diagnostic-runtime` | Tanılama geçitleme yardımcıları | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` |
|
||||
| `plugin-sdk/error-runtime` | Hata biçimlendirme yardımcıları | `formatUncaughtError`, `isApprovalNotFoundError`, hata grafiği yardımcıları |
|
||||
| `plugin-sdk/fetch-runtime` | Sarılmış fetch/proxy yardımcıları | `resolveFetch`, proxy yardımcıları |
|
||||
| `plugin-sdk/host-runtime` | Host normalizasyon yardımcıları | `normalizeHostname`, `normalizeScpRemoteHost` |
|
||||
| `plugin-sdk/retry-runtime` | Yeniden deneme yardımcıları | `RetryConfig`, `retryAsync`, ilke çalıştırıcıları |
|
||||
| `plugin-sdk/allow-from` | Allowlist biçimlendirme | `formatAllowFromLowercase` |
|
||||
| `plugin-sdk/allowlist-resolution` | Allowlist girdi eşleme | `mapAllowlistResolutionInputs` |
|
||||
| `plugin-sdk/command-auth` | Komut geçidi ve komut yüzeyi yardımcıları | `resolveControlCommandGate`, gönderen-yetkilendirme yardımcıları, komut kayıt defteri yardımcıları |
|
||||
| `plugin-sdk/secret-input` | Secret girdi ayrıştırma | Secret girdi yardımcıları |
|
||||
| `plugin-sdk/command-auth` | Komut geçitleme ve komut-yüzeyi yardımcıları | `resolveControlCommandGate`, gönderen yetkilendirme yardımcıları, komut kayıt yardımcıları |
|
||||
| `plugin-sdk/secret-input` | Gizli girdi ayrıştırma | Gizli girdi yardımcıları |
|
||||
| `plugin-sdk/webhook-ingress` | Webhook istek yardımcıları | Webhook hedef yardımcıları |
|
||||
| `plugin-sdk/webhook-request-guards` | Webhook gövde koruma yardımcıları | İstek gövdesi okuma/sınır yardımcıları |
|
||||
| `plugin-sdk/reply-runtime` | Paylaşılan yanıt runtime'ı | Gelen dispatch, heartbeat, yanıt planlayıcı, chunking |
|
||||
| `plugin-sdk/reply-dispatch-runtime` | Dar yanıt dispatch yardımcıları | Finalize + provider dispatch yardımcıları |
|
||||
| `plugin-sdk/reply-runtime` | Paylaşılan yanıt çalışma zamanı | Gelen dağıtım, heartbeat, yanıt planlayıcı, parçalama |
|
||||
| `plugin-sdk/reply-dispatch-runtime` | Dar kapsamlı yanıt dağıtım yardımcıları | Sonlandırma + sağlayıcı dağıtım yardımcıları |
|
||||
| `plugin-sdk/reply-history` | Yanıt geçmişi yardımcıları | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` |
|
||||
| `plugin-sdk/reply-reference` | Yanıt başvurusu planlama | `createReplyReferencePlanner` |
|
||||
| `plugin-sdk/reply-chunking` | Yanıt parça yardımcıları | Metin/markdown chunking yardımcıları |
|
||||
| `plugin-sdk/reply-reference` | Yanıt referansı planlama | `createReplyReferencePlanner` |
|
||||
| `plugin-sdk/reply-chunking` | Yanıt parça yardımcıları | Metin/markdown parçalama yardımcıları |
|
||||
| `plugin-sdk/session-store-runtime` | Oturum deposu yardımcıları | Depo yolu + updated-at yardımcıları |
|
||||
| `plugin-sdk/state-paths` | Durum yolu yardımcıları | Durum ve OAuth dizini yardımcıları |
|
||||
| `plugin-sdk/routing` | Routing/session-key yardımcıları | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, session-key normalleştirme yardımcıları |
|
||||
| `plugin-sdk/status-helpers` | Kanal durum yardımcıları | Kanal/hesap durum özeti oluşturucuları, runtime-state varsayılanları, issue meta veri yardımcıları |
|
||||
| `plugin-sdk/target-resolver-runtime` | Hedef çözücü yardımcıları | Paylaşılan hedef çözücü yardımcıları |
|
||||
| `plugin-sdk/string-normalization-runtime` | Dize normalleştirme yardımcıları | Slug/dize normalleştirme yardımcıları |
|
||||
| `plugin-sdk/request-url` | İstek URL yardımcıları | Request benzeri girdilerden dize URL'leri çıkarma |
|
||||
| `plugin-sdk/run-command` | Zamanlanmış komut yardımcıları | Normalize stdout/stderr ile zamanlanmış komut çalıştırıcı |
|
||||
| `plugin-sdk/param-readers` | Param okuyucular | Yaygın araç/CLI param okuyucuları |
|
||||
| `plugin-sdk/tool-send` | Tool send çıkarımı | Araç argümanlarından kanonik gönderim hedefi alanlarını çıkarma |
|
||||
| `plugin-sdk/temp-path` | Geçici yol yardımcıları | Paylaşılan temp-download yol yardımcıları |
|
||||
| `plugin-sdk/logging-core` | Logging yardımcıları | Alt sistem logger ve redaction yardımcıları |
|
||||
| `plugin-sdk/markdown-table-runtime` | Markdown-table yardımcıları | Markdown tablo modu yardımcıları |
|
||||
| `plugin-sdk/state-paths` | Durum yolu yardımcıları | Durum ve OAuth dizin yardımcıları |
|
||||
| `plugin-sdk/routing` | Yönlendirme/oturum anahtarı yardımcıları | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, oturum anahtarı normalizasyon yardımcıları |
|
||||
| `plugin-sdk/status-helpers` | Kanal durumu yardımcıları | Kanal/hesap durum özeti oluşturucuları, çalışma zamanı durumu varsayılanları, sorun meta verisi yardımcıları |
|
||||
| `plugin-sdk/target-resolver-runtime` | Hedef çözümleyici yardımcıları | Paylaşılan hedef çözümleyici yardımcıları |
|
||||
| `plugin-sdk/string-normalization-runtime` | Dizge normalizasyon yardımcıları | Slug/dizge normalizasyon yardımcıları |
|
||||
| `plugin-sdk/request-url` | İstek URL yardımcıları | İstek benzeri girdilerden dizge URL'leri çıkarma |
|
||||
| `plugin-sdk/run-command` | Zamanlanmış komut yardımcıları | Normalize stdout/stderr ile zamanlanmış komut çalıştırıcısı |
|
||||
| `plugin-sdk/param-readers` | Parametre okuyucular | Yaygın araç/CLI parametre okuyucuları |
|
||||
| `plugin-sdk/tool-payload` | Araç payload çıkarımı | Araç sonuç nesnelerinden normalize payload çıkarma |
|
||||
| `plugin-sdk/tool-send` | Araç gönderim çıkarımı | Araç argümanlarından kanonik gönderim hedefi alanlarını çıkarma |
|
||||
| `plugin-sdk/temp-path` | Geçici yol yardımcıları | Paylaşılan geçici indirme yolu yardımcıları |
|
||||
| `plugin-sdk/logging-core` | Günlükleme yardımcıları | Alt sistem logger ve redaksiyon yardımcıları |
|
||||
| `plugin-sdk/markdown-table-runtime` | Markdown tablo yardımcıları | Markdown tablo modu yardımcıları |
|
||||
| `plugin-sdk/reply-payload` | Mesaj yanıt türleri | Yanıt payload türleri |
|
||||
| `plugin-sdk/provider-setup` | Özenle seçilmiş yerel/self-hosted sağlayıcı kurulum yardımcıları | Self-hosted sağlayıcı keşif/yapılandırma yardımcıları |
|
||||
| `plugin-sdk/self-hosted-provider-setup` | Odaklı OpenAI-compatible self-hosted sağlayıcı kurulum yardımcıları | Aynı self-hosted sağlayıcı keşif/yapılandırma yardımcıları |
|
||||
| `plugin-sdk/provider-auth-runtime` | Sağlayıcı runtime auth yardımcıları | Runtime API anahtarı çözümleme yardımcıları |
|
||||
| `plugin-sdk/provider-auth-api-key` | Sağlayıcı API anahtarı kurulum yardımcıları | API anahtarı onboarding/profile-write yardımcıları |
|
||||
| `plugin-sdk/provider-auth-result` | Sağlayıcı auth-result yardımcıları | Standart OAuth auth-result oluşturucu |
|
||||
| `plugin-sdk/provider-auth-login` | Sağlayıcı etkileşimli login yardımcıları | Paylaşılan etkileşimli login yardımcıları |
|
||||
| `plugin-sdk/provider-env-vars` | Sağlayıcı env-var yardımcıları | Sağlayıcı auth env-var arama yardımcıları |
|
||||
| `plugin-sdk/provider-model-shared` | Paylaşılan sağlayıcı model/replay yardımcıları | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, paylaşılan replay-policy oluşturucuları, provider-endpoint yardımcıları ve model-id normalleştirme yardımcıları |
|
||||
| `plugin-sdk/provider-setup` | Küratörlü yerel/kendi kendine barındırılan sağlayıcı kurulum yardımcıları | Kendi kendine barındırılan sağlayıcı keşfi/yapılandırma yardımcıları |
|
||||
| `plugin-sdk/self-hosted-provider-setup` | Odaklanmış OpenAI uyumlu kendi kendine barındırılan sağlayıcı kurulum yardımcıları | Aynı kendi kendine barındırılan sağlayıcı keşfi/yapılandırma yardımcıları |
|
||||
| `plugin-sdk/provider-auth-runtime` | Sağlayıcı çalışma zamanı kimlik doğrulama yardımcıları | Çalışma zamanı API anahtarı çözümleme yardımcıları |
|
||||
| `plugin-sdk/provider-auth-api-key` | Sağlayıcı API anahtarı kurulum yardımcıları | API anahtarı ilk kurulum/profil yazma yardımcıları |
|
||||
| `plugin-sdk/provider-auth-result` | Sağlayıcı auth-result yardımcıları | Standart OAuth auth-result oluşturucusu |
|
||||
| `plugin-sdk/provider-auth-login` | Sağlayıcı etkileşimli giriş yardımcıları | Paylaşılan etkileşimli giriş yardımcıları |
|
||||
| `plugin-sdk/provider-env-vars` | Sağlayıcı ortam değişkeni yardımcıları | Sağlayıcı auth ortam değişkeni arama yardımcıları |
|
||||
| `plugin-sdk/provider-model-shared` | Paylaşılan sağlayıcı model/yeniden oynatma yardımcıları | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, paylaşılan replay-policy oluşturucuları, sağlayıcı uç nokta yardımcıları ve model kimliği normalizasyon yardımcıları |
|
||||
| `plugin-sdk/provider-catalog-shared` | Paylaşılan sağlayıcı katalog yardımcıları | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
|
||||
| `plugin-sdk/provider-onboard` | Sağlayıcı onboarding yamaları | Onboarding yapılandırma yardımcıları |
|
||||
| `plugin-sdk/provider-http` | Sağlayıcı HTTP yardımcıları | Genel sağlayıcı HTTP/endpoint capability yardımcıları |
|
||||
| `plugin-sdk/provider-web-fetch` | Sağlayıcı web-fetch yardımcıları | Web-fetch sağlayıcı kayıt/önbellek yardımcıları |
|
||||
| `plugin-sdk/provider-web-search-contract` | Sağlayıcı web-search sözleşme yardımcıları | `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` ve kapsamlı kimlik bilgisi ayarlayıcıları/alıcıları gibi dar web-search yapılandırma/kimlik bilgisi sözleşme yardımcıları |
|
||||
| `plugin-sdk/provider-web-search` | Sağlayıcı web-search yardımcıları | Web-search sağlayıcı kayıt/önbellek/runtime yardımcıları |
|
||||
| `plugin-sdk/provider-tools` | Sağlayıcı araç/şema uyumluluk yardımcıları | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini şema temizliği + tanılama ve `resolveXaiModelCompatPatch` / `applyXaiModelCompat` gibi xAI uyumluluk yardımcıları |
|
||||
| `plugin-sdk/provider-http` | Sağlayıcı HTTP yardımcıları | Genel sağlayıcı HTTP/uç nokta yeteneği yardımcıları |
|
||||
| `plugin-sdk/provider-web-fetch` | Sağlayıcı web-fetch yardımcıları | Web-fetch sağlayıcı kaydı/önbellek yardımcıları |
|
||||
| `plugin-sdk/provider-web-search-config-contract` | Sağlayıcı web-search yapılandırma yardımcıları | Plugin etkinleştirme kablolamasına ihtiyaç duymayan sağlayıcılar için dar kapsamlı web-search yapılandırma/kimlik bilgisi yardımcıları |
|
||||
| `plugin-sdk/provider-web-search-contract` | Sağlayıcı web-search sözleşme yardımcıları | `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` ve kapsamlı kimlik bilgisi ayarlayıcıları/alıcıları gibi dar kapsamlı web-search yapılandırma/kimlik bilgisi sözleşme yardımcıları |
|
||||
| `plugin-sdk/provider-web-search` | Sağlayıcı web-search yardımcıları | Web-search sağlayıcı kaydı/önbellek/çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/provider-tools` | Sağlayıcı araç/şema uyumluluk yardımcıları | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini şema temizleme + tanılama ve `resolveXaiModelCompatPatch` / `applyXaiModelCompat` gibi xAI uyumluluk yardımcıları |
|
||||
| `plugin-sdk/provider-usage` | Sağlayıcı kullanım yardımcıları | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` ve diğer sağlayıcı kullanım yardımcıları |
|
||||
| `plugin-sdk/provider-stream` | Sağlayıcı akış sarmalayıcı yardımcıları | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, akış sarmalayıcı türleri ve paylaşılan Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot sarmalayıcı yardımcıları |
|
||||
| `plugin-sdk/keyed-async-queue` | Sıralı async kuyruk | `KeyedAsyncQueue` |
|
||||
| `plugin-sdk/media-runtime` | Paylaşılan medya yardımcıları | Medya fetch/transform/store yardımcıları artı medya payload oluşturucuları |
|
||||
| `plugin-sdk/media-generation-runtime` | Paylaşılan media-generation yardımcıları | Görüntü/video/müzik üretimi için paylaşılan failover yardımcıları, aday seçimi ve eksik model mesajlaşması |
|
||||
| `plugin-sdk/media-understanding` | Media-understanding yardımcıları | Media understanding sağlayıcı türleri artı sağlayıcıya dönük görüntü/ses yardımcı dışa aktarımları |
|
||||
| `plugin-sdk/text-runtime` | Paylaşılan metin yardımcıları | Assistanta görünür metin temizleme, markdown render/chunking/table yardımcıları, redaction yardımcıları, directive-tag yardımcıları, safe-text yardımcıları ve ilgili metin/logging yardımcıları |
|
||||
| `plugin-sdk/text-chunking` | Metin parça yardımcıları | Giden metin chunking yardımcısı |
|
||||
| `plugin-sdk/speech` | Konuşma yardımcıları | Konuşma sağlayıcı türleri artı sağlayıcıya dönük directive, registry ve doğrulama yardımcıları |
|
||||
| `plugin-sdk/speech-core` | Paylaşılan konuşma çekirdeği | Konuşma sağlayıcı türleri, registry, directive'ler, normalleştirme |
|
||||
| `plugin-sdk/realtime-transcription` | Realtime transcription yardımcıları | Sağlayıcı türleri ve registry yardımcıları |
|
||||
| `plugin-sdk/realtime-voice` | Realtime voice yardımcıları | Sağlayıcı türleri ve registry yardımcıları |
|
||||
| `plugin-sdk/image-generation-core` | Paylaşılan image-generation çekirdeği | Image-generation türleri, failover, auth ve registry yardımcıları |
|
||||
| `plugin-sdk/music-generation` | Music-generation yardımcıları | Music-generation sağlayıcı/istek/sonuç türleri |
|
||||
| `plugin-sdk/music-generation-core` | Paylaşılan music-generation çekirdeği | Music-generation türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma |
|
||||
| `plugin-sdk/video-generation` | Video-generation yardımcıları | Video-generation sağlayıcı/istek/sonuç türleri |
|
||||
| `plugin-sdk/video-generation-core` | Paylaşılan video-generation çekirdeği | Video-generation türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma |
|
||||
| `plugin-sdk/interactive-runtime` | Etkileşimli yanıt yardımcıları | Etkileşimli yanıt payload normalleştirme/indirgeme |
|
||||
| `plugin-sdk/channel-config-primitives` | Kanal yapılandırma ilkel öğeleri | Dar kanal config-schema ilkel öğeleri |
|
||||
| `plugin-sdk/channel-config-writes` | Kanal config-write yardımcıları | Kanal config-write yetkilendirme yardımcıları |
|
||||
| `plugin-sdk/channel-plugin-common` | Paylaşılan kanal başlangıç bölümü | Paylaşılan kanal plugin başlangıç dışa aktarımları |
|
||||
| `plugin-sdk/channel-status` | Kanal durum yardımcıları | Paylaşılan kanal durum anlık görüntüsü/özet yardımcıları |
|
||||
| `plugin-sdk/media-runtime` | Paylaşılan medya yardımcıları | Medya fetch/transform/store yardımcıları ile medya payload oluşturucuları |
|
||||
| `plugin-sdk/media-generation-runtime` | Paylaşılan medya üretimi yardımcıları | Görüntü/video/müzik üretimi için paylaşılan failover yardımcıları, aday seçimi ve eksik model mesajları |
|
||||
| `plugin-sdk/media-understanding` | Media-understanding yardımcıları | Media understanding sağlayıcı türleri ile sağlayıcıya dönük görüntü/ses yardımcı dışa aktarmaları |
|
||||
| `plugin-sdk/text-runtime` | Paylaşılan metin yardımcıları | Asistan tarafından görünen metin temizleme, markdown işleme/parçalama/tablo yardımcıları, redaksiyon yardımcıları, directive-tag yardımcıları, güvenli metin yardımcıları ve ilgili metin/günlükleme yardımcıları |
|
||||
| `plugin-sdk/text-chunking` | Metin parçalama yardımcıları | Giden metin parçalama yardımcısı |
|
||||
| `plugin-sdk/speech` | Konuşma yardımcıları | Konuşma sağlayıcı türleri ile sağlayıcıya dönük directive, registry ve doğrulama yardımcıları |
|
||||
| `plugin-sdk/speech-core` | Paylaşılan konuşma çekirdeği | Konuşma sağlayıcı türleri, kayıt, directive'ler, normalizasyon |
|
||||
| `plugin-sdk/realtime-transcription` | Gerçek zamanlı transkripsiyon yardımcıları | Sağlayıcı türleri ve kayıt yardımcıları |
|
||||
| `plugin-sdk/realtime-voice` | Gerçek zamanlı ses yardımcıları | Sağlayıcı türleri ve kayıt yardımcıları |
|
||||
| `plugin-sdk/image-generation-core` | Paylaşılan görüntü üretimi çekirdeği | Görüntü üretimi türleri, failover, kimlik doğrulama ve kayıt yardımcıları |
|
||||
| `plugin-sdk/music-generation` | Müzik üretimi yardımcıları | Müzik üretimi sağlayıcı/istek/sonuç türleri |
|
||||
| `plugin-sdk/music-generation-core` | Paylaşılan müzik üretimi çekirdeği | Müzik üretimi türleri, failover yardımcıları, sağlayıcı araması ve model-ref ayrıştırma |
|
||||
| `plugin-sdk/video-generation` | Video üretimi yardımcıları | Video üretimi sağlayıcı/istek/sonuç türleri |
|
||||
| `plugin-sdk/video-generation-core` | Paylaşılan video üretimi çekirdeği | Video üretimi türleri, failover yardımcıları, sağlayıcı araması ve model-ref ayrıştırma |
|
||||
| `plugin-sdk/interactive-runtime` | Etkileşimli yanıt yardımcıları | Etkileşimli yanıt payload normalizasyonu/indirgeme |
|
||||
| `plugin-sdk/channel-config-primitives` | Kanal yapılandırma ilkelleri | Dar kapsamlı kanal config-schema ilkelleri |
|
||||
| `plugin-sdk/channel-config-writes` | Kanal yapılandırma yazma yardımcıları | Kanal yapılandırma yazma yetkilendirme yardımcıları |
|
||||
| `plugin-sdk/channel-plugin-common` | Paylaşılan kanal prelüdü | Paylaşılan kanal plugin prelüd dışa aktarmaları |
|
||||
| `plugin-sdk/channel-status` | Kanal durumu yardımcıları | Paylaşılan kanal durumu anlık görüntü/özet yardımcıları |
|
||||
| `plugin-sdk/allowlist-config-edit` | Allowlist yapılandırma yardımcıları | Allowlist yapılandırma düzenleme/okuma yardımcıları |
|
||||
| `plugin-sdk/group-access` | Grup erişim yardımcıları | Paylaşılan grup erişim kararı yardımcıları |
|
||||
| `plugin-sdk/direct-dm` | Doğrudan-DM yardımcıları | Paylaşılan doğrudan-DM auth/guard yardımcıları |
|
||||
| `plugin-sdk/extension-shared` | Paylaşılan extension yardımcıları | Passive-channel/status ve ambient proxy yardımcı ilkel öğeleri |
|
||||
| `plugin-sdk/webhook-targets` | Webhook hedef yardımcıları | Webhook hedef kayıt defteri ve route-install yardımcıları |
|
||||
| `plugin-sdk/webhook-path` | Webhook yol yardımcıları | Webhook yol normalleştirme yardımcıları |
|
||||
| `plugin-sdk/group-access` | Grup erişim yardımcıları | Paylaşılan grup erişimi karar yardımcıları |
|
||||
| `plugin-sdk/direct-dm` | Doğrudan-DM yardımcıları | Paylaşılan doğrudan-DM kimlik doğrulama/koruma yardımcıları |
|
||||
| `plugin-sdk/extension-shared` | Paylaşılan extension yardımcıları | Pasif kanal/durum ve ortam proxy yardımcısı ilkelleri |
|
||||
| `plugin-sdk/webhook-targets` | Webhook hedef yardımcıları | Webhook hedef kaydı ve rota kurulum yardımcıları |
|
||||
| `plugin-sdk/webhook-path` | Webhook yol yardımcıları | Webhook yol normalizasyon yardımcıları |
|
||||
| `plugin-sdk/web-media` | Paylaşılan web medya yardımcıları | Uzak/yerel medya yükleme yardımcıları |
|
||||
| `plugin-sdk/zod` | Zod yeniden dışa aktarma | Plugin SDK kullanıcıları için yeniden dışa aktarılan `zod` |
|
||||
| `plugin-sdk/memory-core` | Paketlenmiş memory-core yardımcıları | Memory manager/config/file/CLI yardımcı yüzeyi |
|
||||
| `plugin-sdk/memory-core-engine-runtime` | Memory engine runtime cephesi | Memory index/search runtime cephesi |
|
||||
| `plugin-sdk/memory-core-host-engine-foundation` | Memory host foundation engine | Memory host foundation engine dışa aktarımları |
|
||||
| `plugin-sdk/memory-core-host-engine-embeddings` | Memory host embedding engine | Memory host embedding engine dışa aktarımları |
|
||||
| `plugin-sdk/memory-core-host-engine-qmd` | Memory host QMD engine | Memory host QMD engine dışa aktarımları |
|
||||
| `plugin-sdk/memory-core-host-engine-storage` | Memory host storage engine | Memory host storage engine dışa aktarımları |
|
||||
| `plugin-sdk/memory-core-host-multimodal` | Memory host multimodal yardımcıları | Memory host multimodal yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-query` | Memory host query yardımcıları | Memory host query yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-secret` | Memory host secret yardımcıları | Memory host secret yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-events` | Memory host event journal yardımcıları | Memory host event journal yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-status` | Memory host status yardımcıları | Memory host status yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-runtime-cli` | Memory host CLI runtime | Memory host CLI runtime yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-runtime-core` | Memory host core runtime | Memory host core runtime yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-runtime-files` | Memory host file/runtime yardımcıları | Memory host file/runtime yardımcıları |
|
||||
| `plugin-sdk/memory-host-core` | Memory host core runtime takma adı | Memory host core runtime yardımcıları için satıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-host-events` | Memory host event journal takma adı | Memory host event journal yardımcıları için satıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-host-files` | Memory host file/runtime takma adı | Memory host file/runtime yardımcıları için satıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-host-markdown` | Yönetilen markdown yardımcıları | Memory'ye bitişik plugin'ler için paylaşılan managed-markdown yardımcıları |
|
||||
| `plugin-sdk/memory-host-search` | Etkin memory search cephesi | Lazy active-memory search-manager runtime cephesi |
|
||||
| `plugin-sdk/memory-host-status` | Memory host status takma adı | Memory host status yardımcıları için satıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/zod` | Zod yeniden dışa aktarması | Plugin SDK tüketicileri için yeniden dışa aktarılan `zod` |
|
||||
| `plugin-sdk/memory-core` | Paketlenmiş memory-core yardımcıları | Bellek yöneticisi/yapılandırma/dosya/CLI yardımcı yüzeyi |
|
||||
| `plugin-sdk/memory-core-engine-runtime` | Bellek motoru çalışma zamanı cephesi | Bellek dizin/arama çalışma zamanı cephesi |
|
||||
| `plugin-sdk/memory-core-host-engine-foundation` | Bellek host foundation motoru | Bellek host foundation motoru dışa aktarmaları |
|
||||
| `plugin-sdk/memory-core-host-engine-embeddings` | Bellek host embedding motoru | Bellek host embedding motoru dışa aktarmaları |
|
||||
| `plugin-sdk/memory-core-host-engine-qmd` | Bellek host QMD motoru | Bellek host QMD motoru dışa aktarmaları |
|
||||
| `plugin-sdk/memory-core-host-engine-storage` | Bellek host depolama motoru | Bellek host depolama motoru dışa aktarmaları |
|
||||
| `plugin-sdk/memory-core-host-multimodal` | Bellek host multimodal yardımcıları | Bellek host multimodal yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-query` | Bellek host sorgu yardımcıları | Bellek host sorgu yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-secret` | Bellek host secret yardımcıları | Bellek host secret yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-events` | Bellek host olay günlüğü yardımcıları | Bellek host olay günlüğü yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-status` | Bellek host durum yardımcıları | Bellek host durum yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-runtime-cli` | Bellek host CLI çalışma zamanı | Bellek host CLI çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-runtime-core` | Bellek host çekirdek çalışma zamanı | Bellek host çekirdek çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-runtime-files` | Bellek host dosya/çalışma zamanı yardımcıları | Bellek host dosya/çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/memory-host-core` | Bellek host çekirdek çalışma zamanı takma adı | Bellek host çekirdek çalışma zamanı yardımcıları için sağlayıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-host-events` | Bellek host olay günlüğü takma adı | Bellek host olay günlüğü yardımcıları için sağlayıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-host-files` | Bellek host dosya/çalışma zamanı takma adı | Bellek host dosya/çalışma zamanı yardımcıları için sağlayıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-host-markdown` | Yönetilen markdown yardımcıları | Belleğe bitişik plugin'ler için paylaşılan yönetilen-markdown yardımcıları |
|
||||
| `plugin-sdk/memory-host-search` | Etkin bellek arama cephesi | Tembel etkin bellek search-manager çalışma zamanı cephesi |
|
||||
| `plugin-sdk/memory-host-status` | Bellek host durum takma adı | Bellek host durum yardımcıları için sağlayıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-lancedb` | Paketlenmiş memory-lancedb yardımcıları | Memory-lancedb yardımcı yüzeyi |
|
||||
| `plugin-sdk/testing` | Test yardımcı araçları | Test yardımcıları ve mock'lar |
|
||||
| `plugin-sdk/testing` | Test yardımcıları | Test yardımcıları ve mock'lar |
|
||||
</Accordion>
|
||||
|
||||
Bu tablo, tüm SDK yüzeyi değil, bilinçli olarak yaygın geçiş alt kümesidir.
|
||||
200'den fazla entrypoint'in tam listesi
|
||||
Bu tablo kasıtlı olarak tam SDK yüzeyi değil, yaygın geçiş alt kümesidir.
|
||||
200'den fazla giriş noktasının tam listesi
|
||||
`scripts/lib/plugin-sdk-entrypoints.json` içinde bulunur.
|
||||
|
||||
Bu liste hâlâ bazı paketlenmiş-plugin yardımcı yüzeylerini içerir; örneğin
|
||||
`plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`,
|
||||
`plugin-sdk/zalo-setup` ve `plugin-sdk/matrix*`. Bunlar paketlenmiş-plugin
|
||||
bakımı ve uyumluluk için dışa aktarılmaya devam eder, ancak bilinçli olarak
|
||||
yaygın geçiş tablosuna dahil edilmemiştir ve
|
||||
yeni plugin kodu için önerilen hedef değildir.
|
||||
Bu liste hâlâ `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`,
|
||||
`plugin-sdk/zalo-setup` ve `plugin-sdk/matrix*` gibi bazı paketlenmiş-plugin yardımcı seam'lerini içerir. Bunlar
|
||||
paketlenmiş-plugin bakımı ve uyumluluk için dışa aktarılmaya devam eder, ancak yaygın geçiş tablosuna bilerek
|
||||
dahil edilmemiştir ve yeni plugin kodu için önerilen hedef değildir.
|
||||
|
||||
Aynı kural şu diğer paketlenmiş yardımcı aileleri için de geçerlidir:
|
||||
Aynı kural diğer paketlenmiş yardımcı aileleri için de geçerlidir, örneğin:
|
||||
|
||||
- tarayıcı desteği yardımcıları: `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`
|
||||
- tarayıcı destek yardımcıları: `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*`
|
||||
- paketlenmiş yardımcı/plugin yüzeyleri, örneğin `plugin-sdk/googlechat`,
|
||||
- `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` ve `plugin-sdk/voice-call`
|
||||
`plugin-sdk/thread-ownership` ve `plugin-sdk/voice-call` gibi paketlenmiş yardımcı/plugin yüzeyleri
|
||||
|
||||
`plugin-sdk/github-copilot-token` şu anda dar token-helper
|
||||
`plugin-sdk/github-copilot-token` şu anda dar kapsamlı belirteç yardımcı
|
||||
yüzeyi `DEFAULT_COPILOT_API_BASE_URL`,
|
||||
`deriveCopilotApiBaseUrlFromToken` ve `resolveCopilotApiToken` değerlerini açığa çıkarır.
|
||||
`deriveCopilotApiBaseUrlFromToken` ve `resolveCopilotApiToken`'ı sunar.
|
||||
|
||||
Yapılan işe uyan en dar import'u kullanın. Bir dışa aktarım bulamazsanız
|
||||
`src/plugin-sdk/` içindeki kaynağı inceleyin veya Discord'da sorun.
|
||||
İşinize en uygun en dar içe aktarmayı kullanın. Bir dışa aktarma bulamazsanız,
|
||||
`src/plugin-sdk/` altındaki kaynağı kontrol edin veya Discord'da sorun.
|
||||
|
||||
## Kaldırma zaman çizelgesi
|
||||
|
||||
| Ne zaman | Ne olur |
|
||||
| ---------------------- | ----------------------------------------------------------------------- |
|
||||
| **Şimdi** | Kullanımdan kaldırılmış yüzeyler çalışma zamanında uyarı verir |
|
||||
| **Bir sonraki büyük sürüm** | Kullanımdan kaldırılmış yüzeyler kaldırılır; bunları hâlâ kullanan plugin'ler başarısız olur |
|
||||
| Ne zaman | Ne olur |
|
||||
| ---------------------- | ---------------------------------------------------------------------- |
|
||||
| **Şimdi** | Kullanımdan kaldırılmış yüzeyler çalışma zamanı uyarıları yayar |
|
||||
| **Bir sonraki büyük sürüm** | Kullanımdan kaldırılmış yüzeyler kaldırılacaktır; bunları hâlâ kullanan plugin'ler başarısız olacaktır |
|
||||
|
||||
Tüm core plugin'ler zaten taşındı. Harici plugin'ler
|
||||
Tüm çekirdek plugin'ler zaten geçirildi. Harici plugin'ler
|
||||
bir sonraki büyük sürümden önce geçiş yapmalıdır.
|
||||
|
||||
## Uyarıları geçici olarak bastırma
|
||||
@ -402,8 +398,8 @@ Bu geçici bir kaçış kapağıdır, kalıcı bir çözüm değildir.
|
||||
## İlgili
|
||||
|
||||
- [Başlangıç](/tr/plugins/building-plugins) — ilk plugin'inizi oluşturun
|
||||
- [SDK Genel Bakış](/tr/plugins/sdk-overview) — alt yollar için tam import başvurusu
|
||||
- [SDK Genel Bakış](/tr/plugins/sdk-overview) — alt yol içe aktarmaları için tam başvuru
|
||||
- [Kanal Plugin'leri](/tr/plugins/sdk-channel-plugins) — kanal plugin'leri oluşturma
|
||||
- [Sağlayıcı Plugin'leri](/tr/plugins/sdk-provider-plugins) — sağlayıcı plugin'leri oluşturma
|
||||
- [Plugin İç Yapısı](/tr/plugins/architecture) — mimariyi derinlemesine inceleme
|
||||
- [Plugin Manifest'i](/tr/plugins/manifest) — manifest şeması başvurusu
|
||||
- [Plugin İç Yapısı](/tr/plugins/architecture) — mimariye derinlemesine bakış
|
||||
- [Plugin Manifesti](/tr/plugins/manifest) — manifest şeması başvurusu
|
||||
|
||||
@ -1,30 +1,31 @@
|
||||
---
|
||||
read_when:
|
||||
- Hangi SDK alt yolundan içe aktarma yapmanız gerektiğini öğrenmeniz gerekiyor
|
||||
- Hangi SDK alt yolundan içe aktarma yapmanız gerektiğini bilmeniz gerekiyor
|
||||
- OpenClawPluginApi üzerindeki tüm kayıt yöntemleri için bir başvuru istiyorsunuz
|
||||
- Belirli bir SDK dışa aktarımını arıyorsunuz
|
||||
sidebarTitle: SDK Overview
|
||||
summary: Import map, kayıt API başvurusu ve SDK mimarisi
|
||||
summary: İçe aktarma eşleme tablosu, kayıt API başvurusu ve SDK mimarisi
|
||||
title: Plugin SDK Genel Bakış
|
||||
x-i18n:
|
||||
generated_at: "2026-04-08T02:17:58Z"
|
||||
generated_at: "2026-04-08T08:44:45Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: c5a41bd82d165dfbb7fbd6e4528cf322e9133a51efe55fa8518a7a0a626d9d30
|
||||
source_hash: 6e7b420eb0f3faa8916357d52df949f6c9a46f1c843a1e6a0c0b8bb26db6cbff
|
||||
source_path: plugins/sdk-overview.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Plugin SDK Genel Bakış
|
||||
|
||||
Plugin SDK, plugin'ler ile çekirdek arasındaki türlenmiş sözleşmedir. Bu sayfa,
|
||||
**neyin içe aktarılacağı** ve **nelerin kaydedilebileceği** için başvurudur.
|
||||
Plugin SDK, plugin'ler ile çekirdek arasındaki tiplenmiş sözleşmedir. Bu sayfa,
|
||||
**neyin içe aktarılacağı** ve **nelerin kaydedilebileceği** için başvuru
|
||||
kaynağıdır.
|
||||
|
||||
<Tip>
|
||||
**Nasıl yapılır kılavuzu mu arıyorsunuz?**
|
||||
- İlk plugin mi? [Başlangıç](/tr/plugins/building-plugins) ile başlayın
|
||||
- Kanal plugin'i mi? [Kanal Plugin'leri](/tr/plugins/sdk-channel-plugins) bölümüne bakın
|
||||
- Sağlayıcı plugin'i mi? [Sağlayıcı Plugin'leri](/tr/plugins/sdk-provider-plugins) bölümüne bakın
|
||||
- Kanal plugin'i mi? [Kanal Plugin'leri](/tr/plugins/sdk-channel-plugins) sayfasına bakın
|
||||
- Sağlayıcı plugin'i mi? [Sağlayıcı Plugin'leri](/tr/plugins/sdk-provider-plugins) sayfasına bakın
|
||||
</Tip>
|
||||
|
||||
## İçe aktarma kuralı
|
||||
@ -36,29 +37,41 @@ import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
|
||||
import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
|
||||
```
|
||||
|
||||
Her alt yol küçük, kendi içinde tamamlanmış bir modüldür. Bu, başlangıcın hızlı kalmasını sağlar ve döngüsel bağımlılık sorunlarını önler. Kanala özgü giriş/oluşturma yardımcıları için `openclaw/plugin-sdk/channel-core` tercih edin; daha geniş şemsiye yüzey ve
|
||||
`buildChannelConfigSchema` gibi paylaşılan yardımcılar için `openclaw/plugin-sdk/core` yolunu kullanın.
|
||||
Her alt yol küçük, kendi içinde tamamlanmış bir modüldür. Bu, başlangıcın hızlı
|
||||
kalmasını sağlar ve dairesel bağımlılık sorunlarını önler. Kanala özel
|
||||
entry/build yardımcıları için `openclaw/plugin-sdk/channel-core` tercih edin;
|
||||
daha geniş şemsiye yüzey ve `buildChannelConfigSchema` gibi paylaşılan
|
||||
yardımcılar için `openclaw/plugin-sdk/core` kullanın.
|
||||
|
||||
`openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
|
||||
`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp` veya
|
||||
kanal markalı yardımcı yüzeyler gibi sağlayıcı adlı kolaylık katmanlarını eklemeyin veya bunlara bağımlı olmayın. Paketlenmiş plugin'ler, kendi `api.ts` veya `runtime-api.ts` barrel dosyalarında genel
|
||||
SDK alt yollarını birleştirmelidir; çekirdek ise gerçekten kanallar arası bir ihtiyaç olduğunda ya bu plugin'e yerel barrel dosyalarını kullanmalı ya da dar bir genel SDK sözleşmesi eklemelidir.
|
||||
kanal markalı yardımcı yüzeyler gibi sağlayıcı adlı kolaylık katmanları
|
||||
eklemeyin ya da bunlara bağımlı olmayın. Paketlenmiş plugin'ler, kendi `api.ts`
|
||||
veya `runtime-api.ts` barrel dosyaları içinde genel SDK alt yollarını
|
||||
birleştirmelidir ve çekirdek, ihtiyaç gerçekten kanallar arası olduğunda ya bu
|
||||
plugin-yerel barrel dosyalarını kullanmalı ya da dar bir genel SDK sözleşmesi
|
||||
eklemelidir.
|
||||
|
||||
Üretilen export map hâlâ `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
|
||||
`plugin-sdk/zalo`, `plugin-sdk/zalo-setup` ve `plugin-sdk/matrix*` gibi az sayıda paketlenmiş plugin yardımcı yüzeyi içerir. Bu
|
||||
alt yollar yalnızca paketlenmiş plugin bakımı ve uyumluluk için vardır; aşağıdaki ortak tabloda bilerek yer verilmemiştir ve yeni üçüncü taraf plugin'leri için önerilen içe aktarma yolu değildir.
|
||||
Oluşturulmuş dışa aktarma eşleme tablosu hâlâ `plugin-sdk/feishu`,
|
||||
`plugin-sdk/feishu-setup`, `plugin-sdk/zalo`, `plugin-sdk/zalo-setup` ve
|
||||
`plugin-sdk/matrix*` gibi küçük bir paketlenmiş-plugin yardımcı yüzeyi kümesi
|
||||
içerir. Bu alt yollar yalnızca paketlenmiş-plugin bakımı ve uyumluluk için
|
||||
vardır; aşağıdaki ortak tabloda bilerek atlanmıştır ve yeni üçüncü taraf
|
||||
plugin'leri için önerilen içe aktarma yolu değildir.
|
||||
|
||||
## Alt yol başvurusu
|
||||
|
||||
En sık kullanılan alt yollar, amaçlarına göre gruplandırılmıştır. 200+ alt yolun
|
||||
üretilmiş tam listesi `scripts/lib/plugin-sdk-entrypoints.json` içinde bulunur.
|
||||
Amaçlarına göre gruplandırılmış, en sık kullanılan alt yollar. Oluşturulmuş tam
|
||||
200+ alt yol listesi `scripts/lib/plugin-sdk-entrypoints.json` içinde bulunur.
|
||||
|
||||
Ayrılmış paketlenmiş plugin yardımcı alt yolları bu üretilmiş listede görünmeye devam eder.
|
||||
Bir doküman sayfası bunlardan birini açıkça genel olarak öne çıkarmadıkça, bunları uygulama ayrıntısı/uyumluluk yüzeyleri olarak değerlendirin.
|
||||
Ayrılmış paketlenmiş-plugin yardımcı alt yolları bu oluşturulmuş listede yine
|
||||
de görünür. Bir dokümantasyon sayfası bunlardan birini açıkça herkese açık
|
||||
olarak tanıtmadıkça, bunları uygulama ayrıntısı/uyumluluk yüzeyleri olarak
|
||||
değerlendirin.
|
||||
|
||||
### Plugin girişi
|
||||
### Plugin entry
|
||||
|
||||
| Subpath | Temel dışa aktarımlar |
|
||||
| Alt yol | Temel dışa aktarımlar |
|
||||
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `plugin-sdk/plugin-entry` | `definePluginEntry` |
|
||||
| `plugin-sdk/core` | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema` |
|
||||
@ -67,282 +80,288 @@ Bir doküman sayfası bunlardan birini açıkça genel olarak öne çıkarmadık
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Kanal alt yolları">
|
||||
| Subpath | Temel dışa aktarımlar |
|
||||
| Alt yol | Temel dışa aktarımlar |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/channel-core` | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
|
||||
| `plugin-sdk/config-schema` | Kök `openclaw.json` Zod şema dışa aktarımı (`OpenClawSchema`) |
|
||||
| `plugin-sdk/channel-setup` | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, ayrıca `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
|
||||
| `plugin-sdk/setup` | Paylaşılan kurulum sihirbazı yardımcıları, allowlist istemleri, kurulum durumu oluşturucuları |
|
||||
| `plugin-sdk/setup` | Paylaşılan kurulum sihirbazı yardımcıları, izin listesi istemleri, kurulum durumu oluşturucuları |
|
||||
| `plugin-sdk/setup-runtime` | `createPatchedAccountSetupAdapter`, `createEnvPatchedAccountSetupAdapter`, `createSetupInputPresenceValidator`, `noteChannelLookupFailure`, `noteChannelLookupSummary`, `promptResolvedAllowFrom`, `splitSetupEntries`, `createAllowlistSetupWizardProxy`, `createDelegatedSetupWizardProxy` |
|
||||
| `plugin-sdk/setup-adapter-runtime` | `createEnvPatchedAccountSetupAdapter` |
|
||||
| `plugin-sdk/setup-tools` | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
|
||||
| `plugin-sdk/account-core` | Çok hesaplı yapılandırma/eylem geçidi yardımcıları, varsayılan hesap geri dönüş yardımcıları |
|
||||
| `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, hesap kimliği normalleştirme yardımcıları |
|
||||
| `plugin-sdk/account-core` | Çoklu hesap yapılandırma/eylem geçidi yardımcıları, varsayılan hesap geri dönüş yardımcıları |
|
||||
| `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, hesap kimliği normalizasyon yardımcıları |
|
||||
| `plugin-sdk/account-resolution` | Hesap arama + varsayılan geri dönüş yardımcıları |
|
||||
| `plugin-sdk/account-helpers` | Dar hesap listesi/hesap eylemi yardımcıları |
|
||||
| `plugin-sdk/channel-pairing` | `createChannelPairingController` |
|
||||
| `plugin-sdk/channel-reply-pipeline` | `createChannelReplyPipeline` |
|
||||
| `plugin-sdk/channel-config-helpers` | `createHybridChannelConfigAdapter` |
|
||||
| `plugin-sdk/channel-config-schema` | Kanal yapılandırma şeması türleri |
|
||||
| `plugin-sdk/telegram-command-config` | Paketlenmiş sözleşme geri dönüşü ile Telegram özel komut normalleştirme/doğrulama yardımcıları |
|
||||
| `plugin-sdk/channel-config-schema` | Kanal yapılandırma şema türleri |
|
||||
| `plugin-sdk/telegram-command-config` | Paketlenmiş sözleşme geri dönüşü ile Telegram özel komut normalizasyonu/doğrulama yardımcıları |
|
||||
| `plugin-sdk/channel-policy` | `resolveChannelGroupRequireMention` |
|
||||
| `plugin-sdk/channel-lifecycle` | `createAccountStatusSink` |
|
||||
| `plugin-sdk/inbound-envelope` | Paylaşılan inbound route + envelope oluşturucu yardımcıları |
|
||||
| `plugin-sdk/inbound-reply-dispatch` | Paylaşılan inbound kayıt ve dispatch yardımcıları |
|
||||
| `plugin-sdk/messaging-targets` | Hedef ayrıştırma/eşleştirme yardımcıları |
|
||||
| `plugin-sdk/outbound-media` | Paylaşılan outbound medya yükleme yardımcıları |
|
||||
| `plugin-sdk/outbound-runtime` | Outbound kimlik/gönderme vekil yardımcıları |
|
||||
| `plugin-sdk/thread-bindings-runtime` | Thread-binding yaşam döngüsü ve bağdaştırıcı yardımcıları |
|
||||
| `plugin-sdk/inbound-envelope` | Paylaşılan gelen rota + zarf oluşturucu yardımcıları |
|
||||
| `plugin-sdk/inbound-reply-dispatch` | Paylaşılan gelen kayıt ve dağıtım yardımcıları |
|
||||
| `plugin-sdk/messaging-targets` | Hedef ayrıştırma/eşleme yardımcıları |
|
||||
| `plugin-sdk/outbound-media` | Paylaşılan giden medya yükleme yardımcıları |
|
||||
| `plugin-sdk/outbound-runtime` | Giden kimlik/gönderim delege yardımcıları |
|
||||
| `plugin-sdk/thread-bindings-runtime` | İş parçacığı bağlama yaşam döngüsü ve bağdaştırıcı yardımcıları |
|
||||
| `plugin-sdk/agent-media-payload` | Eski agent medya payload oluşturucusu |
|
||||
| `plugin-sdk/conversation-runtime` | Konuşma/thread binding, pairing ve yapılandırılmış binding yardımcıları |
|
||||
| `plugin-sdk/conversation-runtime` | Konuşma/iş parçacığı bağlama, eşleştirme ve yapılandırılmış bağlama yardımcıları |
|
||||
| `plugin-sdk/runtime-config-snapshot` | Çalışma zamanı yapılandırma anlık görüntü yardımcısı |
|
||||
| `plugin-sdk/runtime-group-policy` | Çalışma zamanı grup ilkesi çözümleme yardımcıları |
|
||||
| `plugin-sdk/channel-status` | Paylaşılan kanal durumu anlık görüntü/özet yardımcıları |
|
||||
| `plugin-sdk/channel-config-primitives` | Dar kanal yapılandırma şeması primitive'leri |
|
||||
| `plugin-sdk/channel-status` | Paylaşılan kanal durum anlık görüntüsü/özet yardımcıları |
|
||||
| `plugin-sdk/channel-config-primitives` | Dar kanal yapılandırma-şeması ilkelleri |
|
||||
| `plugin-sdk/channel-config-writes` | Kanal yapılandırma yazma yetkilendirme yardımcıları |
|
||||
| `plugin-sdk/channel-plugin-common` | Paylaşılan kanal plugin önyüzü dışa aktarımları |
|
||||
| `plugin-sdk/allowlist-config-edit` | Allowlist yapılandırma düzenleme/okuma yardımcıları |
|
||||
| `plugin-sdk/channel-plugin-common` | Paylaşılan kanal plugin prelude dışa aktarımları |
|
||||
| `plugin-sdk/allowlist-config-edit` | İzin listesi yapılandırma düzenleme/okuma yardımcıları |
|
||||
| `plugin-sdk/group-access` | Paylaşılan grup erişim kararı yardımcıları |
|
||||
| `plugin-sdk/direct-dm` | Paylaşılan doğrudan DM auth/koruma yardımcıları |
|
||||
| `plugin-sdk/interactive-runtime` | Etkileşimli yanıt payload normalleştirme/indirgeme yardımcıları |
|
||||
| `plugin-sdk/channel-inbound` | Inbound debounce, mention eşleme, mention-policy yardımcıları ve envelope yardımcıları |
|
||||
| `plugin-sdk/direct-dm` | Paylaşılan doğrudan DM kimlik doğrulama/koruma yardımcıları |
|
||||
| `plugin-sdk/interactive-runtime` | Etkileşimli yanıt payload normalizasyonu/indirgeme yardımcıları |
|
||||
| `plugin-sdk/channel-inbound` | Gelen debounce, mention eşleme, mention ilkesi yardımcıları ve zarf yardımcıları |
|
||||
| `plugin-sdk/channel-send-result` | Yanıt sonuç türleri |
|
||||
| `plugin-sdk/channel-actions` | `createMessageToolButtonsSchema`, `createMessageToolCardSchema` |
|
||||
| `plugin-sdk/channel-targets` | Hedef ayrıştırma/eşleştirme yardımcıları |
|
||||
| `plugin-sdk/channel-contract` | Kanal sözleşmesi türleri |
|
||||
| `plugin-sdk/channel-feedback` | Geri bildirim/tepki bağlama |
|
||||
| `plugin-sdk/channel-secret-runtime` | `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment` gibi dar secret-contract yardımcıları ve secret hedef türleri |
|
||||
| `plugin-sdk/channel-targets` | Hedef ayrıştırma/eşleme yardımcıları |
|
||||
| `plugin-sdk/channel-contract` | Kanal sözleşme türleri |
|
||||
| `plugin-sdk/channel-feedback` | Geri bildirim/reaksiyon bağlantısı |
|
||||
| `plugin-sdk/channel-secret-runtime` | `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment` ve secret hedef türleri gibi dar secret-sözleşme yardımcıları |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Sağlayıcı alt yolları">
|
||||
| Subpath | Temel dışa aktarımlar |
|
||||
| Alt yol | Temel dışa aktarımlar |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
|
||||
| `plugin-sdk/provider-setup` | Düzenlenmiş yerel/self-hosted sağlayıcı kurulum yardımcıları |
|
||||
| `plugin-sdk/self-hosted-provider-setup` | Odaklanmış OpenAI uyumlu self-hosted sağlayıcı kurulum yardımcıları |
|
||||
| `plugin-sdk/cli-backend` | CLI backend varsayılanları + watchdog sabitleri |
|
||||
| `plugin-sdk/cli-backend` | CLI arka uç varsayılanları + watchdog sabitleri |
|
||||
| `plugin-sdk/provider-auth-runtime` | Sağlayıcı plugin'leri için çalışma zamanı API anahtarı çözümleme yardımcıları |
|
||||
| `plugin-sdk/provider-auth-api-key` | `upsertApiKeyProfile` gibi API anahtarı onboarding/profil yazma yardımcıları |
|
||||
| `plugin-sdk/provider-auth-result` | Standart OAuth auth-result oluşturucusu |
|
||||
| `plugin-sdk/provider-auth-login` | Sağlayıcı plugin'leri için paylaşılan etkileşimli giriş yardımcıları |
|
||||
| `plugin-sdk/provider-env-vars` | Sağlayıcı auth env-var arama yardımcıları |
|
||||
| `plugin-sdk/provider-auth-result` | Standart OAuth kimlik doğrulama sonuç oluşturucusu |
|
||||
| `plugin-sdk/provider-auth-login` | Sağlayıcı plugin'leri için paylaşılan etkileşimli oturum açma yardımcıları |
|
||||
| `plugin-sdk/provider-env-vars` | Sağlayıcı kimlik doğrulama ortam değişkeni arama yardımcıları |
|
||||
| `plugin-sdk/provider-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile`, `upsertApiKeyProfile`, `writeOAuthCredentials` |
|
||||
| `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, paylaşılan replay-policy oluşturucuları, sağlayıcı uç nokta yardımcıları ve `normalizeNativeXaiModelId` gibi model kimliği normalleştirme yardımcıları |
|
||||
| `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, paylaşılan replay-policy oluşturucuları, sağlayıcı uç nokta yardımcıları ve `normalizeNativeXaiModelId` gibi model-kimliği normalizasyon yardımcıları |
|
||||
| `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
|
||||
| `plugin-sdk/provider-http` | Genel sağlayıcı HTTP/uç nokta yetenek yardımcıları |
|
||||
| `plugin-sdk/provider-web-fetch-contract` | `enablePluginInConfig` ve `WebFetchProviderPlugin` gibi dar web-fetch yapılandırma/seçim sözleşmesi yardımcıları |
|
||||
| `plugin-sdk/provider-web-fetch` | Web-fetch sağlayıcı kayıt/önbellek yardımcıları |
|
||||
| `plugin-sdk/provider-web-search-contract` | `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` ve kapsamlı kimlik bilgisi ayarlayıcıları/getter'ları gibi dar web-search yapılandırma/kimlik bilgisi sözleşmesi yardımcıları |
|
||||
| `plugin-sdk/provider-web-search` | Web-search sağlayıcı kayıt/önbellek/çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini şema temizleme + tanılama ve `resolveXaiModelCompatPatch` / `applyXaiModelCompat` gibi xAI uyumluluk yardımcıları |
|
||||
| `plugin-sdk/provider-web-fetch` | Web-fetch sağlayıcı kaydı/önbellek yardımcıları |
|
||||
| `plugin-sdk/provider-web-search-config-contract` | Plugin-etkinleştirme bağlantısına ihtiyaç duymayan sağlayıcılar için dar web-search yapılandırma/kimlik bilgisi yardımcıları |
|
||||
| `plugin-sdk/provider-web-search-contract` | `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` ve kapsamlı kimlik bilgisi ayarlayıcıları/alıcıları gibi dar web-search yapılandırma/kimlik bilgisi sözleşmesi yardımcıları |
|
||||
| `plugin-sdk/provider-web-search` | Web-search sağlayıcı kaydı/önbellek/çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini şema temizliği + tanılama ve `resolveXaiModelCompatPatch` / `applyXaiModelCompat` gibi xAI uyumluluk yardımcıları |
|
||||
| `plugin-sdk/provider-usage` | `fetchClaudeUsage` ve benzerleri |
|
||||
| `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, stream wrapper türleri ve paylaşılan Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot wrapper yardımcıları |
|
||||
| `plugin-sdk/provider-onboard` | Onboarding yapılandırma yamalama yardımcıları |
|
||||
| `plugin-sdk/global-singleton` | Süreç yerel singleton/map/önbellek yardımcıları |
|
||||
| `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, akış sarmalayıcı türleri ve paylaşılan Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot sarmalayıcı yardımcıları |
|
||||
| `plugin-sdk/provider-onboard` | Onboarding yapılandırma yama yardımcıları |
|
||||
| `plugin-sdk/global-singleton` | Süreç-yerel singleton/map/önbellek yardımcıları |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Auth ve güvenlik alt yolları">
|
||||
| Subpath | Temel dışa aktarımlar |
|
||||
<Accordion title="Kimlik doğrulama ve güvenlik alt yolları">
|
||||
| Alt yol | Temel dışa aktarımlar |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/command-auth` | `resolveControlCommandGate`, komut kayıt yardımcıları, gönderici yetkilendirme yardımcıları |
|
||||
| `plugin-sdk/approval-auth-runtime` | Onaylayıcı çözümleme ve aynı sohbet eylem-auth yardımcıları |
|
||||
| `plugin-sdk/approval-client-runtime` | Native exec onay profili/filtre yardımcıları |
|
||||
| `plugin-sdk/approval-delivery-runtime` | Native onay yeteneği/teslim bağdaştırıcıları |
|
||||
| `plugin-sdk/command-auth` | `resolveControlCommandGate`, komut kayıt yardımcıları, gönderen yetkilendirme yardımcıları |
|
||||
| `plugin-sdk/approval-auth-runtime` | Onaylayıcı çözümleme ve aynı sohbet eylem-kimlik doğrulama yardımcıları |
|
||||
| `plugin-sdk/approval-client-runtime` | Yerel exec onay profili/filtre yardımcıları |
|
||||
| `plugin-sdk/approval-delivery-runtime` | Yerel onay yeteneği/teslim bağdaştırıcıları |
|
||||
| `plugin-sdk/approval-gateway-runtime` | Paylaşılan onay gateway çözümleme yardımcısı |
|
||||
| `plugin-sdk/approval-handler-adapter-runtime` | Sıcak kanal giriş noktaları için hafif native onay bağdaştırıcı yükleme yardımcıları |
|
||||
| `plugin-sdk/approval-handler-adapter-runtime` | Sıcak kanal entrypoint'leri için hafif yerel onay bağdaştırıcısı yükleme yardımcıları |
|
||||
| `plugin-sdk/approval-handler-runtime` | Daha geniş onay işleyici çalışma zamanı yardımcıları; dar bağdaştırıcı/gateway yüzeyleri yeterliyse onları tercih edin |
|
||||
| `plugin-sdk/approval-native-runtime` | Native onay hedefi + hesap bağlama yardımcıları |
|
||||
| `plugin-sdk/approval-native-runtime` | Yerel onay hedefi + hesap bağlama yardımcıları |
|
||||
| `plugin-sdk/approval-reply-runtime` | Exec/plugin onay yanıt payload yardımcıları |
|
||||
| `plugin-sdk/command-auth-native` | Native komut auth + native oturum hedef yardımçıları |
|
||||
| `plugin-sdk/command-auth-native` | Yerel komut kimlik doğrulama + yerel oturum hedefi yardımcıları |
|
||||
| `plugin-sdk/command-detection` | Paylaşılan komut algılama yardımcıları |
|
||||
| `plugin-sdk/command-surface` | Komut gövdesi normalleştirme ve komut yüzeyi yardımcıları |
|
||||
| `plugin-sdk/command-surface` | Komut gövdesi normalizasyonu ve komut yüzeyi yardımcıları |
|
||||
| `plugin-sdk/allow-from` | `formatAllowFromLowercase` |
|
||||
| `plugin-sdk/channel-secret-runtime` | Kanal/plugin secret yüzeyleri için dar secret-contract toplama yardımcıları |
|
||||
| `plugin-sdk/secret-ref-runtime` | Secret-contract/yapılandırma ayrıştırması için dar `coerceSecretRef` ve SecretRef türleme yardımcıları |
|
||||
| `plugin-sdk/security-runtime` | Paylaşılan güven, DM geçitleme, harici içerik ve secret toplama yardımcıları |
|
||||
| `plugin-sdk/ssrf-policy` | Host allowlist ve private-network SSRF ilkesi yardımcıları |
|
||||
| `plugin-sdk/ssrf-runtime` | Pinned-dispatcher, SSRF korumalı fetch ve SSRF ilkesi yardımcıları |
|
||||
| `plugin-sdk/secret-input` | Secret giriş ayrıştırma yardımcıları |
|
||||
| `plugin-sdk/channel-secret-runtime` | Kanal/plugin secret yüzeyleri için dar secret-sözleşmesi toplama yardımcıları |
|
||||
| `plugin-sdk/secret-ref-runtime` | Secret-sözleşmesi/yapılandırma ayrıştırması için dar `coerceSecretRef` ve SecretRef türlendirme yardımcıları |
|
||||
| `plugin-sdk/security-runtime` | Paylaşılan güven, DM geçidi, harici içerik ve secret toplama yardımcıları |
|
||||
| `plugin-sdk/ssrf-policy` | Ana makine izin listesi ve özel ağ SSRF ilkesi yardımcıları |
|
||||
| `plugin-sdk/ssrf-runtime` | Sabitlenmiş dispatcher, SSRF korumalı fetch ve SSRF ilkesi yardımcıları |
|
||||
| `plugin-sdk/secret-input` | Secret girdi ayrıştırma yardımcıları |
|
||||
| `plugin-sdk/webhook-ingress` | Webhook istek/hedef yardımcıları |
|
||||
| `plugin-sdk/webhook-request-guards` | İstek gövdesi boyutu/zaman aşımı yardımcıları |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Çalışma zamanı ve depolama alt yolları">
|
||||
| Subpath | Temel dışa aktarımlar |
|
||||
| Alt yol | Temel dışa aktarımlar |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/runtime` | Geniş çalışma zamanı/günlükleme/yedekleme/plugin kurulum yardımcıları |
|
||||
| `plugin-sdk/runtime-env` | Dar çalışma zamanı env, logger, timeout, retry ve backoff yardımcıları |
|
||||
| `plugin-sdk/runtime` | Geniş çalışma zamanı/günlükleme/yedekleme/plugin-kurulum yardımcıları |
|
||||
| `plugin-sdk/runtime-env` | Dar çalışma zamanı env, logger, zaman aşımı, yeniden deneme ve backoff yardımcıları |
|
||||
| `plugin-sdk/channel-runtime-context` | Genel kanal çalışma zamanı bağlamı kaydı ve arama yardımcıları |
|
||||
| `plugin-sdk/runtime-store` | `createPluginRuntimeStore` |
|
||||
| `plugin-sdk/plugin-runtime` | Paylaşılan plugin komutu/hook/http/etkileşimli yardımcıları |
|
||||
| `plugin-sdk/hook-runtime` | Paylaşılan webhook/dahili hook pipeline yardımcıları |
|
||||
| `plugin-sdk/hook-runtime` | Paylaşılan webhook/dahili hook işlem hattı yardımcıları |
|
||||
| `plugin-sdk/lazy-runtime` | `createLazyRuntimeModule`, `createLazyRuntimeMethod` ve `createLazyRuntimeSurface` gibi tembel çalışma zamanı içe aktarma/bağlama yardımcıları |
|
||||
| `plugin-sdk/process-runtime` | Süreç exec yardımcıları |
|
||||
| `plugin-sdk/cli-runtime` | CLI biçimlendirme, bekleme ve sürüm yardımcıları |
|
||||
| `plugin-sdk/gateway-runtime` | Gateway istemcisi ve kanal durumu yama yardımcıları |
|
||||
| `plugin-sdk/gateway-runtime` | Gateway istemcisi ve kanal durum yaması yardımcıları |
|
||||
| `plugin-sdk/config-runtime` | Yapılandırma yükleme/yazma yardımcıları |
|
||||
| `plugin-sdk/telegram-command-config` | Paketlenmiş Telegram sözleşme yüzeyi mevcut olmasa bile Telegram komut adı/açıklaması normalleştirme ve yineleme/çakışma kontrolleri |
|
||||
| `plugin-sdk/approval-runtime` | Exec/plugin onay yardımcıları, onay yeteneği oluşturucuları, auth/profil yardımcıları, native yönlendirme/çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/reply-runtime` | Paylaşılan inbound/yanıt çalışma zamanı yardımcıları, parçalara ayırma, dispatch, heartbeat, yanıt planlayıcı |
|
||||
| `plugin-sdk/reply-dispatch-runtime` | Dar yanıt dispatch/finalize yardımcıları |
|
||||
| `plugin-sdk/reply-history` | `buildHistoryContext`, `recordPendingHistoryEntry` ve `clearHistoryEntriesIfEnabled` gibi paylaşılan kısa pencereli yanıt geçmişi yardımcıları |
|
||||
| `plugin-sdk/telegram-command-config` | Paketlenmiş Telegram sözleşme yüzeyi kullanılamadığında bile Telegram komut adı/açıklama normalizasyonu ve yinelenen/çakışma denetimleri |
|
||||
| `plugin-sdk/approval-runtime` | Exec/plugin onay yardımcıları, onay-yetenek oluşturucuları, kimlik doğrulama/profil yardımcıları, yerel yönlendirme/çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/reply-runtime` | Paylaşılan gelen/yanıt çalışma zamanı yardımcıları, parçalama, dağıtım, heartbeat, yanıt planlayıcı |
|
||||
| `plugin-sdk/reply-dispatch-runtime` | Dar yanıt dağıtımı/tamamlama yardımcıları |
|
||||
| `plugin-sdk/reply-history` | `buildHistoryContext`, `recordPendingHistoryEntry` ve `clearHistoryEntriesIfEnabled` gibi paylaşılan kısa pencere yanıt geçmişi yardımcıları |
|
||||
| `plugin-sdk/reply-reference` | `createReplyReferencePlanner` |
|
||||
| `plugin-sdk/reply-chunking` | Dar metin/markdown parçalara ayırma yardımcıları |
|
||||
| `plugin-sdk/reply-chunking` | Dar metin/markdown parçalama yardımcıları |
|
||||
| `plugin-sdk/session-store-runtime` | Oturum deposu yolu + updated-at yardımcıları |
|
||||
| `plugin-sdk/state-paths` | Durum/OAuth dizin yolu yardımcıları |
|
||||
| `plugin-sdk/routing` | `resolveAgentRoute`, `buildAgentSessionKey` ve `resolveDefaultAgentBoundAccountId` gibi route/oturum anahtarı/hesap bağlama yardımcıları |
|
||||
| `plugin-sdk/status-helpers` | Paylaşılan kanal/hesap durumu özeti yardımcıları, çalışma zamanı durumu varsayılanları ve sorun metadata yardımcıları |
|
||||
| `plugin-sdk/target-resolver-runtime` | Paylaşılan hedef çözücü yardımcıları |
|
||||
| `plugin-sdk/string-normalization-runtime` | Slug/string normalleştirme yardımcıları |
|
||||
| `plugin-sdk/request-url` | Fetch/istek benzeri girdilerden string URL çıkarma |
|
||||
| `plugin-sdk/routing` | `resolveAgentRoute`, `buildAgentSessionKey` ve `resolveDefaultAgentBoundAccountId` gibi rota/oturum anahtarı/hesap bağlama yardımcıları |
|
||||
| `plugin-sdk/status-helpers` | Paylaşılan kanal/hesap durum özeti yardımcıları, çalışma zamanı durum varsayılanları ve sorun meta verisi yardımcıları |
|
||||
| `plugin-sdk/target-resolver-runtime` | Paylaşılan hedef çözümleyici yardımcıları |
|
||||
| `plugin-sdk/string-normalization-runtime` | Slug/dize normalizasyon yardımcıları |
|
||||
| `plugin-sdk/request-url` | Fetch/istek benzeri girdilerden dize URL'leri çıkarın |
|
||||
| `plugin-sdk/run-command` | Normalleştirilmiş stdout/stderr sonuçlarıyla zamanlanmış komut çalıştırıcı |
|
||||
| `plugin-sdk/param-readers` | Ortak araç/CLI param okurları |
|
||||
| `plugin-sdk/tool-send` | Araç argümanlarından kanonik gönderim hedef alanlarını çıkarma |
|
||||
| `plugin-sdk/param-readers` | Ortak araç/CLI parametre okuyucuları |
|
||||
| `plugin-sdk/tool-payload` | Araç sonuç nesnelerinden normalleştirilmiş payload'ları çıkarın |
|
||||
| `plugin-sdk/tool-send` | Araç bağımsız değişkenlerinden kanonik gönderim hedef alanlarını çıkarın |
|
||||
| `plugin-sdk/temp-path` | Paylaşılan geçici indirme yolu yardımcıları |
|
||||
| `plugin-sdk/logging-core` | Alt sistem logger ve redaction yardımcıları |
|
||||
| `plugin-sdk/markdown-table-runtime` | Markdown tablo kipi yardımcıları |
|
||||
| `plugin-sdk/logging-core` | Alt sistem logger ve redaksiyon yardımcıları |
|
||||
| `plugin-sdk/markdown-table-runtime` | Markdown tablo modu yardımcıları |
|
||||
| `plugin-sdk/json-store` | Küçük JSON durum okuma/yazma yardımcıları |
|
||||
| `plugin-sdk/file-lock` | Yeniden girişli dosya kilidi yardımcıları |
|
||||
| `plugin-sdk/persistent-dedupe` | Disk destekli dedupe önbellek yardımcıları |
|
||||
| `plugin-sdk/acp-runtime` | ACP çalışma zamanı/oturum ve reply-dispatch yardımcıları |
|
||||
| `plugin-sdk/agent-config-primitives` | Dar agent çalışma zamanı yapılandırma şeması primitive'leri |
|
||||
| `plugin-sdk/boolean-param` | Gevşek boolean param okuru |
|
||||
| `plugin-sdk/persistent-dedupe` | Disk destekli yinelenenleri kaldırma önbelleği yardımcıları |
|
||||
| `plugin-sdk/acp-runtime` | ACP çalışma zamanı/oturum ve yanıt dağıtımı yardımcıları |
|
||||
| `plugin-sdk/agent-config-primitives` | Dar agent çalışma zamanı yapılandırma-şeması ilkelleri |
|
||||
| `plugin-sdk/boolean-param` | Gevşek boolean parametre okuyucusu |
|
||||
| `plugin-sdk/dangerous-name-runtime` | Tehlikeli ad eşleme çözümleme yardımcıları |
|
||||
| `plugin-sdk/device-bootstrap` | Cihaz bootstrap ve pairing token yardımcıları |
|
||||
| `plugin-sdk/extension-shared` | Paylaşılan passive-channel, durum ve ambient proxy yardımcı primitive'leri |
|
||||
| `plugin-sdk/device-bootstrap` | Cihaz bootstrap ve eşleştirme token yardımcıları |
|
||||
| `plugin-sdk/extension-shared` | Paylaşılan pasif kanal, durum ve ambient proxy yardımcı ilkelleri |
|
||||
| `plugin-sdk/models-provider-runtime` | `/models` komutu/sağlayıcı yanıt yardımcıları |
|
||||
| `plugin-sdk/skill-commands-runtime` | Skill komutu listeleme yardımcıları |
|
||||
| `plugin-sdk/native-command-registry` | Native komut kayıt/oluşturma/serileştirme yardımcıları |
|
||||
| `plugin-sdk/provider-zai-endpoint` | Z.A.I uç nokta algılama yardımcıları |
|
||||
| `plugin-sdk/skill-commands-runtime` | Skills komut listeleme yardımcıları |
|
||||
| `plugin-sdk/native-command-registry` | Yerel komut kaydı/oluşturma/serileştirme yardımcıları |
|
||||
| `plugin-sdk/provider-zai-endpoint` | Z.AI uç nokta algılama yardımcıları |
|
||||
| `plugin-sdk/infra-runtime` | Sistem olayı/heartbeat yardımcıları |
|
||||
| `plugin-sdk/collection-runtime` | Küçük sınırlı önbellek yardımcıları |
|
||||
| `plugin-sdk/diagnostic-runtime` | Tanılama bayrağı ve olay yardımcıları |
|
||||
| `plugin-sdk/error-runtime` | Hata grafiği, biçimlendirme, paylaşılan hata sınıflandırma yardımcıları, `isApprovalNotFoundError` |
|
||||
| `plugin-sdk/fetch-runtime` | Sarmalanmış fetch, proxy ve pinned lookup yardımcıları |
|
||||
| `plugin-sdk/host-runtime` | Hostname ve SCP host normalleştirme yardımcıları |
|
||||
| `plugin-sdk/retry-runtime` | Retry yapılandırması ve retry çalıştırıcı yardımcıları |
|
||||
| `plugin-sdk/agent-runtime` | Agent dizini/kimlik/çalışma alanı yardımcıları |
|
||||
| `plugin-sdk/directory-runtime` | Yapılandırma destekli dizin sorgusu/dedupe |
|
||||
| `plugin-sdk/fetch-runtime` | Sarılmış fetch, proxy ve sabitlenmiş arama yardımcıları |
|
||||
| `plugin-sdk/host-runtime` | Ana makine adı ve SCP ana makinesi normalizasyon yardımcıları |
|
||||
| `plugin-sdk/retry-runtime` | Yeniden deneme yapılandırması ve yeniden deneme çalıştırıcı yardımcıları |
|
||||
| `plugin-sdk/agent-runtime` | Agent dizini/kimliği/çalışma alanı yardımcıları |
|
||||
| `plugin-sdk/directory-runtime` | Yapılandırma destekli dizin sorgusu/yinelenen kaldırma |
|
||||
| `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Yetenek ve test alt yolları">
|
||||
| Subpath | Temel dışa aktarımlar |
|
||||
| Alt yol | Temel dışa aktarımlar |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/media-runtime` | Paylaşılan medya fetch/dönüştürme/depolama yardımcıları ve medya payload oluşturucuları |
|
||||
| `plugin-sdk/media-runtime` | Medya payload oluşturucularına ek olarak paylaşılan medya getirme/dönüştürme/depolama yardımcıları |
|
||||
| `plugin-sdk/media-generation-runtime` | Paylaşılan medya üretimi failover yardımcıları, aday seçimi ve eksik model mesajları |
|
||||
| `plugin-sdk/media-understanding` | Medya anlama sağlayıcı türleri ve sağlayıcıya dönük görsel/ses yardımcı dışa aktarımları |
|
||||
| `plugin-sdk/text-runtime` | Asistana görünür metin ayıklama, markdown render/parçalara ayırma/tablo yardımcıları, redaction yardımcıları, directive-tag yardımcıları ve güvenli metin yardımcıları gibi paylaşılan metin/markdown/günlükleme yardımcıları |
|
||||
| `plugin-sdk/text-chunking` | Outbound metin parçalara ayırma yardımcısı |
|
||||
| `plugin-sdk/speech` | Speech sağlayıcı türleri ve sağlayıcıya dönük directive, registry ve doğrulama yardımcıları |
|
||||
| `plugin-sdk/speech-core` | Paylaşılan speech sağlayıcı türleri, registry, directive ve normalleştirme yardımcıları |
|
||||
| `plugin-sdk/realtime-transcription` | Realtime transcription sağlayıcı türleri ve registry yardımcıları |
|
||||
| `plugin-sdk/realtime-voice` | Realtime voice sağlayıcı türleri ve registry yardımcıları |
|
||||
| `plugin-sdk/image-generation` | Image generation sağlayıcı türleri |
|
||||
| `plugin-sdk/image-generation-core` | Paylaşılan image-generation türleri, failover, auth ve registry yardımcıları |
|
||||
| `plugin-sdk/music-generation` | Music generation sağlayıcı/istek/sonuç türleri |
|
||||
| `plugin-sdk/music-generation-core` | Paylaşılan music-generation türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma |
|
||||
| `plugin-sdk/video-generation` | Video generation sağlayıcı/istek/sonuç türleri |
|
||||
| `plugin-sdk/video-generation-core` | Paylaşılan video-generation türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma |
|
||||
| `plugin-sdk/webhook-targets` | Webhook hedef kayıt defteri ve route-install yardımcıları |
|
||||
| `plugin-sdk/webhook-path` | Webhook yol normalleştirme yardımcıları |
|
||||
| `plugin-sdk/text-runtime` | Yardımcıya görünür metin temizleme, markdown işleme/parçalama/tablo yardımcıları, redaksiyon yardımcıları, directive-tag yardımcıları ve güvenli metin araçları gibi paylaşılan metin/markdown/günlükleme yardımcıları |
|
||||
| `plugin-sdk/text-chunking` | Giden metin parçalama yardımcısı |
|
||||
| `plugin-sdk/speech` | Konuşma sağlayıcı türleri ile sağlayıcıya dönük directive, kayıt ve doğrulama yardımcıları |
|
||||
| `plugin-sdk/speech-core` | Paylaşılan konuşma sağlayıcı türleri, kayıt, directive ve normalizasyon yardımcıları |
|
||||
| `plugin-sdk/realtime-transcription` | Gerçek zamanlı transcription sağlayıcı türleri ve kayıt yardımcıları |
|
||||
| `plugin-sdk/realtime-voice` | Gerçek zamanlı ses sağlayıcı türleri ve kayıt yardımcıları |
|
||||
| `plugin-sdk/image-generation` | Görsel üretimi sağlayıcı türleri |
|
||||
| `plugin-sdk/image-generation-core` | Paylaşılan görsel üretimi türleri, failover, kimlik doğrulama ve kayıt yardımcıları |
|
||||
| `plugin-sdk/music-generation` | Müzik üretimi sağlayıcı/istek/sonuç türleri |
|
||||
| `plugin-sdk/music-generation-core` | Paylaşılan müzik üretimi türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma |
|
||||
| `plugin-sdk/video-generation` | Video üretimi sağlayıcı/istek/sonuç türleri |
|
||||
| `plugin-sdk/video-generation-core` | Paylaşılan video üretimi türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma |
|
||||
| `plugin-sdk/webhook-targets` | Webhook hedef kaydı ve rota kurulum yardımcıları |
|
||||
| `plugin-sdk/webhook-path` | Webhook yolu normalizasyon yardımcıları |
|
||||
| `plugin-sdk/web-media` | Paylaşılan uzak/yerel medya yükleme yardımcıları |
|
||||
| `plugin-sdk/zod` | Plugin SDK kullanıcıları için yeniden dışa aktarılan `zod` |
|
||||
| `plugin-sdk/zod` | Plugin SDK tüketicileri için yeniden dışa aktarılan `zod` |
|
||||
| `plugin-sdk/testing` | `installCommonResolveTargetErrorCases`, `shouldAckReaction` |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Bellek alt yolları">
|
||||
| Subpath | Temel dışa aktarımlar |
|
||||
<Accordion title="Memory alt yolları">
|
||||
| Alt yol | Temel dışa aktarımlar |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/memory-core` | Manager/config/file/CLI yardımcıları için paketlenmiş memory-core yardımcı yüzeyi |
|
||||
| `plugin-sdk/memory-core-engine-runtime` | Bellek indeksleme/arama çalışma zamanı cephesi |
|
||||
| `plugin-sdk/memory-core-host-engine-foundation` | Bellek host foundation engine dışa aktarımları |
|
||||
| `plugin-sdk/memory-core-host-engine-embeddings` | Bellek host embedding engine dışa aktarımları |
|
||||
| `plugin-sdk/memory-core-host-engine-qmd` | Bellek host QMD engine dışa aktarımları |
|
||||
| `plugin-sdk/memory-core-host-engine-storage` | Bellek host storage engine dışa aktarımları |
|
||||
| `plugin-sdk/memory-core-host-multimodal` | Bellek host multimodal yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-query` | Bellek host sorgu yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-secret` | Bellek host secret yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-events` | Bellek host olay günlüğü yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-status` | Bellek host durum yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-runtime-cli` | Bellek host CLI çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-runtime-core` | Bellek host çekirdek çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-runtime-files` | Bellek host dosya/çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/memory-host-core` | Bellek host çekirdek çalışma zamanı yardımcıları için satıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-host-events` | Bellek host olay günlüğü yardımcıları için satıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-host-files` | Bellek host dosya/çalışma zamanı yardımcıları için satıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-host-markdown` | Belleğe bitişik plugin'ler için paylaşılan yönetilen markdown yardımcıları |
|
||||
| `plugin-sdk/memory-host-search` | Search-manager erişimi için etkin bellek çalışma zamanı cephesi |
|
||||
| `plugin-sdk/memory-host-status` | Bellek host durum yardımcıları için satıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-core` | Yönetici/yapılandırma/dosya/CLI yardımcıları için paketlenmiş memory-core yardımcı yüzeyi |
|
||||
| `plugin-sdk/memory-core-engine-runtime` | Memory dizin/arama çalışma zamanı cephesi |
|
||||
| `plugin-sdk/memory-core-host-engine-foundation` | Memory host foundation engine dışa aktarımları |
|
||||
| `plugin-sdk/memory-core-host-engine-embeddings` | Memory host embedding engine dışa aktarımları |
|
||||
| `plugin-sdk/memory-core-host-engine-qmd` | Memory host QMD engine dışa aktarımları |
|
||||
| `plugin-sdk/memory-core-host-engine-storage` | Memory host storage engine dışa aktarımları |
|
||||
| `plugin-sdk/memory-core-host-multimodal` | Memory host multimodal yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-query` | Memory host sorgu yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-secret` | Memory host secret yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-events` | Memory host olay günlüğü yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-status` | Memory host durum yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-runtime-cli` | Memory host CLI çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-runtime-core` | Memory host çekirdek çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/memory-core-host-runtime-files` | Memory host dosya/çalışma zamanı yardımcıları |
|
||||
| `plugin-sdk/memory-host-core` | Memory host çekirdek çalışma zamanı yardımcıları için satıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-host-events` | Memory host olay günlüğü yardımcıları için satıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-host-files` | Memory host dosya/çalışma zamanı yardımcıları için satıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-host-markdown` | Memory'e bitişik plugin'ler için paylaşılan yönetilen-markdown yardımcıları |
|
||||
| `plugin-sdk/memory-host-search` | Search-manager erişimi için etkin memory çalışma zamanı cephesi |
|
||||
| `plugin-sdk/memory-host-status` | Memory host durum yardımcıları için satıcıdan bağımsız takma ad |
|
||||
| `plugin-sdk/memory-lancedb` | Paketlenmiş memory-lancedb yardımcı yüzeyi |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Ayrılmış paketlenmiş yardımcı alt yollar">
|
||||
| Family | Mevcut alt yollar | Amaçlanan kullanım |
|
||||
<Accordion title="Ayrılmış paketlenmiş-yardımcı alt yolları">
|
||||
| Aile | Mevcut alt yollar | Amaçlanan kullanım |
|
||||
| --- | --- | --- |
|
||||
| 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` | Paketlenmiş browser plugin destek yardımcıları (`browser-support` uyumluluk barrel'i olarak kalır) |
|
||||
| Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Paketlenmiş Matrix yardımcı/çalışma zamanı yüzeyi |
|
||||
| Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Paketlenmiş LINE yardımcı/çalışma zamanı yüzeyi |
|
||||
| IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Paketlenmiş IRC yardımcı yüzeyi |
|
||||
| Kanala özgü yardımcılar | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Paketlenmiş kanal uyumluluk/yardımcı yüzeyleri |
|
||||
| Auth/plugin'e özgü yardımcılar | `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`, `plugin-sdk/voice-call` | Paketlenmiş özellik/plugin yardımcı yüzeyleri; `plugin-sdk/github-copilot-token` şu anda `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` ve `resolveCopilotApiToken` dışa aktarır |
|
||||
| Kanala özel yardımcılar | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Paketlenmiş kanal uyumluluk/yardımcı yüzeyleri |
|
||||
| Kimlik doğrulama/plugin'e özel yardımcılar | `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`, `plugin-sdk/voice-call` | Paketlenmiş özellik/plugin yardımcı yüzeyleri; `plugin-sdk/github-copilot-token` şu anda `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` ve `resolveCopilotApiToken` dışa aktarır |
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Kayıt API'si
|
||||
|
||||
`register(api)` callback'i şu yöntemlere sahip bir `OpenClawPluginApi` nesnesi alır:
|
||||
`register(api)` callback'i şu yöntemlere sahip bir `OpenClawPluginApi` nesnesi
|
||||
alır:
|
||||
|
||||
### Yetenek kaydı
|
||||
|
||||
| Method | Ne kaydeder |
|
||||
| ------------------------------------------------ | ------------------------------ |
|
||||
| `api.registerProvider(...)` | Metin çıkarımı (LLM) |
|
||||
| `api.registerCliBackend(...)` | Yerel CLI çıkarım backend'i |
|
||||
| `api.registerChannel(...)` | Mesajlaşma kanalı |
|
||||
| `api.registerSpeechProvider(...)` | Metinden konuşmaya / STT sentezi |
|
||||
| `api.registerRealtimeTranscriptionProvider(...)` | Akış tabanlı realtime transcription |
|
||||
| `api.registerRealtimeVoiceProvider(...)` | Çift yönlü realtime voice oturumları |
|
||||
| `api.registerMediaUnderstandingProvider(...)` | Görsel/ses/video analizi |
|
||||
| `api.registerImageGenerationProvider(...)` | Görsel üretimi |
|
||||
| `api.registerMusicGenerationProvider(...)` | Müzik üretimi |
|
||||
| `api.registerVideoGenerationProvider(...)` | Video üretimi |
|
||||
| `api.registerWebFetchProvider(...)` | Web fetch / scrape sağlayıcısı |
|
||||
| `api.registerWebSearchProvider(...)` | Web araması |
|
||||
| Yöntem | Kaydettiği şey |
|
||||
| ------------------------------------------------ | -------------------------------- |
|
||||
| `api.registerProvider(...)` | Metin çıkarımı (LLM) |
|
||||
| `api.registerCliBackend(...)` | Yerel CLI çıkarım arka ucu |
|
||||
| `api.registerChannel(...)` | Mesajlaşma kanalı |
|
||||
| `api.registerSpeechProvider(...)` | Metinden sese / STT sentezi |
|
||||
| `api.registerRealtimeTranscriptionProvider(...)` | Akışlı gerçek zamanlı transcription |
|
||||
| `api.registerRealtimeVoiceProvider(...)` | İki yönlü gerçek zamanlı ses oturumları |
|
||||
| `api.registerMediaUnderstandingProvider(...)` | Görsel/ses/video analizi |
|
||||
| `api.registerImageGenerationProvider(...)` | Görsel üretimi |
|
||||
| `api.registerMusicGenerationProvider(...)` | Müzik üretimi |
|
||||
| `api.registerVideoGenerationProvider(...)` | Video üretimi |
|
||||
| `api.registerWebFetchProvider(...)` | Web fetch / scrape sağlayıcısı |
|
||||
| `api.registerWebSearchProvider(...)` | Web arama |
|
||||
|
||||
### Araçlar ve komutlar
|
||||
|
||||
| Method | Ne kaydeder |
|
||||
| ------------------------------- | --------------------------------------------- |
|
||||
| Yöntem | Kaydettiği şey |
|
||||
| ------------------------------- | ----------------------------------------------- |
|
||||
| `api.registerTool(tool, opts?)` | Agent aracı (zorunlu veya `{ optional: true }`) |
|
||||
| `api.registerCommand(def)` | Özel komut (LLM'yi atlar) |
|
||||
| `api.registerCommand(def)` | Özel komut (LLM'yi atlar) |
|
||||
|
||||
### Altyapı
|
||||
|
||||
| Method | Ne kaydeder |
|
||||
| ---------------------------------------------- | ------------------------------------- |
|
||||
| `api.registerHook(events, handler, opts?)` | Olay hook'u |
|
||||
| `api.registerHttpRoute(params)` | Gateway HTTP uç noktası |
|
||||
| `api.registerGatewayMethod(name, handler)` | Gateway RPC yöntemi |
|
||||
| `api.registerCli(registrar, opts?)` | CLI alt komutu |
|
||||
| `api.registerService(service)` | Arka plan hizmeti |
|
||||
| `api.registerInteractiveHandler(registration)` | Etkileşimli işleyici |
|
||||
| `api.registerMemoryPromptSupplement(builder)` | Toplamsal bellek bitişiği istem bölümü |
|
||||
| `api.registerMemoryCorpusSupplement(adapter)` | Toplamsal bellek arama/okuma corpus'u |
|
||||
| Yöntem | Kaydettiği şey |
|
||||
| ---------------------------------------------- | ----------------------------------- |
|
||||
| `api.registerHook(events, handler, opts?)` | Olay hook'u |
|
||||
| `api.registerHttpRoute(params)` | Gateway HTTP uç noktası |
|
||||
| `api.registerGatewayMethod(name, handler)` | Gateway RPC yöntemi |
|
||||
| `api.registerCli(registrar, opts?)` | CLI alt komutu |
|
||||
| `api.registerService(service)` | Arka plan hizmeti |
|
||||
| `api.registerInteractiveHandler(registration)` | Etkileşimli işleyici |
|
||||
| `api.registerMemoryPromptSupplement(builder)` | Ekleyici memory'e bitişik prompt bölümü |
|
||||
| `api.registerMemoryCorpusSupplement(adapter)` | Ekleyici memory arama/okuma derlemi |
|
||||
|
||||
Ayrılmış çekirdek yönetici ad alanları (`config.*`, `exec.approvals.*`, `wizard.*`,
|
||||
`update.*`), bir plugin daha dar bir gateway method scope atamaya çalışsa bile her zaman `operator.admin` olarak kalır. Plugin'e ait yöntemler için plugin'e özgü önekleri tercih edin.
|
||||
Ayrılmış çekirdek yönetici ad alanları (`config.*`, `exec.approvals.*`,
|
||||
`wizard.*`, `update.*`), bir plugin daha dar bir gateway yöntem kapsamı
|
||||
atamaya çalışsa bile her zaman `operator.admin` olarak kalır. Plugin'e ait
|
||||
yöntemler için plugin'e özgü önekleri tercih edin.
|
||||
|
||||
### CLI kayıt metadata'sı
|
||||
### CLI kayıt meta verisi
|
||||
|
||||
`api.registerCli(registrar, opts?)` iki tür üst düzey metadata kabul eder:
|
||||
`api.registerCli(registrar, opts?)` iki tür üst düzey meta veri kabul eder:
|
||||
|
||||
- `commands`: registrar'a ait açık komut kökleri
|
||||
- `descriptors`: kök CLI yardımı,
|
||||
yönlendirme ve tembel plugin CLI kaydı için ayrıştırma zamanında kullanılan komut açıklayıcıları
|
||||
- `commands`: registrar'ın sahip olduğu açık komut kökleri
|
||||
- `descriptors`: kök CLI yardımı, yönlendirme ve tembel plugin CLI kaydı için
|
||||
ayrıştırma zamanı komut tanımlayıcıları
|
||||
|
||||
Bir plugin komutunun normal kök CLI yolunda tembel yüklenmesini istiyorsanız,
|
||||
o registrar tarafından sunulan her üst düzey komut kökünü kapsayan `descriptors` sağlayın.
|
||||
Bir plugin komutunun normal kök CLI yolunda tembel yüklenmiş kalmasını
|
||||
istiyorsanız, bu registrar tarafından açığa çıkarılan her üst düzey komut
|
||||
kökünü kapsayan `descriptors` sağlayın.
|
||||
|
||||
```typescript
|
||||
api.registerCli(
|
||||
@ -362,125 +381,141 @@ api.registerCli(
|
||||
);
|
||||
```
|
||||
|
||||
Kök CLI için tembel kayıt gerekmiyorsa yalnızca `commands` kullanın.
|
||||
Bu hevesli uyumluluk yolu desteklenmeye devam eder, ancak ayrıştırma zamanı tembel yükleme için açıklayıcı destekli yer tutucular kurmaz.
|
||||
Normal kök CLI kaydı için tembel yükleme gerekmiyorsa yalnızca `commands`
|
||||
kullanın. Bu istekli uyumluluk yolu desteklenmeye devam eder, ancak ayrıştırma
|
||||
zamanı tembel yükleme için descriptor destekli yer tutucular kurmaz.
|
||||
|
||||
### CLI backend kaydı
|
||||
### CLI arka uç kaydı
|
||||
|
||||
`api.registerCliBackend(...)`, bir plugin'in `codex-cli` gibi yerel
|
||||
AI CLI backend'i için varsayılan yapılandırmaya sahip olmasını sağlar.
|
||||
`api.registerCliBackend(...)`, bir plugin'in `codex-cli` gibi yerel bir
|
||||
AI CLI arka ucunun varsayılan yapılandırmasına sahip olmasına izin verir.
|
||||
|
||||
- Backend `id`, `codex-cli/gpt-5` gibi model başvurularında sağlayıcı öneki olur.
|
||||
- Backend `config`, `agents.defaults.cliBackends.<id>` ile aynı şekli kullanır.
|
||||
- Kullanıcı yapılandırması yine önceliklidir. OpenClaw, CLI'yi çalıştırmadan önce `agents.defaults.cliBackends.<id>` değerini
|
||||
plugin varsayılanının üzerine birleştirir.
|
||||
- Backend'in birleştirmeden sonra uyumluluk yeniden yazımları gerektirdiği durumlarda
|
||||
(örneğin eski flag şekillerini normalleştirme) `normalizeConfig` kullanın.
|
||||
- Arka uç `id`, `codex-cli/gpt-5` gibi model ref'lerinde sağlayıcı öneki olur.
|
||||
- Arka uç `config`, `agents.defaults.cliBackends.<id>` ile aynı şekli kullanır.
|
||||
- Kullanıcı yapılandırması yine önceliklidir. OpenClaw, CLI'yi çalıştırmadan
|
||||
önce plugin varsayılanı üzerine `agents.defaults.cliBackends.<id>` değerini
|
||||
birleştirir.
|
||||
- Bir arka uç birleştirmeden sonra uyumluluk yeniden yazımları gerektiriyorsa
|
||||
`normalizeConfig` kullanın (örneğin eski bayrak şekillerini normalize etmek
|
||||
için).
|
||||
|
||||
### Özel yuvalar
|
||||
### Münhasır yuvalar
|
||||
|
||||
| Method | Ne kaydeder |
|
||||
| ------------------------------------------ | ----------------------------------- |
|
||||
| `api.registerContextEngine(id, factory)` | Bağlam motoru (aynı anda bir etkin) |
|
||||
| `api.registerMemoryCapability(capability)` | Birleşik bellek yeteneği |
|
||||
| `api.registerMemoryPromptSection(builder)` | Bellek istem bölümü oluşturucusu |
|
||||
| `api.registerMemoryFlushPlan(resolver)` | Bellek flush planı çözücüsü |
|
||||
| `api.registerMemoryRuntime(runtime)` | Bellek çalışma zamanı bağdaştırıcısı |
|
||||
| Yöntem | Kaydettiği şey |
|
||||
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| `api.registerContextEngine(id, factory)` | Bağlam motoru (aynı anda yalnızca biri etkin). `assemble()` callback'i, motorun prompt eklemelerini uyarlayabilmesi için `availableTools` ve `citationsMode` alır. |
|
||||
| `api.registerMemoryCapability(capability)` | Birleşik memory yeteneği |
|
||||
| `api.registerMemoryPromptSection(builder)` | Memory prompt bölümü oluşturucusu |
|
||||
| `api.registerMemoryFlushPlan(resolver)` | Memory flush planı çözümleyicisi |
|
||||
| `api.registerMemoryRuntime(runtime)` | Memory çalışma zamanı bağdaştırıcısı |
|
||||
|
||||
### Bellek embedding bağdaştırıcıları
|
||||
### Memory embedding bağdaştırıcıları
|
||||
|
||||
| Method | Ne kaydeder |
|
||||
| ---------------------------------------------- | ------------------------------------------- |
|
||||
| `api.registerMemoryEmbeddingProvider(adapter)` | Etkin plugin için bellek embedding bağdaştırıcısı |
|
||||
| Yöntem | Kaydettiği şey |
|
||||
| ---------------------------------------------- | ---------------------------------------------- |
|
||||
| `api.registerMemoryEmbeddingProvider(adapter)` | Etkin plugin için memory embedding bağdaştırıcısı |
|
||||
|
||||
- `registerMemoryCapability`, tercih edilen özel bellek-plugin API'sidir.
|
||||
- `registerMemoryCapability`, eşlik eden plugin'lerin dışa aktarılan bellek artifact'lerini
|
||||
belirli bir bellek plugin'inin özel düzenine erişmeden `openclaw/plugin-sdk/memory-host-core` üzerinden tüketebilmesi için `publicArtifacts.listArtifacts(...)`
|
||||
de sunabilir.
|
||||
- `registerMemoryCapability`, tercih edilen münhasır memory-plugin API'sidir.
|
||||
- `registerMemoryCapability`, eşlik eden plugin'lerin dışa aktarılan memory
|
||||
yapılarını belirli bir memory plugin'inin özel düzenine ulaşmadan
|
||||
`openclaw/plugin-sdk/memory-host-core` üzerinden tüketebilmesi için
|
||||
`publicArtifacts.listArtifacts(...)` da sunabilir.
|
||||
- `registerMemoryPromptSection`, `registerMemoryFlushPlan` ve
|
||||
`registerMemoryRuntime`, eskiyle uyumlu özel bellek-plugin API'leridir.
|
||||
- `registerMemoryEmbeddingProvider`, etkin bellek plugin'inin bir
|
||||
veya daha fazla embedding bağdaştırıcı kimliği kaydetmesine izin verir (örneğin `openai`, `gemini` veya plugin tarafından tanımlanan özel bir kimlik).
|
||||
`registerMemoryRuntime`, eskiyle uyumlu münhasır memory-plugin API'leridir.
|
||||
- `registerMemoryEmbeddingProvider`, etkin memory plugin'inin bir veya daha
|
||||
fazla embedding bağdaştırıcısı kimliği kaydetmesine izin verir (örneğin
|
||||
`openai`, `gemini` veya özel plugin tanımlı bir kimlik).
|
||||
- `agents.defaults.memorySearch.provider` ve
|
||||
`agents.defaults.memorySearch.fallback` gibi kullanıcı yapılandırmaları bu kayıtlı
|
||||
bağdaştırıcı kimliklerine göre çözülür.
|
||||
`agents.defaults.memorySearch.fallback` gibi kullanıcı yapılandırmaları, bu
|
||||
kaydedilmiş bağdaştırıcı kimliklerine göre çözülür.
|
||||
|
||||
### Olaylar ve yaşam döngüsü
|
||||
|
||||
| Method | Ne yapar |
|
||||
| -------------------------------------------- | ---------------------------- |
|
||||
| `api.on(hookName, handler, opts?)` | Türlenmiş yaşam döngüsü hook'u |
|
||||
| `api.onConversationBindingResolved(handler)` | Konuşma binding callback'i |
|
||||
| Yöntem | Yaptığı şey |
|
||||
| -------------------------------------------- | ----------------------------- |
|
||||
| `api.on(hookName, handler, opts?)` | Tiplenmiş yaşam döngüsü hook'u |
|
||||
| `api.onConversationBindingResolved(handler)` | Konuşma bağlama callback'i |
|
||||
|
||||
### Hook karar semantiği
|
||||
|
||||
- `before_tool_call`: `{ block: true }` döndürmek sonlandırıcıdır. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır.
|
||||
- `before_tool_call`: `{ block: false }` döndürmek karar yok olarak değerlendirilir (`block` alanını vermemekle aynı), geçersiz kılma sayılmaz.
|
||||
- `before_install`: `{ block: true }` döndürmek sonlandırıcıdır. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır.
|
||||
- `before_install`: `{ block: false }` döndürmek karar yok olarak değerlendirilir (`block` alanını vermemekle aynı), geçersiz kılma sayılmaz.
|
||||
- `reply_dispatch`: `{ handled: true, ... }` döndürmek sonlandırıcıdır. Herhangi bir işleyici dispatch'i sahiplendiğinde, daha düşük öncelikli işleyiciler ve varsayılan model dispatch yolu atlanır.
|
||||
- `message_sending`: `{ cancel: true }` döndürmek sonlandırıcıdır. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır.
|
||||
- `message_sending`: `{ cancel: false }` döndürmek karar yok olarak değerlendirilir (`cancel` alanını vermemekle aynı), geçersiz kılma sayılmaz.
|
||||
- `before_tool_call`: `{ block: true }` döndürmek kesindir. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır.
|
||||
- `before_tool_call`: `{ block: false }` döndürmek karar yok olarak değerlendirilir (`block` alanını hiç vermemekle aynıdır), geçersiz kılma olarak değil.
|
||||
- `before_install`: `{ block: true }` döndürmek kesindir. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır.
|
||||
- `before_install`: `{ block: false }` döndürmek karar yok olarak değerlendirilir (`block` alanını hiç vermemekle aynıdır), geçersiz kılma olarak değil.
|
||||
- `reply_dispatch`: `{ handled: true, ... }` döndürmek kesindir. Herhangi bir işleyici dağıtımı sahiplendiğinde, daha düşük öncelikli işleyiciler ve varsayılan model dağıtım yolu atlanır.
|
||||
- `message_sending`: `{ cancel: true }` döndürmek kesindir. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır.
|
||||
- `message_sending`: `{ cancel: false }` döndürmek karar yok olarak değerlendirilir (`cancel` alanını hiç vermemekle aynıdır), geçersiz kılma olarak değil.
|
||||
|
||||
### API nesnesi alanları
|
||||
|
||||
| Field | Type | Açıklama |
|
||||
| ------------------------ | ------------------------- | ------------------------------------------------------------------------------------------ |
|
||||
| `api.id` | `string` | Plugin kimliği |
|
||||
| `api.name` | `string` | Görünen ad |
|
||||
| `api.version` | `string?` | Plugin sürümü (isteğe bağlı) |
|
||||
| `api.description` | `string?` | Plugin açıklaması (isteğe bağlı) |
|
||||
| `api.source` | `string` | Plugin kaynak yolu |
|
||||
| `api.rootDir` | `string?` | Plugin kök dizini (isteğe bağlı) |
|
||||
| `api.config` | `OpenClawConfig` | Geçerli yapılandırma anlık görüntüsü (varsa etkin bellek içi çalışma zamanı anlık görüntüsü) |
|
||||
| `api.pluginConfig` | `Record<string, unknown>` | `plugins.entries.<id>.config` altındaki plugin'e özgü yapılandırma |
|
||||
| `api.runtime` | `PluginRuntime` | [Çalışma zamanı yardımcıları](/tr/plugins/sdk-runtime) |
|
||||
| `api.logger` | `PluginLogger` | Kapsamlı logger (`debug`, `info`, `warn`, `error`) |
|
||||
| `api.registrationMode` | `PluginRegistrationMode` | Geçerli yükleme kipi; `"setup-runtime"` tam giriş öncesi hafif başlangıç/kurulum penceresidir |
|
||||
| `api.resolvePath(input)` | `(string) => string` | Plugin köküne göre yolu çözümle |
|
||||
| Alan | Tür | Açıklama |
|
||||
| ----------------------- | ------------------------- | ----------------------------------------------------------------------------------------- |
|
||||
| `api.id` | `string` | Plugin kimliği |
|
||||
| `api.name` | `string` | Görünen ad |
|
||||
| `api.version` | `string?` | Plugin sürümü (isteğe bağlı) |
|
||||
| `api.description` | `string?` | Plugin açıklaması (isteğe bağlı) |
|
||||
| `api.source` | `string` | Plugin kaynak yolu |
|
||||
| `api.rootDir` | `string?` | Plugin kök dizini (isteğe bağlı) |
|
||||
| `api.config` | `OpenClawConfig` | Geçerli yapılandırma anlık görüntüsü (mevcutsa etkin bellek içi çalışma zamanı anlık görüntüsü) |
|
||||
| `api.pluginConfig` | `Record<string, unknown>` | `plugins.entries.<id>.config` içinden plugin'e özgü yapılandırma |
|
||||
| `api.runtime` | `PluginRuntime` | [Çalışma zamanı yardımcıları](/tr/plugins/sdk-runtime) |
|
||||
| `api.logger` | `PluginLogger` | Kapsamlı logger (`debug`, `info`, `warn`, `error`) |
|
||||
| `api.registrationMode` | `PluginRegistrationMode` | Geçerli yükleme modu; `"setup-runtime"` hafif, tam entry öncesi başlatma/kurulum penceresidir |
|
||||
| `api.resolvePath(input)` | `(string) => string` | Yolu plugin köküne göre çözümleyin |
|
||||
|
||||
## Dahili modül kuralı
|
||||
|
||||
Plugin'inizde, dahili içe aktarmalar için yerel barrel dosyaları kullanın:
|
||||
Plugin'iniz içinde, dahili içe aktarmalar için yerel barrel dosyaları kullanın:
|
||||
|
||||
```
|
||||
my-plugin/
|
||||
api.ts # Harici tüketiciler için genel dışa aktarımlar
|
||||
api.ts # Harici tüketiciler için herkese açık dışa aktarımlar
|
||||
runtime-api.ts # Yalnızca dahili çalışma zamanı dışa aktarımları
|
||||
index.ts # Plugin giriş noktası
|
||||
setup-entry.ts # Yalnızca hafif kurulum girişi (isteğe bağlı)
|
||||
index.ts # Plugin entry point
|
||||
setup-entry.ts # Yalnızca hafif kurulum entry'si (isteğe bağlı)
|
||||
```
|
||||
|
||||
<Warning>
|
||||
Üretim kodunda kendi plugin'inizi `openclaw/plugin-sdk/<your-plugin>`
|
||||
üzerinden asla içe aktarmayın. Dahili içe aktarmaları `./api.ts` veya
|
||||
`./runtime-api.ts` üzerinden yönlendirin. SDK yolu yalnızca harici sözleşmedir.
|
||||
Üretim kodunda kendi plugin'inizi asla `openclaw/plugin-sdk/<your-plugin>`
|
||||
üzerinden içe aktarmayın. Dahili içe aktarmaları `./api.ts` veya
|
||||
`./runtime-api.ts` üzerinden yönlendirin. SDK yolu yalnızca harici
|
||||
sözleşmedir.
|
||||
</Warning>
|
||||
|
||||
Facade ile yüklenen paketlenmiş plugin genel yüzeyleri (`api.ts`, `runtime-api.ts`,
|
||||
`index.ts`, `setup-entry.ts` ve benzeri genel giriş dosyaları) artık OpenClaw zaten çalışıyorsa etkin çalışma zamanı yapılandırma anlık görüntüsünü tercih eder. Henüz çalışma zamanı anlık görüntüsü yoksa, disk üzerindeki çözülmüş yapılandırma dosyasına geri dönerler.
|
||||
Cephe üzerinden yüklenen paketlenmiş plugin herkese açık yüzeyleri (`api.ts`,
|
||||
`runtime-api.ts`, `index.ts`, `setup-entry.ts` ve benzer herkese açık entry
|
||||
dosyaları), OpenClaw zaten çalışıyorsa artık etkin çalışma zamanı yapılandırma
|
||||
anlık görüntüsünü tercih eder. Henüz çalışma zamanı anlık görüntüsü yoksa,
|
||||
diskteki çözülmüş yapılandırma dosyasına geri dönerler.
|
||||
|
||||
Sağlayıcı plugin'leri ayrıca, bir yardımcı kasıtlı olarak sağlayıcıya özgüyse ve henüz genel bir SDK alt yoluna ait değilse, dar bir plugin'e yerel sözleşme barrel dosyası da sunabilir. Güncel paketlenmiş örnek: Anthropic sağlayıcısı, Anthropic beta-header ve `service_tier` mantığını genel bir
|
||||
`plugin-sdk/*` sözleşmesine yükseltmek yerine Claude stream yardımcılarını kendi genel `api.ts` / `contract-api.ts` yüzeyinde tutar.
|
||||
Sağlayıcı plugin'leri, bir yardımcı bilinçli olarak sağlayıcıya özelse ve henüz
|
||||
genel bir SDK alt yoluna ait değilse dar bir plugin-yerel sözleşme barrel'i de
|
||||
sunabilir. Mevcut paketlenmiş örnek: Anthropic sağlayıcısı, Anthropic beta
|
||||
başlığı ve `service_tier` mantığını genel bir `plugin-sdk/*` sözleşmesine
|
||||
taşımak yerine Claude akış yardımcılarını kendi herkese açık `api.ts` /
|
||||
`contract-api.ts` yüzeyinde tutar.
|
||||
|
||||
Diğer güncel paketlenmiş örnekler:
|
||||
Diğer mevcut paketlenmiş örnekler:
|
||||
|
||||
- `@openclaw/openai-provider`: `api.ts`, sağlayıcı oluşturucularını,
|
||||
varsayılan model yardımcılarını ve realtime sağlayıcı oluşturucularını dışa aktarır
|
||||
- `@openclaw/openrouter-provider`: `api.ts`, sağlayıcı oluşturucusunu ve
|
||||
varsayılan model yardımcılarını ve gerçek zamanlı sağlayıcı oluşturucularını
|
||||
dışa aktarır
|
||||
- `@openclaw/openrouter-provider`: `api.ts`, sağlayıcı oluşturucuyu ve
|
||||
onboarding/yapılandırma yardımcılarını dışa aktarır
|
||||
|
||||
<Warning>
|
||||
Extension üretim kodu ayrıca `openclaw/plugin-sdk/<other-plugin>`
|
||||
içe aktarmalarından da kaçınmalıdır. Bir yardımcı gerçekten paylaşılıyorsa,
|
||||
iki plugin'i birbirine bağlamak yerine bunu `openclaw/plugin-sdk/speech`, `.../provider-model-shared` veya başka bir yetenek odaklı yüzey gibi nötr bir SDK alt yoluna yükseltin.
|
||||
Extension üretim kodu ayrıca `openclaw/plugin-sdk/<other-plugin>` içe
|
||||
aktarmalarından da kaçınmalıdır. Bir yardımcı gerçekten paylaşılıyorsa, iki
|
||||
plugin'i birbirine bağlamak yerine onu `openclaw/plugin-sdk/speech`,
|
||||
`.../provider-model-shared` veya başka bir yetenek odaklı yüzey gibi tarafsız
|
||||
bir SDK alt yoluna taşıyın.
|
||||
</Warning>
|
||||
|
||||
## İlgili
|
||||
|
||||
- [Giriş Noktaları](/tr/plugins/sdk-entrypoints) — `definePluginEntry` ve `defineChannelPluginEntry` seçenekleri
|
||||
- [Entry Points](/tr/plugins/sdk-entrypoints) — `definePluginEntry` ve `defineChannelPluginEntry` seçenekleri
|
||||
- [Çalışma Zamanı Yardımcıları](/tr/plugins/sdk-runtime) — tam `api.runtime` ad alanı başvurusu
|
||||
- [Kurulum ve Yapılandırma](/tr/plugins/sdk-setup) — paketleme, manifest'ler, yapılandırma şemaları
|
||||
- [Test](/tr/plugins/sdk-testing) — test yardımcıları ve lint kuralları
|
||||
- [Kurulum ve Yapılandırma](/tr/plugins/sdk-setup) — paketleme, manifestler, yapılandırma şemaları
|
||||
- [Test](/tr/plugins/sdk-testing) — test araçları ve lint kuralları
|
||||
- [SDK Geçişi](/tr/plugins/sdk-migration) — kullanımdan kaldırılmış yüzeylerden geçiş
|
||||
- [Plugin İç Yapısı](/tr/plugins/architecture) — derin mimari ve yetenek modeli
|
||||
|
||||
@ -2,13 +2,13 @@
|
||||
read_when:
|
||||
- OpenClaw ile Google Gemini modellerini kullanmak istiyorsunuz
|
||||
- API anahtarı veya OAuth kimlik doğrulama akışına ihtiyacınız var
|
||||
summary: Google Gemini kurulumu (API anahtarı + OAuth, görüntü oluşturma, medya anlama, web araması)
|
||||
summary: Google Gemini kurulumu (API anahtarı + OAuth, görsel oluşturma, medya anlama, web arama)
|
||||
title: Google (Gemini)
|
||||
x-i18n:
|
||||
generated_at: "2026-04-08T02:17:14Z"
|
||||
generated_at: "2026-04-08T08:43:24Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: e9e558f5ce35c853e0240350be9a1890460c5f7f7fd30b05813a656497dee516
|
||||
source_hash: fad2ff68987301bd86145fa6e10de8c7b38d5bd5dbcd13db9c883f7f5b9a4e01
|
||||
source_path: providers/google.md
|
||||
workflow: 15
|
||||
---
|
||||
@ -16,7 +16,7 @@ x-i18n:
|
||||
# Google (Gemini)
|
||||
|
||||
Google eklentisi, Google AI Studio üzerinden Gemini modellerine erişim sağlar; ayrıca
|
||||
Gemini Grounding aracılığıyla görüntü oluşturma, medya anlama (görüntü/ses/video) ve web aramasını da destekler.
|
||||
Gemini Grounding aracılığıyla görsel oluşturma, medya anlama (görsel/ses/video) ve web aramayı da destekler.
|
||||
|
||||
- Sağlayıcı: `google`
|
||||
- Kimlik doğrulama: `GEMINI_API_KEY` veya `GOOGLE_API_KEY`
|
||||
@ -56,11 +56,11 @@ openclaw onboard --non-interactive \
|
||||
|
||||
Alternatif bir sağlayıcı olan `google-gemini-cli`, API anahtarı yerine PKCE OAuth kullanır.
|
||||
Bu resmi olmayan bir entegrasyondur; bazı kullanıcılar hesap
|
||||
kısıtlamaları bildirmektedir. Riski size ait olmak üzere kullanın.
|
||||
kısıtlamaları bildirmektedir. Riski size ait olacak şekilde kullanın.
|
||||
|
||||
- Varsayılan model: `google-gemini-cli/gemini-3-flash-preview`
|
||||
- Takma ad: `gemini-cli`
|
||||
- Kurulum önkoşulu: yerel Gemini CLI `gemini` olarak kullanılabilir olmalıdır
|
||||
- Kurulum önkoşulu: yerel Gemini CLI'ın `gemini` olarak kullanılabilir olması
|
||||
- Homebrew: `brew install gemini-cli`
|
||||
- npm: `npm install -g @google/gemini-cli`
|
||||
- Giriş:
|
||||
@ -76,34 +76,37 @@ Ortam değişkenleri:
|
||||
|
||||
(Veya `GEMINI_CLI_*` varyantları.)
|
||||
|
||||
Gemini CLI OAuth istekleri girişten sonra başarısız olursa,
|
||||
Giriş yaptıktan sonra Gemini CLI OAuth istekleri başarısız olursa,
|
||||
gateway host üzerinde `GOOGLE_CLOUD_PROJECT` veya `GOOGLE_CLOUD_PROJECT_ID` ayarlayın ve
|
||||
yeniden deneyin.
|
||||
|
||||
Giriş, tarayıcı akışı başlamadan önce başarısız olursa, yerel `gemini`
|
||||
Tarayıcı akışı başlamadan önce giriş başarısız olursa, yerel `gemini`
|
||||
komutunun kurulu olduğundan ve `PATH` üzerinde bulunduğundan emin olun. OpenClaw hem Homebrew kurulumlarını
|
||||
hem de genel npm kurulumlarını, yaygın Windows/npm düzenleri dahil, destekler.
|
||||
hem de genel npm kurulumlarını destekler; buna yaygın Windows/npm düzenleri de dahildir.
|
||||
|
||||
Gemini CLI JSON kullanım notları:
|
||||
|
||||
- Yanıt metni CLI JSON `response` alanından gelir.
|
||||
- CLI `usage` alanını boş bıraktığında kullanım `stats` değerine geri döner.
|
||||
- `stats.cached`, OpenClaw `cacheRead` değerine normalize edilir.
|
||||
- `stats.input` eksikse OpenClaw giriş tokenlarını
|
||||
- Yanıt metni, CLI JSON içindeki `response` alanından gelir.
|
||||
- CLI `usage` alanını boş bıraktığında kullanım, `stats` alanına geri döner.
|
||||
- `stats.cached`, OpenClaw `cacheRead` içine normalize edilir.
|
||||
- `stats.input` eksikse OpenClaw, giriş tokenlerini
|
||||
`stats.input_tokens - stats.cached` değerinden türetir.
|
||||
|
||||
## Yetenekler
|
||||
|
||||
| Yetenek | Destekleniyor |
|
||||
| --------------------- | ----------------- |
|
||||
| Sohbet tamamlamaları | Evet |
|
||||
| Görüntü oluşturma | Evet |
|
||||
| Müzik oluşturma | Evet |
|
||||
| Görüntü anlama | Evet |
|
||||
| Ses transkripsiyonu | Evet |
|
||||
| Video anlama | Evet |
|
||||
| Web araması (Grounding) | Evet |
|
||||
| Thinking/reasoning | Evet (Gemini 3.1+) |
|
||||
| Yetenek | Destekleniyor |
|
||||
| ---------------------- | ----------------- |
|
||||
| Sohbet tamamlamaları | Evet |
|
||||
| Görsel oluşturma | Evet |
|
||||
| Müzik oluşturma | Evet |
|
||||
| Görsel anlama | Evet |
|
||||
| Ses dökümü | Evet |
|
||||
| Video anlama | Evet |
|
||||
| Web arama (Grounding) | Evet |
|
||||
| Düşünme/muhakeme | Evet (Gemini 3.1+) |
|
||||
| Gemma 4 modelleri | Evet |
|
||||
|
||||
Gemma 4 modelleri (örneğin `gemma-4-26b-a4b-it`) düşünme modunu destekler. OpenClaw, Gemma 4 için `thinkingBudget` değerini desteklenen bir Google `thinkingLevel` değerine yeniden yazar. Düşünmeyi `off` olarak ayarlamak, bunu `MINIMAL` değerine eşlemek yerine düşünmenin devre dışı kalmasını korur.
|
||||
|
||||
## Doğrudan Gemini önbellek yeniden kullanımı
|
||||
|
||||
@ -112,10 +115,10 @@ yapılandırılmış bir `cachedContent` tanıtıcısını Gemini isteklerine il
|
||||
|
||||
- Model başına veya genel parametreleri
|
||||
`cachedContent` ya da eski `cached_content` ile yapılandırın
|
||||
- Her ikisi de varsa `cachedContent` önceliklidir
|
||||
- İkisi de varsa `cachedContent` önceliklidir
|
||||
- Örnek değer: `cachedContents/prebuilt-context`
|
||||
- Gemini önbellek isabeti kullanımı, üst akıştaki `cachedContentTokenCount` değerinden
|
||||
OpenClaw `cacheRead` alanına normalize edilir
|
||||
- Gemini önbellek isabeti kullanımı, yukarı akıştaki `cachedContentTokenCount` değerinden
|
||||
OpenClaw `cacheRead` içine normalize edilir
|
||||
|
||||
Örnek:
|
||||
|
||||
@ -135,21 +138,21 @@ yapılandırılmış bir `cachedContent` tanıtıcısını Gemini isteklerine il
|
||||
}
|
||||
```
|
||||
|
||||
## Görüntü oluşturma
|
||||
## Görsel oluşturma
|
||||
|
||||
Paketlenmiş `google` görüntü oluşturma sağlayıcısı varsayılan olarak
|
||||
Paketle gelen `google` görsel oluşturma sağlayıcısı varsayılan olarak
|
||||
`google/gemini-3.1-flash-image-preview` kullanır.
|
||||
|
||||
- Ayrıca `google/gemini-3-pro-image-preview` desteklenir
|
||||
- Oluşturma: istek başına en fazla 4 görüntü
|
||||
- Düzenleme modu: etkin, en fazla 5 giriş görüntüsü
|
||||
- Ayrıca `google/gemini-3-pro-image-preview` da desteklenir
|
||||
- Oluşturma: istek başına en fazla 4 görsel
|
||||
- Düzenleme modu: etkin, en fazla 5 giriş görseli
|
||||
- Geometri denetimleri: `size`, `aspectRatio` ve `resolution`
|
||||
|
||||
Yalnızca OAuth kullanan `google-gemini-cli` sağlayıcısı ayrı bir metin çıkarımı
|
||||
yüzeyidir. Görüntü oluşturma, medya anlama ve Gemini Grounding
|
||||
`google` sağlayıcı kimliği üzerinde kalır.
|
||||
yüzeyidir. Görsel oluşturma, medya anlama ve Gemini Grounding
|
||||
`google` sağlayıcı kimliğinde kalır.
|
||||
|
||||
Google'ı varsayılan görüntü sağlayıcısı olarak kullanmak için:
|
||||
Google'ı varsayılan görsel sağlayıcısı olarak kullanmak için:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -164,15 +167,15 @@ Google'ı varsayılan görüntü sağlayıcısı olarak kullanmak için:
|
||||
```
|
||||
|
||||
Paylaşılan araç
|
||||
parametreleri, sağlayıcı seçimi ve yük devretme davranışı için [Görüntü Oluşturma](/tr/tools/image-generation) bölümüne bakın.
|
||||
parametreleri, sağlayıcı seçimi ve devralma davranışı için [Görsel Oluşturma](/tr/tools/image-generation) bölümüne bakın.
|
||||
|
||||
## Video oluşturma
|
||||
|
||||
Paketlenmiş `google` eklentisi ayrıca paylaşılan
|
||||
`video_generate` aracı üzerinden video oluşturmayı kaydeder.
|
||||
Paketle gelen `google` eklentisi, paylaşılan
|
||||
`video_generate` aracı üzerinden video oluşturmayı da kaydeder.
|
||||
|
||||
- Varsayılan video modeli: `google/veo-3.1-fast-generate-preview`
|
||||
- Modlar: metinden videoya, görüntüden videoya ve tek videolu referans akışları
|
||||
- Modlar: metinden videoya, görselden videoya ve tek video referans akışları
|
||||
- `aspectRatio`, `resolution` ve `audio` desteklenir
|
||||
- Mevcut süre sınırı: **4 ila 8 saniye**
|
||||
|
||||
@ -191,19 +194,19 @@ Google'ı varsayılan video sağlayıcısı olarak kullanmak için:
|
||||
```
|
||||
|
||||
Paylaşılan araç
|
||||
parametreleri, sağlayıcı seçimi ve yük devretme davranışı için [Video Oluşturma](/tr/tools/video-generation) bölümüne bakın.
|
||||
parametreleri, sağlayıcı seçimi ve devralma davranışı için [Video Oluşturma](/tr/tools/video-generation) bölümüne bakın.
|
||||
|
||||
## Müzik oluşturma
|
||||
|
||||
Paketlenmiş `google` eklentisi ayrıca paylaşılan
|
||||
`music_generate` aracı üzerinden müzik oluşturmayı kaydeder.
|
||||
Paketle gelen `google` eklentisi, paylaşılan
|
||||
`music_generate` aracı üzerinden müzik oluşturmayı da kaydeder.
|
||||
|
||||
- Varsayılan müzik modeli: `google/lyria-3-clip-preview`
|
||||
- Ayrıca `google/lyria-3-pro-preview` desteklenir
|
||||
- Komut denetimleri: `lyrics` ve `instrumental`
|
||||
- Ayrıca `google/lyria-3-pro-preview` da desteklenir
|
||||
- İstem denetimleri: `lyrics` ve `instrumental`
|
||||
- Çıkış biçimi: varsayılan olarak `mp3`, ayrıca `google/lyria-3-pro-preview` üzerinde `wav`
|
||||
- Referans girdileri: en fazla 10 görüntü
|
||||
- Oturum destekli çalıştırmalar, `action: "status"` dahil olmak üzere paylaşılan görev/durum akışı üzerinden ayrılır
|
||||
- Referans girdileri: en fazla 10 görsel
|
||||
- Oturum destekli çalıştırmalar, `action: "status"` dahil olmak üzere paylaşılan görev/durum akışı üzerinden ayrıştırılır
|
||||
|
||||
Google'ı varsayılan müzik sağlayıcısı olarak kullanmak için:
|
||||
|
||||
@ -220,10 +223,10 @@ Google'ı varsayılan müzik sağlayıcısı olarak kullanmak için:
|
||||
```
|
||||
|
||||
Paylaşılan araç
|
||||
parametreleri, sağlayıcı seçimi ve yük devretme davranışı için [Müzik Oluşturma](/tr/tools/music-generation) bölümüne bakın.
|
||||
parametreleri, sağlayıcı seçimi ve devralma davranışı için [Müzik Oluşturma](/tr/tools/music-generation) bölümüne bakın.
|
||||
|
||||
## Ortam notu
|
||||
|
||||
Gateway bir daemon olarak çalışıyorsa (launchd/systemd), `GEMINI_API_KEY`
|
||||
değerinin bu sürece erişilebilir olduğundan emin olun (örneğin `~/.openclaw/.env` içinde veya
|
||||
değerinin bu süreç için kullanılabilir olduğundan emin olun (örneğin `~/.openclaw/.env` içinde veya
|
||||
`env.shellEnv` aracılığıyla).
|
||||
|
||||
@ -1,43 +1,43 @@
|
||||
---
|
||||
read_when:
|
||||
- OpenClaw'ı Ollama üzerinden bulut veya yerel modellerle çalıştırmak istiyorsunuz
|
||||
- Ollama kurulumu ve yapılandırma rehberine ihtiyacınız var
|
||||
- Ollama kurulumu ve yapılandırması konusunda rehberliğe ihtiyacınız var
|
||||
summary: OpenClaw'ı Ollama ile çalıştırın (bulut ve yerel modeller)
|
||||
title: Ollama
|
||||
x-i18n:
|
||||
generated_at: "2026-04-08T02:18:18Z"
|
||||
generated_at: "2026-04-08T08:43:38Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 222ec68f7d4bb29cc7796559ddef1d5059f5159e7a51e2baa3a271ddb3abb716
|
||||
source_hash: d3295a7c879d3636a2ffdec05aea6e670e54a990ef52bd9b0cae253bc24aa3f7
|
||||
source_path: providers/ollama.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Ollama
|
||||
|
||||
Ollama, makinenizde açık kaynaklı modeller çalıştırmayı kolaylaştıran yerel bir LLM çalışma zamanıdır. OpenClaw, Ollama'nın yerel API'siyle (`/api/chat`) entegre olur, akış ve araç çağırmayı destekler ve `OLLAMA_API_KEY` (veya bir auth profili) ile etkinleştirdiğinizde ve açık bir `models.providers.ollama` girdisi tanımlamadığınızda yerel Ollama modellerini otomatik olarak keşfedebilir.
|
||||
Ollama, makinenizde açık kaynaklı modelleri çalıştırmayı kolaylaştıran yerel bir LLM çalışma zamanıdır. OpenClaw, Ollama'nın yerel API'si (`/api/chat`) ile entegre olur, akış ve araç çağırmayı destekler ve `OLLAMA_API_KEY` (veya bir kimlik doğrulama profili) ile etkinleştirdiğinizde ve açık bir `models.providers.ollama` girdisi tanımlamadığınızda yerel Ollama modellerini otomatik olarak keşfedebilir.
|
||||
|
||||
<Warning>
|
||||
**Uzak Ollama kullanıcıları**: OpenClaw ile `/v1` OpenAI uyumlu URL'yi (`http://host:11434/v1`) kullanmayın. Bu, araç çağırmayı bozar ve modeller ham araç JSON'unu düz metin olarak çıkarabilir. Bunun yerine yerel Ollama API URL'sini kullanın: `baseUrl: "http://host:11434"` (`/v1` olmadan).
|
||||
**Uzak Ollama kullanıcıları**: OpenClaw ile `/v1` OpenAI uyumlu URL'yi (`http://host:11434/v1`) kullanmayın. Bu, araç çağırmayı bozar ve modeller ham araç JSON'unu düz metin olarak çıktılayabilir. Bunun yerine yerel Ollama API URL'sini kullanın: `baseUrl: "http://host:11434"` (`/v1` olmadan).
|
||||
</Warning>
|
||||
|
||||
## Hızlı başlangıç
|
||||
|
||||
### Onboarding (önerilir)
|
||||
### İlk kurulum (önerilir)
|
||||
|
||||
Ollama kurmanın en hızlı yolu onboarding üzerinden geçer:
|
||||
Ollama'yı kurmanın en hızlı yolu ilk kurulum sürecini kullanmaktır:
|
||||
|
||||
```bash
|
||||
openclaw onboard
|
||||
```
|
||||
|
||||
Sağlayıcı listesinden **Ollama** seçin. Onboarding şunları yapar:
|
||||
Sağlayıcı listesinden **Ollama** seçin. İlk kurulum şunları yapacaktır:
|
||||
|
||||
1. Ollama örneğinize ulaşılabilen Ollama temel URL'sini sorar (varsayılan `http://127.0.0.1:11434`).
|
||||
2. **Cloud + Local** (bulut modelleri ve yerel modeller) veya **Local** (yalnızca yerel modeller) seçmenizi sağlar.
|
||||
3. **Cloud + Local** seçerseniz ve ollama.com üzerinde oturumunuz açık değilse tarayıcı tabanlı bir oturum açma akışı başlatır.
|
||||
4. Mevcut modelleri keşfeder ve varsayılanlar önerir.
|
||||
5. Seçilen model yerelde mevcut değilse onu otomatik olarak çeker.
|
||||
1. Örneğinize erişilebilen Ollama temel URL'sini sorar (varsayılan `http://127.0.0.1:11434`).
|
||||
2. **Cloud + Local** (bulut modelleri ve yerel modeller) veya **Local** (yalnızca yerel modeller) seçmenize izin verir.
|
||||
3. **Cloud + Local** seçerseniz ve `ollama.com` üzerinde oturum açmamışsanız tarayıcıda bir oturum açma akışı başlatır.
|
||||
4. Kullanılabilir modelleri keşfeder ve varsayılanlar önerir.
|
||||
5. Seçilen model yerel olarak mevcut değilse onu otomatik olarak çeker.
|
||||
|
||||
Etkileşimsiz mod da desteklenir:
|
||||
|
||||
@ -57,11 +57,11 @@ openclaw onboard --non-interactive \
|
||||
--accept-risk
|
||||
```
|
||||
|
||||
### Manuel kurulum
|
||||
### Elle kurulum
|
||||
|
||||
1. Ollama'yı kurun: [https://ollama.com/download](https://ollama.com/download)
|
||||
1. Ollama'yı yükleyin: [https://ollama.com/download](https://ollama.com/download)
|
||||
|
||||
2. Yerel çıkarım istiyorsanız yerel bir model çekin:
|
||||
2. Yerel çıkarım istiyorsanız bir yerel model çekin:
|
||||
|
||||
```bash
|
||||
ollama pull gemma4
|
||||
@ -71,28 +71,28 @@ ollama pull gpt-oss:20b
|
||||
ollama pull llama3.3
|
||||
```
|
||||
|
||||
3. Bulut modellerini de istiyorsanız oturum açın:
|
||||
3. Bulut modelleri de istiyorsanız oturum açın:
|
||||
|
||||
```bash
|
||||
ollama signin
|
||||
```
|
||||
|
||||
4. Onboarding çalıştırın ve `Ollama` seçin:
|
||||
4. İlk kurulumu çalıştırın ve `Ollama` seçin:
|
||||
|
||||
```bash
|
||||
openclaw onboard
|
||||
```
|
||||
|
||||
- `Local`: yalnızca yerel modeller
|
||||
- `Cloud + Local`: yerel modeller artı bulut modelleri
|
||||
- `kimi-k2.5:cloud`, `minimax-m2.7:cloud` ve `glm-5.1:cloud` gibi bulut modelleri yerel `ollama pull` **gerektirmez**
|
||||
- `Cloud + Local`: yerel modeller ve bulut modelleri
|
||||
- `kimi-k2.5:cloud`, `minimax-m2.7:cloud` ve `glm-5.1:cloud` gibi bulut modelleri yerel bir `ollama pull` gerektirmez
|
||||
|
||||
OpenClaw şu anda şunları önerir:
|
||||
|
||||
- yerel varsayılan: `gemma4`
|
||||
- bulut varsayılanları: `kimi-k2.5:cloud`, `minimax-m2.7:cloud`, `glm-5.1:cloud`
|
||||
|
||||
5. Manuel kurulumu tercih ediyorsanız Ollama'yı doğrudan OpenClaw için etkinleştirin (herhangi bir değer çalışır; Ollama gerçek bir anahtar gerektirmez):
|
||||
5. Elle kurulum tercih ediyorsanız, Ollama'yı doğrudan OpenClaw için etkinleştirin (herhangi bir değer çalışır; Ollama gerçek bir anahtar gerektirmez):
|
||||
|
||||
```bash
|
||||
# Ortam değişkeni ayarla
|
||||
@ -109,7 +109,7 @@ openclaw models list
|
||||
openclaw models set ollama/gemma4
|
||||
```
|
||||
|
||||
7. Veya varsayılanı yapılandırmada ayarlayın:
|
||||
7. Ya da varsayılanı yapılandırmada ayarlayın:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -123,32 +123,33 @@ openclaw models set ollama/gemma4
|
||||
|
||||
## Model keşfi (örtük sağlayıcı)
|
||||
|
||||
`OLLAMA_API_KEY` (veya bir auth profili) ayarladığınızda ve **`models.providers.ollama` tanımlamadığınızda**, OpenClaw modelleri `http://127.0.0.1:11434` adresindeki yerel Ollama örneğinden keşfeder:
|
||||
`OLLAMA_API_KEY` (veya bir kimlik doğrulama profili) ayarladığınızda ve `models.providers.ollama` tanımlamadığınızda, OpenClaw yerel Ollama örneğinden `http://127.0.0.1:11434` adresinde modelleri keşfeder:
|
||||
|
||||
- `/api/tags` sorgulanır
|
||||
- Mümkün olduğunda `contextWindow` okumak için en iyi çabayla `/api/show` aramaları kullanılır
|
||||
- Kullanılabildiğinde `contextWindow` değerini okumak ve yetenekleri (görsel dahil) algılamak için en iyi çabayla `/api/show` aramaları kullanılır
|
||||
- `/api/show` tarafından bildirilen `vision` yeteneğine sahip modeller, görsel destekli (`input: ["text", "image"]`) olarak işaretlenir; böylece OpenClaw bu modeller için isteme görüntüleri otomatik olarak ekler
|
||||
- `reasoning`, model adı sezgisiyle işaretlenir (`r1`, `reasoning`, `think`)
|
||||
- `maxTokens`, OpenClaw tarafından kullanılan varsayılan Ollama azami token sınırına ayarlanır
|
||||
- `maxTokens`, OpenClaw tarafından kullanılan varsayılan Ollama maksimum token sınırına ayarlanır
|
||||
- Tüm maliyetler `0` olarak ayarlanır
|
||||
|
||||
Bu, kataloğu yerel Ollama örneğiyle uyumlu tutarken manuel model girdilerinden kaçınmanızı sağlar.
|
||||
Bu, katalogu yerel Ollama örneğiyle uyumlu tutarken elle model girişi yapma gereğini ortadan kaldırır.
|
||||
|
||||
Hangi modellerin mevcut olduğunu görmek için:
|
||||
Hangi modellerin kullanılabilir olduğunu görmek için:
|
||||
|
||||
```bash
|
||||
ollama list
|
||||
openclaw models list
|
||||
```
|
||||
|
||||
Yeni bir model eklemek için onu Ollama ile çekmeniz yeterlidir:
|
||||
Yeni bir model eklemek için, onu Ollama ile çekmeniz yeterlidir:
|
||||
|
||||
```bash
|
||||
ollama pull mistral
|
||||
```
|
||||
|
||||
Yeni model otomatik olarak keşfedilir ve kullanıma sunulur.
|
||||
Yeni model otomatik olarak keşfedilir ve kullanıma hazır olur.
|
||||
|
||||
`models.providers.ollama` değerini açıkça ayarlarsanız otomatik keşif atlanır ve modelleri manuel olarak tanımlamanız gerekir (aşağıya bakın).
|
||||
`models.providers.ollama` değerini açıkça ayarlarsanız otomatik keşif atlanır ve modelleri elle tanımlamanız gerekir (aşağıya bakın).
|
||||
|
||||
## Yapılandırma
|
||||
|
||||
@ -160,13 +161,13 @@ Ollama'yı etkinleştirmenin en basit yolu ortam değişkeni kullanmaktır:
|
||||
export OLLAMA_API_KEY="ollama-local"
|
||||
```
|
||||
|
||||
### Açık kurulum (manuel modeller)
|
||||
### Açık kurulum (elle modeller)
|
||||
|
||||
Şu durumlarda açık yapılandırma kullanın:
|
||||
|
||||
- Ollama başka bir host/port üzerinde çalışıyorsa.
|
||||
- Ollama başka bir ana makine/bağlantı noktasında çalışıyorsa.
|
||||
- Belirli bağlam pencerelerini veya model listelerini zorlamak istiyorsanız.
|
||||
- Tamamen manuel model tanımları istiyorsanız.
|
||||
- Tamamen elle model tanımları istiyorsanız.
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -193,11 +194,11 @@ export OLLAMA_API_KEY="ollama-local"
|
||||
}
|
||||
```
|
||||
|
||||
`OLLAMA_API_KEY` ayarlıysa sağlayıcı girdisinde `apiKey` değerini atlayabilirsiniz; OpenClaw bunu kullanılabilirlik kontrolleri için doldurur.
|
||||
`OLLAMA_API_KEY` ayarlıysa, sağlayıcı girdisinde `apiKey` değerini atlayabilirsiniz; OpenClaw bunu kullanılabilirlik denetimleri için doldurur.
|
||||
|
||||
### Özel temel URL (açık yapılandırma)
|
||||
|
||||
Ollama farklı bir host veya port üzerinde çalışıyorsa (açık yapılandırma otomatik keşfi devre dışı bırakır, bu yüzden modelleri manuel tanımlayın):
|
||||
Ollama farklı bir ana makinede veya bağlantı noktasında çalışıyorsa (açık yapılandırma otomatik keşfi devre dışı bırakır, bu nedenle modelleri elle tanımlayın):
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -206,7 +207,7 @@ Ollama farklı bir host veya port üzerinde çalışıyorsa (açık yapılandır
|
||||
ollama: {
|
||||
apiKey: "ollama-local",
|
||||
baseUrl: "http://ollama-host:11434", // /v1 yok - yerel Ollama API URL'sini kullanın
|
||||
api: "ollama", // yerel araç çağırma davranışını garanti etmek için açıkça ayarlayın
|
||||
api: "ollama", // Yerel araç çağırma davranışını garanti etmek için açıkça ayarlayın
|
||||
},
|
||||
},
|
||||
},
|
||||
@ -219,7 +220,7 @@ URL'ye `/v1` eklemeyin. `/v1` yolu, araç çağırmanın güvenilir olmadığı
|
||||
|
||||
### Model seçimi
|
||||
|
||||
Bir kez yapılandırıldığında tüm Ollama modelleriniz kullanılabilir olur:
|
||||
Yapılandırıldıktan sonra tüm Ollama modelleriniz kullanılabilir olur:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -236,9 +237,9 @@ Bir kez yapılandırıldığında tüm Ollama modelleriniz kullanılabilir olur:
|
||||
|
||||
## Bulut modelleri
|
||||
|
||||
Bulut modelleri, yerel modellerinizle birlikte bulutta barındırılan modelleri (`kimi-k2.5:cloud`, `minimax-m2.7:cloud`, `glm-5.1:cloud` gibi) çalıştırmanızı sağlar.
|
||||
Bulut modelleri, bulutta barındırılan modelleri (örneğin `kimi-k2.5:cloud`, `minimax-m2.7:cloud`, `glm-5.1:cloud`) yerel modellerinizle birlikte çalıştırmanıza olanak tanır.
|
||||
|
||||
Bulut modellerini kullanmak için kurulum sırasında **Cloud + Local** modunu seçin. Sihirbaz oturumunuzun açık olup olmadığını kontrol eder ve gerektiğinde tarayıcı tabanlı oturum açma akışı başlatır. Kimlik doğrulama doğrulanamazsa sihirbaz yerel model varsayılanlarına geri döner.
|
||||
Bulut modellerini kullanmak için kurulum sırasında **Cloud + Local** modunu seçin. Sihirbaz, oturum açıp açmadığınızı denetler ve gerektiğinde tarayıcıda bir oturum açma akışı başlatır. Kimlik doğrulama doğrulanamazsa sihirbaz yerel model varsayılanlarına geri döner.
|
||||
|
||||
Doğrudan [ollama.com/signin](https://ollama.com/signin) adresinden de oturum açabilirsiniz.
|
||||
|
||||
@ -247,8 +248,7 @@ Doğrudan [ollama.com/signin](https://ollama.com/signin) adresinden de oturum a
|
||||
OpenClaw ayrıca paketlenmiş bir `web_search`
|
||||
sağlayıcısı olarak **Ollama Web Search** desteği sunar.
|
||||
|
||||
- Yapılandırılmış Ollama host'unuzu kullanır (`models.providers.ollama.baseUrl` ayarlıysa onu,
|
||||
aksi halde `http://127.0.0.1:11434`).
|
||||
- Yapılandırılmış Ollama ana makinenizi kullanır (`models.providers.ollama.baseUrl` ayarlıysa onu, aksi takdirde `http://127.0.0.1:11434`).
|
||||
- Anahtar gerektirmez.
|
||||
- Ollama'nın çalışıyor olmasını ve `ollama signin` ile oturum açılmış olmasını gerektirir.
|
||||
|
||||
@ -267,13 +267,13 @@ sağlayıcısı olarak **Ollama Web Search** desteği sunar.
|
||||
}
|
||||
```
|
||||
|
||||
Tam kurulum ve davranış ayrıntıları için [Ollama Web Search](/tr/tools/ollama-search) bölümüne bakın.
|
||||
Tam kurulum ve davranış ayrıntıları için bkz. [Ollama Web Search](/tr/tools/ollama-search).
|
||||
|
||||
## Gelişmiş
|
||||
|
||||
### Reasoning modelleri
|
||||
|
||||
OpenClaw, varsayılan olarak `deepseek-r1`, `reasoning` veya `think` gibi adlara sahip modelleri reasoning destekli kabul eder:
|
||||
OpenClaw, `deepseek-r1`, `reasoning` veya `think` gibi adlara sahip modelleri varsayılan olarak reasoning destekli kabul eder:
|
||||
|
||||
```bash
|
||||
ollama pull deepseek-r1:32b
|
||||
@ -281,16 +281,16 @@ ollama pull deepseek-r1:32b
|
||||
|
||||
### Model maliyetleri
|
||||
|
||||
Ollama ücretsizdir ve yerelde çalışır, bu nedenle tüm model maliyetleri $0 olarak ayarlanır.
|
||||
Ollama ücretsizdir ve yerel olarak çalışır, bu nedenle tüm model maliyetleri $0 olarak ayarlanır.
|
||||
|
||||
### Akış yapılandırması
|
||||
|
||||
OpenClaw'ın Ollama entegrasyonu varsayılan olarak **yerel Ollama API'sini** (`/api/chat`) kullanır; bu, akış ve araç çağırmayı aynı anda tam olarak destekler. Özel bir yapılandırma gerekmez.
|
||||
OpenClaw'ın Ollama entegrasyonu varsayılan olarak **yerel Ollama API**'sini (`/api/chat`) kullanır; bu API akış ve araç çağırmayı aynı anda tam olarak destekler. Özel bir yapılandırma gerekmez.
|
||||
|
||||
#### Eski OpenAI uyumlu mod
|
||||
|
||||
<Warning>
|
||||
**Araç çağırma OpenAI uyumlu modda güvenilir değildir.** Bu modu yalnızca bir proxy için OpenAI biçimine ihtiyacınız varsa ve yerel araç çağırma davranışına bağımlı değilseniz kullanın.
|
||||
**Araç çağırma, OpenAI uyumlu modda güvenilir değildir.** Bu modu yalnızca bir proxy için OpenAI biçimine ihtiyacınız varsa ve yerel araç çağırma davranışına bağımlı değilseniz kullanın.
|
||||
</Warning>
|
||||
|
||||
Bunun yerine OpenAI uyumlu uç noktayı kullanmanız gerekiyorsa (ör. yalnızca OpenAI biçimini destekleyen bir proxy arkasında), `api: "openai-completions"` değerini açıkça ayarlayın:
|
||||
@ -311,9 +311,9 @@ Bunun yerine OpenAI uyumlu uç noktayı kullanmanız gerekiyorsa (ör. yalnızca
|
||||
}
|
||||
```
|
||||
|
||||
Bu mod aynı anda akış + araç çağırmayı desteklemeyebilir. Model yapılandırmasında `params: { streaming: false }` ile akışı devre dışı bırakmanız gerekebilir.
|
||||
Bu mod, akış + araç çağırmayı aynı anda desteklemeyebilir. Model yapılandırmasında `params: { streaming: false }` ile akışı devre dışı bırakmanız gerekebilir.
|
||||
|
||||
Ollama ile `api: "openai-completions"` kullanıldığında OpenClaw, Ollama'nın sessizce 4096 bağlam penceresine geri dönmemesi için varsayılan olarak `options.num_ctx` enjekte eder. Proxy'niz/yukarı akışınız bilinmeyen `options` alanlarını reddediyorsa bu davranışı devre dışı bırakın:
|
||||
`api: "openai-completions"` Ollama ile kullanıldığında, OpenClaw varsayılan olarak `options.num_ctx` ekler; böylece Ollama sessizce 4096 bağlam penceresine geri düşmez. Proxy/yukarı akış bilinmeyen `options` alanlarını reddediyorsa bu davranışı devre dışı bırakın:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -333,19 +333,19 @@ Ollama ile `api: "openai-completions"` kullanıldığında OpenClaw, Ollama'nın
|
||||
|
||||
### Bağlam pencereleri
|
||||
|
||||
Otomatik keşfedilen modeller için OpenClaw, mümkün olduğunda Ollama tarafından bildirilen bağlam penceresini kullanır; aksi halde OpenClaw tarafından kullanılan varsayılan Ollama bağlam penceresine geri döner. Açık sağlayıcı yapılandırmasında `contextWindow` ve `maxTokens` değerlerini geçersiz kılabilirsiniz.
|
||||
Otomatik olarak keşfedilen modeller için OpenClaw, kullanılabiliyorsa Ollama tarafından bildirilen bağlam penceresini kullanır; aksi takdirde OpenClaw tarafından kullanılan varsayılan Ollama bağlam penceresine geri döner. Açık sağlayıcı yapılandırmasında `contextWindow` ve `maxTokens` değerlerini geçersiz kılabilirsiniz.
|
||||
|
||||
## Sorun giderme
|
||||
|
||||
### Ollama algılanmadı
|
||||
|
||||
Ollama'nın çalıştığından, `OLLAMA_API_KEY` (veya bir auth profili) ayarladığınızdan ve açık bir `models.providers.ollama` girdisi tanımlamadığınızdan emin olun:
|
||||
Ollama'nın çalıştığından, `OLLAMA_API_KEY` (veya bir kimlik doğrulama profili) ayarladığınızdan ve açık bir `models.providers.ollama` girdisi tanımlamadığınızdan emin olun:
|
||||
|
||||
```bash
|
||||
ollama serve
|
||||
```
|
||||
|
||||
Ayrıca API'nin erişilebilir olduğunu doğrulayın:
|
||||
Ve API'nin erişilebilir olduğunu doğrulayın:
|
||||
|
||||
```bash
|
||||
curl http://localhost:11434/api/tags
|
||||
@ -353,9 +353,9 @@ curl http://localhost:11434/api/tags
|
||||
|
||||
### Kullanılabilir model yok
|
||||
|
||||
Modeliniz listelenmiyorsa şunlardan birini yapın:
|
||||
Modeliniz listelenmiyorsa şu iki durumdan biri söz konusudur:
|
||||
|
||||
- Modeli yerelde çekin veya
|
||||
- Modeli yerel olarak çekin veya
|
||||
- Modeli `models.providers.ollama` içinde açıkça tanımlayın.
|
||||
|
||||
Model eklemek için:
|
||||
@ -369,18 +369,18 @@ ollama pull llama3.3 # Veya başka bir model
|
||||
|
||||
### Bağlantı reddedildi
|
||||
|
||||
Ollama'nın doğru port üzerinde çalıştığını kontrol edin:
|
||||
Ollama'nın doğru bağlantı noktasında çalıştığını denetleyin:
|
||||
|
||||
```bash
|
||||
# Ollama çalışıyor mu kontrol edin
|
||||
# Ollama'nın çalışıp çalışmadığını denetleyin
|
||||
ps aux | grep ollama
|
||||
|
||||
# Veya Ollama'yı yeniden başlatın
|
||||
# Ya da Ollama'yı yeniden başlatın
|
||||
ollama serve
|
||||
```
|
||||
|
||||
## Ayrıca bakın
|
||||
|
||||
- [Model Sağlayıcıları](/tr/concepts/model-providers) - Tüm sağlayıcılara genel bakış
|
||||
- [Model Seçimi](/tr/concepts/models) - Modeller nasıl seçilir
|
||||
- [Yapılandırma](/tr/gateway/configuration) - Tam yapılandırma referansı
|
||||
- [Model Providers](/tr/concepts/model-providers) - Tüm sağlayıcılara genel bakış
|
||||
- [Model Selection](/tr/concepts/models) - Modeller nasıl seçilir
|
||||
- [Configuration](/tr/gateway/configuration) - Tam yapılandırma başvurusu
|
||||
|
||||
Loading…
Reference in New Issue
Block a user