chore(i18n): refresh tr translations

2026-04-11 15:25:32 +00:00 · 2026-04-11 15:25:32 +00:00 · b4cff0e8d2
commit b4cff0e8d2
parent 6b52660c66
7 changed files with 2270 additions and 1755 deletions
--- a/docs/tr/gateway/configuration-reference.md
+++ b/docs/tr/gateway/configuration-reference.md
--- a/docs/tr/help/gpt54-codex-agentic-parity-maintainers.md
+++ b/docs/tr/help/gpt54-codex-agentic-parity-maintainers.md
@ -0,0 +1,174 @@
+---
+x-i18n:
+    generated_at: "2026-04-11T15:15:48Z"
+    model: gpt-5.4
+    provider: openai
+    source_hash: 910bcf7668becf182ef48185b43728bf2fa69629d6d50189d47d47b06f807a9e
+    source_path: help/gpt54-codex-agentic-parity-maintainers.md
+    workflow: 15
+---
+
+# GPT-5.4 / Codex Eşdeğerliği Sorumlu Notları
+
+Bu not, özgün altı sözleşmeli mimariyi kaybetmeden GPT-5.4 / Codex eşdeğerliği programını dört birleştirme birimi olarak nasıl inceleyeceğinizi açıklar.
+
+## Birleştirme birimleri
+
+### PR A: katı agentic yürütme
+
+Sahip olduğu alanlar:
+
+- `executionContract`
+- GPT-5-öncelikli aynı turda devam ettirme
+- terminal olmayan ilerleme takibi olarak `update_plan`
+- yalnızca plan içeren sessiz durmalar yerine açık engellenmiş durumlar
+
+Sahip olmadığı alanlar:
+
+- kimlik doğrulama/çalışma zamanı hata sınıflandırması
+- izin doğruluğu
+- yeniden oynatma/devam ettirme yeniden tasarımı
+- eşdeğerlik kıyaslaması
+
+### PR B: çalışma zamanı doğruluğu
+
+Sahip olduğu alanlar:
+
+- Codex OAuth kapsam doğruluğu
+- türlendirilmiş sağlayıcı/çalışma zamanı hata sınıflandırması
+- `/elevated full` kullanılabilirliği ve engellenme nedenlerinin doğru şekilde gösterilmesi
+
+Sahip olmadığı alanlar:
+
+- araç şeması normalleştirmesi
+- yeniden oynatma/canlılık durumu
+- kıyaslama kapısı
+
+### PR C: yürütme doğruluğu
+
+Sahip olduğu alanlar:
+
+- sağlayıcıya ait OpenAI/Codex araç uyumluluğu
+- parametresiz katı şema işleme
+- replay-invalid durumunun görünür kılınması
+- duraklatılmış, engellenmiş ve terk edilmiş uzun görev durumlarının görünürlüğü
+
+Sahip olmadığı alanlar:
+
+- kendi kendine seçilen devam ettirme
+- sağlayıcı kancaları dışındaki genel Codex lehçesi davranışı
+- kıyaslama kapısı
+
+### PR D: eşdeğerlik düzeneği
+
+Sahip olduğu alanlar:
+
+- ilk dalga GPT-5.4 ile Opus 4.6 senaryo paketi
+- eşdeğerlik dokümantasyonu
+- eşdeğerlik raporu ve sürüm kapısı mekanikleri
+
+Sahip olmadığı alanlar:
+
+- QA-lab dışındaki çalışma zamanı davranış değişiklikleri
+- düzenek içindeki kimlik doğrulama/proxy/DNS simülasyonu
+
+## Özgün altı sözleşmeye geri eşleme
+
+| Özgün sözleşme                          | Birleştirme birimi |
+| --------------------------------------- | ------------------ |
+| Sağlayıcı taşıma/kimlik doğrulama doğruluğu | PR B               |
+| Araç sözleşmesi/şema uyumluluğu         | PR C               |
+| Aynı turda yürütme                      | PR A               |
+| İzin doğruluğu                          | PR B               |
+| Yeniden oynatma/devam ettirme/canlılık doğruluğu | PR C               |
+| Kıyaslama/sürüm kapısı                  | PR D               |
+
+## İnceleme sırası
+
+1. PR A
+2. PR B
+3. PR C
+4. PR D
+
+PR D ispat katmanıdır. Çalışma zamanı doğruluğu PR’lerinin gecikme nedeni olmamalıdır.
+
+## Nelere bakılmalı
+
+### PR A
+
+- GPT-5 çalıştırmaları yorumda durmak yerine eyleme geçiyor veya güvenli şekilde başarısız oluyor
+- `update_plan` artık tek başına ilerleme gibi görünmüyor
+- davranış GPT-5-öncelikli ve gömülü-Pi kapsamlı kalıyor
+
+### PR B
+
+- kimlik doğrulama/proxy/çalışma zamanı hataları artık genel “model failed” işleyişine çökertilmiyor
+- `/elevated full` yalnızca gerçekten kullanılabilir olduğunda kullanılabilir olarak açıklanıyor
+- engellenme nedenleri hem model hem de kullanıcıya dönük çalışma zamanı için görünür durumda
+
+### PR C
+
+- katı OpenAI/Codex araç kaydı öngörülebilir davranıyor
+- parametresiz araçlar katı şema denetimlerinde başarısız olmuyor
+- yeniden oynatma ve sıkıştırma sonuçları doğru canlılık durumunu koruyor
+
+### PR D
+
+- senaryo paketi anlaşılır ve yeniden üretilebilir
+- paket yalnızca salt okunur akışları değil, durum değiştiren bir yeniden oynatma güvenliği hattını da içeriyor
+- raporlar insanlar ve otomasyon tarafından okunabilir
+- eşdeğerlik iddiaları anekdota değil, kanıta dayanıyor
+
+PR D’den beklenen çıktılar:
+
+- her model çalıştırması için `qa-suite-report.md` / `qa-suite-summary.json`
+- toplu ve senaryo düzeyinde karşılaştırma için `qa-agentic-parity-report.md`
+- makine tarafından okunabilir hüküm için `qa-agentic-parity-summary.json`
+
+## Sürüm kapısı
+
+Aşağıdakiler gerçekleşmeden GPT-5.4’ün Opus 4.6 ile eşdeğer veya ondan üstün olduğunu iddia etmeyin:
+
+- PR A, PR B ve PR C birleştirilmiş olmalı
+- PR D ilk dalga eşdeğerlik paketini temiz şekilde çalıştırmalı
+- çalışma zamanı doğruluğu regresyon paketleri yeşil kalmalı
+- eşdeğerlik raporu sahte başarı durumu göstermemeli ve durma davranışında regresyon olmamalı
+
+```mermaid
+flowchart LR
+    A["PR A-C birleştirildi"] --> B["GPT-5.4 eşdeğerlik paketini çalıştır"]
+    A --> C["Opus 4.6 eşdeğerlik paketini çalıştır"]
+    B --> D["qa-suite-summary.json"]
+    C --> E["qa-suite-summary.json"]
+    D --> F["qa parity-report"]
+    E --> F
+    F --> G["Markdown raporu + JSON hükmü"]
+    G --> H{"Geçti mi?"}
+    H -- "evet" --> I["Eşdeğerlik iddiasına izin verilir"]
+    H -- "hayır" --> J["Çalışma zamanı düzeltmeleri / inceleme döngüsü açık kalsın"]
+```
+
+Eşdeğerlik düzeneği tek kanıt kaynağı değildir. İncelemede bu ayrımı açık tutun:
+
+- PR D, senaryo tabanlı GPT-5.4 ile Opus 4.6 karşılaştırmasının sahibidir
+- PR B deterministic paketleri, kimlik doğrulama/proxy/DNS ve tam erişim doğruluğu kanıtının sahibi olmaya devam eder
+
+## Hedeften kanıta eşleme
+
+| Tamamlama kapısı öğesi                  | Birincil sahip | İnceleme çıktısı                                                    |
+| --------------------------------------- | -------------- | ------------------------------------------------------------------- |
+| Yalnızca plan içeren duraksamalar yok   | PR A           | katı agentic çalışma zamanı testleri ve `approval-turn-tool-followthrough` |
+| Sahte ilerleme veya sahte araç tamamlanması yok | PR A + PR D    | eşdeğerlik sahte başarı sayısı ve senaryo düzeyindeki rapor ayrıntıları |
+| Yanlış `/elevated full` yönlendirmesi yok | PR B           | deterministic çalışma zamanı doğruluğu paketleri                    |
+| Yeniden oynatma/canlılık hataları açık kalır | PR C + PR D    | yaşam döngüsü/yeniden oynatma paketleri ve `compaction-retry-mutating-tool` |
+| GPT-5.4, Opus 4.6 ile eşleşir veya onu geçer | PR D           | `qa-agentic-parity-report.md` ve `qa-agentic-parity-summary.json`   |
+
+## İnceleyici kısaltması: önce ve sonra
+
+| Kullanıcı açısından görünür sorun, önce                     | Sonra inceleme sinyali                                                                  |
+| ----------------------------------------------------------- | --------------------------------------------------------------------------------------- |
+| GPT-5.4 planlamadan sonra duruyordu                         | PR A, yalnızca yorumla tamamlanma yerine eyleme geçme veya engellenme davranışı gösterir |
+| Araç kullanımı katı OpenAI/Codex şemalarıyla kırılgan görünüyordu | PR C, araç kaydını ve parametresiz çağrımı öngörülebilir tutar                         |
+| `/elevated full` ipuçları bazen yanıltıcıydı                | PR B, yönlendirmeyi gerçek çalışma zamanı yeteneği ve engellenme nedenlerine bağlar    |
+| Uzun görevler yeniden oynatma/sıkıştırma belirsizliğinde kaybolabiliyordu | PR C, açık duraklatılmış, engellenmiş, terk edilmiş ve replay-invalid durumları üretir |
+| Eşdeğerlik iddiaları anekdota dayanıyordu                   | PR D, her iki modelde de aynı senaryo kapsamıyla bir rapor ve JSON hükmü üretir |
--- a/docs/tr/help/gpt54-codex-agentic-parity.md
+++ b/docs/tr/help/gpt54-codex-agentic-parity.md
@ -0,0 +1,229 @@
+---
+x-i18n:
+    generated_at: "2026-04-11T15:15:48Z"
+    model: gpt-5.4
+    provider: openai
+    source_hash: 7ee6b925b8a0f8843693cea9d50b40544657b5fb8a9e0860e2ff5badb273acb6
+    source_path: help/gpt54-codex-agentic-parity.md
+    workflow: 15
+---
+
+# OpenClaw'da GPT-5.4 / Codex Ajanik Eşdeğerliği
+
+OpenClaw, araç kullanan frontier modellerle zaten iyi çalışıyordu, ancak GPT-5.4 ve Codex tarzı modeller hâlâ pratikte birkaç açıdan düşük performans gösteriyordu:
+
+- işi yapmak yerine planlama sonrası durabiliyorlardı
+- sıkı OpenAI/Codex araç şemalarını yanlış kullanabiliyorlardı
+- tam erişim imkansız olsa bile `/elevated full` isteyebiliyorlardı
+- tekrar oynatma veya sıkıştırma sırasında uzun süren görev durumunu kaybedebiliyorlardı
+- Claude Opus 4.6 ile eşdeğerlik iddiaları tekrar üretilebilir senaryolar yerine anekdotlara dayanıyordu
+
+Bu eşdeğerlik programı bu boşlukları incelenebilir dört dilimde kapatıyor.
+
+## Neler değişti
+
+### PR A: strict-agentic yürütme
+
+Bu dilim, gömülü Pi GPT-5 çalıştırmaları için isteğe bağlı bir `strict-agentic` yürütme sözleşmesi ekler.
+
+Etkinleştirildiğinde OpenClaw, yalnızca plan içeren turları artık “yeterince iyi” tamamlanmış saymaz. Model sadece ne yapmayı amaçladığını söyleyip gerçekten araç kullanmaz veya ilerleme göstermezse, OpenClaw bir hemen-harekete-geç yönlendirmesiyle yeniden dener ve ardından görevi sessizce bitirmek yerine açık bir engellenmiş durumla kapalı başarısızlığa düşer.
+
+Bu, GPT-5.4 deneyimini özellikle şu durumlarda iyileştirir:
+
+- kısa “tamam yap” takip mesajları
+- ilk adımın açık olduğu kod görevleri
+- `update_plan` kullanımının dolgu metin değil ilerleme takibi olması gereken akışlar
+
+### PR B: çalışma zamanı doğruluğu
+
+Bu dilim, OpenClaw'un iki konuda doğruyu söylemesini sağlar:
+
+- sağlayıcı/çalışma zamanı çağrısının neden başarısız olduğu
+- `/elevated full` özelliğinin gerçekten kullanılabilir olup olmadığı
+
+Bu sayede GPT-5.4; eksik kapsam, kimlik doğrulama yenileme hataları, HTML 403 kimlik doğrulama hataları, proxy sorunları, DNS veya zaman aşımı hataları ve engellenmiş tam erişim modları için daha iyi çalışma zamanı sinyalleri alır. Modelin yanlış çözümü uydurma veya çalışma zamanının sağlayamayacağı bir izin modunu istemeye devam etme olasılığı azalır.
+
+### PR C: yürütme doğruluğu
+
+Bu dilim iki tür doğruluğu iyileştirir:
+
+- sağlayıcıya ait OpenAI/Codex araç-şema uyumluluğu
+- tekrar oynatma ve uzun görev canlılığı görünürlüğü
+
+Araç uyumluluğu çalışması, sıkı OpenAI/Codex araç kaydı için şema sürtünmesini azaltır; özellikle parametresiz araçlar ve sıkı nesne-kök beklentileri etrafında. Tekrar oynatma/canlılık çalışması ise uzun süren görevleri daha gözlemlenebilir hale getirir; böylece duraklatılmış, engellenmiş ve terk edilmiş durumlar genel hata metinleri içinde kaybolmak yerine görünür olur.
+
+### PR D: eşdeğerlik altyapısı
+
+Bu dilim, GPT-5.4 ile Opus 4.6'nın aynı senaryolar üzerinden çalıştırılıp ortak kanıtlarla karşılaştırılabilmesi için ilk dalga QA-lab eşdeğerlik paketini ekler.
+
+Eşdeğerlik paketi kanıt katmanıdır. Tek başına çalışma zamanı davranışını değiştirmez.
+
+İki adet `qa-suite-summary.json` yapıtınız olduğunda, sürüm kapısı karşılaştırmasını şu komutla üretin:
+
+```bash
+pnpm openclaw qa parity-report \
+  --repo-root . \
+  --candidate-summary .artifacts/qa-e2e/gpt54/qa-suite-summary.json \
+  --baseline-summary .artifacts/qa-e2e/opus46/qa-suite-summary.json \
+  --output-dir .artifacts/qa-e2e/parity
+```
+
+Bu komut şunları yazar:
+
+- insanlar tarafından okunabilir bir Markdown raporu
+- makineler tarafından okunabilir bir JSON kararı
+- açık bir `pass` / `fail` kapı sonucu
+
+## Bunun GPT-5.4'ü pratikte nasıl iyileştirdiği
+
+Bu çalışmadan önce, OpenClaw üzerindeki GPT-5.4 gerçek kodlama oturumlarında Opus'tan daha az ajanik hissettirebiliyordu çünkü çalışma zamanı, özellikle GPT-5 tarzı modeller için zararlı olan davranışlara tolerans gösteriyordu:
+
+- yalnızca yorum içeren turlar
+- araçlar etrafında şema sürtünmesi
+- belirsiz izin geri bildirimi
+- sessiz tekrar oynatma veya sıkıştırma bozulması
+
+Amaç, GPT-5.4'ü Opus'u taklit etmeye zorlamak değildir. Amaç, GPT-5.4'e gerçek ilerlemeyi ödüllendiren, daha temiz araç ve izin semantiği sağlayan ve hata modlarını makine ve insanlar tarafından okunabilir açık durumlara dönüştüren bir çalışma zamanı sözleşmesi vermektir.
+
+Bu, kullanıcı deneyimini şu durumdan değiştirir:
+
+- “modelin iyi bir planı vardı ama durdu”
+
+şuna dönüştürür:
+
+- “model ya harekete geçti ya da OpenClaw neden yapamadığını tam olarak ortaya koydu”
+
+## GPT-5.4 kullanıcıları için önce ve sonra
+
+| Bu programdan önce                                                                                | PR A-D'den sonra                                                                        |
+| ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| GPT-5.4 mantıklı bir plandan sonra sonraki araç adımını atmadan durabiliyordu                    | PR A, “yalnızca plan” durumunu “hemen harekete geç veya engellenmiş bir durum göster”a çevirir |
+| Sıkı araç şemaları parametresiz veya OpenAI/Codex biçimli araçları kafa karıştırıcı şekilde reddedebiliyordu | PR C, sağlayıcıya ait araç kaydı ve çağrımını daha öngörülebilir hale getirir          |
+| `/elevated full` yönlendirmesi engellenmiş çalışma zamanlarında belirsiz veya yanlış olabiliyordu | PR B, GPT-5.4'e ve kullanıcıya doğru çalışma zamanı ve izin ipuçları verir              |
+| Tekrar oynatma veya sıkıştırma hataları görevin sessizce kaybolduğu hissini verebiliyordu        | PR C, duraklatılmış, engellenmiş, terk edilmiş ve tekrar oynatması geçersiz sonuçları açıkça gösterir |
+| “GPT-5.4 Opus'tan daha kötü hissettiriyor” büyük ölçüde anekdot niteliğindeydi                   | PR D bunu aynı senaryo paketi, aynı metrikler ve kesin bir geç/kaldı kapısına dönüştürür |
+
+## Mimari
+
+```mermaid
+flowchart TD
+    A["Kullanıcı isteği"] --> B["Gömülü Pi çalışma zamanı"]
+    B --> C["Strict-agentic yürütme sözleşmesi"]
+    B --> D["Sağlayıcıya ait araç uyumluluğu"]
+    B --> E["Çalışma zamanı doğruluğu"]
+    B --> F["Tekrar oynatma ve canlılık durumu"]
+    C --> G["Araç çağrısı veya açık bir engellenmiş durum"]
+    D --> G
+    E --> G
+    F --> G
+    G --> H["QA-lab eşdeğerlik paketi"]
+    H --> I["Senaryo raporu ve eşdeğerlik kapısı"]
+```
+
+## Sürüm akışı
+
+```mermaid
+flowchart LR
+    A["Birleştirilmiş çalışma zamanı dilimleri (PR A-C)"] --> B["GPT-5.4 eşdeğerlik paketini çalıştır"]
+    A --> C["Opus 4.6 eşdeğerlik paketini çalıştır"]
+    B --> D["qa-suite-summary.json"]
+    C --> E["qa-suite-summary.json"]
+    D --> F["openclaw qa parity-report"]
+    E --> F
+    F --> G["qa-agentic-parity-report.md"]
+    F --> H["qa-agentic-parity-summary.json"]
+    H --> I{"Kapı geçti mi?"}
+    I -- "evet" --> J["Kanıta dayalı eşdeğerlik iddiası"]
+    I -- "hayır" --> K["Çalışma zamanı/inceleme döngüsünü açık tut"]
+```
+
+## Senaryo paketi
+
+İlk dalga eşdeğerlik paketi şu anda beş senaryoyu kapsıyor:
+
+### `approval-turn-tool-followthrough`
+
+Modelin kısa bir onaydan sonra “bunu yapacağım” diyerek durmadığını kontrol eder. Aynı turda ilk somut eylemi yapmalıdır.
+
+### `model-switch-tool-continuity`
+
+Araç kullanan çalışmanın model/çalışma zamanı geçiş sınırları boyunca yorum moduna sıfırlanmak veya yürütme bağlamını kaybetmek yerine tutarlı kalıp kalmadığını kontrol eder.
+
+### `source-docs-discovery-report`
+
+Modelin kaynak kodu ve dokümantasyonu okuyup bulguları sentezleyebildiğini ve ince bir özet üretip erken durmak yerine göreve ajanik biçimde devam edebildiğini kontrol eder.
+
+### `image-understanding-attachment`
+
+Ek içeren karma mod görevlerin eyleme geçirilebilir kalıp kalmadığını ve belirsiz anlatıma çöküp çökmediğini kontrol eder.
+
+### `compaction-retry-mutating-tool`
+
+Gerçek bir değiştirici yazma işlemi içeren bir görevin, çalışma sıkıştırılsa, yeniden denense veya baskı altında yanıt durumu kaybolsa bile tekrar oynatma güvensizliğini sessizce tekrar oynatma güvenliymiş gibi göstermeden açık tutup tutmadığını kontrol eder.
+
+## Senaryo matrisi
+
+| Senaryo                           | Test ettiği şey                           | İyi GPT-5.4 davranışı                                                            | Başarısızlık sinyali                                                              |
+| --------------------------------- | ----------------------------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| `approval-turn-tool-followthrough` | Bir plandan sonraki kısa onay turları     | Niyeti yeniden ifade etmek yerine ilk somut araç eylemini hemen başlatır        | yalnızca plan içeren takip, araç etkinliği yok veya gerçek bir engel olmadan engellenmiş tur |
+| `model-switch-tool-continuity`     | Araç kullanımı altında çalışma zamanı/model geçişi | Görev bağlamını korur ve tutarlı biçimde eyleme devam eder                      | yorum moduna sıfırlanır, araç bağlamını kaybeder veya geçişten sonra durur        |
+| `source-docs-discovery-report`     | Kaynak okuma + sentez + eylem             | Kaynakları bulur, araçları kullanır ve takılmadan faydalı bir rapor üretir      | ince özet, eksik araç çalışması veya eksik-tur durması                            |
+| `image-understanding-attachment`   | Ek odaklı ajanik çalışma                  | Eki yorumlar, araçlarla ilişkilendirir ve göreve devam eder                     | belirsiz anlatım, ekin yok sayılması veya somut bir sonraki eylemin olmaması      |
+| `compaction-retry-mutating-tool`   | Sıkıştırma baskısı altında değiştirici çalışma | Gerçek bir yazma işlemi yapar ve yan etkiden sonra tekrar oynatma güvensizliğini açık tutar | değiştirici yazma olur ama tekrar oynatma güvenliği ima edilir, eksik kalır veya çelişkili olur |
+
+## Sürüm kapısı
+
+GPT-5.4 ancak birleştirilmiş çalışma zamanı hem eşdeğerlik paketini hem de çalışma zamanı doğruluğu regresyonlarını aynı anda geçtiğinde eşdeğer veya daha iyi kabul edilebilir.
+
+Gerekli sonuçlar:
+
+- bir sonraki araç eylemi açıkken yalnızca plan kaynaklı takılma olmaması
+- gerçek yürütme olmadan sahte tamamlanma olmaması
+- yanlış `/elevated full` yönlendirmesi olmaması
+- sessiz tekrar oynatma veya sıkıştırma nedeniyle terk edilme olmaması
+- üzerinde anlaşılmış Opus 4.6 temel çizgisi kadar güçlü veya daha güçlü eşdeğerlik paketi metrikleri
+
+İlk dalga altyapısı için kapı şu ölçütleri karşılaştırır:
+
+- tamamlanma oranı
+- amaç dışı durma oranı
+- geçerli araç çağrısı oranı
+- sahte başarı sayısı
+
+Eşdeğerlik kanıtı kasıtlı olarak iki katmana ayrılmıştır:
+
+- PR D, QA-lab ile aynı senaryolarda GPT-5.4 ile Opus 4.6 davranışını kanıtlar
+- PR B deterministik paketleri, altyapı dışında kimlik doğrulama, proxy, DNS ve `/elevated full` doğruluğunu kanıtlar
+
+## Hedeften kanıta matrisi
+
+| Tamamlanma kapısı maddesi                              | Sorumlu PR  | Kanıt kaynağı                                                     | Geçiş sinyali                                                                          |
+| ------------------------------------------------------ | ----------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| GPT-5.4 artık planlamadan sonra takılmıyor             | PR A        | `approval-turn-tool-followthrough` ve PR A çalışma zamanı paketleri | onay turları gerçek işi veya açık bir engellenmiş durumu tetikler                     |
+| GPT-5.4 artık sahte ilerleme veya sahte araç tamamlanması üretmiyor | PR A + PR D | eşdeğerlik raporu senaryo sonuçları ve sahte başarı sayısı        | şüpheli geçiş sonucu yok ve yalnızca yorum içeren tamamlanma yok                      |
+| GPT-5.4 artık yanlış `/elevated full` yönlendirmesi vermiyor | PR B        | deterministik doğruluk paketleri                                  | engellenme nedenleri ve tam erişim ipuçları çalışma zamanına uygun doğrulukta kalır   |
+| Tekrar oynatma/canlılık hataları açık kalır            | PR C + PR D | PR C yaşam döngüsü/tekrar oynatma paketleri ve `compaction-retry-mutating-tool` | değiştirici çalışma, sessizce kaybolmak yerine tekrar oynatma güvensizliğini açık tutar |
+| GPT-5.4, üzerinde anlaşılmış metriklerde Opus 4.6'ya eşit veya daha iyi | PR D        | `qa-agentic-parity-report.md` ve `qa-agentic-parity-summary.json` | aynı senaryo kapsamı ve tamamlanma, durma davranışı veya geçerli araç kullanımında gerileme olmaması |
+
+## Eşdeğerlik kararını nasıl okumalı
+
+İlk dalga eşdeğerlik paketi için son makine tarafından okunabilir karar olarak `qa-agentic-parity-summary.json` içindeki kararı kullanın.
+
+- `pass`, GPT-5.4'ün Opus 4.6 ile aynı senaryoları kapsadığı ve üzerinde anlaşılan toplu metriklerde gerileme göstermediği anlamına gelir.
+- `fail`, en az bir kesin kapının tetiklendiği anlamına gelir: daha zayıf tamamlanma, daha kötü amaç dışı durmalar, daha zayıf geçerli araç kullanımı, herhangi bir sahte başarı durumu veya eşleşmeyen senaryo kapsamı.
+- “shared/base CI issue” kendi başına bir eşdeğerlik sonucu değildir. PR D dışındaki CI gürültüsü bir çalıştırmayı engellerse, karar dal dönemine ait günlüklerden çıkarım yapmak yerine temiz bir birleştirilmiş çalışma zamanı yürütmesini beklemelidir.
+- Kimlik doğrulama, proxy, DNS ve `/elevated full` doğruluğu hâlâ PR B'nin deterministik paketlerinden gelir; bu nedenle son sürüm iddiası için her ikisi de gerekir: geçen bir PR D eşdeğerlik kararı ve yeşil PR B doğruluk kapsamı.
+
+## `strict-agentic` özelliğini kimler etkinleştirmeli
+
+`strict-agentic` özelliğini şu durumlarda kullanın:
+
+- bir sonraki adım açık olduğunda ajanın hemen harekete geçmesi bekleniyorsa
+- birincil çalışma zamanı GPT-5.4 veya Codex ailesi modellerse
+- “yardımcı” ama yalnızca özet yapan yanıtlar yerine açık engellenmiş durumları tercih ediyorsanız
+
+Şu durumlarda varsayılan sözleşmeyi koruyun:
+
+- mevcut daha gevşek davranışı istiyorsanız
+- GPT-5 ailesi modeller kullanmıyorsanız
+- çalışma zamanı zorlamasını değil istemleri test ediyorsanız
--- a/docs/tr/plugins/architecture.md
+++ b/docs/tr/plugins/architecture.md
--- a/docs/tr/plugins/manifest.md
+++ b/docs/tr/plugins/manifest.md
@ -1,14 +1,14 @@
 ---
 read_when:
-    - Bir OpenClaw plugin'i geliştiriyorsunuz
-    - Bir plugin yapılandırma şeması yayımlamanız veya plugin doğrulama hatalarında hata ayıklamanız gerekiyor
-summary: Plugin manifest + JSON şema gereksinimleri (katı yapılandırma doğrulaması)
+    - Bir OpenClaw plugin'i oluşturuyorsunuz
+    - Bir plugin yapılandırma şeması sağlamanız veya plugin doğrulama hatalarında hata ayıklamanız gerekiyor
+summary: Plugin manifesti + JSON şema gereksinimleri (katı yapılandırma doğrulaması)
 title: Plugin Manifesti
 x-i18n:
-    generated_at: "2026-04-11T02:45:48Z"
+    generated_at: "2026-04-11T15:15:58Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 6b254c121d1eb5ea19adbd4148243cf47339c960442ab1ca0e0bfd52e0154c88
+    source_hash: 42d454b560a8f6bf714c5d782f34216be1216d83d0a319d08d7349332c91a9e4
    source_path: plugins/manifest.md
    workflow: 15
 ---
@ -17,7 +17,7 @@ x-i18n:

 Bu sayfa yalnızca **yerel OpenClaw plugin manifesti** içindir.

-Uyumlu paket düzenleri için [Plugin bundles](/tr/plugins/bundles) bölümüne bakın.
+Uyumlu paket düzenleri için bkz. [Plugin paketleri](/tr/plugins/bundles).

 Uyumlu paket biçimleri farklı manifest dosyaları kullanır:

@ -26,48 +26,49 @@ Uyumlu paket biçimleri farklı manifest dosyaları kullanır:
  düzeni
 - Cursor paketi: `.cursor-plugin/plugin.json`

-OpenClaw bu paket düzenlerini de otomatik algılar, ancak bunlar burada açıklanan `openclaw.plugin.json` şemasına göre doğrulanmaz.
+OpenClaw bu paket düzenlerini de otomatik olarak algılar, ancak bunlar burada
+açıklanan `openclaw.plugin.json` şemasına göre doğrulanmaz.

-Uyumlu paketler için OpenClaw şu anda, düzen OpenClaw çalışma zamanı beklentileriyle eşleştiğinde paket meta verilerini, bildirilmiş
-skill köklerini, Claude komut köklerini, Claude paketi `settings.json` varsayılanlarını,
+Uyumlu paketler için OpenClaw şu anda, düzen OpenClaw çalışma zamanı beklentileriyle
+eşleştiğinde, paket meta verilerini ve bildirilen skill köklerini, Claude komut köklerini, Claude paketi `settings.json` varsayılanlarını,
 Claude paketi LSP varsayılanlarını ve desteklenen hook paketlerini okur.

-Her yerel OpenClaw plugin'i, **plugin kökünde**
-bir `openclaw.plugin.json` dosyası içermelidir. OpenClaw bu manifesti,
-plugin kodunu **çalıştırmadan** yapılandırmayı doğrulamak için kullanır. Eksik veya geçersiz manifestler,
-plugin hataları olarak değerlendirilir ve yapılandırma doğrulamasını engeller.
+Her yerel OpenClaw plugin'i, **plugin kökünde** bir `openclaw.plugin.json` dosyası
+bulundurmak **zorundadır**. OpenClaw bu manifesti, plugin yapılandırmasını
+**plugin kodunu çalıştırmadan** doğrulamak için kullanır. Eksik veya geçersiz
+manifestler plugin hatası olarak değerlendirilir ve yapılandırma doğrulamasını engeller.

-Tam plugin sistemi kılavuzu için bkz.: [Plugins](/tr/tools/plugin).
-Yerel yetenek modeli ve güncel dış uyumluluk yönergeleri için:
-[Capability model](/tr/plugins/architecture#public-capability-model).
+Tam plugin sistemi kılavuzuna bakın: [Plugins](/tr/tools/plugin).
+Yerel yetenek modeli ve güncel dış uyumluluk rehberi için:
+[Yetenek modeli](/tr/plugins/architecture#public-capability-model).

 ## Bu dosya ne işe yarar

-`openclaw.plugin.json`, OpenClaw'ın sizin
-plugin kodunuzu yüklemeden önce okuduğu meta verilerdir.
+`openclaw.plugin.json`, OpenClaw'un plugin kodunuzu yüklemeden önce okuduğu
+meta verilerdir.

 Şunlar için kullanın:

 - plugin kimliği
 - yapılandırma doğrulaması
- plugin çalışma zamanını başlatmadan kullanılabilir olması gereken kimlik doğrulama ve onboarding meta verileri
+- plugin çalışma zamanını başlatmadan kullanılabilir olması gereken auth ve onboarding meta verileri
+- çalışma zamanı yüklenmeden önce kontrol düzlemi yüzeylerinin inceleyebileceği düşük maliyetli etkinleştirme ipuçları
+- çalışma zamanı yüklenmeden önce kurulum/onboarding yüzeylerinin inceleyebileceği düşük maliyetli kurulum tanımlayıcıları
 - plugin çalışma zamanı yüklenmeden önce çözümlenmesi gereken takma ad ve otomatik etkinleştirme meta verileri
- plugin'i çalışma zamanı yüklenmeden önce otomatik etkinleştirmesi gereken
-  kısaltılmış model ailesi sahipliği meta verileri
- bundled uyumluluk bağlama ve sözleşme kapsamı için kullanılan statik yetenek sahipliği anlık görüntüleri
- çalışma zamanını yüklemeden katalog ve doğrulama
-  yüzeylerine birleştirilmesi gereken kanala özgü yapılandırma meta verileri
- yapılandırma UI ipuçları
+- çalışma zamanı yüklenmeden önce plugin'i otomatik etkinleştirmesi gereken kısa model ailesi sahipliği meta verileri
+- paketlenmiş uyumluluk bağlantıları ve sözleşme kapsamı için kullanılan statik yetenek sahipliği anlık görüntüleri
+- çalışma zamanı yüklenmeden katalog ve doğrulama yüzeylerine birleştirilmesi gereken kanala özgü yapılandırma meta verileri
+- yapılandırma arayüzü ipuçları

 Şunlar için kullanmayın:

 - çalışma zamanı davranışını kaydetmek
- kod entrypoint'lerini bildirmek
- npm install meta verileri
+- kod giriş noktalarını bildirmek
+- npm kurulum meta verileri

-Bunlar plugin kodunuza ve `package.json` dosyanıza aittir.
+Bunlar plugin kodunuza ve `package.json` dosyasına aittir.

-## Minimum örnek
+## Minimal örnek

 ```json
 {
@ -86,7 +87,7 @@ Bunlar plugin kodunuza ve `package.json` dosyanıza aittir.
 {
  "id": "openrouter",
  "name": "OpenRouter",
-  "description": "OpenRouter sağlayıcı plugin'i",
+  "description": "OpenRouter provider plugin",
  "version": "1.0.0",
  "providers": ["openrouter"],
  "modelSupport": {
@ -107,19 +108,19 @@ Bunlar plugin kodunuza ve `package.json` dosyanıza aittir.
      "provider": "openrouter",
      "method": "api-key",
      "choiceId": "openrouter-api-key",
-      "choiceLabel": "OpenRouter API anahtarı",
+      "choiceLabel": "OpenRouter API key",
      "groupId": "openrouter",
      "groupLabel": "OpenRouter",
      "optionKey": "openrouterApiKey",
      "cliFlag": "--openrouter-api-key",
      "cliOption": "--openrouter-api-key <key>",
-      "cliDescription": "OpenRouter API anahtarı",
+      "cliDescription": "OpenRouter API key",
      "onboardingScopes": ["text-inference"]
    }
  ],
  "uiHints": {
    "apiKey": {
-      "label": "API anahtarı",
+      "label": "API key",
      "placeholder": "sk-or-v1-...",
      "sensitive": true
    }
@ -138,59 +139,60 @@ Bunlar plugin kodunuza ve `package.json` dosyanıza aittir.

 ## Üst düzey alan başvurusu

-| Alan                                | Gerekli | Tür                              | Anlamı                                                                                                                                                                                                       |
+| Alan                                | Zorunlu | Tür                              | Anlamı                                                                                                                                                                                                       |
 | ----------------------------------- | ------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `id`                                | Evet    | `string`                         | Kanonik plugin kimliği. `plugins.entries.<id>` içinde kullanılan kimlik budur.                                                                                                                              |
+| `id`                                | Evet    | `string`                         | Kanonik plugin kimliği. Bu, `plugins.entries.<id>` içinde kullanılan kimliktir.                                                                                                                              |
 | `configSchema`                      | Evet    | `object`                         | Bu plugin'in yapılandırması için satır içi JSON Şeması.                                                                                                                                                      |
-| `enabledByDefault`                  | Hayır   | `true`                           | Bir bundled plugin'in varsayılan olarak etkin olduğunu işaretler. Plugin'i varsayılan olarak devre dışı bırakmak için bunu çıkarın veya `true` dışındaki herhangi bir değer ayarlayın.                     |
+| `enabledByDefault`                  | Hayır   | `true`                           | Paketlenmiş bir plugin'in varsayılan olarak etkin olduğunu belirtir. Plugin'i varsayılan olarak devre dışı bırakmak için bunu atlayın veya `true` dışındaki herhangi bir değere ayarlayın.                 |
 | `legacyPluginIds`                   | Hayır   | `string[]`                       | Bu kanonik plugin kimliğine normalize edilen eski kimlikler.                                                                                                                                                 |
-| `autoEnableWhenConfiguredProviders` | Hayır   | `string[]`                       | Kimlik doğrulama, yapılandırma veya model başvuruları bunları andığında bu plugin'i otomatik etkinleştirmesi gereken sağlayıcı kimlikleri.                                                                  |
-| `kind`                              | Hayır   | `"memory"` \| `"context-engine"` | `plugins.slots.*` tarafından kullanılan dışlayıcı bir plugin türü bildirir.                                                                                                                                 |
-| `channels`                          | Hayır   | `string[]`                       | Bu plugin'in sahip olduğu kanal kimlikleri. Keşif ve yapılandırma doğrulaması için kullanılır.                                                                                                              |
-| `providers`                         | Hayır   | `string[]`                       | Bu plugin'in sahip olduğu sağlayıcı kimlikleri.                                                                                                                                                              |
-| `modelSupport`                      | Hayır   | `object`                         | Çalışma zamanından önce plugin'i otomatik yüklemek için kullanılan, manifestin sahip olduğu kısaltılmış model ailesi meta verileri.                                                                         |
-| `cliBackends`                       | Hayır   | `string[]`                       | Bu plugin'in sahip olduğu CLI çıkarım backend kimlikleri. Açık yapılandırma başvurularından başlangıçta otomatik etkinleştirme için kullanılır.                                                             |
-| `commandAliases`                    | Hayır   | `object[]`                       | Çalışma zamanı yüklenmeden önce plugin farkındalıklı yapılandırma ve CLI tanılamaları üretmesi gereken, bu plugin'in sahip olduğu komut adları.                                                              |
-| `providerAuthEnvVars`               | Hayır   | `Record<string, string[]>`       | OpenClaw'ın plugin kodunu yüklemeden inceleyebileceği düşük maliyetli sağlayıcı kimlik doğrulama ortam değişkeni meta verileri.                                                                             |
-| `providerAuthAliases`               | Hayır   | `Record<string, string>`         | Kimlik doğrulama araması için başka bir sağlayıcı kimliğini yeniden kullanması gereken sağlayıcı kimlikleri; örneğin temel sağlayıcı API anahtarını ve kimlik doğrulama profillerini paylaşan bir coding sağlayıcısı. |
-| `channelEnvVars`                    | Hayır   | `Record<string, string[]>`       | OpenClaw'ın plugin kodunu yüklemeden inceleyebileceği düşük maliyetli kanal ortam değişkeni meta verileri. Bunu, genel başlangıç/yapılandırma yardımcılarının görmesi gereken ortam değişkeni odaklı kanal kurulumu veya kimlik doğrulama yüzeyleri için kullanın. |
-| `providerAuthChoices`               | Hayır   | `object[]`                       | Onboarding seçicileri, tercih edilen sağlayıcı çözümlemesi ve basit CLI bayrağı bağlaması için düşük maliyetli kimlik doğrulama seçimi meta verileri.                                                      |
-| `contracts`                         | Hayır   | `object`                         | Speech, realtime transcription, realtime voice, media-understanding, image-generation, music-generation, video-generation, web-fetch, web search ve araç sahipliği için statik bundled yetenek anlık görüntüsü. |
-| `channelConfigs`                    | Hayır   | `Record<string, object>`         | Çalışma zamanı yüklenmeden önce keşif ve doğrulama yüzeylerine birleştirilen, manifestin sahip olduğu kanal yapılandırma meta verileri.                                                                      |
+| `autoEnableWhenConfiguredProviders` | Hayır   | `string[]`                       | Auth, yapılandırma veya model başvuruları bunlardan bahsettiğinde bu plugin'i otomatik olarak etkinleştirmesi gereken provider kimlikleri.                                                                  |
+| `kind`                              | Hayır   | `"memory"` \| `"context-engine"` | `plugins.slots.*` tarafından kullanılan özel bir plugin türünü bildirir.                                                                                                                                     |
+| `channels`                          | Hayır   | `string[]`                       | Bu plugin'e ait kanal kimlikleri. Keşif ve yapılandırma doğrulaması için kullanılır.                                                                                                                         |
+| `providers`                         | Hayır   | `string[]`                       | Bu plugin'e ait provider kimlikleri.                                                                                                                                                                         |
+| `modelSupport`                      | Hayır   | `object`                         | Çalışma zamanından önce plugin'i otomatik yüklemek için kullanılan, manifest sahipli kısa model ailesi meta verileri.                                                                                        |
+| `cliBackends`                       | Hayır   | `string[]`                       | Bu plugin'e ait CLI çıkarım backend kimlikleri. Açık yapılandırma başvurularından başlangıçta otomatik etkinleştirme için kullanılır.                                                                       |
+| `commandAliases`                    | Hayır   | `object[]`                       | Çalışma zamanı yüklenmeden önce plugin farkındalıklı yapılandırma ve CLI tanılamaları üretmesi gereken, bu plugin'e ait komut adları.                                                                        |
+| `providerAuthEnvVars`               | Hayır   | `Record<string, string[]>`       | OpenClaw'un plugin kodunu yüklemeden inceleyebileceği düşük maliyetli provider auth ortam değişkeni meta verileri.                                                                                          |
+| `providerAuthAliases`               | Hayır   | `Record<string, string>`         | Auth araması için başka bir provider kimliğini yeniden kullanması gereken provider kimlikleri; örneğin temel provider API anahtarını ve auth profillerini paylaşan bir coding provider.                     |
+| `channelEnvVars`                    | Hayır   | `Record<string, string[]>`       | OpenClaw'un plugin kodunu yüklemeden inceleyebileceği düşük maliyetli kanal ortam değişkeni meta verileri. Bunu, genel başlangıç/yapılandırma yardımcılarının görmesi gereken env tabanlı kanal kurulumu veya auth yüzeyleri için kullanın. |
+| `providerAuthChoices`               | Hayır   | `object[]`                       | Onboarding seçicileri, tercih edilen provider çözümleme ve basit CLI bayrağı bağlama için düşük maliyetli auth seçeneği meta verileri.                                                                      |
+| `activation`                        | Hayır   | `object`                         | Provider, komut, kanal, rota ve yetenek tetiklemeli yükleme için düşük maliyetli etkinleştirme ipuçları. Yalnızca meta veri; gerçek davranış yine plugin çalışma zamanına aittir.                           |
+| `setup`                             | Hayır   | `object`                         | Keşif ve kurulum yüzeylerinin plugin çalışma zamanını yüklemeden inceleyebileceği düşük maliyetli kurulum/onboarding tanımlayıcıları.                                                                        |
+| `contracts`                         | Hayır   | `object`                         | Speech, gerçek zamanlı transcription, gerçek zamanlı voice, media-understanding, image-generation, music-generation, video-generation, web-fetch, web search ve tool sahipliği için statik paketlenmiş yetenek anlık görüntüsü. |
+| `channelConfigs`                    | Hayır   | `Record<string, object>`         | Çalışma zamanı yüklenmeden önce keşif ve doğrulama yüzeylerine birleştirilen, manifest sahipli kanal yapılandırma meta verileri.                                                                              |
 | `skills`                            | Hayır   | `string[]`                       | Plugin köküne göre göreli olarak yüklenecek Skills dizinleri.                                                                                                                                                |
 | `name`                              | Hayır   | `string`                         | İnsan tarafından okunabilir plugin adı.                                                                                                                                                                      |
 | `description`                       | Hayır   | `string`                         | Plugin yüzeylerinde gösterilen kısa özet.                                                                                                                                                                    |
 | `version`                           | Hayır   | `string`                         | Bilgilendirici plugin sürümü.                                                                                                                                                                                |
-| `uiHints`                           | Hayır   | `Record<string, object>`         | Yapılandırma alanları için UI etiketleri, placeholder'lar ve hassasiyet ipuçları.                                                                                                                           |
+| `uiHints`                           | Hayır   | `Record<string, object>`         | Yapılandırma alanları için UI etiketleri, yer tutucular ve hassasiyet ipuçları.                                                                                                                              |

-## `providerAuthChoices` başvurusu
+## providerAuthChoices başvurusu

-Her `providerAuthChoices` girdisi bir onboarding veya kimlik doğrulama seçimini açıklar.
-OpenClaw bunu sağlayıcı çalışma zamanı yüklenmeden önce okur.
+Her `providerAuthChoices` girdisi bir onboarding veya auth seçeneğini açıklar.
+OpenClaw bunu provider çalışma zamanı yüklenmeden önce okur.

-| Alan                  | Gerekli | Tür                                             | Anlamı                                                                                                   |
-| --------------------- | ------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
-| `provider`            | Evet    | `string`                                        | Bu seçimin ait olduğu sağlayıcı kimliği.                                                                 |
-| `method`              | Evet    | `string`                                        | Yönlendirilecek kimlik doğrulama yöntemi kimliği.                                                        |
-| `choiceId`            | Evet    | `string`                                        | Onboarding ve CLI akışları tarafından kullanılan kararlı kimlik doğrulama seçimi kimliği.               |
-| `choiceLabel`         | Hayır   | `string`                                        | Kullanıcıya dönük etiket. Atlanırsa OpenClaw `choiceId` değerine geri döner.                            |
-| `choiceHint`          | Hayır   | `string`                                        | Seçici için kısa yardımcı metin.                                                                         |
-| `assistantPriority`   | Hayır   | `number`                                        | Assistant tarafından yönlendirilen etkileşimli seçicilerde daha düşük değerler daha önce sıralanır.     |
-| `assistantVisibility` | Hayır   | `"visible"` \| `"manual-only"`                  | Manuel CLI seçimine izin vermeye devam ederken seçimi assistant seçicilerinden gizler.                  |
-| `deprecatedChoiceIds` | Hayır   | `string[]`                                      | Kullanıcıları bu yerine geçen seçime yönlendirmesi gereken eski seçim kimlikleri.                       |
-| `groupId`             | Hayır   | `string`                                        | İlgili seçimleri gruplamak için isteğe bağlı grup kimliği.                                              |
-| `groupLabel`          | Hayır   | `string`                                        | Bu grup için kullanıcıya dönük etiket.                                                                   |
-| `groupHint`           | Hayır   | `string`                                        | Grup için kısa yardımcı metin.                                                                           |
-| `optionKey`           | Hayır   | `string`                                        | Basit tek bayraklı kimlik doğrulama akışları için dahili seçenek anahtarı.                              |
-| `cliFlag`             | Hayır   | `string`                                        | `--openrouter-api-key` gibi CLI bayrak adı.                                                              |
-| `cliOption`           | Hayır   | `string`                                        | `--openrouter-api-key <key>` gibi tam CLI seçenek şekli.                                                 |
-| `cliDescription`      | Hayır   | `string`                                        | CLI yardımında kullanılan açıklama.                                                                      |
-| `onboardingScopes`    | Hayır   | `Array<"text-inference" \| "image-generation">` | Bu seçimin hangi onboarding yüzeylerinde görünmesi gerektiği. Atlanırsa varsayılan `["text-inference"]` olur. |
+| Alan                  | Zorunlu | Tür                                               | Anlamı                                                                                                     |
+| --------------------- | ------- | ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| `provider`            | Evet    | `string`                                          | Bu seçeneğin ait olduğu provider kimliği.                                                                  |
+| `method`              | Evet    | `string`                                          | Yönlendirilecek auth yöntemi kimliği.                                                                      |
+| `choiceId`            | Evet    | `string`                                          | Onboarding ve CLI akışlarında kullanılan kararlı auth seçeneği kimliği.                                   |
+| `choiceLabel`         | Hayır   | `string`                                          | Kullanıcıya gösterilen etiket. Atlanırsa OpenClaw `choiceId` değerine geri döner.                         |
+| `choiceHint`          | Hayır   | `string`                                          | Seçici için kısa yardımcı metin.                                                                           |
+| `assistantPriority`   | Hayır   | `number`                                          | Daha düşük değerler, asistan tarafından yönlendirilen etkileşimli seçicilerde daha önce sıralanır.        |
+| `assistantVisibility` | Hayır   | `"visible"` \| `"manual-only"`                    | Manuel CLI seçimine yine izin verirken seçeneği asistan seçicilerinden gizler.                            |
+| `deprecatedChoiceIds` | Hayır   | `string[]`                                        | Kullanıcıları bu yerine geçen seçeneğe yönlendirmesi gereken eski seçenek kimlikleri.                     |
+| `groupId`             | Hayır   | `string`                                          | İlgili seçenekleri gruplamak için isteğe bağlı grup kimliği.                                               |
+| `groupLabel`          | Hayır   | `string`                                          | Bu grup için kullanıcıya gösterilen etiket.                                                                |
+| `groupHint`           | Hayır   | `string`                                          | Grup için kısa yardımcı metin.                                                                             |
+| `optionKey`           | Hayır   | `string`                                          | Basit tek bayraklı auth akışları için dahili seçenek anahtarı.                                             |
+| `cliFlag`             | Hayır   | `string`                                          | `--openrouter-api-key` gibi CLI bayrağı adı.                                                               |
+| `cliOption`           | Hayır   | `string`                                          | `--openrouter-api-key <key>` gibi tam CLI seçenek biçimi.                                                  |
+| `cliDescription`      | Hayır   | `string`                                          | CLI yardımında kullanılan açıklama.                                                                        |
+| `onboardingScopes`    | Hayır   | `Array<"text-inference" \| "image-generation">`   | Bu seçeneğin hangi onboarding yüzeylerinde görünmesi gerektiği. Atlanırsa varsayılan olarak `["text-inference"]` kullanılır. |

-## `commandAliases` başvurusu
+## commandAliases başvurusu

-Kullanıcıların yanlışlıkla `plugins.allow` içine koyabileceği veya kök bir CLI komutu olarak çalıştırmaya çalışabileceği bir çalışma zamanı komut adına plugin sahipse `commandAliases` kullanın. OpenClaw
-bu meta verileri, plugin çalışma zamanı kodunu içe aktarmadan tanılama amacıyla kullanır.
+Bir plugin, kullanıcıların yanlışlıkla `plugins.allow` içine koyabileceği veya kök CLI komutu olarak çalıştırmayı deneyebileceği bir çalışma zamanı komut adına sahipse `commandAliases` kullanın. OpenClaw bu meta veriyi, plugin çalışma zamanı kodunu içe aktarmadan tanılama için kullanır.

 ```json
 {
@ -204,22 +206,88 @@ bu meta verileri, plugin çalışma zamanı kodunu içe aktarmadan tanılama ama
 }
 ```

-| Alan         | Gerekli | Tür               | Anlamı                                                                      |
+| Alan         | Zorunlu | Tür               | Anlamı                                                                      |
 | ------------ | ------- | ----------------- | ---------------------------------------------------------------------------- |
 | `name`       | Evet    | `string`          | Bu plugin'e ait komut adı.                                                   |
-| `kind`       | Hayır   | `"runtime-slash"` | Takma adı, kök bir CLI komutu yerine sohbet slash komutu olarak işaretler.   |
-| `cliCommand` | Hayır   | `string`          | Varsa CLI işlemleri için önerilecek ilgili kök CLI komutu.                   |
+| `kind`       | Hayır   | `"runtime-slash"` | Takma adı, kök CLI komutu yerine bir sohbet slash komutu olarak işaretler.   |
+| `cliCommand` | Hayır   | `string`          | Varsa, CLI işlemleri için önerilecek ilişkili kök CLI komutu.                |

-## `uiHints` başvurusu
+## activation başvurusu

-`uiHints`, yapılandırma alanı adlarından küçük render ipuçlarına giden bir eşlemedir.
+Plugin daha sonra hangi kontrol düzlemi olaylarının onu etkinleştirmesi gerektiğini düşük maliyetle bildirebiliyorsa `activation` kullanın.
+
+Bu blok yalnızca meta veridir. Çalışma zamanı davranışını kaydetmez ve `register(...)`, `setupEntry` veya diğer çalışma zamanı/plugin giriş noktalarının yerine geçmez.
+
+```json
+{
+  "activation": {
+    "onProviders": ["openai"],
+    "onCommands": ["models"],
+    "onChannels": ["web"],
+    "onRoutes": ["gateway-webhook"],
+    "onCapabilities": ["provider", "tool"]
+  }
+}
+```
+
+| Alan             | Zorunlu | Tür                                                  | Anlamı                                                            |
+| ---------------- | ------- | ---------------------------------------------------- | ----------------------------------------------------------------- |
+| `onProviders`    | Hayır   | `string[]`                                           | İstendiğinde bu plugin'i etkinleştirmesi gereken provider kimlikleri. |
+| `onCommands`     | Hayır   | `string[]`                                           | Bu plugin'i etkinleştirmesi gereken komut kimlikleri.             |
+| `onChannels`     | Hayır   | `string[]`                                           | Bu plugin'i etkinleştirmesi gereken kanal kimlikleri.             |
+| `onRoutes`       | Hayır   | `string[]`                                           | Bu plugin'i etkinleştirmesi gereken rota türleri.                 |
+| `onCapabilities` | Hayır   | `Array<"provider" \| "channel" \| "tool" \| "hook">` | Kontrol düzlemi etkinleştirme planlamasında kullanılan geniş yetenek ipuçları. |
+
+## setup başvurusu
+
+Kurulum ve onboarding yüzeyleri çalışma zamanı yüklenmeden önce plugin'e ait düşük maliyetli meta verilere ihtiyaç duyuyorsa `setup` kullanın.
+
+```json
+{
+  "setup": {
+    "providers": [
+      {
+        "id": "openai",
+        "authMethods": ["api-key"],
+        "envVars": ["OPENAI_API_KEY"]
+      }
+    ],
+    "cliBackends": ["openai-cli"],
+    "configMigrations": ["legacy-openai-auth"],
+    "requiresRuntime": false
+  }
+}
+```
+
+Üst düzey `cliBackends` geçerliliğini korur ve CLI çıkarım backend'lerini tanımlamaya devam eder. `setup.cliBackends`, yalnızca meta veri olarak kalması gereken kontrol düzlemi/kurulum akışları için kurulum odaklı tanımlayıcı yüzeyidir.
+
+### setup.providers başvurusu
+
+| Alan          | Zorunlu | Tür        | Anlamı                                                                                 |
+| ------------- | ------- | ---------- | --------------------------------------------------------------------------------------- |
+| `id`          | Evet    | `string`   | Kurulum veya onboarding sırasında gösterilen provider kimliği.                          |
+| `authMethods` | Hayır   | `string[]` | Tam çalışma zamanı yüklenmeden bu provider'ın desteklediği kurulum/auth yöntem kimlikleri. |
+| `envVars`     | Hayır   | `string[]` | Genel kurulum/durum yüzeylerinin plugin çalışma zamanı yüklenmeden kontrol edebileceği ortam değişkenleri. |
+
+### setup alanları
+
+| Alan               | Zorunlu | Tür        | Anlamı                                                                    |
+| ------------------ | ------- | ---------- | -------------------------------------------------------------------------- |
+| `providers`        | Hayır   | `object[]` | Kurulum ve onboarding sırasında gösterilen provider kurulum tanımlayıcıları. |
+| `cliBackends`      | Hayır   | `string[]` | Tam çalışma zamanı etkinleştirmesi olmadan kullanılabilen kurulum zamanı backend kimlikleri. |
+| `configMigrations` | Hayır   | `string[]` | Bu plugin'in kurulum yüzeyine ait yapılandırma geçişi kimlikleri.         |
+| `requiresRuntime`  | Hayır   | `boolean`  | Tanımlayıcı aramasından sonra kurulumun hâlâ plugin çalışma zamanını çalıştırmaya ihtiyaç duyup duymadığı. |
+
+## uiHints başvurusu
+
+`uiHints`, yapılandırma alan adlarından küçük işleme ipuçlarına giden bir eşlemedir.

 ```json
 {
  "uiHints": {
    "apiKey": {
-      "label": "API anahtarı",
-      "help": "OpenRouter istekleri için kullanılır",
+      "label": "API key",
+      "help": "Used for OpenRouter requests",
      "placeholder": "sk-or-v1-...",
      "sensitive": true
    }
@ -229,19 +297,18 @@ bu meta verileri, plugin çalışma zamanı kodunu içe aktarmadan tanılama ama

 Her alan ipucu şunları içerebilir:

-| Alan          | Tür        | Anlamı                                 |
-| ------------- | ---------- | -------------------------------------- |
-| `label`       | `string`   | Kullanıcıya dönük alan etiketi.        |
-| `help`        | `string`   | Kısa yardımcı metin.                   |
-| `tags`        | `string[]` | İsteğe bağlı UI etiketleri.            |
-| `advanced`    | `boolean`  | Alanı gelişmiş olarak işaretler.       |
+| Alan          | Tür        | Anlamı                                |
+| ------------- | ---------- | ------------------------------------- |
+| `label`       | `string`   | Kullanıcıya gösterilen alan etiketi.  |
+| `help`        | `string`   | Kısa yardımcı metin.                  |
+| `tags`        | `string[]` | İsteğe bağlı UI etiketleri.           |
+| `advanced`    | `boolean`  | Alanı gelişmiş olarak işaretler.      |
 | `sensitive`   | `boolean`  | Alanı gizli veya hassas olarak işaretler. |
-| `placeholder` | `string`   | Form girdileri için placeholder metni. |
+| `placeholder` | `string`   | Form girdileri için yer tutucu metin. |

-## `contracts` başvurusu
+## contracts başvurusu

-`contracts` alanını yalnızca OpenClaw'ın
-plugin çalışma zamanını içe aktarmadan okuyabileceği statik yetenek sahipliği meta verileri için kullanın.
+OpenClaw'un plugin çalışma zamanını içe aktarmadan okuyabildiği statik yetenek sahipliği meta verileri için yalnızca `contracts` kullanın.

 ```json
 {
@ -261,21 +328,21 @@ plugin çalışma zamanını içe aktarmadan okuyabileceği statik yetenek sahip

 Her liste isteğe bağlıdır:

-| Alan                             | Tür        | Anlamı                                                      |
-| -------------------------------- | ---------- | ----------------------------------------------------------- |
-| `speechProviders`                | `string[]` | Bu plugin'in sahip olduğu speech sağlayıcı kimlikleri.      |
-| `realtimeTranscriptionProviders` | `string[]` | Bu plugin'in sahip olduğu realtime transcription sağlayıcı kimlikleri. |
-| `realtimeVoiceProviders`         | `string[]` | Bu plugin'in sahip olduğu realtime voice sağlayıcı kimlikleri. |
-| `mediaUnderstandingProviders`    | `string[]` | Bu plugin'in sahip olduğu media-understanding sağlayıcı kimlikleri. |
-| `imageGenerationProviders`       | `string[]` | Bu plugin'in sahip olduğu image-generation sağlayıcı kimlikleri. |
-| `videoGenerationProviders`       | `string[]` | Bu plugin'in sahip olduğu video-generation sağlayıcı kimlikleri. |
-| `webFetchProviders`              | `string[]` | Bu plugin'in sahip olduğu web-fetch sağlayıcı kimlikleri.   |
-| `webSearchProviders`             | `string[]` | Bu plugin'in sahip olduğu web search sağlayıcı kimlikleri.  |
-| `tools`                          | `string[]` | Bundled sözleşme kontrolleri için bu plugin'in sahip olduğu agent araç adları. |
+| Alan                             | Tür        | Anlamı                                                         |
+| -------------------------------- | ---------- | --------------------------------------------------------------- |
+| `speechProviders`                | `string[]` | Bu plugin'in sahip olduğu speech provider kimlikleri.           |
+| `realtimeTranscriptionProviders` | `string[]` | Bu plugin'in sahip olduğu gerçek zamanlı transcription provider kimlikleri. |
+| `realtimeVoiceProviders`         | `string[]` | Bu plugin'in sahip olduğu gerçek zamanlı voice provider kimlikleri. |
+| `mediaUnderstandingProviders`    | `string[]` | Bu plugin'in sahip olduğu media-understanding provider kimlikleri. |
+| `imageGenerationProviders`       | `string[]` | Bu plugin'in sahip olduğu image-generation provider kimlikleri. |
+| `videoGenerationProviders`       | `string[]` | Bu plugin'in sahip olduğu video-generation provider kimlikleri. |
+| `webFetchProviders`              | `string[]` | Bu plugin'in sahip olduğu web-fetch provider kimlikleri.        |
+| `webSearchProviders`             | `string[]` | Bu plugin'in sahip olduğu web-search provider kimlikleri.       |
+| `tools`                          | `string[]` | Paketlenmiş sözleşme kontrolleri için bu plugin'in sahip olduğu ajan tool adları. |

-## `channelConfigs` başvurusu
+## channelConfigs başvurusu

-Bir kanal plugin'i, çalışma zamanı yüklenmeden önce düşük maliyetli yapılandırma meta verilerine ihtiyaç duyuyorsa `channelConfigs` kullanın.
+Bir kanal plugin'i çalışma zamanı yüklenmeden önce düşük maliyetli yapılandırma meta verilerine ihtiyaç duyuyorsa `channelConfigs` kullanın.

 ```json
 {
@ -295,7 +362,7 @@ Bir kanal plugin'i, çalışma zamanı yüklenmeden önce düşük maliyetli yap
        }
      },
      "label": "Matrix",
-      "description": "Matrix homeserver bağlantısı",
+      "description": "Matrix homeserver connection",
      "preferOver": ["matrix-legacy"]
    }
  }
@ -304,18 +371,17 @@ Bir kanal plugin'i, çalışma zamanı yüklenmeden önce düşük maliyetli yap

 Her kanal girdisi şunları içerebilir:

-| Alan          | Tür                      | Anlamı                                                                                   |
-| ------------- | ------------------------ | ---------------------------------------------------------------------------------------- |
-| `schema`      | `object`                 | `channels.<id>` için JSON Şeması. Bildirilen her kanal yapılandırma girdisi için gereklidir. |
-| `uiHints`     | `Record<string, object>` | Bu kanal yapılandırma bölümü için isteğe bağlı UI etiketleri/placeholder'lar/hassas ipuçları. |
-| `label`       | `string`                 | Çalışma zamanı meta verileri hazır olmadığında seçiciye ve inceleme yüzeylerine birleştirilen kanal etiketi. |
-| `description` | `string`                 | İnceleme ve katalog yüzeyleri için kısa kanal açıklaması.                                |
-| `preferOver`  | `string[]`               | Seçim yüzeylerinde bunun gerisinde kalması gereken eski veya daha düşük öncelikli plugin kimlikleri. |
+| Alan         | Tür                      | Anlamı                                                                                      |
+| ------------ | ------------------------ | ------------------------------------------------------------------------------------------- |
+| `schema`      | `object`                 | `channels.<id>` için JSON Şeması. Bildirilen her kanal yapılandırma girdisi için zorunludur. |
+| `uiHints`     | `Record<string, object>` | Bu kanal yapılandırma bölümü için isteğe bağlı UI etiketleri/yer tutucular/hassas ipuçları. |
+| `label`       | `string`                 | Çalışma zamanı meta verileri hazır olmadığında seçici ve inceleme yüzeylerine birleştirilen kanal etiketi. |
+| `description` | `string`                 | İnceleme ve katalog yüzeyleri için kısa kanal açıklaması.                                   |
+| `preferOver`  | `string[]`               | Bu kanalın seçim yüzeylerinde geride bırakması gereken eski veya daha düşük öncelikli plugin kimlikleri. |

-## `modelSupport` başvurusu
+## modelSupport başvurusu

-OpenClaw'ın, plugin çalışma zamanı yüklenmeden önce `gpt-5.4` veya `claude-sonnet-4.6` gibi
-kısaltılmış model kimliklerinden sağlayıcı plugin'inizi çıkarım yapmasını istiyorsanız `modelSupport` kullanın.
+OpenClaw'un, plugin çalışma zamanı yüklenmeden önce `gpt-5.4` veya `claude-sonnet-4.6` gibi kısa model kimliklerinden provider plugin'inizi çıkarsaması gerekiyorsa `modelSupport` kullanın.

 ```json
 {
@ -326,74 +392,60 @@ kısaltılmış model kimliklerinden sağlayıcı plugin'inizi çıkarım yapmas
 }
 ```

-OpenClaw şu önceliği uygular:
+OpenClaw şu öncelik sırasını uygular:

 - açık `provider/model` başvuruları, sahip olan `providers` manifest meta verilerini kullanır
- `modelPatterns`, `modelPrefixes` üzerinde önceliklidir
- bir bundled olmayan plugin ile bir bundled plugin aynı anda eşleşirse, bundled olmayan
-  plugin kazanır
- kalan belirsizlik, kullanıcı veya yapılandırma bir sağlayıcı belirtinceye kadar yok sayılır
+- `modelPatterns`, `modelPrefixes` değerlerinden önce gelir
+- paketlenmemiş bir plugin ile paketlenmiş bir plugin aynı anda eşleşirse, paketlenmemiş plugin kazanır
+- kalan belirsizlik, kullanıcı veya yapılandırma bir provider belirtinceye kadar yok sayılır

 Alanlar:

-| Alan            | Tür        | Anlamı                                                                        |
+| Alan            | Tür        | Anlamı                                                                       |
 | --------------- | ---------- | ----------------------------------------------------------------------------- |
-| `modelPrefixes` | `string[]` | Kısaltılmış model kimliklerine `startsWith` ile eşleştirilen önekler.         |
-| `modelPatterns` | `string[]` | Profil son eki kaldırıldıktan sonra kısaltılmış model kimliklerine göre eşleştirilen regex kaynakları. |
+| `modelPrefixes` | `string[]` | Kısa model kimliklerine karşı `startsWith` ile eşleştirilen önekler.          |
+| `modelPatterns` | `string[]` | Profil soneki kaldırıldıktan sonra kısa model kimliklerine karşı eşleştirilen regex kaynakları. |

-Eski üst düzey yetenek anahtarları kullanımdan kaldırılmıştır. `speechProviders`, `realtimeTranscriptionProviders`,
-`realtimeVoiceProviders`, `mediaUnderstandingProviders`,
-`imageGenerationProviders`, `videoGenerationProviders`,
-`webFetchProviders` ve `webSearchProviders` alanlarını `contracts` altına taşımak için
-`openclaw doctor --fix` kullanın; normal
-manifest yüklemesi artık bu üst düzey alanları yetenek sahipliği olarak değerlendirmez.
+Eski üst düzey yetenek anahtarları kullanımdan kaldırılmıştır. `speechProviders`, `realtimeTranscriptionProviders`, `realtimeVoiceProviders`, `mediaUnderstandingProviders`, `imageGenerationProviders`, `videoGenerationProviders`, `webFetchProviders` ve `webSearchProviders` alanlarını `contracts` altına taşımak için `openclaw doctor --fix` kullanın; normal manifest yükleme artık bu üst düzey alanları yetenek sahipliği olarak değerlendirmez.

-## Manifest ile `package.json` karşılaştırması
+## Manifest ve package.json karşılaştırması

-Bu iki dosya farklı işlere hizmet eder:
+İki dosya farklı işler görür:

-| Dosya                  | Şunun için kullanın                                                                                                                |
+| Dosya                  | Kullanım amacı                                                                                                                     |
 | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
-| `openclaw.plugin.json` | Keşif, yapılandırma doğrulaması, kimlik doğrulama seçimi meta verileri ve plugin kodu çalışmadan önce var olması gereken UI ipuçları |
-| `package.json`         | npm meta verileri, bağımlılık kurulumu ve entrypoint'ler, kurulum geçitlemesi, kurulum veya katalog meta verileri için kullanılan `openclaw` bloğu |
+| `openclaw.plugin.json` | Plugin kodu çalışmadan önce var olması gereken keşif, yapılandırma doğrulaması, auth seçeneği meta verileri ve UI ipuçları       |
+| `package.json`         | npm meta verileri, bağımlılık kurulumu ve giriş noktaları, kurulum engelleme, setup veya katalog meta verileri için kullanılan `openclaw` bloğu |

-Bir meta veri parçasının nereye ait olduğundan emin değilseniz şu kuralı kullanın:
+Bir meta verinin nereye ait olduğundan emin değilseniz şu kuralı kullanın:

- OpenClaw bunu plugin kodunu yüklemeden önce bilmek zorundaysa, `openclaw.plugin.json` içine koyun
- paketleme, giriş dosyaları veya npm install davranışı ile ilgiliyse, `package.json` içine koyun
+- OpenClaw bunun plugin kodunu yüklemeden önce bilmek zorundaysa, `openclaw.plugin.json` içine koyun
+- paketleme, giriş dosyaları veya npm kurulum davranışıyla ilgiliyse, `package.json` içine koyun

-### Keşfi etkileyen `package.json` alanları
+### Keşfi etkileyen package.json alanları

-Bazı çalışma zamanı öncesi plugin meta verileri, bilinçli olarak
-`openclaw.plugin.json` yerine `package.json` içindeki
-`openclaw` bloğu altında tutulur.
+Bazı çalışma zamanı öncesi plugin meta verileri, kasıtlı olarak `openclaw.plugin.json` yerine `package.json` içindeki `openclaw` bloğunda bulunur.

 Önemli örnekler:

-| Alan                                                              | Anlamı                                                                                                                                      |
-| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
-| `openclaw.extensions`                                             | Yerel plugin entrypoint'lerini bildirir.                                                                                                    |
-| `openclaw.setupEntry`                                             | Onboarding ve ertelenmiş kanal başlangıcı sırasında kullanılan hafif, yalnızca kurulum amaçlı entrypoint.                                  |
-| `openclaw.channel`                                                | Etiketler, doküman yolları, takma adlar ve seçim metni gibi düşük maliyetli kanal katalog meta verileri.                                   |
-| `openclaw.channel.configuredState`                                | Tam kanal çalışma zamanını yüklemeden “yalnızca env tabanlı kurulum zaten var mı?” sorusunu yanıtlayabilen hafif configured-state denetleyici meta verileri. |
-| `openclaw.channel.persistedAuthState`                             | Tam kanal çalışma zamanını yüklemeden “zaten oturum açılmış bir şey var mı?” sorusunu yanıtlayabilen hafif persisted-auth denetleyici meta verileri. |
-| `openclaw.install.npmSpec` / `openclaw.install.localPath`         | Bundled ve harici olarak yayımlanan plugin'ler için kurulum/güncelleme ipuçları.                                                           |
-| `openclaw.install.defaultChoice`                                  | Birden fazla kurulum kaynağı mevcut olduğunda tercih edilen kurulum yolu.                                                                   |
-| `openclaw.install.minHostVersion`                                 | `>=2026.3.22` gibi bir semver alt sınırı kullanarak desteklenen minimum OpenClaw host sürümü.                                              |
-| `openclaw.install.allowInvalidConfigRecovery`                     | Yapılandırma geçersiz olduğunda dar kapsamlı bir bundled-plugin yeniden kurulum kurtarma yoluna izin verir.                                |
-| `openclaw.startup.deferConfiguredChannelFullLoadUntilAfterListen` | Başlangıç sırasında tam kanal plugin'inden önce yalnızca kurulum amaçlı kanal yüzeylerinin yüklenmesine izin verir.                        |
+| Alan                                                              | Anlamı                                                                                                                                       |
+| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| `openclaw.extensions`                                             | Yerel plugin giriş noktalarını bildirir.                                                                                                     |
+| `openclaw.setupEntry`                                             | Onboarding ve ertelenmiş kanal başlangıcı sırasında kullanılan hafif, yalnızca setup amaçlı giriş noktası.                                 |
+| `openclaw.channel`                                                | Etiketler, belge yolları, takma adlar ve seçim metni gibi düşük maliyetli kanal katalog meta verileri.                                      |
+| `openclaw.channel.configuredState`                                | Tam kanal çalışma zamanını yüklemeden "yalnızca env tabanlı kurulum zaten var mı?" sorusuna yanıt verebilen hafif yapılandırılmış durum denetleyici meta verileri. |
+| `openclaw.channel.persistedAuthState`                             | Tam kanal çalışma zamanını yüklemeden "zaten giriş yapılmış bir şey var mı?" sorusuna yanıt verebilen hafif kalıcı auth durumu denetleyici meta verileri. |
+| `openclaw.install.npmSpec` / `openclaw.install.localPath`         | Paketlenmiş ve haricen yayımlanan plugin'ler için kurulum/güncelleme ipuçları.                                                              |
+| `openclaw.install.defaultChoice`                                  | Birden fazla kurulum kaynağı mevcut olduğunda tercih edilen kurulum yolu.                                                                    |
+| `openclaw.install.minHostVersion`                                 | `>=2026.3.22` gibi bir semver alt sınırı kullanan, desteklenen minimum OpenClaw host sürümü.                                                |
+| `openclaw.install.allowInvalidConfigRecovery`                     | Yapılandırma geçersiz olduğunda dar kapsamlı bir paketlenmiş plugin yeniden kurulum kurtarma yoluna izin verir.                             |
+| `openclaw.startup.deferConfiguredChannelFullLoadUntilAfterListen` | Başlangıç sırasında tam kanal plugin'inden önce yalnızca setup amaçlı kanal yüzeylerinin yüklenmesini sağlar.                              |

-`openclaw.install.minHostVersion`, kurulum sırasında ve manifest kayıt defteri
-yüklenirken zorunlu kılınır. Geçersiz değerler reddedilir; daha yeni ama geçerli değerler eski host'larda plugin'i atlar.
+`openclaw.install.minHostVersion`, kurulum ve manifest kayıt defteri yükleme sırasında uygulanır. Geçersiz değerler reddedilir; daha yeni ama geçerli değerler, eski host'larda plugin'i atlar.

-`openclaw.install.allowInvalidConfigRecovery` bilinçli olarak dardır. Keyfi
-bozuk yapılandırmaları kurulabilir hale getirmez. Bugün yalnızca kurulum
-akışlarının, belirli eski bundled-plugin yükseltme hatalarından kurtulmasına izin verir; örneğin eksik bundled plugin yolu veya aynı
-bundled plugin için eski bir `channels.<id>` girdisi. İlgisiz yapılandırma hataları yine kurulumu engeller ve operatörleri
-`openclaw doctor --fix` komutuna yönlendirir.
+`openclaw.install.allowInvalidConfigRecovery` kasıtlı olarak dar kapsamlıdır. Rastgele bozuk yapılandırmaların kurulabilir olmasını sağlamaz. Bugün yalnızca, eksik paketlenmiş plugin yolu veya aynı paketlenmiş plugin için bayat bir `channels.<id>` girdisi gibi belirli eski paketlenmiş plugin yükseltme hatalarından kurulum akışlarının kurtulmasına izin verir. İlgisiz yapılandırma hataları yine kurulumu engeller ve operatörleri `openclaw doctor --fix` komutuna yönlendirir.

-`openclaw.channel.persistedAuthState`, küçük bir denetleyici
-modülü için paket meta verisidir:
+`openclaw.channel.persistedAuthState`, küçük bir denetleyici modülü için paket meta verisidir:

 ```json
 {
@ -409,13 +461,9 @@ modülü için paket meta verisidir:
 }
 ```

-Kurulum, doctor veya configured-state akışları tam kanal plugin'i yüklenmeden önce
-düşük maliyetli bir evet/hayır kimlik doğrulama
-yoklaması gerektirdiğinde bunu kullanın. Hedef export, yalnızca kalıcı durumu okuyan küçük bir
-fonksiyon olmalıdır; bunu tam kanal çalışma zamanı barrel'ı üzerinden yönlendirmeyin.
+Setup, doctor veya yapılandırılmış durum akışlarının tam kanal plugin'i yüklenmeden önce ucuz bir evet/hayır auth yoklamasına ihtiyaç duyduğu durumlarda bunu kullanın. Hedef export, yalnızca kalıcı durumu okuyan küçük bir işlev olmalıdır; bunu tam kanal çalışma zamanı barrel'ı üzerinden yönlendirmeyin.

-`openclaw.channel.configuredState`, düşük maliyetli yalnızca env tabanlı
-configured denetimleri için aynı şekli izler:
+`openclaw.channel.configuredState`, düşük maliyetli yalnızca env tabanlı yapılandırılmış durum denetimleri için aynı biçimi izler:

 ```json
 {
@ -431,65 +479,44 @@ configured denetimleri için aynı şekli izler:
 }
 ```

-Bir kanal configured-state durumunu env veya diğer küçük
-çalışma zamanı dışı girdilerden yanıtlayabiliyorsa bunu kullanın. Denetim tam yapılandırma çözümlemesi veya gerçek
-kanal çalışma zamanını gerektiriyorsa, bu mantığı bunun yerine plugin
-`config.hasConfiguredState` hook'unda tutun.
+Bir kanal env veya diğer küçük çalışma zamanı dışı girdilerden yapılandırılmış durumu yanıtlayabiliyorsa bunu kullanın. Denetim tam yapılandırma çözümlemesine veya gerçek kanal çalışma zamanına ihtiyaç duyuyorsa, bu mantığı onun yerine plugin `config.hasConfiguredState` hook'unda tutun.

-## JSON Şeması gereksinimleri
+## JSON Şema gereksinimleri

- **Her plugin bir JSON Şeması yayımlamalıdır**, yapılandırma kabul etmese bile.
+- **Her plugin bir JSON Şeması bulundurmak zorundadır**, yapılandırma kabul etmese bile.
 - Boş bir şema kabul edilebilir (örneğin `{ "type": "object", "additionalProperties": false }`).
- Şemalar çalışma zamanında değil, yapılandırma okuma/yazma sırasında doğrulanır.
+- Şemalar çalışma zamanında değil, yapılandırma okuma/yazma anında doğrulanır.

 ## Doğrulama davranışı

- Kanal kimliği bir
-  plugin manifesti tarafından bildirilmedikçe bilinmeyen `channels.*` anahtarları **hatadır**.
- `plugins.entries.<id>`, `plugins.allow`, `plugins.deny` ve `plugins.slots.*`
-  **keşfedilebilir** plugin kimliklerine başvurmalıdır. Bilinmeyen kimlikler **hatadır**.
- Bir plugin kuruluysa ancak manifesti veya şeması bozuk ya da eksikse,
-  doğrulama başarısız olur ve Doctor plugin hatasını raporlar.
- Plugin yapılandırması mevcut ama plugin **devre dışı** ise, yapılandırma korunur ve
-  Doctor + günlüklerde bir **uyarı** gösterilir.
+- Bilinmeyen `channels.*` anahtarları, kanal kimliği bir plugin manifesti tarafından bildirilmedikçe **hatadır**.
+- `plugins.entries.<id>`, `plugins.allow`, `plugins.deny` ve `plugins.slots.*`, **keşfedilebilir** plugin kimliklerine başvurmak zorundadır. Bilinmeyen kimlikler **hatadır**.
+- Bir plugin kuruluysa ancak bozuk veya eksik bir manifest ya da şemaya sahipse, doğrulama başarısız olur ve Doctor plugin hatasını bildirir.
+- Plugin yapılandırması mevcutsa ancak plugin **devre dışıysa**, yapılandırma korunur ve Doctor + günlüklerde bir **uyarı** gösterilir.

-Tam `plugins.*` şeması için [Configuration reference](/tr/gateway/configuration) bölümüne bakın.
+Tam `plugins.*` şeması için bkz. [Yapılandırma başvurusu](/tr/gateway/configuration).

 ## Notlar

 - Manifest, yerel dosya sistemi yüklemeleri dahil **yerel OpenClaw plugin'leri için zorunludur**.
- Çalışma zamanı yine plugin modülünü ayrı olarak yükler; manifest yalnızca
-  keşif + doğrulama içindir.
- Yerel manifestler JSON5 ile ayrıştırılır; bu nedenle son değer hâlâ bir nesne olduğu sürece yorumlar, sondaki virgüller ve
-  tırnaksız anahtarlar kabul edilir.
- Manifest yükleyici yalnızca belgelenmiş manifest alanlarını okur. Buraya
-  özel üst düzey anahtarlar eklemekten kaçının.
- `providerAuthEnvVars`, kimlik doğrulama yoklamaları, env işaretleyici
-  doğrulaması ve env adlarını incelemek için plugin
-  çalışma zamanını başlatmaması gereken benzer sağlayıcı kimlik doğrulama yüzeyleri için düşük maliyetli meta veri yoludur.
- `providerAuthAliases`, sağlayıcı varyantlarının başka bir sağlayıcının kimlik doğrulama
-  env değişkenlerini, kimlik doğrulama profillerini, yapılandırma destekli kimlik doğrulamayı ve API anahtarı onboarding seçimini
-  bu ilişkiyi çekirdekte sabit kodlamadan yeniden kullanmasına olanak tanır.
- `channelEnvVars`, shell-env fallback, kurulum
-  istemleri ve env adlarını incelemek için
-  kanal çalışma zamanını başlatmaması gereken benzer kanal yüzeyleri için düşük maliyetli meta veri yoludur.
- `providerAuthChoices`, kimlik doğrulama seçimi seçicileri,
-  sağlayıcı çalışma zamanı yüklenmeden önce `--auth-choice` çözümlemesi, tercih edilen sağlayıcı eşlemesi ve basit onboarding
-  CLI bayrağı kaydı için düşük maliyetli meta veri yoludur. Sağlayıcı kodu gerektiren çalışma zamanı sihirbazı
-  meta verileri için
-  [Provider runtime hooks](/tr/plugins/architecture#provider-runtime-hooks) bölümüne bakın.
- Dışlayıcı plugin türleri `plugins.slots.*` üzerinden seçilir.
-  - `kind: "memory"` değeri `plugins.slots.memory` ile seçilir.
-  - `kind: "context-engine"` değeri `plugins.slots.contextEngine`
-    ile seçilir (varsayılan: yerleşik `legacy`).
- `channels`, `providers`, `cliBackends` ve `skills`, bir
-  plugin bunlara ihtiyaç duymuyorsa atlanabilir.
- Plugin'iniz yerel modüllere bağlıysa, derleme adımlarını ve
-  tüm paket yöneticisi izin listesi gereksinimlerini belgeleyin (örneğin pnpm `allow-build-scripts`
+- Çalışma zamanı yine plugin modülünü ayrı olarak yükler; manifest yalnızca keşif + doğrulama içindir.
+- Yerel manifestler JSON5 ile ayrıştırılır; bu nedenle son değer hâlâ bir nesne olduğu sürece yorumlar, sondaki virgüller ve tırnaksız anahtarlar kabul edilir.
+- Manifest yükleyici yalnızca belgelenmiş manifest alanlarını okur. Buraya özel üst düzey anahtarlar eklemekten kaçının.
+- `providerAuthEnvVars`, env adlarını incelemek için plugin çalışma zamanını başlatmaması gereken auth yoklamaları, env işaretleyici doğrulaması ve benzeri provider auth yüzeyleri için düşük maliyetli meta veri yoludur.
+- `providerAuthAliases`, provider varyantlarının başka bir provider'ın auth env değişkenlerini, auth profillerini, yapılandırma destekli auth'unu ve API anahtarı onboarding seçeneğini çekirdekte bu ilişkiyi sabit kodlamadan yeniden kullanmasını sağlar.
+- `channelEnvVars`, env adlarını incelemek için plugin çalışma zamanını başlatmaması gereken shell env geri dönüşü, setup istemleri ve benzeri kanal yüzeyleri için düşük maliyetli meta veri yoludur.
+- `providerAuthChoices`, provider çalışma zamanı yüklenmeden önce auth seçeneği seçicileri, `--auth-choice` çözümleme, tercih edilen provider eşleme ve basit onboarding CLI bayrağı kaydı için düşük maliyetli meta veri yoludur. Provider kodu gerektiren çalışma zamanı sihirbazı meta verileri için bkz.
+  [Provider runtime hook'ları](/tr/plugins/architecture#provider-runtime-hooks).
+- Özel plugin türleri `plugins.slots.*` üzerinden seçilir.
+  - `kind: "memory"`, `plugins.slots.memory` tarafından seçilir.
+  - `kind: "context-engine"`, `plugins.slots.contextEngine`
+    tarafından seçilir (varsayılan: yerleşik `legacy`).
+- Bir plugin bunlara ihtiyaç duymuyorsa `channels`, `providers`, `cliBackends` ve `skills` atlanabilir.
+- Plugin'iniz yerel modüllere bağımlıysa, derleme adımlarını ve varsa paket yöneticisi izin listesi gereksinimlerini belgelendirin (örneğin pnpm `allow-build-scripts`
  - `pnpm rebuild <package>`).

 ## İlgili

- [Building Plugins](/tr/plugins/building-plugins) — plugin'lerle çalışmaya başlama
- [Plugin Architecture](/tr/plugins/architecture) — iç mimari
- [SDK Overview](/tr/plugins/sdk-overview) — Plugin SDK başvurusu
+- [Plugin Oluşturma](/tr/plugins/building-plugins) — plugin'lerle çalışmaya başlama
+- [Plugin Mimarisi](/tr/plugins/architecture) — iç mimari
+- [SDK Genel Bakış](/tr/plugins/sdk-overview) — Plugin SDK başvurusu
--- a/docs/tr/reference/rich-output-protocol.md
+++ b/docs/tr/reference/rich-output-protocol.md
@ -0,0 +1,60 @@
+---
+x-i18n:
+    generated_at: "2026-04-11T15:15:48Z"
+    model: gpt-5.4
+    provider: openai
+    source_hash: 2a8884fc2c304bf96d4675f0c1d1ff781d6dc1ae8c49d92ce08040c9c7709035
+    source_path: reference/rich-output-protocol.md
+    workflow: 15
+---
+
+# Zengin Çıktı Protokolü
+
+Asistan çıktısı küçük bir teslim/render yönergesi kümesi taşıyabilir:
+
+- Ek teslimi için `MEDIA:`
+- Sesli sunum ipuçları için `[[audio_as_voice]]`
+- Yanıt meta verisi için `[[reply_to_current]]` / `[[reply_to:<id>]]`
+- Control UI zengin render için `[embed ...]`
+
+Bu yönergeler ayrıdır. `MEDIA:` ve reply/voice etiketleri teslim meta verisi olarak kalır; `[embed ...]` ise yalnızca web için zengin render yoludur.
+
+## `[embed ...]`
+
+`[embed ...]`, Control UI için etkene yönelik tek zengin render söz dizimidir.
+
+Kendiliğinden kapanan örnek:
+
+```text
+[embed ref="cv_123" title="Durum" /]
+```
+
+Kurallar:
+
+- `[view ...]` artık yeni çıktı için geçerli değildir.
+- Embed kısa kodları yalnızca asistan mesaj yüzeyinde render edilir.
+- Yalnızca URL destekli embed'ler render edilir. `ref="..."` veya `url="..."` kullanın.
+- Blok biçimli satır içi HTML embed kısa kodları render edilmez.
+- Web UI kısa kodu görünür metinden ayıklar ve embed'i satır içinde render eder.
+- `MEDIA:` bir embed takma adı değildir ve zengin embed render için kullanılmamalıdır.
+
+## Saklanan Render Biçimi
+
+Normalleştirilmiş/saklanan asistan içerik bloğu, yapılandırılmış bir `canvas` öğesidir:
+
+```json
+{
+  "type": "canvas",
+  "preview": {
+    "kind": "canvas",
+    "surface": "assistant_message",
+    "render": "url",
+    "viewId": "cv_123",
+    "url": "/__openclaw__/canvas/documents/cv_123/index.html",
+    "title": "Status",
+    "preferredHeight": 320
+  }
+}
+```
+
+Saklanan/render edilen zengin bloklar bu `canvas` biçimini doğrudan kullanır. `present_view` tanınmaz.
--- a/docs/tr/tools/video-generation.md
+++ b/docs/tr/tools/video-generation.md
@ -1,25 +1,25 @@
 ---
 read_when:
-    - Agent aracılığıyla video oluşturma
+    - Videoları agent aracılığıyla oluşturma
    - Video oluşturma sağlayıcılarını ve modellerini yapılandırma
    - '`video_generate` araç parametrelerini anlama'
-summary: 12 sağlayıcı backend kullanarak metinden, görsellerden veya mevcut videolardan video oluşturma
+summary: Metin, görseller veya mevcut videolardan 14 sağlayıcı arka ucunu kullanarak videolar oluşturun
 title: Video Oluşturma
 x-i18n:
-    generated_at: "2026-04-11T02:48:15Z"
+    generated_at: "2026-04-11T15:15:59Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 6848d03ef578181902517d068e8d9fe2f845e572a90481bbdf7bd9f1c591f245
+    source_hash: 0ec159a0bbb6b8a030e68828c0a8bcaf40c8538ecf98bc8ff609dab9d0068263
    source_path: tools/video-generation.md
    workflow: 15
 ---

 # Video Oluşturma

-OpenClaw agent'ları metin istemlerinden, referans görsellerden veya mevcut videolardan video oluşturabilir. On iki sağlayıcı backend desteklenir ve her birinin farklı model seçenekleri, girdi modları ve özellik kümeleri vardır. Agent, yapılandırmanıza ve kullanılabilir API anahtarlarına göre doğru sağlayıcıyı otomatik olarak seçer.
+OpenClaw agent’ları metin istemlerinden, referans görsellerden veya mevcut videolardan videolar oluşturabilir. On dört sağlayıcı arka ucu desteklenir ve her birinin farklı model seçenekleri, giriş modları ve özellik kümeleri vardır. Agent, yapılandırmanıza ve kullanılabilir API anahtarlarına göre doğru sağlayıcıyı otomatik olarak seçer.

 <Note>
-`video_generate` aracı yalnızca en az bir video oluşturma sağlayıcısı kullanılabilir olduğunda görünür. Agent araçlarınızda bunu görmüyorsanız bir sağlayıcı API anahtarı ayarlayın veya `agents.defaults.videoGenerationModel` yapılandırın.
+`video_generate` aracı yalnızca en az bir video oluşturma sağlayıcısı kullanılabilir olduğunda görünür. Agent araçlarınızda bunu görmüyorsanız bir sağlayıcı API anahtarı ayarlayın veya `agents.defaults.videoGenerationModel` yapılandırmasını yapın.
 </Note>

 OpenClaw, video oluşturmayı üç çalışma zamanı modu olarak ele alır:
@ -28,8 +28,7 @@ OpenClaw, video oluşturmayı üç çalışma zamanı modu olarak ele alır:
 - istek bir veya daha fazla referans görsel içerdiğinde `imageToVideo`
 - istek bir veya daha fazla referans video içerdiğinde `videoToVideo`

-Sağlayıcılar bu modların herhangi bir alt kümesini destekleyebilir. Araç, gönderimden önce etkin
-modu doğrular ve desteklenen modları `action=list` içinde bildirir.
+Sağlayıcılar bu modların herhangi bir alt kümesini destekleyebilir. Araç, gönderimden önce etkin modu doğrular ve desteklenen modları `action=list` içinde bildirir.

 ## Hızlı başlangıç

@ -45,35 +44,35 @@ export GEMINI_API_KEY="your-key"
 openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1-fast-generate-preview"
 ```

-3. Agent'a sorun:
+3. Agent’a sorun:

 > Gün batımında sörf yapan dost canlısı bir ıstakozun 5 saniyelik sinematik bir videosunu oluştur.

-Agent `video_generate` aracını otomatik olarak çağırır. Araç allowlist ayarlaması gerekmez.
+Agent, `video_generate` aracını otomatik olarak çağırır. Araç izin listesi gerekmez.

-## Video oluşturduğunuzda ne olur
+## Bir video oluşturduğunuzda ne olur

-Video oluşturma eşzamansızdır. Agent bir oturum içinde `video_generate` çağırdığında:
+Video oluşturma eşzamansızdır. Agent bir oturumda `video_generate` çağırdığında:

 1. OpenClaw isteği sağlayıcıya gönderir ve hemen bir görev kimliği döndürür.
-2. Sağlayıcı işi arka planda işler (genellikle sağlayıcıya ve çözünürlüğe bağlı olarak 30 saniye ile 5 dakika arasında).
+2. Sağlayıcı işi arka planda işler (genellikle sağlayıcıya ve çözünürlüğe bağlı olarak 30 saniye ila 5 dakika).
 3. Video hazır olduğunda OpenClaw aynı oturumu dahili bir tamamlanma olayıyla uyandırır.
 4. Agent tamamlanan videoyu özgün konuşmaya geri gönderir.

-Bir iş sürerken aynı oturumdaki yinelenen `video_generate` çağrıları yeni bir oluşturma başlatmak yerine geçerli görev durumunu döndürür. CLI üzerinden ilerlemeyi denetlemek için `openclaw tasks list` veya `openclaw tasks show <taskId>` kullanın.
+Bir iş devam ederken, aynı oturumdaki yinelenen `video_generate` çağrıları yeni bir oluşturma başlatmak yerine mevcut görev durumunu döndürür. CLI üzerinden ilerlemeyi denetlemek için `openclaw tasks list` veya `openclaw tasks show <taskId>` kullanın.

-Oturum destekli agent çalıştırmalarının dışında (örneğin doğrudan araç çağrıları), araç satır içi oluşturmaya fallback yapar ve son medya yolunu aynı tur içinde döndürür.
+Oturum destekli agent çalıştırmalarının dışında (örneğin doğrudan araç çağrıları), araç satır içi oluşturmaya geri döner ve son medya yolunu aynı turda döndürür.

 ### Görev yaşam döngüsü

 Her `video_generate` isteği dört durumdan geçer:

-1. **queued** -- görev oluşturuldu, sağlayıcının kabul etmesi bekleniyor.
-2. **running** -- sağlayıcı işliyor (genellikle sağlayıcıya ve çözünürlüğe bağlı olarak 30 saniye ile 5 dakika arasında).
-3. **succeeded** -- video hazır; agent uyanır ve videoyu konuşmaya gönderir.
+1. **queued** -- görev oluşturuldu, sağlayıcının bunu kabul etmesi bekleniyor.
+2. **running** -- sağlayıcı işliyor (genellikle sağlayıcıya ve çözünürlüğe bağlı olarak 30 saniye ila 5 dakika).
+3. **succeeded** -- video hazır; agent uyanır ve bunu konuşmaya gönderir.
 4. **failed** -- sağlayıcı hatası veya zaman aşımı; agent hata ayrıntılarıyla uyanır.

-CLI üzerinden durumu denetleyin:
+CLI’den durumu denetleyin:

 ```bash
 openclaw tasks list
@ -81,119 +80,173 @@ openclaw tasks show <taskId>
 openclaw tasks cancel <taskId>
 ```

-Yinelenme önleme: geçerli oturum için bir video görevi zaten `queued` veya `running` durumundaysa, `video_generate` yeni bir görev başlatmak yerine mevcut görev durumunu döndürür. Yeni bir oluşturmayı tetiklemeden açıkça denetlemek için `action: "status"` kullanın.
+Yinelenenleri önleme: geçerli oturum için bir video görevi zaten `queued` veya `running` durumundaysa, `video_generate` yeni bir görev başlatmak yerine mevcut görev durumunu döndürür. Yeni bir oluşturmayı tetiklemeden açıkça denetlemek için `action: "status"` kullanın.

 ## Desteklenen sağlayıcılar

-| Sağlayıcı | Varsayılan model                | Metin | Görsel ref        | Video ref        | API anahtarı                             |
-| --------- | ------------------------------- | ----- | ----------------- | ---------------- | ---------------------------------------- |
-| Alibaba   | `wan2.6-t2v`                    | Evet  | Evet (uzak URL)   | Evet (uzak URL)  | `MODELSTUDIO_API_KEY`                    |
-| BytePlus  | `seedance-1-0-lite-t2v-250428`  | Evet  | 1 görsel          | Hayır            | `BYTEPLUS_API_KEY`                       |
-| ComfyUI   | `workflow`                      | Evet  | 1 görsel          | Hayır            | `COMFY_API_KEY` veya `COMFY_CLOUD_API_KEY` |
-| fal       | `fal-ai/minimax/video-01-live`  | Evet  | 1 görsel          | Hayır            | `FAL_KEY`                                |
-| Google    | `veo-3.1-fast-generate-preview` | Evet  | 1 görsel          | 1 video          | `GEMINI_API_KEY`                         |
-| MiniMax   | `MiniMax-Hailuo-2.3`            | Evet  | 1 görsel          | Hayır            | `MINIMAX_API_KEY`                        |
-| OpenAI    | `sora-2`                        | Evet  | 1 görsel          | 1 video          | `OPENAI_API_KEY`                         |
-| Qwen      | `wan2.6-t2v`                    | Evet  | Evet (uzak URL)   | Evet (uzak URL)  | `QWEN_API_KEY`                           |
-| Runway    | `gen4.5`                        | Evet  | 1 görsel          | 1 video          | `RUNWAYML_API_SECRET`                    |
-| Together  | `Wan-AI/Wan2.2-T2V-A14B`        | Evet  | 1 görsel          | Hayır            | `TOGETHER_API_KEY`                       |
-| Vydra     | `veo3`                          | Evet  | 1 görsel (`kling`) | Hayır           | `VYDRA_API_KEY`                          |
-| xAI       | `grok-imagine-video`            | Evet  | 1 görsel          | 1 video          | `XAI_API_KEY`                            |
+| Sağlayıcı             | Varsayılan model                | Metin | Görsel ref.                                          | Video ref.       | API anahtarı                             |
+| --------------------- | ------------------------------- | ----- | ---------------------------------------------------- | ---------------- | ---------------------------------------- |
+| Alibaba               | `wan2.6-t2v`                    | Evet  | Evet (uzak URL)                                      | Evet (uzak URL)  | `MODELSTUDIO_API_KEY`                    |
+| BytePlus (1.0)        | `seedance-1-0-pro-250528`       | Evet  | En fazla 2 görsel (yalnızca I2V modelleri; ilk + son kare) | Hayır            | `BYTEPLUS_API_KEY`                       |
+| BytePlus Seedance 1.5 | `seedance-1-5-pro-251215`       | Evet  | En fazla 2 görsel (rol ile ilk + son kare)           | Hayır            | `BYTEPLUS_API_KEY`                       |
+| BytePlus Seedance 2.0 | `dreamina-seedance-2-0-260128`  | Evet  | En fazla 9 referans görsel                           | En fazla 3 video | `BYTEPLUS_API_KEY`                       |
+| ComfyUI               | `workflow`                      | Evet  | 1 görsel                                             | Hayır            | `COMFY_API_KEY` veya `COMFY_CLOUD_API_KEY` |
+| fal                   | `fal-ai/minimax/video-01-live`  | Evet  | 1 görsel                                             | Hayır            | `FAL_KEY`                                |
+| Google                | `veo-3.1-fast-generate-preview` | Evet  | 1 görsel                                             | 1 video          | `GEMINI_API_KEY`                         |
+| MiniMax               | `MiniMax-Hailuo-2.3`            | Evet  | 1 görsel                                             | Hayır            | `MINIMAX_API_KEY`                        |
+| OpenAI                | `sora-2`                        | Evet  | 1 görsel                                             | 1 video          | `OPENAI_API_KEY`                         |
+| Qwen                  | `wan2.6-t2v`                    | Evet  | Evet (uzak URL)                                      | Evet (uzak URL)  | `QWEN_API_KEY`                           |
+| Runway                | `gen4.5`                        | Evet  | 1 görsel                                             | 1 video          | `RUNWAYML_API_SECRET`                    |
+| Together              | `Wan-AI/Wan2.2-T2V-A14B`        | Evet  | 1 görsel                                             | Hayır            | `TOGETHER_API_KEY`                       |
+| Vydra                 | `veo3`                          | Evet  | 1 görsel (`kling`)                                   | Hayır            | `VYDRA_API_KEY`                          |
+| xAI                   | `grok-imagine-video`            | Evet  | 1 görsel                                             | 1 video          | `XAI_API_KEY`                            |

 Bazı sağlayıcılar ek veya alternatif API anahtarı ortam değişkenlerini kabul eder. Ayrıntılar için ilgili [sağlayıcı sayfalarına](#related) bakın.

-Çalışma zamanında kullanılabilir sağlayıcıları, modelleri ve
-çalışma zamanı modlarını incelemek için `video_generate action=list` çalıştırın.
+Çalışma zamanında kullanılabilir sağlayıcıları, modelleri ve çalışma zamanı modlarını incelemek için `video_generate action=list` çalıştırın.

 ### Bildirilmiş yetenek matrisi

-Bu, `video_generate`, sözleşme testleri
-ve paylaşılan canlı tarama tarafından kullanılan açık mod sözleşmesidir.
+Bu, `video_generate`, sözleşme testleri ve paylaşılan canlı tarama tarafından kullanılan açık mod sözleşmesidir.

-| Sağlayıcı | `generate` | `imageToVideo` | `videoToVideo` | Bugünkü paylaşılan canlı hatlar                                                                                                          |
+| Sağlayıcı | `generate` | `imageToVideo` | `videoToVideo` | Güncel paylaşılan canlı kanallar                                                                                                        |
 | --------- | ---------- | -------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
-| Alibaba   | Evet       | Evet           | Evet           | `generate`, `imageToVideo`; `videoToVideo` atlanır çünkü bu sağlayıcı uzak `http(s)` video URL'leri gerektirir                          |
+| Alibaba   | Evet       | Evet           | Evet           | `generate`, `imageToVideo`; `videoToVideo` atlanır çünkü bu sağlayıcı uzak `http(s)` video URL’leri gerektirir                          |
 | BytePlus  | Evet       | Evet           | Hayır          | `generate`, `imageToVideo`                                                                                                               |
-| ComfyUI   | Evet       | Evet           | Hayır          | Paylaşılan taramada yok; iş akışına özgü kapsam Comfy testleriyle birlikte yaşar                                                        |
+| ComfyUI   | Evet       | Evet           | Hayır          | Paylaşılan taramada yok; iş akışına özel kapsam Comfy testlerinde bulunur                                                               |
 | fal       | Evet       | Evet           | Hayır          | `generate`, `imageToVideo`                                                                                                               |
-| Google    | Evet       | Evet           | Evet           | `generate`, `imageToVideo`; paylaşılan `videoToVideo` atlanır çünkü mevcut buffer destekli Gemini/Veo taraması bu girdiyi kabul etmez  |
+| Google    | Evet       | Evet           | Evet           | `generate`, `imageToVideo`; paylaşılan `videoToVideo` atlanır çünkü mevcut arabellek destekli Gemini/Veo taraması bu girdiyi kabul etmez |
 | MiniMax   | Evet       | Evet           | Hayır          | `generate`, `imageToVideo`                                                                                                               |
-| OpenAI    | Evet       | Evet           | Evet           | `generate`, `imageToVideo`; paylaşılan `videoToVideo` atlanır çünkü bu organizasyon/girdi yolu şu anda sağlayıcı tarafı inpaint/remix erişimi gerektirir |
-| Qwen      | Evet       | Evet           | Evet           | `generate`, `imageToVideo`; `videoToVideo` atlanır çünkü bu sağlayıcı uzak `http(s)` video URL'leri gerektirir                          |
-| Runway    | Evet       | Evet           | Evet           | `generate`, `imageToVideo`; `videoToVideo` yalnızca seçili model `runway/gen4_aleph` olduğunda çalışır                                 |
+| OpenAI    | Evet       | Evet           | Evet           | `generate`, `imageToVideo`; paylaşılan `videoToVideo` atlanır çünkü bu kuruluş/girdi yolu şu anda sağlayıcı tarafı inpaint/remix erişimi gerektirir |
+| Qwen      | Evet       | Evet           | Evet           | `generate`, `imageToVideo`; `videoToVideo` atlanır çünkü bu sağlayıcı uzak `http(s)` video URL’leri gerektirir                          |
+| Runway    | Evet       | Evet           | Evet           | `generate`, `imageToVideo`; `videoToVideo` yalnızca seçilen model `runway/gen4_aleph` olduğunda çalışır                                 |
 | Together  | Evet       | Evet           | Hayır          | `generate`, `imageToVideo`                                                                                                               |
-| Vydra     | Evet       | Evet           | Hayır          | `generate`; paylaşılan `imageToVideo` atlanır çünkü paketlenmiş `veo3` yalnızca metindir ve paketlenmiş `kling` uzak görsel URL'si gerektirir |
-| xAI       | Evet       | Evet           | Evet           | `generate`, `imageToVideo`; `videoToVideo` atlanır çünkü bu sağlayıcı şu anda uzak bir MP4 URL'si gerektirir                           |
+| Vydra     | Evet       | Evet           | Hayır          | `generate`; paylaşılan `imageToVideo` atlanır çünkü paketlenmiş `veo3` yalnızca metindir ve paketlenmiş `kling` uzak bir görsel URL’si gerektirir |
+| xAI       | Evet       | Evet           | Evet           | `generate`, `imageToVideo`; `videoToVideo` atlanır çünkü bu sağlayıcı şu anda uzak bir MP4 URL’si gerektirir                            |

 ## Araç parametreleri

-### Gerekli
+### Zorunlu

 | Parametre | Tür    | Açıklama                                                                  |
 | --------- | ------ | ------------------------------------------------------------------------- |
-| `prompt`  | string | Oluşturulacak videonun metin açıklaması (`action: "generate"` için gereklidir) |
+| `prompt`  | string | Oluşturulacak videonun metin açıklaması (`action: "generate"` için zorunludur) |

 ### İçerik girdileri

-| Parametre | Tür      | Açıklama                           |
-| --------- | -------- | ---------------------------------- |
-| `image`   | string   | Tek referans görsel (yol veya URL) |
-| `images`  | string[] | Birden çok referans görsel (en fazla 5) |
-| `video`   | string   | Tek referans video (yol veya URL)  |
-| `videos`  | string[] | Birden çok referans video (en fazla 4) |
+| Parametre    | Tür      | Açıklama                                                                                                                              |
+| ------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| `image`      | string   | Tek referans görseli (yol veya URL)                                                                                                   |
+| `images`     | string[] | Birden çok referans görseli (en fazla 9)                                                                                              |
+| `imageRoles` | string[] | Birleşik görsel listesine paralel, konuma göre isteğe bağlı rol ipuçları. Kanonik değerler: `first_frame`, `last_frame`, `reference_image` |
+| `video`      | string   | Tek referans videosu (yol veya URL)                                                                                                   |
+| `videos`     | string[] | Birden çok referans videosu (en fazla 4)                                                                                              |
+| `videoRoles` | string[] | Birleşik video listesine paralel, konuma göre isteğe bağlı rol ipuçları. Kanonik değer: `reference_video`                            |
+| `audioRef`   | string   | Tek referans sesi (yol veya URL). Sağlayıcı ses girdilerini desteklediğinde örneğin arka plan müziği veya ses referansı için kullanılır |
+| `audioRefs`  | string[] | Birden çok referans ses (en fazla 3)                                                                                                  |
+| `audioRoles` | string[] | Birleşik ses listesine paralel, konuma göre isteğe bağlı rol ipuçları. Kanonik değer: `reference_audio`                             |
+
+Rol ipuçları sağlayıcıya olduğu gibi iletilir. Kanonik değerler
+`VideoGenerationAssetRole` birleşiminden gelir ancak sağlayıcılar ek
+rol dizelerini kabul edebilir. `*Roles` dizileri karşılık gelen
+referans listesinden daha fazla giriş içermemelidir; bire bir hizalama
+hataları açık bir hatayla başarısız olur.
+Bir yuvayı ayarsız bırakmak için boş bir dize kullanın.

 ### Stil denetimleri

-| Parametre        | Tür     | Açıklama                                                                 |
-| ---------------- | ------- | ------------------------------------------------------------------------ |
-| `aspectRatio`    | string  | `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` |
-| `resolution`     | string  | `480P`, `720P`, `768P` veya `1080P`                                     |
-| `durationSeconds`| number  | Hedef süre saniye cinsinden (sağlayıcının desteklediği en yakın değere yuvarlanır) |
-| `size`           | string  | Sağlayıcı desteklediğinde boyut ipucu                                   |
-| `audio`          | boolean | Desteklendiğinde oluşturulan sesi etkinleştirir                         |
-| `watermark`      | boolean | Desteklendiğinde sağlayıcı filigranını açar/kapatır                     |
+| Parametre         | Tür     | Açıklama                                                                                  |
+| ----------------- | ------- | ----------------------------------------------------------------------------------------- |
+| `aspectRatio`     | string  | `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` veya `adaptive` |
+| `resolution`      | string  | `480P`, `720P`, `768P` veya `1080P`                                                       |
+| `durationSeconds` | number  | Saniye cinsinden hedef süre (sağlayıcının desteklediği en yakın değere yuvarlanır)       |
+| `size`            | string  | Sağlayıcı desteklediğinde boyut ipucu                                                     |
+| `audio`           | boolean | Desteklendiğinde çıktıda oluşturulan sesi etkinleştirir. `audioRef*` (girdiler) ile ayrıdır |
+| `watermark`       | boolean | Desteklendiğinde sağlayıcı filigranını açıp kapatır                                       |
+
+`adaptive`, sağlayıcıya özgü bir bekçi değerdir: yeteneklerinde `adaptive`
+bildiren sağlayıcılara olduğu gibi iletilir (örneğin BytePlus
+Seedance bunu giriş görseli boyutlarından oranı otomatik algılamak için
+kullanır). Bunu bildirmeyen sağlayıcılar değeri araç sonucundaki
+`details.ignoredOverrides` üzerinden gösterir, böylece düşürülmesi görünür olur.

 ### Gelişmiş

-| Parametre | Tür    | Açıklama                                             |
-| --------- | ------ | ---------------------------------------------------- |
-| `action`  | string | `"generate"` (varsayılan), `"status"` veya `"list"` |
-| `model`   | string | Sağlayıcı/model geçersiz kılması (ör. `runway/gen4.5`) |
-| `filename`| string | Çıktı dosya adı ipucu                                |
+| Parametre         | Tür    | Açıklama                                                                                                                                                                                                                                                                                                                                               |
+| ----------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `action`          | string | `"generate"` (varsayılan), `"status"` veya `"list"`                                                                                                                                                                                                                                                                                                    |
+| `model`           | string | Sağlayıcı/model geçersiz kılması (ör. `runway/gen4.5`)                                                                                                                                                                                                                                                                                                 |
+| `filename`        | string | Çıktı dosya adı ipucu                                                                                                                                                                                                                                                                                                                                   |
+| `providerOptions` | object | JSON nesnesi olarak sağlayıcıya özgü seçenekler (ör. `{"seed": 42, "draft": true}`). Yazılı bir şema bildiren sağlayıcılar anahtarları ve türleri doğrular; bilinmeyen anahtarlar veya uyuşmazlıklar geri dönüş sırasında adayın atlanmasına neden olur. Bildirilmiş bir şeması olmayan sağlayıcılar seçenekleri olduğu gibi alır. Her sağlayıcının ne kabul ettiğini görmek için `video_generate action=list` çalıştırın |

-Tüm sağlayıcılar tüm parametreleri desteklemez. OpenClaw zaten süreyi en yakın sağlayıcı destekli değere normalleştirir; ayrıca yedek sağlayıcı farklı bir kontrol yüzeyi sunduğunda boyuttan en-boy oranına gibi çevrilmiş geometri ipuçlarını da yeniden eşler. Gerçekten desteklenmeyen geçersiz kılmalar en iyi çabayla yok sayılır ve araç sonucunda uyarı olarak bildirilir. Katı yetenek sınırları (örneğin çok fazla referans girdisi) gönderimden önce başarısız olur.
+Tüm sağlayıcılar tüm parametreleri desteklemez. OpenClaw süreyi zaten
+sağlayıcının desteklediği en yakın değere normalize eder ve ayrıca bir geri dönüş
+sağlayıcısı farklı bir denetim yüzeyi sunduğunda boyuttan en-boy oranına gibi
+çevrilmiş geometri ipuçlarını yeniden eşler. Gerçekten desteklenmeyen
+geçersiz kılmalar, mümkün olan en iyi şekilde yok sayılır ve araç sonucunda uyarı
+olarak bildirilir. Sert yetenek sınırları (örneğin çok fazla referans girdisi)
+gönderimden önce başarısız olur.

-Araç sonuçları uygulanan ayarları bildirir. OpenClaw, sağlayıcı fallback'i sırasında süreyi veya geometriyi yeniden eşlediğinde döndürülen `durationSeconds`, `size`, `aspectRatio` ve `resolution` değerleri gönderilenleri yansıtır ve `details.normalization` istekten uygulanana yapılan çeviriyi kaydeder.
+Araç sonuçları uygulanan ayarları bildirir. OpenClaw, sağlayıcı geri dönüşü sırasında
+süreyi veya geometriyi yeniden eşlediğinde, döndürülen `durationSeconds`, `size`,
+`aspectRatio` ve `resolution` değerleri gönderilenleri yansıtır ve
+`details.normalization` istenenden uygulanana çeviriyi yakalar.

 Referans girdileri çalışma zamanı modunu da seçer:

 - Referans medya yok: `generate`
 - Herhangi bir görsel referansı: `imageToVideo`
 - Herhangi bir video referansı: `videoToVideo`
+- Referans ses girdileri çözümlenen modu değiştirmez; görsel/video referanslarının seçtiği modun üzerine uygulanır ve yalnızca `maxInputAudios` bildiren sağlayıcılarla çalışır

 Karışık görsel ve video referansları kararlı bir paylaşılan yetenek yüzeyi değildir.
 İstek başına tek bir referans türünü tercih edin.

+#### Geri dönüş ve yazılı seçenekler
+
+Bazı yetenek denetimleri araç sınırı yerine geri dönüş katmanında uygulanır; böylece
+birincil sağlayıcının sınırlarını aşan bir istek yine de yetenekli bir geri dönüşte
+çalışabilir:
+
+- Etkin aday `maxInputAudios` bildirmiyorsa (veya bunu `0` olarak
+  bildiriyorsa), istek ses referansları içerdiğinde atlanır ve
+  sonraki aday denenir.
+- Etkin adayın `maxDurationSeconds` değeri istenen
+  `durationSeconds` değerinin altındaysa ve aday bir
+  `supportedDurationSeconds` listesi bildirmiyorsa, atlanır.
+- İstek `providerOptions` içeriyorsa ve etkin aday
+  açıkça yazılı bir `providerOptions` şeması bildiriyorsa, sağlanan
+  anahtarlar şemada yoksa veya değer türleri uyuşmuyorsa aday
+  atlanır. Henüz bir şema bildirmemiş sağlayıcılar seçenekleri
+  olduğu gibi alır (geri uyumlu geçiş). Bir sağlayıcı
+  boş bir şema bildirerek tüm sağlayıcı seçeneklerinden açıkça vazgeçebilir
+  (`capabilities.providerOptions: {}`); bu da
+  tür uyuşmazlığıyla aynı atlamaya neden olur.
+
+Bir istekteki ilk atlama nedeni `warn` düzeyinde günlüğe kaydedilir; böylece operatörler
+birincil sağlayıcılarının ne zaman pas geçildiğini görür; sonraki atlamalar uzun geri dönüş
+zincirlerini sessiz tutmak için `debug` düzeyinde günlüğe kaydedilir. Her aday atlanırsa,
+birleştirilmiş hata her biri için atlama nedenini içerir.
+
 ## Eylemler

- **generate** (varsayılan) -- verilen istem ve isteğe bağlı referans girdilerinden bir video oluşturur.
+- **generate** (varsayılan) -- verilen istem ve isteğe bağlı referans girdilerinden video oluşturur.
 - **status** -- başka bir oluşturma başlatmadan geçerli oturum için devam eden video görevinin durumunu denetler.
 - **list** -- kullanılabilir sağlayıcıları, modelleri ve yeteneklerini gösterir.

 ## Model seçimi

-Video oluşturulurken OpenClaw modeli şu sırayla çözümler:
+Bir video oluştururken OpenClaw modeli şu sırayla çözümler:

-1. **`model` araç parametresi** -- agent bunu çağrıda belirtirse.
+1. **`model` araç parametresi** -- agent çağrıda bir tane belirtirse.
 2. **`videoGenerationModel.primary`** -- yapılandırmadan.
 3. **`videoGenerationModel.fallbacks`** -- sırayla denenir.
-4. **Otomatik algılama** -- geçerli kimlik doğrulamaya sahip sağlayıcıları kullanır; önce mevcut varsayılan sağlayıcı, ardından kalan sağlayıcılar alfabetik sırayla.
+4. **Otomatik algılama** -- geçerli kimlik doğrulamaya sahip sağlayıcıları kullanır; önce geçerli varsayılan sağlayıcı, ardından kalan sağlayıcılar alfabetik sırayla.

-Bir sağlayıcı başarısız olursa sıradaki aday otomatik olarak denenir. Tüm adaylar başarısız olursa hata, her denemedeki ayrıntıları içerir.
+Bir sağlayıcı başarısız olursa sonraki aday otomatik olarak denenir. Tüm adaylar başarısız olursa, hata her denemeden ayrıntılar içerir.

 Video oluşturmanın yalnızca açık `model`, `primary` ve `fallbacks`
-girdilerini kullanmasını istiyorsanız `agents.defaults.mediaGenerationAutoProviderFallback: false`
-ayarını yapın.
+girdilerini kullanmasını istiyorsanız `agents.defaults.mediaGenerationAutoProviderFallback: false` ayarlayın.

 ```json5
 {
@ -208,55 +261,29 @@ ayarını yapın.
 }
 ```

-fal üzerindeki HeyGen video-agent şu şekilde sabitlenebilir:
-
-```json5
-{
-  agents: {
-    defaults: {
-      videoGenerationModel: {
-        primary: "fal/fal-ai/heygen/v2/video-agent",
-      },
-    },
-  },
-}
-```
-
-fal üzerindeki Seedance 2.0 şu şekilde sabitlenebilir:
-
-```json5
-{
-  agents: {
-    defaults: {
-      videoGenerationModel: {
-        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
-      },
-    },
-  },
-}
-```
-
 ## Sağlayıcı notları

-| Sağlayıcı | Notlar                                                                                                                                                               |
-| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Alibaba   | DashScope/Model Studio eşzamansız uç noktasını kullanır. Referans görseller ve videolar uzak `http(s)` URL'leri olmalıdır.                                        |
-| BytePlus  | Yalnızca tek görsel referansı.                                                                                                                                       |
-| ComfyUI   | İş akışı güdümlü yerel veya bulut yürütme. Yapılandırılan grafik üzerinden metinden videoya ve görselden videoya desteği sunar.                                   |
-| fal       | Uzun süren işler için kuyruk destekli akış kullanır. Yalnızca tek görsel referansı. HeyGen video-agent ile Seedance 2.0 metinden videoya ve görselden videoya model başvurularını içerir. |
-| Google    | Gemini/Veo kullanır. Bir görsel veya bir video referansını destekler.                                                                                               |
-| MiniMax   | Yalnızca tek görsel referansı.                                                                                                                                       |
-| OpenAI    | Yalnızca `size` geçersiz kılması iletilir. Diğer stil geçersiz kılmaları (`aspectRatio`, `resolution`, `audio`, `watermark`) uyarıyla birlikte yok sayılır.      |
-| Qwen      | Alibaba ile aynı DashScope backend'ini kullanır. Referans girdileri uzak `http(s)` URL'leri olmalıdır; yerel dosyalar önceden reddedilir.                        |
-| Runway    | Data URI'leri üzerinden yerel dosyaları destekler. Videodan videoya için `runway/gen4_aleph` gerekir. Yalnızca metin çalıştırmaları `16:9` ve `9:16` en-boy oranlarını sunar. |
-| Together  | Yalnızca tek görsel referansı.                                                                                                                                       |
-| Vydra     | Kimlik doğrulamayı düşüren yönlendirmeleri önlemek için doğrudan `https://www.vydra.ai/api/v1` kullanır. `veo3` paketlenmiş olarak yalnızca metinden videoya sunulur; `kling` uzak bir görsel URL'si gerektirir. |
-| xAI       | Metinden videoya, görselden videoya ve uzak video düzenleme/uzatma akışlarını destekler.                                                                           |
+| Sağlayıcı             | Notlar                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Alibaba               | DashScope/Model Studio eşzamansız uç noktasını kullanır. Referans görseller ve videolar uzak `http(s)` URL’leri olmalıdır.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| BytePlus (1.0)        | Sağlayıcı kimliği `byteplus`. Modeller: `seedance-1-0-pro-250528` (varsayılan), `seedance-1-0-pro-t2v-250528`, `seedance-1-0-pro-fast-251015`, `seedance-1-0-lite-t2v-250428`, `seedance-1-0-lite-i2v-250428`. T2V modelleri (`*-t2v-*`) görsel girdilerini kabul etmez; I2V modelleri ve genel `*-pro-*` modelleri tek bir referans görseli (ilk kare) destekler. Görseli konumsal olarak geçirin veya `role: "first_frame"` ayarlayın. Bir görsel sağlandığında T2V model kimlikleri otomatik olarak karşılık gelen I2V varyantına geçirilir. Desteklenen `providerOptions` anahtarları: `seed` (number), `draft` (boolean, 480p’yi zorlar), `camera_fixed` (boolean). |
+| BytePlus Seedance 1.5 | [`@openclaw/byteplus-modelark`](https://www.npmjs.com/package/@openclaw/byteplus-modelark) plugin’ini gerektirir. Sağlayıcı kimliği `byteplus-seedance15`. Model: `seedance-1-5-pro-251215`. Birleşik `content[]` API’sini kullanır. En fazla 2 giriş görselini destekler (first_frame + last_frame). Tüm girdiler uzak `https://` URL’leri olmalıdır. Her görselde `role: "first_frame"` / `"last_frame"` ayarlayın veya görselleri konumsal olarak geçirin. `aspectRatio: "adaptive"` giriş görselinden oranı otomatik algılar. `audio: true`, `generate_audio` ile eşlenir. `providerOptions.seed` (number) iletilir.                                                                                                  |
+| BytePlus Seedance 2.0 | [`@openclaw/byteplus-modelark`](https://www.npmjs.com/package/@openclaw/byteplus-modelark) plugin’ini gerektirir. Sağlayıcı kimliği `byteplus-seedance2`. Modeller: `dreamina-seedance-2-0-260128`, `dreamina-seedance-2-0-fast-260128`. Birleşik `content[]` API’sini kullanır. En fazla 9 referans görseli, 3 referans videosu ve 3 referans sesi destekler. Tüm girdiler uzak `https://` URL’leri olmalıdır. Her varlıkta `role` ayarlayın — desteklenen değerler: `"first_frame"`, `"last_frame"`, `"reference_image"`, `"reference_video"`, `"reference_audio"`. `aspectRatio: "adaptive"` giriş görselinden oranı otomatik algılar. `audio: true`, `generate_audio` ile eşlenir. `providerOptions.seed` (number) iletilir. |
+| ComfyUI               | İş akışı odaklı yerel veya bulut yürütme. Yapılandırılmış grafik üzerinden metinden videoya ve görselden videoya destekler.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| fal                   | Uzun süren işler için kuyruk destekli akış kullanır. Yalnızca tek görsel referansı.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| Google                | Gemini/Veo kullanır. Bir görsel veya bir video referansını destekler.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| MiniMax               | Yalnızca tek görsel referansı.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| OpenAI                | Yalnızca `size` geçersiz kılması iletilir. Diğer stil geçersiz kılmaları (`aspectRatio`, `resolution`, `audio`, `watermark`) bir uyarıyla yok sayılır.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| Qwen                  | Alibaba ile aynı DashScope arka ucunu kullanır. Referans girdileri uzak `http(s)` URL’leri olmalıdır; yerel dosyalar peşinen reddedilir.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| Runway                | Veri URI’leri aracılığıyla yerel dosyaları destekler. Videodan videoya için `runway/gen4_aleph` gerekir. Yalnızca metin çalıştırmaları `16:9` ve `9:16` en-boy oranlarını sunar.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| Together              | Yalnızca tek görsel referansı.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| Vydra                 | Kimlik doğrulamayı düşüren yönlendirmelerden kaçınmak için doğrudan `https://www.vydra.ai/api/v1` kullanır. `veo3` paketlenmiş olarak yalnızca metinden videoya sunulur; `kling` uzak bir görsel URL’si gerektirir.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| xAI                   | Metinden videoya, görselden videoya ve uzak video düzenleme/uzatma akışlarını destekler.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

 ## Sağlayıcı yetenek modları

 Paylaşılan video oluşturma sözleşmesi artık sağlayıcıların yalnızca düz toplu sınırlar yerine
-moda özgü yetenekleri bildirmesine izin verir. Yeni sağlayıcı
+moda özgü yetenekler bildirmesine izin veriyor. Yeni sağlayıcı
 uygulamaları açık mod bloklarını tercih etmelidir:

 ```typescript
@ -282,10 +309,10 @@ capabilities: {
 ```

 `maxInputImages` ve `maxInputVideos` gibi düz toplu alanlar,
-dönüştürme modu desteğini bildirmek için yeterli değildir. Sağlayıcılar
-`generate`, `imageToVideo` ve `videoToVideo` modlarını açıkça bildirmelidir; böylece canlı testler,
-sözleşme testleri ve paylaşılan `video_generate` aracı mod desteğini
-deterministik biçimde doğrulayabilir.
+dönüştürme modu desteğini duyurmak için yeterli değildir. Sağlayıcılar,
+canlı testlerin, sözleşme testlerinin ve paylaşılan `video_generate` aracının
+mod desteğini deterministik biçimde doğrulayabilmesi için
+`generate`, `imageToVideo` ve `videoToVideo` alanlarını açıkça bildirmelidir.

 ## Canlı testler

@ -302,17 +329,17 @@ pnpm test:live:media video
 ```

 Bu canlı dosya eksik sağlayıcı ortam değişkenlerini `~/.profile` içinden yükler,
-varsayılan olarak kayıtlı kimlik doğrulama profillerinden önce canlı/env API anahtarlarını tercih eder
-ve yerel medya ile güvenli biçimde çalıştırabildiği bildirilmiş modları yürütür:
+varsayılan olarak kaydedilmiş kimlik doğrulama profilleri yerine canlı/ortam API anahtarlarını
+tercih eder ve yerel medya ile güvenle çalıştırabildiği bildirilmiş modları yürütür:

- Taramadaki her sağlayıcı için `generate`
+- taramadaki her sağlayıcı için `generate`
 - `capabilities.imageToVideo.enabled` olduğunda `imageToVideo`
 - `capabilities.videoToVideo.enabled` olduğunda ve sağlayıcı/model
-  paylaşılan taramada buffer destekli yerel video girdisini kabul ettiğinde `videoToVideo`
+  paylaşılan taramada arabellek destekli yerel video girdisini kabul ettiğinde `videoToVideo`

-Bugün paylaşılan `videoToVideo` canlı hattı şunları kapsar:
+Bugün paylaşılan `videoToVideo` canlı kanalı şunu kapsar:

- yalnızca `runway`, ancak siz `runway/gen4_aleph` seçtiğinizde
+- yalnızca `runway/gen4_aleph` seçtiğinizde `runway`

 ## Yapılandırma

@ -339,8 +366,8 @@ openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2

 ## İlgili

- [Tools Overview](/tr/tools)
- [Background Tasks](/tr/automation/tasks) -- eşzamansız video oluşturma için görev takibi
+- [Araçlara Genel Bakış](/tr/tools)
+- [Arka Plan Görevleri](/tr/automation/tasks) -- eşzamansız video oluşturma için görev izleme
 - [Alibaba Model Studio](/tr/providers/alibaba)
 - [BytePlus](/tr/concepts/model-providers#byteplus-international)
 - [ComfyUI](/tr/providers/comfy)
@ -353,5 +380,5 @@ openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2
 - [Together AI](/tr/providers/together)
 - [Vydra](/tr/providers/vydra)
 - [xAI](/tr/providers/xai)
- [Configuration Reference](/tr/gateway/configuration-reference#agent-defaults)
- [Models](/tr/concepts/models)
+- [Yapılandırma Başvurusu](/tr/gateway/configuration-reference#agent-defaults)
+- [Modeller](/tr/concepts/models)