chore(i18n): refresh tr translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-24 15:23:58 +00:00
parent 751ffc91ac
commit 482d1288f3
5 changed files with 594 additions and 638 deletions

View File

@ -2,27 +2,27 @@
read_when:
- Gateway Plugin'lerini veya uyumlu paketleri kurmak ya da yönetmek istiyorsunuz
- Plugin yükleme hatalarında hata ayıklamak istiyorsunuz
summary: '`openclaw plugins` için CLI başvurusu (listeleme, kurma, marketplace, kaldırma, etkinleştirme/devre dışı bırakma, doctor)'
summary: '`openclaw plugins` için CLI başvurusu (listeleme, kurulum, pazar yeri, kaldırma, etkinleştirme/devre dışı bırakma, doctor)'
title: Plugin'ler
x-i18n:
generated_at: "2026-04-24T09:03:18Z"
generated_at: "2026-04-24T15:21:56Z"
model: gpt-5.4
provider: openai
source_hash: 35ef8f54c64ea52d7618a0ef8b90d3d75841a27ae4cd689b4ca8e0cfdcddc408
source_hash: bc693d5e3bc49057e1a108ba65a4dcb3bb662c00229e6fa38a0335afba8240e5
source_path: cli/plugins.md
workflow: 15
---
# `openclaw plugins`
Gateway Plugin'lerini, kanca paketlerini ve uyumlu paketleri yönetin.
Gateway Plugin'lerini, hook paketlerini ve uyumlu paketleri yönetin.
İlgili:
- Plugin sistemi: [Plugin'ler](/tr/tools/plugin)
- Paket uyumluluğu: [Plugin paketleri](/tr/plugins/bundles)
- Plugin manifesti + şema: [Plugin manifesti](/tr/plugins/manifest)
- Güvenlik sıkılaştırması: [Güvenlik](/tr/gateway/security)
- Güvenlik sertleştirme: [Güvenlik](/tr/gateway/security)
## Komutlar
@ -46,23 +46,17 @@ openclaw plugins marketplace list <marketplace>
openclaw plugins marketplace list <marketplace> --json
```
Paketlenmiş Plugin'ler OpenClaw ile birlikte gelir. Bazıları varsayılan olarak etkindir (örneğin
paketlenmiş model sağlayıcıları, paketlenmiş konuşma sağlayıcıları ve paketlenmiş tarayıcı
Plugin'i); diğerleri için `plugins enable` gerekir.
Paket halinde gelen Plugin'ler OpenClaw ile birlikte gelir. Bazıları varsayılan olarak etkindir (örneğin paket halindeki model sağlayıcıları, paket halindeki konuşma sağlayıcıları ve paket halindeki tarayıcı Plugin'i); diğerleri için `plugins enable` gerekir.
Yerel OpenClaw Plugin'leri, satır içi JSON
Schema ile `openclaw.plugin.json` göndermelidir (`configSchema`, boş olsa bile). Uyumlu paketler bunun yerine kendi paket
manifestlerini kullanır.
Yerel OpenClaw Plugin'leri, satır içi JSON Schema ile birlikte `openclaw.plugin.json` içermelidir (`configSchema`, boş olsa bile). Uyumlu paketler bunun yerine kendi paket manifestlerini kullanır.
`plugins list`, `Format: openclaw` veya `Format: bundle` gösterir. Ayrıntılı liste/bilgi
çıktısı ayrıca paket alt türünü (`codex`, `claude` veya `cursor`) ve algılanan paket
yeteneklerini gösterir.
`plugins list`, `Format: openclaw` veya `Format: bundle` gösterir. Ayrıntılı liste/info çıktısı ayrıca paket alt türünü (`codex`, `claude` veya `cursor`) ve algılanan paket yeteneklerini de gösterir.
### Kurulum
```bash
openclaw plugins install <package> # Önce ClawHub, sonra npm
openclaw plugins install clawhub:<package> # Yalnızca ClawHub
openclaw plugins install <package> # önce ClawHub, sonra npm
openclaw plugins install clawhub:<package> # yalnızca ClawHub
openclaw plugins install <package> --force # mevcut kurulumu üzerine yaz
openclaw plugins install <package> --pin # sürümü sabitle
openclaw plugins install <package> --dangerously-force-unsafe-install
@ -72,85 +66,57 @@ openclaw plugins install <plugin> --marketplace <name> # marketplace (açık)
openclaw plugins install <plugin> --marketplace https://github.com/<owner>/<repo>
```
Çıplak paket adları önce ClawHub'a, sonra npm'e karşı denetlenir. Güvenlik notu:
Plugin kurulumlarını kod çalıştırmak gibi değerlendirin. Sabitlenmiş sürümleri tercih edin.
Çıplak paket adları önce ClawHub'a, ardından npm'e karşı kontrol edilir. Güvenlik notu: Plugin kurulumlarını kod çalıştırmak gibi değerlendirin. Sabitlenmiş sürümleri tercih edin.
`plugins` bölümünüz tek dosyalık bir `$include` ile destekleniyorsa, `plugins install/update/enable/disable/uninstall` o dahil edilen dosyaya yazar ve `openclaw.json` dosyasına dokunmaz. Kök include'lar, include dizileri ve kardeş geçersiz kılmaları olan include'lar düzleştirilmek yerine güvenli kapanışla başarısız olur. Desteklenen şekiller için [Yapılandırma include'ları](/tr/gateway/configuration) bölümüne bakın.
`plugins` bölümünüz tek dosyalık bir `$include` tarafından destekleniyorsa, `plugins install/update/enable/disable/uninstall` işlemleri bu dahil edilen dosyaya yazar ve `openclaw.json` dosyasına dokunmaz. Kök include'lar, include dizileri ve yan override'lara sahip include'lar düzleştirilmek yerine kapalı şekilde başarısız olur. Desteklenen biçimler için [Config includes](/tr/gateway/configuration) bölümüne bakın.
Yapılandırma geçersizse, `plugins install` normalde güvenli kapanışla başarısız olur ve size önce
`openclaw doctor --fix` çalıştırmanızı söyler. Belgelenmiş tek istisna, açıkça
`openclaw.install.allowInvalidConfigRecovery` kullanan Plugin'ler için dar kapsamlı bir
paketlenmiş-Plugin kurtarma yoludur.
Yapılandırma geçersizse, `plugins install` normalde kapalı şekilde başarısız olur ve önce `openclaw doctor --fix` çalıştırmanızı söyler. Belgelenmiş tek istisna, açıkça `openclaw.install.allowInvalidConfigRecovery` seçeneğini kabul eden Plugin'ler için dar kapsamlı bir paket Plugin kurtarma yoludur.
`--force`, mevcut kurulum hedefini yeniden kullanır ve zaten kurulmuş bir
Plugin'i veya kanca paketini yerinde üzerine yazar. Aynı kimliği yeni bir yerel yoldan, arşivden, ClawHub paketinden veya npm yapıtından bilerek yeniden kurarken bunu kullanın.
Zaten izlenen bir npm Plugin'inin rutin yükseltmeleri için
`openclaw plugins update <id-or-npm-spec>` tercih edin.
`--force`, mevcut kurulum hedefini yeniden kullanır ve zaten kurulu olan bir Plugin'i veya hook paketini yerinde üzerine yazar. Aynı kimliği yeni bir yerel yol, arşiv, ClawHub paketi veya npm artifact'inden bilerek yeniden kurarken bunu kullanın. Zaten izlenen bir npm Plugin'inin rutin yükseltmeleri için `openclaw plugins update <id-or-npm-spec>` tercih edin.
Zaten kurulmuş bir Plugin kimliği için `plugins install` çalıştırırsanız, OpenClaw
normal yükseltme için sizi `plugins update <id-or-npm-spec>` komutuna,
mevcut kurulumu farklı bir kaynaktan gerçekten üzerine yazmak istiyorsanız da
`plugins install <package> --force` komutuna yönlendirir.
Zaten kurulu olan bir Plugin kimliği için `plugins install` çalıştırırsanız, OpenClaw durur ve normal bir yükseltme için sizi `plugins update <id-or-npm-spec>` komutuna, mevcut kurulumu farklı bir kaynaktan gerçekten üzerine yazmak istiyorsanız da `plugins install <package> --force` komutuna yönlendirir.
`--pin` yalnızca npm kurulumları için geçerlidir. `--marketplace` ile desteklenmez,
çünkü marketplace kurulumları npm belirteci yerine marketplace kaynak meta verisini kalıcılaştırır.
`--pin` yalnızca npm kurulumları için geçerlidir. `--marketplace` ile desteklenmez, çünkü marketplace kurulumları npm spec yerine marketplace kaynak meta verisini kalıcı olarak saklar.
`--dangerously-force-unsafe-install`, yerleşik tehlikeli kod tarayıcısındaki yanlış pozitifler için acil durum seçeneğidir.
Yerleşik tarayıcı `critical` bulgular bildirse bile kurulumun sürmesine izin verir, ancak Plugin `before_install` kanca politika engellerini **geçersiz kılmaz** ve tarama
başarısızlıklarını **geçersiz kılmaz**.
`--dangerously-force-unsafe-install`, yerleşik tehlikeli kod tarayıcısındaki yanlış pozitifler için acil durum seçeneğidir. Yerleşik tarayıcı `critical` bulgular bildirse bile kurulumun devam etmesine izin verir, ancak Plugin `before_install` hook ilke engellerini **aşmaz** ve tarama başarısızlıklarını da **aşmaz**.
Bu CLI bayrağı Plugin kurulum/güncelleme akışları için geçerlidir. Gateway destekli skill
bağımlılık kurulumları eşleşen `dangerouslyForceUnsafeInstall` istek
geçersiz kılmasını kullanırken, `openclaw skills install` ayrı bir ClawHub skill
indirme/kurma akışı olarak kalır.
Bu CLI bayrağı Plugin install/update akışları için geçerlidir. Gateway destekli skill bağımlılık kurulumlarında eşleşen `dangerouslyForceUnsafeInstall` istek override'ı kullanılırken, `openclaw skills install` ayrı bir ClawHub skill indirme/kurma akışı olarak kalır.
`plugins install`, `package.json` içinde
`openclaw.hooks` sunan kanca paketleri için de kurulum yüzeyidir. Filtrelenmiş kanca
görünürlüğü ve kanca başına etkinleştirme için paket kurulumu değil, `openclaw hooks` kullanın.
`plugins install`, `package.json` içinde `openclaw.hooks` sunan hook paketleri için de kurulum yüzeyidir. Filtrelenmiş hook görünürlüğü ve hook başına etkinleştirme için paket kurulumunu değil, `openclaw hooks` komutunu kullanın.
Npm belirteçleri **yalnızca kayıt defteri içindir** (paket adı + isteğe bağlı **tam sürüm** veya
**dist-tag**). Git/URL/dosya belirteçleri ve semver aralıkları reddedilir. Bağımlılık
kurulumları güvenlik için `--ignore-scripts` ile çalıştırılır.
Npm spec'leri **yalnızca registry** içindir (paket adı + isteğe bağlı **tam sürüm** veya **dist-tag**). Git/URL/dosya spec'leri ve semver aralıkları reddedilir. Bağımlılık kurulumları güvenlik için `--ignore-scripts` ile çalışır.
Çıplak belirteçler ve `@latest`, kararlı izde kalır. Npm bunlardan herhangi birini
bir ön sürüme çözümlerse, OpenClaw durur ve `@beta`/`@rc` gibi bir ön sürüm etiketi veya
`@1.2.3-beta.4` gibi tam bir ön sürümle açık katılım yapmanızı ister.
Çıplak spec'ler ve `@latest`, kararlı iz üzerinde kalır. npm bunlardan birini bir ön sürüme çözerse OpenClaw durur ve `@beta`/`@rc` gibi bir ön sürüm etiketi veya `@1.2.3-beta.4` gibi tam bir ön sürüm kullanarak açıkça katılmanızı ister.
Çıplak bir kurulum belirteci paketlenmiş bir Plugin kimliğiyle eşleşirse (örneğin `diffs`), OpenClaw
paketlenmiş Plugin'i doğrudan kurar. Aynı adlı bir npm paketi kurmak için,
ık kapsamlı bir belirteç kullanın (örneğin `@scope/diffs`).
Çıplak bir kurulum spec'i paket halindeki bir Plugin kimliğiyle eşleşirse (örneğin `diffs`), OpenClaw paket halindeki Plugin'i doğrudan kurar. Aynı adlı bir npm paketini kurmak için açık bir scoped spec kullanın (örneğin `@scope/diffs`).
Desteklenen arşivler: `.zip`, `.tgz`, `.tar.gz`, `.tar`.
Claude marketplace kurulumları da desteklenir.
ClawHub kurulumlarıık bir `clawhub:<package>` konumlayıcısı kullanır:
ClawHub kurulumlarıık bir `clawhub:<package>` konumlandırıcısı kullanır:
```bash
openclaw plugins install clawhub:openclaw-codex-app-server
openclaw plugins install clawhub:openclaw-codex-app-server@1.2.3
```
OpenClaw artık çıplak npm-güvenli Plugin belirteçleri için de ClawHub'ı tercih eder. Yalnızca
ClawHub'da o paket veya sürüm yoksa npm'e geri döner:
OpenClaw artık çıplak npm-güvenli Plugin spec'leri için de öncelikle ClawHub'ı tercih eder. Yalnızca ClawHub'da bu paket veya sürüm yoksa npm'e geri döner:
```bash
openclaw plugins install openclaw-codex-app-server
```
OpenClaw, paket arşivini ClawHub'dan indirir, duyurulan
Plugin API / minimum Gateway uyumluluğunu denetler, ardından normal
arşiv yolu üzerinden kurar. Kaydedilen kurulumlar, daha sonraki güncellemeler için ClawHub kaynak meta verisini korur.
OpenClaw paket arşivini ClawHub'dan indirir, duyurulan Plugin API / minimum gateway uyumluluğunu denetler, ardından normal arşiv yolu üzerinden kurar. Kaydedilen kurulumlar, sonraki güncellemeler için ClawHub kaynak meta verisini korur.
Marketplace adı, Claude'un
`~/.claude/plugins/known_marketplaces.json` içindeki yerel kayıt defteri önbelleğinde varsa `plugin@marketplace` kısa gösterimini kullanın:
Marketplace adı Claude'un `~/.claude/plugins/known_marketplaces.json` içindeki yerel registry önbelleğinde varsa `plugin@marketplace` kısayolunu kullanın:
```bash
openclaw plugins marketplace list <marketplace-name>
openclaw plugins install <plugin-name>@<marketplace-name>
```
Marketplace kaynağınııkça geçirmek istediğinizde `--marketplace` kullanın:
Marketplace kaynağınııkça vermek istediğinizde `--marketplace` kullanın:
```bash
openclaw plugins install <plugin-name> --marketplace <marketplace-name>
@ -161,27 +127,22 @@ openclaw plugins install <plugin-name> --marketplace ./my-marketplace
Marketplace kaynakları şunlar olabilir:
- `~/.claude/plugins/known_marketplaces.json` içinden Claude bilinen-marketplace adı
- `~/.claude/plugins/known_marketplaces.json` içinden bir Claude bilinen-marketplace adı
- yerel bir marketplace kökü veya `marketplace.json` yolu
- `owner/repo` gibi bir GitHub repo kısa gösterimi
- `https://github.com/owner/repo` gibi bir GitHub repo URL'si
- `owner/repo` gibi bir GitHub depo kısayolu
- `https://github.com/owner/repo` gibi bir GitHub depo URL'si
- bir git URL'si
GitHub veya git'ten yüklenen uzak marketplace'lerde, Plugin girdileri klonlanmış marketplace deposunun içinde kalmalıdır. OpenClaw, o depodan gelen göreli yol kaynaklarını kabul eder ve uzak manifestlerden gelen HTTP(S), mutlak yol, git, GitHub ve diğer yol dışı Plugin kaynaklarını reddeder.
GitHub veya git üzerinden yüklenen uzak marketplace'lerde Plugin girdileri klonlanan marketplace deposunun içinde kalmalıdır. OpenClaw bu depodan gelen göreli yol kaynaklarını kabul eder ve uzak manifestlerden gelen HTTP(S), mutlak yol, git, GitHub ve yol dışı diğer Plugin kaynaklarını reddeder.
Yerel yollar ve arşivler için OpenClaw otomatik olarak şunları algılar:
- yerel OpenClaw Plugin'leri (`openclaw.plugin.json`)
- Codex uyumlu paketler (`.codex-plugin/plugin.json`)
- Claude uyumlu paketler (`.claude-plugin/plugin.json` veya varsayılan Claude
bileşen düzeni)
- Claude uyumlu paketler (`.claude-plugin/plugin.json` veya varsayılan Claude bileşen düzeni)
- Cursor uyumlu paketler (`.cursor-plugin/plugin.json`)
Uyumlu paketler normal Plugin köküne kurulur ve
aynı listeleme/bilgi/etkinleştirme/devre dışı bırakma akışına katılır. Bugün paket Skills, Claude
command-skills, Claude `settings.json` varsayılanları, Claude `.lsp.json` /
manifest tarafından bildirilen `lspServers` varsayılanları, Cursor command-skills ve uyumlu
Codex kanca dizinleri desteklenir; algılanan diğer paket yetenekleri tanılama/bilgi çıktısında gösterilir ancak henüz çalışma zamanı yürütmesine bağlanmamıştır.
Uyumlu paketler normal Plugin köküne kurulur ve aynı liste/info/etkinleştir/devre dışı bırak akışına katılır. Bugün paket skill'leri, Claude command-skills, Claude `settings.json` varsayılanları, Claude `.lsp.json` / manifestte bildirilen `lspServers` varsayılanları, Cursor command-skills ve uyumlu Codex hook dizinleri desteklenmektedir; algılanan diğer paket yetenekleri tanılama/info içinde gösterilir ancak henüz çalışma zamanı yürütmesine bağlanmamıştır.
### Listeleme
@ -192,21 +153,25 @@ openclaw plugins list --verbose
openclaw plugins list --json
```
Yalnızca yüklenmiş Plugin'leri göstermek için `--enabled` kullanın. Tablo görünümünden
kaynak/orijin/sürüm/etkinleştirme
meta verisi içeren Plugin başına ayrıntı satırlarına geçmek için `--verbose` kullanın. Makine tarafından okunabilir envanter ve kayıt defteri
tanılamaları için `--json` kullanın.
Yalnızca yüklenmiş Plugin'leri göstermek için `--enabled` kullanın. Tablo görünümünden Plugin başına ayrıntı satırlarına geçmek için `--verbose` kullanın; burada source/origin/version/activation meta verileri gösterilir. Makine tarafından okunabilir envanter ve registry tanılamaları için `--json` kullanın.
Yerel bir dizini kopyalamaktan kaçınmak için `--link` kullanın (`plugins.load.paths` içine ekler):
`plugins list`, geçerli CLI ortamı ve yapılandırmadan keşif çalıştırır. Bir Plugin'in etkinleştirilip etkinleştirilmediğini / yüklenebilir olup olmadığını kontrol etmek için kullanışlıdır, ancak zaten çalışan bir Gateway sürecinin canlı çalışma zamanı sondası değildir. Plugin kodunu, etkinleştirmeyi, hook ilkesini veya `plugins.load.paths` değerini değiştirdikten sonra, yeni `register(api)` kodunun veya hook'ların çalışmasını beklemeden önce kanala hizmet veren Gateway'i yeniden başlatın. Uzak/konteyner dağıtımlarında yalnızca bir sarmalayıcı süreci değil, gerçek `openclaw gateway run` alt sürecini yeniden başlattığınızı doğrulayın.
Çalışma zamanı hook hata ayıklaması için:
- `openclaw plugins inspect <id> --json`, modül yüklü inceleme geçişinden gelen kayıtlı hook'ları ve tanılamaları gösterir.
- `openclaw gateway status --deep --require-rpc`, erişilebilir Gateway'i, servis/süreç ipuçlarını, yapılandırma yolunu ve RPC sağlığını doğrular.
- Paket halinde gelmeyen konuşma hook'ları (`llm_input`, `llm_output`, `agent_end`) için `plugins.entries.<id>.hooks.allowConversationAccess=true` gerekir.
Yerel bir dizini kopyalamamak için `--link` kullanın (`plugins.load.paths` içine ekler):
```bash
openclaw plugins install -l ./my-plugin
```
Bağlı kurulumlar yönetilen bir kurulum hedefi üzerine kopyalamak yerine
kaynak yolu yeniden kullandığından `--force`, `--link` ile desteklenmez.
Bağlantılı kurulumlar yönetilen bir kurulum hedefinin üzerine kopyalamak yerine kaynak yolu yeniden kullandığından, `--force` ile `--link` desteklenmez.
Varsayılan davranışı sabitlenmemiş tutarken, npm kurulumlarında çözümlenen tam belirteci (`name@version`) `plugins.installs` içine kaydetmek için `--pin` kullanın.
Varsayılan davranışı sabitlenmemiş halde tutarken çözülmüş tam spec'i (`name@version`) `plugins.installs` içine kaydetmek için npm kurulumlarında `--pin` kullanın.
### Kaldırma
@ -216,15 +181,11 @@ openclaw plugins uninstall <id> --dry-run
openclaw plugins uninstall <id> --keep-files
```
`uninstall`, Plugin kayıtlarını `plugins.entries`, `plugins.installs`,
Plugin izin listesi ve uygulanabiliyorsa bağlı `plugins.load.paths` girdilerinden kaldırır.
Active Memory Plugin'lerinde, bellek yuvası `memory-core` olarak sıfırlanır.
`uninstall`, `plugins.entries`, `plugins.installs`, Plugin allowlist'i ve uygun olduğunda bağlantılı `plugins.load.paths` girdilerinden Plugin kayıtlarını kaldırır. Active Memory Plugin'leri için bellek yuvası `memory-core` değerine sıfırlanır.
Varsayılan olarak kaldırma, etkin
durum-dizini Plugin kökü altındaki Plugin kurulum dizinini de siler. Dosyaları diskte tutmak için
`--keep-files` kullanın.
Varsayılan olarak uninstall, etkin state-dir Plugin kökü altındaki Plugin kurulum dizinini de kaldırır. Dosyaları diskte tutmak için `--keep-files` kullanın.
`--keep-config`, `--keep-files` için kullanımdan kaldırılmış bir takma ad olarak desteklenir.
`--keep-config`, kullanımdan kaldırılmış bir diğer ad olarak `--keep-files` yerine desteklenir.
### Güncelleme
@ -236,35 +197,19 @@ openclaw plugins update @openclaw/voice-call@beta
openclaw plugins update openclaw-codex-app-server --dangerously-force-unsafe-install
```
Güncellemeler `plugins.installs` içindeki izlenen kurulumlara ve `hooks.internal.installs` içindeki izlenen kanca-paketi
kurulumlarına uygulanır.
Güncellemeler, `plugins.installs` içindeki izlenen kurulumlara ve `hooks.internal.installs` içindeki izlenen hook-paket kurulumlarına uygulanır.
Bir Plugin kimliği geçirdiğinizde, OpenClaw o
Plugin için kaydedilmiş kurulum belirtecini yeniden kullanır. Bu, daha önce kaydedilmiş `@beta` gibi dist-tag'lerin ve tam sabitlenmiş
sürümlerin sonraki `update <id>` çalıştırmalarında da kullanılmaya devam ettiği anlamına gelir.
Bir Plugin kimliği verdiğinizde OpenClaw, o Plugin için kaydedilmiş kurulum spec'ini yeniden kullanır. Bu, `@beta` gibi daha önce saklanan dist-tag'lerin ve sabitlenmiş tam sürümlerin sonraki `update <id>` çalıştırmalarında da kullanılmaya devam edeceği anlamına gelir.
Npm kurulumları için, bir dist-tag
veya tam sürüm içeren açık bir npm paket belirteci de geçirebilirsiniz. OpenClaw, bu paket adını izlenen Plugin
kaydına geri çözümler, kurulu Plugin'i günceller ve gelecekteki
kimlik tabanlı güncellemeler için yeni npm belirtecini kaydeder.
Npm kurulumlarında, bir dist-tag veya tam sürümle açık bir npm paket spec'i de verebilirsiniz. OpenClaw bu paket adını izlenen Plugin kaydına geri çözer, o kurulu Plugin'i günceller ve gelecekteki kimlik tabanlı güncellemeler için yeni npm spec'ini kaydeder.
Sürüm veya etiket olmadan npm paket adını geçirmek de izlenen Plugin
kaydına geri çözümlenir. Bir Plugin tam sürüme sabitlenmişken
onu kayıt defterinin varsayılan yayın hattına geri taşımak istediğinizde bunu kullanın.
Sürüm veya etiket olmadan npm paket adını vermek de izlenen Plugin kaydına geri çözer. Bir Plugin tam bir sürüme sabitlenmişse ve bunu yeniden registry'nin varsayılan sürüm hattına taşımak istiyorsanız bunu kullanın.
Canlı npm güncellemesinden önce OpenClaw, kurulu paket sürümünü npm kayıt defteri meta verileriyle karşılaştırır. Kurulu sürüm ve kaydedilmiş yapıt
kimliği zaten çözümlenen hedefle eşleşiyorsa, güncelleme indirme,
yeniden kurma veya `openclaw.json` yeniden yazımı olmadan atlanır.
Canlı bir npm güncellemesinden önce OpenClaw, kurulu paket sürümünü npm registry meta verilerine göre kontrol eder. Kurulu sürüm ve kaydedilmiş artifact kimliği zaten çözülmüş hedefle eşleşiyorsa, güncelleme indirme, yeniden kurma veya `openclaw.json` dosyasını yeniden yazma olmadan atlanır.
Depolanmış bir bütünlük hash'i varsa ve getirilen yapıt hash'i değişirse,
OpenClaw bunu npm yapıt sapması olarak değerlendirir. Etkileşimli
`openclaw plugins update` komutu beklenen ve gerçek hash'leri yazdırır ve
devam etmeden önce onay ister. Etkileşimsiz güncelleme yardımcıları, çağıran açık bir devam politikası sağlamadıkça güvenli kapanışla başarısız olur.
Kayıtlı bir bütünlük hash'i mevcut olduğunda ve getirilen artifact hash'i değiştiğinde, OpenClaw bunu npm artifact kayması olarak değerlendirir. Etkileşimli `openclaw plugins update` komutu beklenen ve gerçek hash'leri yazdırır ve devam etmeden önce onay ister. Etkileşimli olmayan güncelleme yardımcıları, çağıran açık bir devam etme ilkesi sağlamadıkça kapalı şekilde başarısız olur.
`--dangerously-force-unsafe-install`, Plugin güncellemeleri sırasında yerleşik tehlikeli kod taramasındaki yanlış pozitifler için
`plugins update` üzerinde de acil durum geçersiz kılması olarak kullanılabilir. Yine de Plugin `before_install` politika engellerini
veya tarama-başarısızlık engellemelerini geçersiz kılmaz ve yalnızca Plugin güncellemeleri için geçerlidir, kanca-paketi
güncellemeleri için geçerli değildir.
`--dangerously-force-unsafe-install`, Plugin güncellemeleri sırasında yerleşik tehlikeli kod taramasındaki yanlış pozitifler için acil durum override'ı olarak `plugins update` üzerinde de kullanılabilir. Yine de Plugin `before_install` ilke engellerini veya tarama başarısızlığı engellemesini aşmaz ve yalnızca Plugin güncellemelerine uygulanır, hook-paket güncellemelerine değil.
### İnceleme
@ -273,27 +218,22 @@ openclaw plugins inspect <id>
openclaw plugins inspect <id> --json
```
Tek bir Plugin için derin iç gözlem. Kimlik, yükleme durumu, kaynak,
kayıtlı yetenekler, kancalar, araçlar, komutlar, hizmetler, Gateway yöntemleri,
HTTP yolları, politika bayrakları, tanılamalar, kurulum meta verileri, paket yetenekleri
ve algılanan MCP veya LSP sunucu desteğini gösterir.
Tek bir Plugin için derinlemesine iç gözlem. Kimliği, yükleme durumunu, kaynağı, kaydedilmiş yetenekleri, hook'ları, araçları, komutları, servisleri, gateway yöntemlerini, HTTP yollarını, ilke bayraklarını, tanılamaları, kurulum meta verisini, paket yeteneklerini ve algılanan MCP veya LSP sunucu desteğini gösterir.
Her Plugin, çalışma zamanında gerçekten ne kaydettiğine göre sınıflandırılır:
- **plain-capability** — tek bir yetenek türü (ör. yalnızca sağlayıcı olan bir Plugin)
- **hybrid-capability** — birden fazla yetenek türü (ör. metin + konuşma + görseller)
- **hook-only** — yalnızca kancalar, yetenek veya yüzey yok
- **non-capability** — araçlar/komutlar/hizmetler var ama yetenek yok
- **plain-capability** — tek bir yetenek türü (örneğin yalnızca sağlayıcı olan bir Plugin)
- **hybrid-capability** — birden fazla yetenek türü (örneğin metin + konuşma + görseller)
- **hook-only** — yalnızca hook'lar, yetenek veya yüzey yok
- **non-capability** — araçlar/komutlar/servisler var ama yetenek yok
Yetenek modeli hakkında daha fazlası için [Plugin şekilleri](/tr/plugins/architecture#plugin-shapes) bölümüne bakın.
Yetenek modeli hakkında daha fazlası için [Plugin shapes](/tr/plugins/architecture#plugin-shapes) bölümüne bakın.
`--json` bayrağı, betik yazma ve
denetim için uygun makine tarafından okunabilir bir rapor verir.
`--json` bayrağı, betik yazma ve denetim için uygun, makine tarafından okunabilir bir rapor çıktılar.
`inspect --all`, şekil, yetenek türleri,
uyumluluk bildirimleri, paket yetenekleri ve kanca özeti sütunlarıyla filo genelinde bir tablo oluşturur.
`inspect --all`, shape, yetenek türleri, uyumluluk bildirimleri, paket yetenekleri ve hook özeti sütunları içeren filo genelinde bir tablo oluşturur.
`info`, `inspect` için bir takma addır.
`info`, `inspect` için bir diğer addır.
### Doctor
@ -301,13 +241,9 @@ uyumluluk bildirimleri, paket yetenekleri ve kanca özeti sütunlarıyla filo ge
openclaw plugins doctor
```
`doctor`, Plugin yükleme hatalarını, manifest/keşif tanılamalarını ve
uyumluluk bildirimlerini raporlar. Her şey temiz olduğunda `No plugin issues
detected.` yazdırır.
`doctor`, Plugin yükleme hatalarını, manifest/keşif tanılamalarını ve uyumluluk bildirimlerini raporlar. Her şey temiz olduğunda `No plugin issues detected.` yazdırır.
Eksik `register`/`activate` dışa aktarımları gibi modül-şekli hatalarında, tanılama çıktısına
özet dışa aktarım-şekli bilgisini eklemek için komutu
`OPENCLAW_PLUGIN_LOAD_DEBUG=1` ile yeniden çalıştırın.
Eksik `register`/`activate` dışa aktarımları gibi modül şekli hatalarında, tanılama çıktısına kompakt bir dışa aktarım şekli özeti eklemek için `OPENCLAW_PLUGIN_LOAD_DEBUG=1` ile yeniden çalıştırın.
### Marketplace
@ -316,10 +252,7 @@ openclaw plugins marketplace list <source>
openclaw plugins marketplace list <source> --json
```
Marketplace listeleme, yerel bir marketplace yolu, bir `marketplace.json` yolu,
`owner/repo` gibi bir GitHub kısa gösterimi, bir GitHub depo URL'si veya bir git URL'si kabul eder. `--json`,
çözümlenen kaynak etiketini ve ayrıştırılmış marketplace manifestini
ve Plugin girdilerini yazdırır.
Marketplace list, yerel bir marketplace yolunu, bir `marketplace.json` yolunu, `owner/repo` gibi bir GitHub kısayolunu, bir GitHub depo URL'sini veya bir git URL'sini kabul eder. `--json`, çözümlenen kaynak etiketini ve ayrıştırılmış marketplace manifesti ile Plugin girdilerini yazdırır.
## İlgili

View File

@ -1,14 +1,14 @@
---
read_when:
- Sağlayıcı bazında model kurulum başvurusuna ihtiyacınız var
- Sağlayıcı bazında bir model kurulum başvuru kaynağına ihtiyacınız var
- Model sağlayıcıları için örnek yapılandırmalar veya CLI ilk kurulum komutları istiyorsunuz
summary: Örnek yapılandırmalar + CLI akışları ile model sağlayıcısı genel bakışı
summary: Örnek yapılandırmalar ve CLI akışlarıyla model sağlayıcısı genel bakışı
title: Model sağlayıcıları
x-i18n:
generated_at: "2026-04-24T09:05:52Z"
generated_at: "2026-04-24T15:21:56Z"
model: gpt-5.4
provider: openai
source_hash: ac9bf48897446576d8bc339b340295691741a589863bb57b379c17a5519bffd7
source_hash: 79258cb26fae7926c65b6fe0db938c7b5736a540b33bc24c1fad5ad706ac8204
source_path: concepts/model-providers.md
workflow: 15
---
@ -18,77 +18,65 @@ Model seçim kuralları için bkz. [/concepts/models](/tr/concepts/models).
## Hızlı kurallar
- Model ref'leri `provider/model` kullanır (örnek: `opencode/claude-opus-4-6`).
- `agents.defaults.models`, ayarlandığında izin listesi görevi görür.
- Model başvuruları `provider/model` biçimini kullanır (örnek: `opencode/claude-opus-4-6`).
- `agents.defaults.models`, ayarlandığında bir izin listesi olarak davranır.
- CLI yardımcıları: `openclaw onboard`, `openclaw models list`, `openclaw models set <provider/model>`.
- `models.providers.*.models[].contextWindow` yerel model metadata'sıdır; `contextTokens` ise etkili çalışma zamanı sınırıdır.
- Geri dönüş kuralları, cooldown yoklamaları ve oturum geçersiz kılma kalıcılığı: [Model failover](/tr/concepts/model-failover).
- OpenAI ailesi rotaları öneke özgüdür: `openai/<model>` doğrudan
API anahtarlı OpenAI sağlayıcısını PI içinde kullanır, `openai-codex/<model>` PI içinde Codex OAuth kullanır,
ve `openai/<model>` artı `agents.defaults.embeddedHarness.runtime: "codex"`
yerel Codex uygulama sunucusu koşumunu kullanır. Bkz. [OpenAI](/tr/providers/openai)
ve [Codex harness](/tr/plugins/codex-harness).
- Plugin otomatik etkinleştirme de aynı sınırı izler: `openai-codex/<model>`
OpenAI Plugin'ine aittir, Codex Plugin'i ise
`embeddedHarness.runtime: "codex"` veya eski `codex/<model>` ref'leri ile etkinleştirilir.
- GPT-5.5 şu anda abonelik/OAuth rotaları üzerinden kullanılabilir:
PI içinde `openai-codex/gpt-5.5` veya Codex uygulama sunucusu
koşumuyla `openai/gpt-5.5`. `openai/gpt-5.5` için doğrudan API anahtarı rotası,
OpenAI GPT-5.5'i genel API'de etkinleştirdiğinde desteklenir; o zamana kadar
`OPENAI_API_KEY` kurulumları için `openai/gpt-5.4` gibi API etkin modeller kullanın.
- `models.providers.*.models[].contextWindow` doğal model meta verisidir; `contextTokens` ise etkili çalışma zamanı sınırıdır.
- Yedekleme kuralları, bekleme süresi incelemeleri ve oturum-üstü geçersiz kılma kalıcılığı: [Model failover](/tr/concepts/model-failover).
- OpenAI ailesi yönlendirmeleri önek bazlıdır: `openai/<model>`, PI içinde doğrudan OpenAI API anahtarı sağlayıcısını kullanır; `openai-codex/<model>`, PI içinde Codex OAuth kullanır; `openai/<model>` ile birlikte `agents.defaults.embeddedHarness.runtime: "codex"` ise doğal Codex uygulama sunucusu harness'ını kullanır. Bkz. [OpenAI](/tr/providers/openai) ve [Codex harness](/tr/plugins/codex-harness).
- Plugin otomatik etkinleştirme de aynı sınırı izler: `openai-codex/<model>` OpenAI Plugin'ine aittir, Codex Plugin'i ise `embeddedHarness.runtime: "codex"` veya eski `codex/<model>` başvuruları tarafından etkinleştirilir.
- GPT-5.5 şu anda abonelik/OAuth yolları üzerinden kullanılabilir: PI içinde `openai-codex/gpt-5.5` veya Codex uygulama sunucusu harness'ı ile `openai/gpt-5.5`. `openai/gpt-5.5` için doğrudan API anahtarı yolu, OpenAI GPT-5.5'i genel API üzerinde etkinleştirdiğinde desteklenir; o zamana kadar `OPENAI_API_KEY` kurulumları için `openai/gpt-5.4` gibi API etkin modelleri kullanın.
## Plugin sahipli sağlayıcı davranışı
## Plugin'e ait sağlayıcı davranışı
Sağlayıcıya özgü mantığın çoğu, OpenClaw genel çıkarım döngüsünü korurken sağlayıcı Plugin'lerinde (`registerProvider(...)`) yaşar. Plugin'ler; ilk kuruluma, model kataloglarına, auth env var eşlemesine, aktarım/yapılandırma normalizasyonuna, araç şeması temizliğine, failover sınıflandırmasına, OAuth yenilemeye, kullanım raporlamasına, düşünme/muhakeme profillerine ve daha fazlasına sahiptir.
Sağlayıcıya özgü mantığın çoğu sağlayıcı Plugin'lerinde (`registerProvider(...)`) yaşar; OpenClaw ise genel çıkarım döngüsünü korur. Plugin'ler ilk kurulum, model katalogları, kimlik doğrulama ortam değişkeni eşlemesi, taşıma/yapılandırma normalleştirmesi, araç şeması temizliği, failover sınıflandırması, OAuth yenileme, kullanım raporlama, düşünme/akıl yürütme profilleri ve daha fazlasından sorumludur.
Sağlayıcı SDK kancalarının tam listesi ve paketle gelen Plugin örnekleri [Provider plugins](/tr/plugins/sdk-provider-plugins) sayfasında yer alır. Tamamen özel bir istek yürütücüsüne ihtiyaç duyan bir sağlayıcı, ayrı ve daha derin bir genişletme yüzeyidir.
Sağlayıcı SDK kancalarının tam listesi ve paketlenmiş Plugin örnekleri [Provider plugins](/tr/plugins/sdk-provider-plugins) içinde yer alır. Tamamen özel bir istek yürütücüsüne ihtiyaç duyan bir sağlayıcı, ayrı ve daha derin bir genişletme yüzeyidir.
<Note>
Sağlayıcı çalışma zamanı `capabilities`, paylaşılan çalıştırıcı metadata'sıdır (sağlayıcı ailesi, transcript/araçlama tuhaflıkları, taşıma/önbellek ipuçları). Bu, bir Plugin'in neyi kaydettiğini açıklayan [public capability model](/tr/plugins/architecture#public-capability-model) ile aynı değildir (metin çıkarımı, konuşma vb.).
Sağlayıcı çalışma zamanı `capabilities`, paylaşılan çalıştırıcı meta verisidir (sağlayıcı ailesi, transkript/araçlama farklılıkları, taşıma/önbellek ipuçları). Bu, bir Plugin'in ne kaydettiğini açıklayan [public capability model](/tr/plugins/architecture#public-capability-model) ile aynı şey değildir (metin çıkarımı, konuşma vb.).
</Note>
## API anahtarı döndürme
## API anahtarı rotasyonu
- Seçili sağlayıcılar için genel sağlayıcı döndürmeyi destekler.
- Birden çok anahtarı şu yollarla yapılandırın:
- Seçili sağlayıcılar için genel sağlayıcı rotasyonunu destekler.
- Birden fazla anahtarı şu yollarla yapılandırın:
- `OPENCLAW_LIVE_<PROVIDER>_KEY` (tek canlı geçersiz kılma, en yüksek öncelik)
- `<PROVIDER>_API_KEYS` (virgül veya noktalı virgülle ayrılmış liste)
- `<PROVIDER>_API_KEYS` (virgül veya noktalı virgül listesi)
- `<PROVIDER>_API_KEY` (birincil anahtar)
- `<PROVIDER>_API_KEY_*` (numaralı liste, ör. `<PROVIDER>_API_KEY_1`)
- Google sağlayıcıları için `GOOGLE_API_KEY` de geri dönüş olarak dahildir.
- Anahtar seçim sırası önceliği korur ve değerlerin tekrarını kaldırır.
- İstekler yalnızca hız sınırı yanıtlarında sonraki anahtarla yeniden denenir (
örneğin `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many
- Google sağlayıcıları için `GOOGLE_API_KEY` de yedek olarak dahil edilir.
- Anahtar seçim sırası önceliği korur ve değerleri tekilleştirir.
- İstekler, yalnızca hız sınırı yanıtlarında bir sonraki anahtarla yeniden denenir (örneğin `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many
concurrent requests`, `ThrottlingException`, `concurrency limit reached`,
`workers_ai ... quota limit exceeded` veya periyodik kullanım sınırı mesajları).
- Hız sınırı dışındaki hatalar hemen başarısız olur; anahtar döndürme denenmez.
`workers_ai ... quota limit exceeded` veya dönemsel kullanım sınırı mesajları).
- Hız sınırı dışındaki hatalar hemen başarısız olur; anahtar rotasyonu denenmez.
- Tüm aday anahtarlar başarısız olduğunda, son hata son denemeden döndürülür.
## Yerleşik sağlayıcılar (pi-ai kataloğu)
OpenClaw, piai kataloğuyla birlikte gelir. Bu sağlayıcılar için
`models.providers` yapılandırması gerekmez; yalnızca auth ayarlayın ve bir model seçin.
OpenClaw, piai kataloğuyla birlikte gelir. Bu sağlayıcılar **hiç**
`models.providers` yapılandırması gerektirmez; sadece kimlik doğrulamayı ayarlayın ve bir model seçin.
### OpenAI
- Sağlayıcı: `openai`
- Auth: `OPENAI_API_KEY`
- İsteğe bağlı döndürme: `OPENAI_API_KEYS`, `OPENAI_API_KEY_1`, `OPENAI_API_KEY_2`, artı `OPENCLAW_LIVE_OPENAI_KEY` (tek geçersiz kılma)
- Kimlik doğrulama: `OPENAI_API_KEY`
- İsteğe bağlı rotasyon: `OPENAI_API_KEYS`, `OPENAI_API_KEY_1`, `OPENAI_API_KEY_2`, ayrıca `OPENCLAW_LIVE_OPENAI_KEY` (tek geçersiz kılma)
- Örnek modeller: `openai/gpt-5.4`, `openai/gpt-5.4-mini`
- OpenAI GPT-5.5'i API'de sunduğunda doğrudan GPT-5.5 API desteği burada geleceğe hazırdır
- GPT-5.5 için doğrudan API desteği, OpenAI GPT-5.5'i API'de kullanıma açtığında burada geleceğe hazırdır
- CLI: `openclaw onboard --auth-choice openai-api-key`
- Varsayılan taşıma `auto`'dur (önce WebSocket, geri dönüş SSE)
- Model başına `agents.defaults.models["openai/<model>"].params.transport` ile geçersiz kılın (`"sse"`, `"websocket"` veya `"auto"`)
- OpenAI Responses WebSocket ısınması varsayılan olarak `params.openaiWsWarmup` üzerinden etkindir (`true`/`false`)
- OpenAI priority processing, `agents.defaults.models["openai/<model>"].params.serviceTier` üzerinden etkinleştirilebilir
- Varsayılan taşıma `auto`'dur (önce WebSocket, yedek olarak SSE)
- Model başına şununla geçersiz kılın: `agents.defaults.models["openai/<model>"].params.transport` (`"sse"`, `"websocket"` veya `"auto"`)
- OpenAI Responses WebSocket ısınması varsayılan olarak `params.openaiWsWarmup` (`true`/`false`) ile etkindir
- OpenAI öncelikli işleme `agents.defaults.models["openai/<model>"].params.serviceTier` ile etkinleştirilebilir
- `/fast` ve `params.fastMode`, doğrudan `openai/*` Responses isteklerini `api.openai.com` üzerinde `service_tier=priority` olarak eşler
- Paylaşılan `/fast` geçişi yerine açık bir katman istediğinizde `params.serviceTier` kullanın
- Gizli OpenClaw ilişkilendirme üst bilgileri (`originator`, `version`,
`User-Agent`) yalnızca `api.openai.com` üzerindeki yerel OpenAI trafiğine uygulanır,
genel OpenAI uyumlu proxy'lere uygulanmaz
- Yerel OpenAI rotaları ayrıca Responses `store`, istem önbelleği ipuçları ve
OpenAI muhakeme uyumlu yük şekillendirmesini korur; proxy rotaları korumaz
- `openai/gpt-5.3-codex-spark`, canlı OpenAI API istekleri bunu reddettiği ve mevcut Codex kataloğu bunu sunmadığı için OpenClaw içinde bilerek bastırılır
- Paylaşılan `/fast` anahtarı yerine açık bir katman istediğinizde `params.serviceTier` kullanın
- Gizli OpenClaw atıf başlıkları (`originator`, `version`,
`User-Agent`) yalnızca `api.openai.com`'a giden doğal OpenAI trafiğinde uygulanır, genel OpenAI uyumlu proxy'lerde uygulanmaz
- Doğal OpenAI yolları ayrıca Responses `store`, istem önbelleği ipuçlarını ve
OpenAI akıl yürütme uyumluluğu yük şekillendirmesini korur; proxy yolları korumaz
- `openai/gpt-5.3-codex-spark`, canlı OpenAI API istekleri bunu reddettiği ve mevcut Codex kataloğu bunu göstermediği için OpenClaw'da kasıtlı olarak gizlenmiştir
```json5
{
@ -99,13 +87,13 @@ OpenClaw, piai kataloğuyla birlikte gelir. Bu sağlayıcılar için
### Anthropic
- Sağlayıcı: `anthropic`
- Auth: `ANTHROPIC_API_KEY`
- İsteğe bağlı döndürme: `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`, `ANTHROPIC_API_KEY_2`, artı `OPENCLAW_LIVE_ANTHROPIC_KEY` (tek geçersiz kılma)
- Kimlik doğrulama: `ANTHROPIC_API_KEY`
- İsteğe bağlı rotasyon: `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`, `ANTHROPIC_API_KEY_2`, ayrıca `OPENCLAW_LIVE_ANTHROPIC_KEY` (tek geçersiz kılma)
- Örnek model: `anthropic/claude-opus-4-6`
- CLI: `openclaw onboard --auth-choice apiKey`
- Doğrudan genel Anthropic istekleri, `api.anthropic.com`'a gönderilen API anahtarlı ve OAuth kimlik doğrulamalı trafik dahil, paylaşılan `/fast` geçişini ve `params.fastMode`'u destekler; OpenClaw bunu Anthropic `service_tier`'a eşler (`auto` ve `standard_only`)
- Anthropic notu: Anthropic çalışanları bize OpenClaw tarzı Claude CLI kullanımına yeniden izin verildiğini söyledi; bu yüzden Anthropic yeni bir ilke yayımlamadığı sürece OpenClaw, Claude CLI yeniden kullanımını ve `claude -p` kullanımını bu entegrasyon için onaylı kabul eder.
- Anthropic setup-token, desteklenen bir OpenClaw token yolu olarak kullanılabilir olmaya devam eder, ancak OpenClaw artık mümkün olduğunda Claude CLI yeniden kullanımını ve `claude -p`'yi tercih eder.
- Doğrudan genel Anthropic istekleri, `api.anthropic.com`'a gönderilen API anahtarı ve OAuth ile kimliği doğrulanmış trafik dahil, paylaşılan `/fast` anahtarını ve `params.fastMode`'u destekler; OpenClaw bunu Anthropic `service_tier`'ına (`auto` vs `standard_only`) eşler
- Anthropic notu: Anthropic çalışanları bize OpenClaw tarzı Claude CLI kullanımına yeniden izin verildiğini söyledi; bu nedenle Anthropic yeni bir politika yayımlamadıkça OpenClaw, Claude CLI yeniden kullanımını ve `claude -p` kullanımını bu entegrasyon için onaylı kabul eder.
- Anthropic kurulum belirteci, desteklenen bir OpenClaw belirteç yolu olarak kullanılmaya devam eder, ancak OpenClaw artık mümkün olduğunda Claude CLI yeniden kullanımını ve `claude -p` kullanımını tercih eder.
```json5
{
@ -116,24 +104,24 @@ OpenClaw, piai kataloğuyla birlikte gelir. Bu sağlayıcılar için
### OpenAI Codex OAuth
- Sağlayıcı: `openai-codex`
- Auth: OAuth (ChatGPT)
- PI model ref: `openai-codex/gpt-5.5`
- Yerel Codex uygulama sunucusu koşum ref'i: `agents.defaults.embeddedHarness.runtime: "codex"` ile `openai/gpt-5.5`
- Eski model ref'leri: `codex/gpt-*`
- Plugin sınırı: `openai-codex/*`, OpenAI Plugin'ini yükler; yerel Codex
uygulama sunucusu Plugin'i yalnızca Codex koşumu çalışma zamanı veya eski
`codex/*` ref'leri ile seçilir.
- Kimlik doğrulama: OAuth (ChatGPT)
- PI model başvurusu: `openai-codex/gpt-5.5`
- Doğal Codex uygulama sunucusu harness başvurusu: `openai/gpt-5.5` ve `agents.defaults.embeddedHarness.runtime: "codex"`
- Eski model başvuruları: `codex/gpt-*`
- Plugin sınırı: `openai-codex/*` OpenAI Plugin'ini yükler; doğal Codex
uygulama sunucusu Plugin'i yalnızca Codex harness çalışma zamanı veya eski
`codex/*` başvurularıyla seçilir.
- CLI: `openclaw onboard --auth-choice openai-codex` veya `openclaw models auth login --provider openai-codex`
- Varsayılan taşıma `auto`'dur (önce WebSocket, geri dönüş SSE)
- PI model başına `agents.defaults.models["openai-codex/<model>"].params.transport` ile geçersiz kılın (`"sse"`, `"websocket"` veya `"auto"`)
- `params.serviceTier`, yerel Codex Responses isteklerinde de iletilir (`chatgpt.com/backend-api`)
- Gizli OpenClaw ilişkilendirme üst bilgileri (`originator`, `version`,
`User-Agent`) yalnızca `chatgpt.com/backend-api`
üzerindeki yerel Codex trafiğine eklenir, genel OpenAI uyumlu proxy'lere eklenmez
- Doğrudan `openai/*` ile aynı `/fast` geçişini ve `params.fastMode` yapılandırmasını paylaşır; OpenClaw bunu `service_tier=priority` olarak eşler
- `openai-codex/gpt-5.5`, yerel `contextWindow = 1000000` değerini ve varsayılan çalışma zamanı `contextTokens = 272000` değerini korur; çalışma zamanı sınırını `models.providers.openai-codex.models[].contextTokens` ile geçersiz kılın
- İlke notu: OpenAI Codex OAuth, OpenClaw gibi harici araçlar/iş akışları için açıkça desteklenir.
- Geçerli GPT-5.5 erişimi, OpenAI GPT-5.5'i genel API'de etkinleştirene kadar bu OAuth/abonelik rotasını kullanır.
- Varsayılan taşıma `auto`'dur (önce WebSocket, yedek olarak SSE)
- PI modeli başına şununla geçersiz kılın: `agents.defaults.models["openai-codex/<model>"].params.transport` (`"sse"`, `"websocket"` veya `"auto"`)
- `params.serviceTier`, doğal Codex Responses isteklerinde de iletilir (`chatgpt.com/backend-api`)
- Gizli OpenClaw atıf başlıkları (`originator`, `version`,
`User-Agent`) yalnızca `chatgpt.com/backend-api`'ye giden doğal Codex trafiğine
eklenir, genel OpenAI uyumlu proxy'lere eklenmez
- Doğrudan `openai/*` ile aynı `/fast` anahtarını ve `params.fastMode` yapılandırmasını paylaşır; OpenClaw bunu `service_tier=priority` olarak eşler
- `openai-codex/gpt-5.5`, doğal `contextWindow = 1000000` ve varsayılan çalışma zamanı `contextTokens = 272000` değerlerini korur; çalışma zamanı sınırını `models.providers.openai-codex.models[].contextTokens` ile geçersiz kılın
- Politika notu: OpenAI Codex OAuth, OpenClaw gibi harici araçlar/iş akışları için açıkça desteklenir.
- Mevcut GPT-5.5 erişimi, OpenAI GPT-5.5'i genel API'de etkinleştirene kadar bu OAuth/abonelik yolunu kullanır.
```json5
{
@ -155,13 +143,13 @@ OpenClaw, piai kataloğuyla birlikte gelir. Bu sağlayıcılar için
### Diğer abonelik tarzı barındırılan seçenekler
- [Qwen Cloud](/tr/providers/qwen): Qwen Cloud sağlayıcı yüzeyi artı Alibaba DashScope ve Coding Plan uç nokta eşlemesi
- [Qwen Cloud](/tr/providers/qwen): Qwen Cloud sağlayıcı yüzeyi ile Alibaba DashScope ve Coding Plan uç nokta eşlemesi
- [MiniMax](/tr/providers/minimax): MiniMax Coding Plan OAuth veya API anahtarı erişimi
- [GLM Models](/tr/providers/glm): Z.AI Coding Plan veya genel API uç noktaları
### OpenCode
- Auth: `OPENCODE_API_KEY` (veya `OPENCODE_ZEN_API_KEY`)
- Kimlik doğrulama: `OPENCODE_API_KEY` (veya `OPENCODE_ZEN_API_KEY`)
- Zen çalışma zamanı sağlayıcısı: `opencode`
- Go çalışma zamanı sağlayıcısı: `opencode-go`
- Örnek modeller: `opencode/claude-opus-4-6`, `opencode-go/kimi-k2.5`
@ -176,46 +164,46 @@ OpenClaw, piai kataloğuyla birlikte gelir. Bu sağlayıcılar için
### Google Gemini (API anahtarı)
- Sağlayıcı: `google`
- Auth: `GEMINI_API_KEY`
- İsteğe bağlı döndürme: `GEMINI_API_KEYS`, `GEMINI_API_KEY_1`, `GEMINI_API_KEY_2`, `GOOGLE_API_KEY` geri dönüşü ve `OPENCLAW_LIVE_GEMINI_KEY` (tek geçersiz kılma)
- Kimlik doğrulama: `GEMINI_API_KEY`
- İsteğe bağlı rotasyon: `GEMINI_API_KEYS`, `GEMINI_API_KEY_1`, `GEMINI_API_KEY_2`, `GOOGLE_API_KEY` yedeği ve `OPENCLAW_LIVE_GEMINI_KEY` (tek geçersiz kılma)
- Örnek modeller: `google/gemini-3.1-pro-preview`, `google/gemini-3-flash-preview`
- Uyumluluk: `google/gemini-3.1-flash-preview` kullanan eski OpenClaw yapılandırması `google/gemini-3-flash-preview` olarak normalize edilir
- Uyumluluk: `google/gemini-3.1-flash-preview` kullanan eski OpenClaw yapılandırması `google/gemini-3-flash-preview` olarak normalleştirilir
- CLI: `openclaw onboard --auth-choice gemini-api-key`
- Doğrudan Gemini çalıştırmaları ayrıca `agents.defaults.models["google/<model>"].params.cachedContent`
(veya eski `cached_content`) kabul eder; sağlayıcıya özgü
(veya eski `cached_content`) kabul eder; bu, sağlayıcıya özgü bir
`cachedContents/...` tanıtıcısını iletir; Gemini önbellek isabetleri OpenClaw `cacheRead` olarak görünür
### Google Vertex ve Gemini CLI
- Sağlayıcılar: `google-vertex`, `google-gemini-cli`
- Auth: Vertex, gcloud ADC kullanır; Gemini CLI kendi OAuth akışını kullanır
- Dikkat: OpenClaw içindeki Gemini CLI OAuth resmi olmayan bir entegrasyondur. Bazı kullanıcılar üçüncü taraf istemcileri kullandıktan sonra Google hesap kısıtlamaları bildirmiştir. Devam etmeyi seçerseniz Google şartlarını inceleyin ve kritik olmayan bir hesap kullanın.
- Gemini CLI OAuth, paketle gelen `google` Plugin'inin bir parçası olarak gelir.
- Önce Gemini CLI kurun:
- Kimlik doğrulama: Vertex gcloud ADC kullanır; Gemini CLI kendi OAuth akışını kullanır
- Dikkat: OpenClaw içindeki Gemini CLI OAuth resmî olmayan bir entegrasyondur. Bazı kullanıcılar üçüncü taraf istemcileri kullandıktan sonra Google hesap kısıtlamaları bildirmiştir. Devam etmeyi seçerseniz Google şartlarını inceleyin ve kritik olmayan bir hesap kullanın.
- Gemini CLI OAuth, paketlenmiş `google` Plugin'inin bir parçası olarak gönderilir.
- Önce Gemini CLI'yi yükleyin:
- `brew install gemini-cli`
- veya `npm install -g @google/gemini-cli`
- Etkinleştirin: `openclaw plugins enable google`
- Giriş yapın: `openclaw models auth login --provider google-gemini-cli --set-default`
- Etkinleştirme: `openclaw plugins enable google`
- Giriş: `openclaw models auth login --provider google-gemini-cli --set-default`
- Varsayılan model: `google-gemini-cli/gemini-3-flash-preview`
- Not: istemci kimliği veya gizli anahtarı `openclaw.json` içine **yapıştırmazsınız**. CLI giriş akışı
token'ları gateway host üzerindeki auth profile'larında saklar.
- İstekler girişten sonra başarısız olursa gateway host üzerinde `GOOGLE_CLOUD_PROJECT` veya `GOOGLE_CLOUD_PROJECT_ID` ayarlayın.
- Gemini CLI JSON yanıtları `response` içinden ayrıştırılır; kullanım, `stats` içinden geri döner ve
`stats.cached`, OpenClaw `cacheRead` içine normalize edilir.
- Not: `openclaw.json` içine bir istemci kimliği veya gizli anahtar yapıştırmazsınız. CLI giriş akışı
belirteçleri Gateway ana bilgisayarındaki kimlik doğrulama profillerinde depolar.
- Girişten sonra istekler başarısız olursa, Gateway ana bilgisayarında `GOOGLE_CLOUD_PROJECT` veya `GOOGLE_CLOUD_PROJECT_ID` ayarlayın.
- Gemini CLI JSON yanıtları `response` içinden ayrıştırılır; kullanım
`stats`'a yedeklenir ve `stats.cached`, OpenClaw `cacheRead` içine normalleştirilir.
### Z.AI (GLM)
- Sağlayıcı: `zai`
- Auth: `ZAI_API_KEY`
- Kimlik doğrulama: `ZAI_API_KEY`
- Örnek model: `zai/glm-5.1`
- CLI: `openclaw onboard --auth-choice zai-api-key`
- Takma adlar: `z.ai/*` ve `z-ai/*`, `zai/*` olarak normalize edilir
- Takma adlar: `z.ai/*` ve `z-ai/*`, `zai/*` olarak normalleştirilir
- `zai-api-key`, eşleşen Z.AI uç noktasını otomatik algılar; `zai-coding-global`, `zai-coding-cn`, `zai-global` ve `zai-cn` belirli bir yüzeyi zorlar
### Vercel AI Gateway
- Sağlayıcı: `vercel-ai-gateway`
- Auth: `AI_GATEWAY_API_KEY`
- Kimlik doğrulama: `AI_GATEWAY_API_KEY`
- Örnek modeller: `vercel-ai-gateway/anthropic/claude-opus-4.6`,
`vercel-ai-gateway/moonshotai/kimi-k2.6`
- CLI: `openclaw onboard --auth-choice ai-gateway-api-key`
@ -223,70 +211,70 @@ OpenClaw, piai kataloğuyla birlikte gelir. Bu sağlayıcılar için
### Kilo Gateway
- Sağlayıcı: `kilocode`
- Auth: `KILOCODE_API_KEY`
- Kimlik doğrulama: `KILOCODE_API_KEY`
- Örnek model: `kilocode/kilo/auto`
- CLI: `openclaw onboard --auth-choice kilocode-api-key`
- Base URL: `https://api.kilo.ai/api/gateway/`
- Statik geri dönüş kataloğu `kilocode/kilo/auto` ile birlikte gelir; canlı
- Temel URL: `https://api.kilo.ai/api/gateway/`
- Statik yedek katalog `kilocode/kilo/auto` ile gelir; canlı
`https://api.kilo.ai/api/gateway/models` keşfi çalışma zamanı
kataloğunu daha da genişletebilir.
- `kilocode/kilo/auto` arkasındaki tam yukarı akış yönlendirmesi sabit kodlu olarak OpenClaw'da değil,
Kilo Gateway'e aittir.
- `kilocode/kilo/auto` arkasındaki tam yukarı akış yönlendirmesi OpenClaw'da sabit kodlanmaz, Kilo Gateway'e aittir.
Kurulum ayrıntıları için bkz. [/providers/kilocode](/tr/providers/kilocode).
### Diğer paketle gelen sağlayıcı Plugin'leri
### Diğer paketlenmiş sağlayıcı Plugin'leri
| Sağlayıcı | Kimlik | Auth env | Örnek model |
| ----------------------- | -------------------------------- | ------------------------------------------------------------ | ----------------------------------------------- |
| BytePlus | `byteplus` / `byteplus-plan` | `BYTEPLUS_API_KEY` | `byteplus-plan/ark-code-latest` |
| Cerebras | `cerebras` | `CEREBRAS_API_KEY` | `cerebras/zai-glm-4.7` |
| Cloudflare AI Gateway | `cloudflare-ai-gateway` | `CLOUDFLARE_AI_GATEWAY_API_KEY` | — |
| GitHub Copilot | `github-copilot` | `COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN` | — |
| Groq | `groq` | `GROQ_API_KEY` | — |
| Hugging Face Inference | `huggingface` | `HUGGINGFACE_HUB_TOKEN` veya `HF_TOKEN` | `huggingface/deepseek-ai/DeepSeek-R1` |
| Kilo Gateway | `kilocode` | `KILOCODE_API_KEY` | `kilocode/kilo/auto` |
| Kimi Coding | `kimi` | `KIMI_API_KEY` veya `KIMICODE_API_KEY` | `kimi/kimi-code` |
| MiniMax | `minimax` / `minimax-portal` | `MINIMAX_API_KEY` / `MINIMAX_OAUTH_TOKEN` | `minimax/MiniMax-M2.7` |
| Mistral | `mistral` | `MISTRAL_API_KEY` | `mistral/mistral-large-latest` |
| Moonshot | `moonshot` | `MOONSHOT_API_KEY` | `moonshot/kimi-k2.6` |
| NVIDIA | `nvidia` | `NVIDIA_API_KEY` | `nvidia/nvidia/llama-3.1-nemotron-70b-instruct` |
| OpenRouter | `openrouter` | `OPENROUTER_API_KEY` | `openrouter/auto` |
| Qianfan | `qianfan` | `QIANFAN_API_KEY` | `qianfan/deepseek-v3.2` |
| Qwen Cloud | `qwen` | `QWEN_API_KEY` / `MODELSTUDIO_API_KEY` / `DASHSCOPE_API_KEY` | `qwen/qwen3.5-plus` |
| StepFun | `stepfun` / `stepfun-plan` | `STEPFUN_API_KEY` | `stepfun/step-3.5-flash` |
| Together | `together` | `TOGETHER_API_KEY` | `together/moonshotai/Kimi-K2.5` |
| Venice | `venice` | `VENICE_API_KEY` | — |
| Vercel AI Gateway | `vercel-ai-gateway` | `AI_GATEWAY_API_KEY` | `vercel-ai-gateway/anthropic/claude-opus-4.6` |
| Volcano Engine (Doubao) | `volcengine` / `volcengine-plan` | `VOLCANO_ENGINE_API_KEY` | `volcengine-plan/ark-code-latest` |
| xAI | `xai` | `XAI_API_KEY` | `xai/grok-4` |
| Xiaomi | `xiaomi` | `XIAOMI_API_KEY` | `xiaomi/mimo-v2-flash` |
| Sağlayıcı | Kimlik | Kimlik doğrulama ortam değişkeni | Örnek model |
| ----------------------- | -------------------------------- | ---------------------------------------------------------- | ---------------------------------------------- |
| BytePlus | `byteplus` / `byteplus-plan` | `BYTEPLUS_API_KEY` | `byteplus-plan/ark-code-latest` |
| Cerebras | `cerebras` | `CEREBRAS_API_KEY` | `cerebras/zai-glm-4.7` |
| Cloudflare AI Gateway | `cloudflare-ai-gateway` | `CLOUDFLARE_AI_GATEWAY_API_KEY` | — |
| DeepSeek | `deepseek` | `DEEPSEEK_API_KEY` | `deepseek/deepseek-v4-flash` |
| GitHub Copilot | `github-copilot` | `COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN` | — |
| Groq | `groq` | `GROQ_API_KEY` | — |
| Hugging Face Inference | `huggingface` | `HUGGINGFACE_HUB_TOKEN` veya `HF_TOKEN` | `huggingface/deepseek-ai/DeepSeek-R1` |
| Kilo Gateway | `kilocode` | `KILOCODE_API_KEY` | `kilocode/kilo/auto` |
| Kimi Coding | `kimi` | `KIMI_API_KEY` veya `KIMICODE_API_KEY` | `kimi/kimi-code` |
| MiniMax | `minimax` / `minimax-portal` | `MINIMAX_API_KEY` / `MINIMAX_OAUTH_TOKEN` | `minimax/MiniMax-M2.7` |
| Mistral | `mistral` | `MISTRAL_API_KEY` | `mistral/mistral-large-latest` |
| Moonshot | `moonshot` | `MOONSHOT_API_KEY` | `moonshot/kimi-k2.6` |
| NVIDIA | `nvidia` | `NVIDIA_API_KEY` | `nvidia/nvidia/llama-3.1-nemotron-70b-instruct` |
| OpenRouter | `openrouter` | `OPENROUTER_API_KEY` | `openrouter/auto` |
| Qianfan | `qianfan` | `QIANFAN_API_KEY` | `qianfan/deepseek-v3.2` |
| Qwen Cloud | `qwen` | `QWEN_API_KEY` / `MODELSTUDIO_API_KEY` / `DASHSCOPE_API_KEY` | `qwen/qwen3.5-plus` |
| StepFun | `stepfun` / `stepfun-plan` | `STEPFUN_API_KEY` | `stepfun/step-3.5-flash` |
| Together | `together` | `TOGETHER_API_KEY` | `together/moonshotai/Kimi-K2.5` |
| Venice | `venice` | `VENICE_API_KEY` | — |
| Vercel AI Gateway | `vercel-ai-gateway` | `AI_GATEWAY_API_KEY` | `vercel-ai-gateway/anthropic/claude-opus-4.6` |
| Volcano Engine (Doubao) | `volcengine` / `volcengine-plan` | `VOLCANO_ENGINE_API_KEY` | `volcengine-plan/ark-code-latest` |
| xAI | `xai` | `XAI_API_KEY` | `xai/grok-4` |
| Xiaomi | `xiaomi` | `XIAOMI_API_KEY` | `xiaomi/mimo-v2-flash` |
Bilinmeye değer tuhaflıklar:
Bilinmeye değer farklılıklar:
- **OpenRouter**, uygulama ilişkilendirme üst bilgilerini ve Anthropic `cache_control` işaretleyicilerini yalnızca doğrulanmış `openrouter.ai` rotalarında uygular. Proxy tarzı bir OpenAI uyumlu yol olduğundan, yerel-OpenAI'ye özgü şekillendirmeyi (`serviceTier`, Responses `store`, istem önbelleği ipuçları, OpenAI muhakeme uyumluluğu) atlar. Gemini destekli ref'ler yalnızca proxy-Gemini düşünce imzası temizliğini korur.
- **Kilo Gateway** Gemini destekli ref'ler aynı proxy-Gemini temizleme yolunu izler; `kilocode/kilo/auto` ve diğer proxy-muhakeme-desteksiz ref'ler proxy muhakeme enjeksiyonunu atlar.
- **MiniMax** API anahtarlı ilk kurulum, açık `input: ["text", "image"]` içeren M2.7 model tanımlarını yazar; paketle gelen katalog, bu yapılandırma gerçekleştirilene kadar sohbet ref'lerini yalnızca metin olarak tutar.
- **OpenRouter**, uygulama atıf başlıklarını ve Anthropic `cache_control` işaretlerini yalnızca doğrulanmış `openrouter.ai` yollarında uygular. Proxy tarzı bir OpenAI uyumlu yol olarak, yalnızca doğal OpenAI'ye özgü şekillendirmeyi (`serviceTier`, Responses `store`, istem önbelleği ipuçları, OpenAI akıl yürütme uyumluluğu) atlar. Gemini destekli başvurular yalnızca proxy-Gemini düşünce imzası temizliğini korur.
- **Kilo Gateway** Gemini destekli başvurular aynı proxy-Gemini temizleme yolunu izler; `kilocode/kilo/auto` ve proxy akıl yürütmeyi desteklemeyen diğer başvurular, proxy akıl yürütme eklemeyi atlar.
- **MiniMax** API anahtarıyla ilk kurulum, açık `input: ["text", "image"]` değerlerine sahip M2.7 model tanımlarını yazar; paketlenmiş katalog, bu yapılandırma somutlaştırılana kadar sohbet başvurularını yalnızca metin olarak tutar.
- **xAI**, xAI Responses yolunu kullanır. `/fast` veya `params.fastMode: true`, `grok-3`, `grok-3-mini`, `grok-4` ve `grok-4-0709` modellerini `*-fast` varyantlarına yeniden yazar. `tool_stream` varsayılan olarak açıktır; `agents.defaults.models["xai/<model>"].params.tool_stream=false` ile devre dışı bırakın.
- **Cerebras** GLM modelleri `zai-glm-4.7` / `zai-glm-4.6` kullanır; OpenAI uyumlu base URL `https://api.cerebras.ai/v1` değeridir.
- **Cerebras** GLM modelleri `zai-glm-4.7` / `zai-glm-4.6` kullanır; OpenAI uyumlu temel URL `https://api.cerebras.ai/v1` adresidir.
## `models.providers` üzerinden sağlayıcılar (özel/base URL)
## `models.providers` üzerinden sağlayıcılar (özel/temel URL)
**Özel** sağlayıcılar veya
OpenAI/Anthropic uyumlu proxy'ler eklemek için `models.providers` (veya `models.json`) kullanın.
Aşağıdaki paketle gelen sağlayıcı Plugin'lerinin birçoğu zaten varsayılan bir katalog yayımlar.
Varsayılan base URL'yi, üst bilgileri veya model listesini
geçersiz kılmak istediğinizde yalnızca açık `models.providers.<id>` girdileri kullanın.
Aşağıdaki paketlenmiş sağlayıcı Plugin'lerinin çoğu zaten varsayılan bir katalog yayımlar.
Varsayılan temel URL'yi, başlıkları veya model listesini geçersiz kılmak
istediğinizde yalnızca açık `models.providers.<id>` girdileri kullanın.
### Moonshot AI (Kimi)
Moonshot, paketle gelen bir sağlayıcı Plugin'i olarak gelir. Yerleşik sağlayıcıyı
varsayılan olarak kullanın ve yalnızca base URL veya model metadata'sını geçersiz kılmanız
gerektiğinde açık bir `models.providers.moonshot` girdisi ekleyin:
Moonshot, paketlenmiş bir sağlayıcı Plugin'i olarak gelir. Yerleşik sağlayıcıyı
varsayılan olarak kullanın ve yalnızca temel URL'yi veya model meta verisini
geçersiz kılmanız gerektiğinde açık bir `models.providers.moonshot` girdisi ekleyin:
- Sağlayıcı: `moonshot`
- Auth: `MOONSHOT_API_KEY`
- Kimlik doğrulama: `MOONSHOT_API_KEY`
- Örnek model: `moonshot/kimi-k2.6`
- CLI: `openclaw onboard --auth-choice moonshot-api-key` veya `openclaw onboard --auth-choice moonshot-api-key-cn`
@ -326,7 +314,7 @@ Kimi K2 model kimlikleri:
Kimi Coding, Moonshot AI'nin Anthropic uyumlu uç noktasını kullanır:
- Sağlayıcı: `kimi`
- Auth: `KIMI_API_KEY`
- Kimlik doğrulama: `KIMI_API_KEY`
- Örnek model: `kimi/kimi-code`
```json5
@ -342,10 +330,10 @@ Eski `kimi/k2p5`, uyumluluk model kimliği olarak kabul edilmeye devam eder.
### Volcano Engine (Doubao)
Volcano Engine (火山引擎), Çin'deki Doubao ve diğer modellere erişim sağlar.
Volcano Engine (火山引擎), Çin'de Doubao ve diğer modellere erişim sağlar.
- Sağlayıcı: `volcengine` (kodlama: `volcengine-plan`)
- Auth: `VOLCANO_ENGINE_API_KEY`
- Sağlayıcı: `volcengine` (coding: `volcengine-plan`)
- Kimlik doğrulama: `VOLCANO_ENGINE_API_KEY`
- Örnek model: `volcengine-plan/ark-code-latest`
- CLI: `openclaw onboard --auth-choice volcengine-api-key`
@ -357,13 +345,13 @@ Volcano Engine (火山引擎), Çin'deki Doubao ve diğer modellere erişim sağ
}
```
İlk kurulum varsayılan olarak kodlama yüzeyini kullanır, ancak genel `volcengine/*`
İlk kurulum varsayılan olarak coding yüzeyine ayarlanır, ancak genel `volcengine/*`
kataloğu da aynı anda kaydedilir.
İlk kurulum/yapılandırma model seçicilerinde Volcengine auth seçimi,
hem `volcengine/*` hem de `volcengine-plan/*` satırlarını tercih eder. Bu modeller henüz
yüklenmemişse OpenClaw, boş bir
sağlayıcı kapsamlı seçici göstermek yerine filtresiz kataloğa geri döner.
İlk kurulum/yapılandırma model seçicilerinde, Volcengine kimlik doğrulama seçeneği hem
`volcengine/*` hem de `volcengine-plan/*` satırlarını tercih eder. Bu modeller henüz yüklenmemişse,
OpenClaw boş bir sağlayıcı kapsamlı seçici göstermek yerine filtrelenmemiş
kataloğa geri döner.
Kullanılabilir modeller:
@ -373,7 +361,7 @@ Kullanılabilir modeller:
- `volcengine/glm-4-7-251222` (GLM 4.7)
- `volcengine/deepseek-v3-2-251201` (DeepSeek V3.2 128K)
Kodlama modelleri (`volcengine-plan`):
Coding modelleri (`volcengine-plan`):
- `volcengine-plan/ark-code-latest`
- `volcengine-plan/doubao-seed-code`
@ -385,8 +373,8 @@ Kodlama modelleri (`volcengine-plan`):
BytePlus ARK, uluslararası kullanıcılar için Volcano Engine ile aynı modellere erişim sağlar.
- Sağlayıcı: `byteplus` (kodlama: `byteplus-plan`)
- Auth: `BYTEPLUS_API_KEY`
- Sağlayıcı: `byteplus` (coding: `byteplus-plan`)
- Kimlik doğrulama: `BYTEPLUS_API_KEY`
- Örnek model: `byteplus-plan/ark-code-latest`
- CLI: `openclaw onboard --auth-choice byteplus-api-key`
@ -398,13 +386,13 @@ BytePlus ARK, uluslararası kullanıcılar için Volcano Engine ile aynı modell
}
```
İlk kurulum varsayılan olarak kodlama yüzeyini kullanır, ancak genel `byteplus/*`
İlk kurulum varsayılan olarak coding yüzeyine ayarlanır, ancak genel `byteplus/*`
kataloğu da aynı anda kaydedilir.
İlk kurulum/yapılandırma model seçicilerinde BytePlus auth seçimi,
hem `byteplus/*` hem de `byteplus-plan/*` satırlarını tercih eder. Bu modeller henüz
yüklenmemişse OpenClaw, boş bir
sağlayıcı kapsamlı seçici göstermek yerine filtresiz kataloğa geri döner.
İlk kurulum/yapılandırma model seçicilerinde, BytePlus kimlik doğrulama seçeneği hem
`byteplus/*` hem de `byteplus-plan/*` satırlarını tercih eder. Bu modeller henüz yüklenmemişse,
OpenClaw boş bir sağlayıcı kapsamlı seçici göstermek yerine filtrelenmemiş
kataloğa geri döner.
Kullanılabilir modeller:
@ -412,7 +400,7 @@ Kullanılabilir modeller:
- `byteplus/kimi-k2-5-260127` (Kimi K2.5)
- `byteplus/glm-4-7-251222` (GLM 4.7)
Kodlama modelleri (`byteplus-plan`):
Coding modelleri (`byteplus-plan`):
- `byteplus-plan/ark-code-latest`
- `byteplus-plan/doubao-seed-code`
@ -422,10 +410,10 @@ Kodlama modelleri (`byteplus-plan`):
### Synthetic
Synthetic, `synthetic` sağlayıcısı arkasında Anthropic uyumlu modeller sunar:
Synthetic, `synthetic` sağlayıcısının arkasında Anthropic uyumlu modeller sunar:
- Sağlayıcı: `synthetic`
- Auth: `SYNTHETIC_API_KEY`
- Kimlik doğrulama: `SYNTHETIC_API_KEY`
- Örnek model: `synthetic/hf:MiniMaxAI/MiniMax-M2.5`
- CLI: `openclaw onboard --auth-choice synthetic-api-key`
@ -456,29 +444,29 @@ MiniMax, özel uç noktalar kullandığı için `models.providers` üzerinden ya
- MiniMax OAuth (CN): `--auth-choice minimax-cn-oauth`
- MiniMax API anahtarı (Global): `--auth-choice minimax-global-api`
- MiniMax API anahtarı (CN): `--auth-choice minimax-cn-api`
- Auth: `minimax` için `MINIMAX_API_KEY`; `minimax-portal` için `MINIMAX_OAUTH_TOKEN` veya
- Kimlik doğrulama: `minimax` için `MINIMAX_API_KEY`; `minimax-portal` için `MINIMAX_OAUTH_TOKEN` veya
`MINIMAX_API_KEY`
Kurulum ayrıntıları, model seçenekleri ve yapılandırma parçacıkları için bkz. [/providers/minimax](/tr/providers/minimax).
MiniMax'in Anthropic uyumlu akış yolunda OpenClaw, siz açıkça ayarlamadığınız sürece düşünmeyi
varsayılan olarak devre dışı bırakır ve `/fast on`,
MiniMax'ın Anthropic uyumlu akış yolunda OpenClaw, siz açıkça ayarlamadığınız
sürece thinking'i varsayılan olarak devre dışı bırakır ve `/fast on`,
`MiniMax-M2.7` modelini `MiniMax-M2.7-highspeed` olarak yeniden yazar.
Plugin sahipli yetenek ayrımı:
Plugin'e ait yetenek ayrımı:
- Metin/sohbet varsayılanları `minimax/MiniMax-M2.7` üzerinde kalır
- Görsel oluşturma `minimax/image-01` veya `minimax-portal/image-01` kullanır
- Görsel anlama, her iki MiniMax auth yolunda da Plugin sahipli `MiniMax-VL-01` kullanır
- Web arama, sağlayıcı kimliği `minimax` üzerinde kalır
- Görsel oluşturma `minimax/image-01` veya `minimax-portal/image-01` olur
- Görsel anlama, her iki MiniMax kimlik doğrulama yolunda da Plugin'e ait `MiniMax-VL-01` olur
- Web araması sağlayıcı kimliği `minimax` üzerinde kalır
### LM Studio
LM Studio, yerel API'yi kullanan paketle gelen bir sağlayıcı Plugin'i olarak gelir:
LM Studio, doğal API'yi kullanan paketlenmiş bir sağlayıcı Plugin'i olarak gelir:
- Sağlayıcı: `lmstudio`
- Auth: `LM_API_TOKEN`
- Varsayılan çıkarım base URL: `http://localhost:1234/v1`
- Kimlik doğrulama: `LM_API_TOKEN`
- Varsayılan çıkarım temel URL'si: `http://localhost:1234/v1`
Ardından bir model ayarlayın (`http://localhost:1234/api/v1/models` tarafından döndürülen kimliklerden biriyle değiştirin):
@ -490,20 +478,20 @@ Ardından bir model ayarlayın (`http://localhost:1234/api/v1/models` tarafında
}
```
OpenClaw; keşif + otomatik yükleme için LM Studio'nun yerel `/api/v1/models` ve `/api/v1/models/load` uç noktalarını, varsayılan olarak çıkarım için ise `/v1/chat/completions` yolunu kullanır.
OpenClaw, keşif + otomatik yükleme için varsayılan olarak LM Studio'nun doğal `/api/v1/models` ve `/api/v1/models/load` uç noktalarını, çıkarım için ise `/v1/chat/completions` yolunu kullanır.
Kurulum ve sorun giderme için bkz. [/providers/lmstudio](/tr/providers/lmstudio).
### Ollama
Ollama, paketle gelen bir sağlayıcı Plugin'i olarak gelir ve Ollama'nın yerel API'sini kullanır:
Ollama, paketlenmiş bir sağlayıcı Plugin'i olarak gelir ve Ollama'nın doğal API'sini kullanır:
- Sağlayıcı: `ollama`
- Auth: Gerekmez (yerel sunucu)
- Kimlik doğrulama: Gerekmez (yerel sunucu)
- Örnek model: `ollama/llama3.3`
- Kurulum: [https://ollama.com/download](https://ollama.com/download)
```bash
# Ollama'yı kurun, ardından bir model çekin:
# Ollama'yı yükleyin, ardından bir model çekin:
ollama pull llama3.3
```
@ -515,19 +503,19 @@ ollama pull llama3.3
}
```
Ollama, siz `OLLAMA_API_KEY` ile katılım gösterdiğinizde yerelde `http://127.0.0.1:11434` adresinde algılanır ve paketle gelen sağlayıcı Plugin'i Ollama'yı doğrudan
`openclaw onboard` içine ve model seçicisine ekler. İlk kurulum, bulut/yerel mod ve özel yapılandırma için bkz. [/providers/ollama](/tr/providers/ollama).
`OLLAMA_API_KEY` ile etkinleştirmeyi seçtiğinizde Ollama, `http://127.0.0.1:11434` adresinde yerel olarak algılanır ve paketlenmiş sağlayıcı Plugin'i Ollama'yı doğrudan
`openclaw onboard` ve model seçiciye ekler. İlk kurulum, bulut/yerel mod ve özel yapılandırma için bkz. [/providers/ollama](/tr/providers/ollama).
### vLLM
vLLM, yerel/kendi kendine barındırılan OpenAI uyumlu
sunucular için paketle gelen bir sağlayıcı Plugin'i olarak gelir:
vLLM, yerel/kendi barındırdığınız OpenAI uyumlu
sunucular için paketlenmiş bir sağlayıcı Plugin'i olarak gelir:
- Sağlayıcı: `vllm`
- Auth: İsteğe bağlıdır (sunucunuza bağlıdır)
- Varsayılan base URL: `http://127.0.0.1:8000/v1`
- Kimlik doğrulama: İsteğe bağlıdır (sunucunuza bağlıdır)
- Varsayılan temel URL: `http://127.0.0.1:8000/v1`
Yerelde otomatik keşfe katılım göstermek için (sunucunuz auth zorlamıyorsa herhangi bir değer çalışır):
Yerelde otomatik keşfi etkinleştirmek için (sunucunuz kimlik doğrulamayı zorlamıyorsa herhangi bir değer çalışır):
```bash
export VLLM_API_KEY="vllm-local"
@ -547,14 +535,15 @@ Ayrıntılar için bkz. [/providers/vllm](/tr/providers/vllm).
### SGLang
SGLang, hızlı kendi kendine barındırılan
OpenAI uyumlu sunucular için paketle gelen bir sağlayıcı Plugin'i olarak gelir:
SGLang, hızlı kendi barındırdığınız
OpenAI uyumlu sunucular için paketlenmiş bir sağlayıcı Plugin'i olarak gelir:
- Sağlayıcı: `sglang`
- Auth: İsteğe bağlıdır (sunucunuza bağlıdır)
- Varsayılan base URL: `http://127.0.0.1:30000/v1`
- Kimlik doğrulama: İsteğe bağlıdır (sunucunuza bağlıdır)
- Varsayılan temel URL: `http://127.0.0.1:30000/v1`
Yerelde otomatik keşfe katılım göstermek için (sunucunuz auth zorlamıyorsa herhangi bir değer çalışır):
Yerelde otomatik keşfi etkinleştirmek için (sunucunuz kimlik doğrulamayı
zorlamıyorsa herhangi bir değer çalışır):
```bash
export SGLANG_API_KEY="sglang-local"
@ -617,13 +606,13 @@ Notlar:
- `contextWindow: 200000`
- `maxTokens: 8192`
- Önerilen: proxy/model sınırlarınızla eşleşen açık değerler ayarlayın.
- Yerel olmayan uç noktalarda `api: "openai-completions"` için (`api.openai.com` olmayan boş olmayan herhangi bir `baseUrl` host'u), OpenClaw desteklenmeyen `developer` rolleri için sağlayıcı `400` hatalarını önlemek amacıyla `compat.supportsDeveloperRole: false` zorlar.
- Proxy tarzı OpenAI uyumlu rotalar ayrıca yerel OpenAI'ye özgü istek
şekillendirmesini de atlar: `service_tier` yok, Responses `store` yok, istem önbelleği ipuçları yok,
OpenAI muhakeme uyumlu yük şekillendirmesi yok ve gizli OpenClaw ilişkilendirme
üst bilgileri yok.
- `baseUrl` boş/atlanmışsa OpenClaw varsayılan OpenAI davranışını korur (`api.openai.com` olarak çözülür).
- Güvenlik için, açık `compat.supportsDeveloperRole: true` değeri yerel olmayan `openai-completions` uç noktalarında yine de geçersiz kılınır.
- Doğal olmayan uç noktalardaki `api: "openai-completions"` için (`api.openai.com` olmayan bir ana bilgisayara sahip boş olmayan herhangi bir `baseUrl`), OpenClaw, desteklenmeyen `developer` rolleri için sağlayıcı 400 hatalarını önlemek amacıyla `compat.supportsDeveloperRole: false` değerini zorunlu kılar.
- Proxy tarzı OpenAI uyumlu yollar ayrıca yalnızca doğal OpenAI'ye özgü istek
şekillendirmeyi de atlar: `service_tier` yok, Responses `store` yok, istem önbelleği ipuçları yok,
OpenAI akıl yürütme uyumluluğu yük şekillendirmesi yok ve gizli OpenClaw atıf
başlıkları yok.
- `baseUrl` boşsa/atlanmışsa OpenClaw varsayılan OpenAI davranışını korur (`api.openai.com`'a çözülür).
- Güvenlik için, açık bir `compat.supportsDeveloperRole: true` değeri bile doğal olmayan `openai-completions` uç noktalarında yine de geçersiz kılınır.
## CLI örnekleri
@ -637,7 +626,7 @@ Ayrıca bkz.: tam yapılandırma örnekleri için [/gateway/configuration](/tr/g
## İlgili
- [Modeller](/tr/concepts/models) — model yapılandırması ve takma adlar
- [Model Failover](/tr/concepts/model-failover) — geri dönüş zincirleri ve yeniden deneme davranışı
- [Yapılandırma Başvurusu](/tr/gateway/config-agents#agent-defaults) — model yapılandırma anahtarları
- [Sağlayıcılar](/tr/providers) — sağlayıcı başına kurulum kılavuzları
- [Models](/tr/concepts/models) — model yapılandırması ve takma adlar
- [Model Failover](/tr/concepts/model-failover) — yedek zincirleri ve yeniden deneme davranışı
- [Configuration Reference](/tr/gateway/config-agents#agent-defaults) — model yapılandırma anahtarları
- [Providers](/tr/providers) — sağlayıcı bazında kurulum kılavuzları

View File

@ -1,50 +1,50 @@
---
read_when:
- OpenClaw'da Pi SDK entegrasyon tasarımını anlama
- Pi için ajan oturum yaşam döngüsünü, araç yapısını veya sağlayıcı bağlantısını değiştirme
summary: OpenClaw'ın gömülü Pi ajan entegrasyonunun ve oturum yaşam döngüsünün mimarisi
- OpenClaw içinde Pi SDK entegrasyon tasarımını anlama
- Pi için ajan oturum yaşam döngüsünü, araçları veya sağlayıcı bağlantılarını değiştirme
summary: OpenClaw'ın gömülü Pi ajan entegrasyonunun mimarisi ve oturum yaşam döngüsü
title: Pi entegrasyon mimarisi
x-i18n:
generated_at: "2026-04-24T09:18:36Z"
generated_at: "2026-04-24T15:21:53Z"
model: gpt-5.4
provider: openai
source_hash: 3c0c490cad121a65d557a72887ea619a7d0cff34a62220752214185c9148dc0b
source_hash: 0c0b019ff6d35f6fdcd57b56edd1945e62a96bb4b34e312d7fb0c627f01287f1
source_path: pi.md
workflow: 15
---
Bu belge, OpenClaw'ın AI ajan yeteneklerini güçlendirmek için [pi-coding-agent](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent) ve kardeş paketleri (`pi-ai`, `pi-agent-core`, `pi-tui`) ile nasıl entegre olduğunu açıklar.
Bu belge, OpenClaw'ın yapay zeka ajan yeteneklerini desteklemek için [pi-coding-agent](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent) ve onun kardeş paketleri (`pi-ai`, `pi-agent-core`, `pi-tui`) ile nasıl entegre olduğunu açıklar.
## Genel bakış
## Genel Bakış
OpenClaw, bir AI kodlama ajanını mesajlaşma gateway mimarisi içine gömmek için pi SDK'sını kullanır. Pi'yi alt süreç olarak başlatmak veya RPC modunu kullanmak yerine OpenClaw, pi'nin `AgentSession` yapısını doğrudan `createAgentSession()` aracılığıyla içe aktarır ve örnekler. Bu gömülü yaklaşım şunları sağlar:
OpenClaw, bir yapay zeka kodlama ajanını mesajlaşma Gateway mimarisine gömmek için pi SDK'sını kullanır. OpenClaw, pi'yi bir alt süreç olarak başlatmak veya RPC modunu kullanmak yerine, `createAgentSession()` aracılığıyla pi'nin `AgentSession` yapısını doğrudan içe aktarır ve örnekler. Bu gömülü yaklaşım şunları sağlar:
- Oturum yaşam döngüsü ve olay işleme üzerinde tam denetim
- Özel araç enjeksiyonu (mesajlaşma, sandbox, kanala özgü eylemler)
- Kanal/bağlam başına sistem istemi özelleştirmesi
- Dallanma/Compaction destekli oturum kalıcılığı
- Failover ile çok hesaplı auth profile döndürme
- Kanal/bağlama göre sistem istemi özelleştirmesi
- Dallanma/Compaction desteğiyle oturum kalıcılığı
- Yedeklemeli çok hesaplı kimlik doğrulama profili rotasyonu
- Sağlayıcıdan bağımsız model değiştirme
## Paket bımlılıkları
## Paket Bımlılıkları
```json
{
"@mariozechner/pi-agent-core": "0.68.1",
"@mariozechner/pi-ai": "0.68.1",
"@mariozechner/pi-coding-agent": "0.68.1",
"@mariozechner/pi-tui": "0.68.1"
"@mariozechner/pi-agent-core": "0.70.2",
"@mariozechner/pi-ai": "0.70.2",
"@mariozechner/pi-coding-agent": "0.70.2",
"@mariozechner/pi-tui": "0.70.2"
}
```
| Paket | Amaç |
| ------------------ | ----------------------------------------------------------------------------------------------------- |
| `pi-ai` | Çekirdek LLM soyutlamaları: `Model`, `streamSimple`, mesaj türleri, sağlayıcı API'leri |
| `pi-agent-core` | Ajan döngüsü, araç yürütme, `AgentMessage` türleri |
| `pi-coding-agent` | Üst düzey SDK: `createAgentSession`, `SessionManager`, `AuthStorage`, `ModelRegistry`, yerleşik araçlar |
| `pi-tui` | Terminal UI bileşenleri (OpenClaw'ın yerel TUI modunda kullanılır) |
| Paket | Amaç |
| ----------------- | ------------------------------------------------------------------------------------------------------ |
| `pi-ai` | Temel LLM soyutlamaları: `Model`, `streamSimple`, mesaj türleri, sağlayıcı API'leri |
| `pi-agent-core` | Ajan döngüsü, araç yürütme, `AgentMessage` türleri |
| `pi-coding-agent` | Üst düzey SDK: `createAgentSession`, `SessionManager`, `AuthStorage`, `ModelRegistry`, yerleşik araçlar |
| `pi-tui` | Terminal UI bileşenleri (OpenClaw'ın yerel TUI modunda kullanılır) |
## Dosya yapısı
## Dosya Yapısı
```
src/agents/
@ -54,66 +54,66 @@ src/agents/
│ ├── run/
│ │ ├── attempt.ts # Oturum kurulumu ile tek deneme mantığı
│ │ ├── params.ts # RunEmbeddedPiAgentParams türü
│ │ ├── payloads.ts # Çalıştırma sonuçlarından yanıt payload'ları oluşturur
│ │ ├── payloads.ts # Çalıştırma sonuçlarından yanıt payload'larını oluşturur
│ │ ├── images.ts # Vision model görsel enjeksiyonu
│ │ └── types.ts # EmbeddedRunAttemptResult
│ ├── abort.ts # Abort hata algılama
│ ├── cache-ttl.ts # Bağlam budama için önbellek TTL takibi
│ ├── abort.ts # Abort hata tespiti
│ ├── cache-ttl.ts # Bağlam budama için önbellek TTL izleme
│ ├── compact.ts # Elle/otomatik Compaction mantığı
│ ├── extensions.ts # Gömülü çalıştırmalar için pi uzantılarını yükler
│ ├── extra-params.ts # Sağlayıcıya özgü akış parametreleri
│ ├── google.ts # Google/Gemini tur sıralama düzeltmeleri
│ ├── history.ts # Geçmiş sınırlama (DM vs grup)
│ ├── history.ts # Geçmiş sınırlama (DM ve grup)
│ ├── lanes.ts # Oturum/genel komut hatları
│ ├── logger.ts # Alt sistem günlükleyicisi
│ ├── model.ts # ModelRegistry üzerinden model çözümleme
│ ├── model.ts # ModelRegistry aracılığıyla model çözümleme
│ ├── runs.ts # Etkin çalıştırma takibi, abort, kuyruk
│ ├── sandbox-info.ts # Sistem istemi için sandbox bilgisi
│ ├── session-manager-cache.ts # SessionManager örneği önbellekleme
│ ├── session-manager-cache.ts # SessionManager örnek önbelleklemesi
│ ├── session-manager-init.ts # Oturum dosyası başlatma
│ ├── system-prompt.ts # Sistem istemi oluşturucu
│ ├── tool-split.ts # Araçları builtIn ve custom olarak ayırır
│ ├── types.ts # EmbeddedPiAgentMeta, EmbeddedPiRunResult
│ └── utils.ts # ThinkLevel eşleme, hata açıklaması
│ └── utils.ts # ThinkLevel eşlemesi, hata açıklaması
├── pi-embedded-subscribe.ts # Oturum olayı aboneliği/dağıtımı
├── pi-embedded-subscribe.types.ts # SubscribeEmbeddedPiSessionParams
├── pi-embedded-subscribe.handlers.ts # Olay işleyici fabrikası
├── pi-embedded-subscribe.handlers.lifecycle.ts
├── pi-embedded-subscribe.handlers.types.ts
├── pi-embedded-block-chunker.ts # Akış blok yanıtı parçalama
├── pi-embedded-block-chunker.ts # Akış blok yanıtı parçalaması
├── pi-embedded-messaging.ts # Mesajlaşma aracı gönderim takibi
├── pi-embedded-helpers.ts # Hata sınıflandırması, tur doğrulama
├── pi-embedded-helpers.ts # Hata sınıflandırması, tur doğrulaması
├── pi-embedded-helpers/ # Yardımcı modüller
├── pi-embedded-utils.ts # Biçimlendirme yardımcıları
├── pi-tools.ts # createOpenClawCodingTools()
├── pi-tools.abort.ts # Araçlar için AbortSignal sarmalama
├── pi-tools.policy.ts # Araç izin listesi/red listesi politikası
├── pi-tools.policy.ts # Araç izin listesi/engelleme listesi ilkesi
├── pi-tools.read.ts # Read aracı özelleştirmeleri
├── pi-tools.schema.ts # Araç şeması normalizasyonu
├── pi-tools.schema.ts # Araç şeması normalleştirmesi
├── pi-tools.types.ts # AnyAgentTool tür takma adı
├── pi-tool-definition-adapter.ts # AgentTool -> ToolDefinition bağdaştırıcısı
├── pi-tool-definition-adapter.ts # AgentTool -> ToolDefinition adaptörü
├── pi-settings.ts # Ayar geçersiz kılmaları
├── pi-hooks/ # Özel pi hook'ları
│ ├── compaction-safeguard.ts # Safeguard uzantısı
│ ├── compaction-safeguard.ts # Koruma uzantısı
│ ├── compaction-safeguard-runtime.ts
│ ├── context-pruning.ts # Cache-TTL bağlam budama uzantısı
│ ├── context-pruning.ts # Önbellek-TTL bağlam budama uzantısı
│ └── context-pruning/
├── model-auth.ts # Auth profile çözümleme
├── auth-profiles.ts # Profile deposu, bekleme süresi, failover
├── model-auth.ts # Kimlik doğrulama profili çözümleme
├── auth-profiles.ts # Profil deposu, bekleme süresi, yedekleme
├── model-selection.ts # Varsayılan model çözümleme
├── models-config.ts # models.json üretimi
├── models-config.ts # models.json oluşturma
├── model-catalog.ts # Model kataloğu önbelleği
├── context-window-guard.ts # Bağlam penceresi doğrulaması
├── failover-error.ts # FailoverError sınıfı
├── defaults.ts # DEFAULT_PROVIDER, DEFAULT_MODEL
├── system-prompt.ts # buildAgentSystemPrompt()
├── system-prompt-params.ts # Sistem istemi parametre çözümleme
├── system-prompt-report.ts # Hata ayıklama raporu üretimi
├── system-prompt-report.ts # Hata ayıklama raporu oluşturma
├── tool-summaries.ts # Araç açıklama özetleri
├── tool-policy.ts # Araç politikası çözümleme
├── transcript-policy.ts # Transkript doğrulama politikası
├── skills.ts # Skill anlık görüntüsü/istem oluşturma
├── skills/ # Skill alt sistemi
├── tool-policy.ts # Araç ilkesi çözümleme
├── transcript-policy.ts # Transkript doğrulama ilkesi
├── skills.ts # Skills anlık görüntüsü/istemi oluşturma
├── skills/ # Skills alt sistemi
├── sandbox.ts # Sandbox bağlam çözümleme
├── sandbox/ # Sandbox alt sistemi
├── channel-tools.ts # Kanala özgü araç enjeksiyonu
@ -134,17 +134,16 @@ src/agents/
└── ...
```
Kanala özgü mesaj eylemi çalışma zamanları artık `src/agents/tools` altında değil,
Plugin'e ait uzantı dizinlerinde yaşar; örneğin:
Kanala özgü mesaj eylemi çalışma zamanları artık `src/agents/tools` altında değil, plugin sahipliğindeki extension dizinlerinde bulunur; örneğin:
- Discord Plugin'i eylem çalışma zamanı dosyaları
- Slack Plugin'i eylem çalışma zamanı dosyası
- Telegram Plugin'i eylem çalışma zamanı dosyası
- WhatsApp Plugin'i eylem çalışma zamanı dosyası
- Discord plugin eylem çalışma zamanı dosyaları
- Slack plugin eylem çalışma zamanı dosyası
- Telegram plugin eylem çalışma zamanı dosyası
- WhatsApp plugin eylem çalışma zamanı dosyası
## Çekirdek entegrasyon akışı
## Temel Entegrasyon Akışı
### 1. Gömülü bir ajan çalıştırma
### 1. Gömülü Bir Ajanı Çalıştırma
Ana giriş noktası `pi-embedded-runner/run.ts` içindeki `runEmbeddedPiAgent()` fonksiyonudur:
@ -168,9 +167,9 @@ const result = await runEmbeddedPiAgent({
});
```
### 2. Oturum oluşturma
### 2. Oturum Oluşturma
`runEmbeddedPiAgent()` tarafından çağrılan `runEmbeddedAttempt()` içinde pi SDK kullanılır:
`runEmbeddedAttempt()` içinde (`runEmbeddedPiAgent()` tarafından çağrılır), pi SDK kullanılır:
```typescript
import {
@ -205,7 +204,7 @@ const { session } = await createAgentSession({
applySystemPromptOverrideToSession(session, systemPromptOverride);
```
### 3. Olay aboneliği
### 3. Olay Aboneliği
`subscribeEmbeddedPiSession()`, pi'nin `AgentSession` olaylarına abone olur:
@ -226,13 +225,13 @@ const subscription = subscribeEmbeddedPiSession({
İşlenen olaylar şunları içerir:
- `message_start` / `message_end` / `message_update` (akış metni/thinking)
- `message_start` / `message_end` / `message_update` (akış metni/düşünme)
- `tool_execution_start` / `tool_execution_update` / `tool_execution_end`
- `turn_start` / `turn_end`
- `agent_start` / `agent_end`
- `compaction_start` / `compaction_end`
### 4. İstem gönderme
### 4. İstem Gönderme
Kurulumdan sonra oturuma istem gönderilir:
@ -240,27 +239,25 @@ Kurulumdan sonra oturuma istem gönderilir:
await session.prompt(effectivePrompt, { images: imageResult.images });
```
SDK tam ajan döngüsünü işler: LLM'ye gönderme, araç çağrılarını yürütme, yanıtları akış hâlinde iletme.
SDK, tam ajan döngüsünü yönetir: LLM'ye gönderme, araç çağrılarını yürütme, yanıtları akış halinde iletme.
Görsel enjeksiyonu isteme özeldir: OpenClaw, geçerli istemden görsel ref'lerini yükler ve
bunları yalnızca o tur için `images` üzerinden geçirir. Eski geçmiş turlarını yeniden tarayarak
görsel payload'larını yeniden enjekte etmez.
Görsel enjeksiyonu isteme yereldir: OpenClaw, geçerli istemden görsel referanslarını yükler ve bunları yalnızca o tur için `images` aracılığıyla geçirir. Görsel payload'larını yeniden enjekte etmek için geçmişteki eski turları yeniden taramaz.
## Araç mimarisi
## Araç Mimarisi
### Araç işlem hattı
### Araç Hattı
1. **Temel Araçlar**: pi'nin `codingTools` araçları (read, bash, edit, write)
2. **Özel Değiştirmeler**: OpenClaw, bash yerine `exec`/`process` koyar, read/edit/write araçlarını sandbox için özelleştirir
3. **OpenClaw Araçları**: mesajlaşma, browser, canvas, oturumlar, Cron, gateway vb.
1. **Temel Araçlar**: pi'nin `codingTools` araçları (`read`, `bash`, `edit`, `write`)
2. **Özel Değiştirmeler**: OpenClaw, `bash` yerine `exec`/`process` kullanır; `read`/`edit`/`write` araçlarını sandbox için özelleştirir
3. **OpenClaw Araçları**: mesajlaşma, tarayıcı, tuval, oturumlar, Cron, Gateway vb.
4. **Kanal Araçları**: Discord/Telegram/Slack/WhatsApp'e özgü eylem araçları
5. **Politika Filtreleme**: araçlar, profile, sağlayıcı, ajan, grup, sandbox politikalarına göre filtrelenir
6. **Şema Normalizasyonu**: şemalar Gemini/OpenAI tuhaflıkları için temizlenir
7. **AbortSignal Sarmalama**: araçlar abort sinyallerine uyacak şekilde sarılır
5. **İlke Filtreleme**: Araçlar profil, sağlayıcı, ajan, grup ve sandbox ilkelerine göre filtrelenir
6. **Şema Normalleştirme**: Şemalar Gemini/OpenAI tuhaflıkları için temizlenir
7. **AbortSignal Sarmalama**: Araçlar abort sinyallerine uyacak şekilde sarılır
### Araç tanımı bağdaştırıcısı
### Araç Tanımı Adaptörü
pi-agent-core içindeki `AgentTool`, pi-coding-agent içindeki `ToolDefinition` yapısından farklı bir `execute` imzasına sahiptir. `pi-tool-definition-adapter.ts` içindeki bağdaştırıcı bunu köprüler:
pi-agent-core içindeki `AgentTool`, pi-coding-agent içindeki `ToolDefinition` yapısından farklı bir `execute` imzasına sahiptir. `pi-tool-definition-adapter.ts` içindeki adaptör bu farkı kapatır:
```typescript
export function toToolDefinitions(tools: AnyAgentTool[]): ToolDefinition[] {
@ -270,14 +267,14 @@ export function toToolDefinitions(tools: AnyAgentTool[]): ToolDefinition[] {
description: tool.description ?? "",
parameters: tool.parameters,
execute: async (toolCallId, params, onUpdate, _ctx, signal) => {
// pi-coding-agent imzası pi-agent-core'dan farklıdır
// pi-coding-agent imzası, pi-agent-core'dan farklıdır
return await tool.execute(toolCallId, params, signal, onUpdate);
},
}));
}
```
### Araç ayırma stratejisi
### Araç Ayırma Stratejisi
`splitSdkTools()`, tüm araçları `customTools` üzerinden geçirir:
@ -290,34 +287,34 @@ export function splitSdkTools(options: { tools: AnyAgentTool[]; sandboxEnabled:
}
```
Bu, OpenClaw'ın politika filtrelemesinin, sandbox entegrasyonunun ve genişletilmiş araç setinin sağlayıcılar arasında tutarlı kalmasını sağlar.
Bu, OpenClaw'ın ilke filtrelemesi, sandbox entegrasyonu ve genişletilmiş araç setinin sağlayıcılar arasında tutarlı kalmasını sağlar.
## Sistem istemi oluşturma
## Sistem İstemi Oluşturma
Sistem istemi, `buildAgentSystemPrompt()` içinde (`system-prompt.ts`) oluşturulur. Tooling, Tool Call Style, Safety guardrails, OpenClaw CLI reference, Skills, Docs, Workspace, Sandbox, Messaging, Reply Tags, Voice, Silent Replies, Heartbeats, Runtime metadata bölümleri ile birlikte etkin olduğunda Memory ve Reactions bölümlerini, ayrıca isteğe bağlı bağlam dosyalarını ve ek sistem istemi içeriğini içeren tam bir istem oluşturur. Bölümler, alt ajanlar tarafından kullanılan minimal istem modu için kırpılır.
Sistem istemi, `buildAgentSystemPrompt()` içinde (`system-prompt.ts`) oluşturulur. Araçlar, Araç Çağrı Stili, Güvenlik korkulukları, OpenClaw CLI başvurusu, Skills, Belgeler, Çalışma Alanı, Sandbox, Mesajlaşma, Yanıt Etiketleri, Ses, Sessiz Yanıtlar, Heartbeats, Çalışma zamanı meta verileri ve etkin olduğunda Memory ile Reactions; ayrıca isteğe bağlı bağlam dosyaları ve ek sistem istemi içeriği gibi bölümleri içeren tam bir istem bir araya getirilir. Alt ajanlar için kullanılan minimal istem modunda bölümler kırpılır.
İstem, oturum oluşturulduktan sonra `applySystemPromptOverrideToSession()` ile uygulanır:
İstem, oturum oluşturulduktan sonra `applySystemPromptOverrideToSession()` aracılığıyla uygulanır:
```typescript
const systemPromptOverride = createSystemPromptOverride(appendPrompt);
applySystemPromptOverrideToSession(session, systemPromptOverride);
```
## Oturum yönetimi
## Oturum Yönetimi
### Oturum dosyaları
### Oturum Dosyaları
Oturumlar, ağaç yapısına sahip JSONL dosyalarıdır (`id`/`parentId` bağlantıları). Pi'nin `SessionManager` yapısı kalıcılığı yönetir:
Oturumlar, ağaç yapısına sahip (`id`/`parentId` bağlantılı) JSONL dosyalarıdır. Pi'nin `SessionManager` bileşeni kalıcılığı yönetir:
```typescript
const sessionManager = SessionManager.open(params.sessionFile);
```
OpenClaw bunu araç sonucu güvenliği için `guardSessionManager()` ile sarar.
OpenClaw bunu, araç sonucu güvenliği için `guardSessionManager()` ile sarar.
### Oturum önbellekleme
### Oturum Önbellekleme
`session-manager-cache.ts`, tekrar tekrar dosya ayrıştırmayı önlemek için SessionManager örneklerini önbellekler:
`session-manager-cache.ts`, tekrar tekrar dosya ayrıştırmayı önlemek için SessionManager örneklerini önbelleğe alır:
```typescript
await prewarmSessionFile(params.sessionFile);
@ -325,19 +322,18 @@ sessionManager = SessionManager.open(params.sessionFile);
trackSessionManagerAccess(params.sessionFile);
```
### Geçmiş sınırlama
### Geçmiş Sınırlama
`limitHistoryTurns()`, kanal türüne göre (DM vs grup) konuşma geçmişini kırpar.
`limitHistoryTurns()`, kanal türüne göre (DM ve grup) konuşma geçmişini kırpar.
### Compaction
Otomatik Compaction, bağlam taşmasında tetiklenir. Yaygın taşma imzaları
şunları içerir:
`request_too_large`, `context length exceeded`, `input exceeds the
arasında `request_too_large`, `context length exceeded`, `input exceeds the
maximum number of tokens`, `input token count exceeds the maximum number of
input tokens`, `input is too long for the model` ve `ollama error: context
length exceeded`. `compactEmbeddedPiSessionDirect()`, elle
Compaction işlemini yönetir:
length exceeded` bulunur. `compactEmbeddedPiSessionDirect()` manuel
Compaction'ı yönetir:
```typescript
const compactResult = await compactEmbeddedPiSessionDirect({
@ -345,25 +341,25 @@ const compactResult = await compactEmbeddedPiSessionDirect({
});
```
## Kimlik doğrulama ve model çözümleme
## Kimlik Doğrulama ve Model Çözümleme
### Auth profile'ları
### Kimlik Doğrulama Profilleri
OpenClaw, sağlayıcı başına birden çok API anahtarına sahip bir auth profile deposu tutar:
OpenClaw, sağlayıcı başına birden fazla API anahtarına sahip bir kimlik doğrulama profili deposu tutar:
```typescript
const authStore = ensureAuthProfileStore(agentDir, { allowKeychainPrompt: false });
const profileOrder = resolveAuthProfileOrder({ cfg, store: authStore, provider, preferredProfile });
```
Profile'lar, bekleme süresi takibi ile başarısızlıklarda döndürülür:
Profiller, bekleme süresi takibiyle birlikte hatalarda döndürülür:
```typescript
await markAuthProfileFailure({ store, profileId, reason, cfg, agentDir });
const rotated = await advanceAuthProfile();
```
### Model çözümleme
### Model Çözümleme
```typescript
import { resolveModel } from "./pi-embedded-runner/model.js";
@ -375,13 +371,13 @@ const { model, error, authStorage, modelRegistry } = resolveModel(
config,
);
// pi'nin ModelRegistry ve AuthStorage yapılarını kullanır
// Pi'nin ModelRegistry ve AuthStorage bileşenlerini kullanır
authStorage.setRuntimeApiKey(model.provider, apiKeyInfo.apiKey);
```
### Failover
### Yedekleme
`FailoverError`, yapılandırıldığında model fallback'ini tetikler:
Yapılandırıldığında `FailoverError`, model geri dönüşünü tetikler:
```typescript
if (fallbackConfigured && isFailoverErrorMessage(errorText)) {
@ -395,13 +391,13 @@ if (fallbackConfigured && isFailoverErrorMessage(errorText)) {
}
```
## Pi uzantıları
## Pi Uzantıları
OpenClaw, özelleşmiş davranış için özel pi uzantıları yükler:
OpenClaw, özelleşmiş davranışlar için özel pi uzantıları yükler:
### Compaction safeguard
### Compaction Koruması
`src/agents/pi-hooks/compaction-safeguard.ts`, adaptif token bütçeleme ile birlikte araç hata ve dosya işlemi özetlerini de içeren korumaları Compaction'a ekler:
`src/agents/pi-hooks/compaction-safeguard.ts`, uyarlanabilir token bütçelemenin yanı sıra araç hatası ve dosya işlemi özetleri dahil olmak üzere Compaction'a korkuluklar ekler:
```typescript
if (resolveCompactionMode(params.cfg) === "safeguard") {
@ -410,9 +406,9 @@ if (resolveCompactionMode(params.cfg) === "safeguard") {
}
```
### Bağlam budama
### Bağlam Budama
`src/agents/pi-hooks/context-pruning.ts`, önbellek TTL tabanlı bağlam budamayı uygular:
`src/agents/pi-hooks/context-pruning.ts`, önbellek-TTL tabanlı bağlam budamayı uygular:
```typescript
if (cfg?.agents?.defaults?.contextPruning?.mode === "cache-ttl") {
@ -426,28 +422,28 @@ if (cfg?.agents?.defaults?.contextPruning?.mode === "cache-ttl") {
}
```
## Akış ve blok yanıtları
## Akış ve Blok Yanıtları
### Blok parçalama
### Blok Parçalama
`EmbeddedBlockChunker`, akış hâlindeki metni ayrık yanıt bloklarına dönüştürmeyi yönetir:
`EmbeddedBlockChunker`, akış metnini ayrık yanıt bloklarına dönüştürmeyi yönetir:
```typescript
const blockChunker = blockChunking ? new EmbeddedBlockChunker(blockChunking) : null;
```
### Thinking/final etiket temizleme
### Thinking/Final Etiketlerini Ayıklama
Akış çıktısı, `<think>`/`<thinking>` bloklarını temizlemek ve `<final>` içeriğini çıkarmak için işlenir:
Akış çıktısı, `<think>`/`<thinking>` bloklarını kaldırmak ve `<final>` içeriğini çıkarmak için işlenir:
```typescript
const stripBlockTags = (text: string, state: { thinking: boolean; final: boolean }) => {
// <think>...</think> içeriğini temizle
// enforceFinalTag varsa yalnızca <final>...</final> içeriğini döndür
// <think>...</think> içeriğini kaldır
// enforceFinalTag ise yalnızca <final>...</final> içeriğini döndür
};
```
### Yanıt yönergeleri
### Yanıt Yönergeleri
`[[media:url]]`, `[[voice]]`, `[[reply:id]]` gibi yanıt yönergeleri ayrıştırılır ve çıkarılır:
@ -455,24 +451,24 @@ const stripBlockTags = (text: string, state: { thinking: boolean; final: boolean
const { text: cleanedText, mediaUrls, audioAsVoice, replyToId } = consumeReplyDirectives(chunk);
```
## Hata işleme
## Hata Yönetimi
### Hata sınıflandırma
### Hata Sınıflandırması
`pi-embedded-helpers.ts`, hataları uygun işleme için sınıflandırır:
`pi-embedded-helpers.ts`, uygun işleme için hataları sınıflandırır:
```typescript
isContextOverflowError(errorText) // Bağlam çok büyük
isCompactionFailureError(errorText) // Compaction başarısız oldu
isAuthAssistantError(lastAssistant) // Auth başarısızlığı
isRateLimitAssistantError(...) // Hız sınırı
isFailoverAssistantError(...) // Failover yapılmalı
isAuthAssistantError(lastAssistant) // Kimlik doğrulama hatası
isRateLimitAssistantError(...) // Hız sınırına takıldı
isFailoverAssistantError(...) // Yedeklemeye geçilmeli
classifyFailoverReason(errorText) // "auth" | "rate_limit" | "quota" | "timeout" | ...
```
### Thinking düzeyi fallback'i
### Thinking Düzeyi Geri Dönüşü
Bir thinking düzeyi desteklenmiyorsa fallback uygulanır:
Bir thinking düzeyi desteklenmiyorsa geri dönüş yapılır:
```typescript
const fallbackThinking = pickFallbackThinkingLevel({
@ -485,7 +481,7 @@ if (fallbackThinking) {
}
```
## Sandbox entegrasyonu
## Sandbox Entegrasyonu
Sandbox modu etkin olduğunda araçlar ve yollar sınırlandırılır:
@ -499,59 +495,59 @@ const sandbox = await resolveSandboxContext({
if (sandboxRoot) {
// Sandbox'lı read/edit/write araçlarını kullan
// Exec container içinde çalışır
// Browser bridge URL kullanır
// Tarayıcı bridge URL'sini kullanır
}
```
## Sağlayıcıya özgü işleme
## Sağlayıcıya Özgü İşleme
### Anthropic
- Reddetme magic string temizliği
- Art arda roller için tur doğrulama
- Sıkı yukarı akış Pi araç parametresi doğrulaması
- Ret magic string temizleme
- Ardışık roller için tur doğrulaması
- Yukarı akış Pi araç parametresi doğrulamasının katı olması
### Google/Gemini
- Plugin'e ait araç şeması sanitize etme
- Plugin sahipliğindeki araç şeması temizleme
### OpenAI
- Codex modelleri için `apply_patch` aracı
- Thinking düzeyi düşürme işleme
## TUI entegrasyonu
## TUI Entegrasyonu
OpenClaw ayrıca doğrudan pi-tui bileşenlerini kullanan yerel bir TUI moduna da sahiptir:
OpenClaw ayrıca pi-tui bileşenlerini doğrudan kullanan bir yerel TUI moduna da sahiptir:
```typescript
// src/tui/tui.ts
import { ... } from "@mariozechner/pi-tui";
```
Bu, pi'nin yerel moduna benzer etkileşimli terminal deneyimini sağlar.
Bu, pi'nin yerel moduna benzer etkileşimli terminal deneyimi sağlar.
## Pi CLI'dan temel farklar
## Pi CLI'dan Temel Farklar
| Yön | Pi CLI | OpenClaw Embedded |
| ---------------- | ----------------------- | ------------------------------------------------------------------------------------------------ |
| Çağırma | `pi` komutu / RPC | `createAgentSession()` üzerinden SDK |
| Araçlar | Varsayılan kodlama araçları | Özel OpenClaw araç paketi |
| Sistem istemi | AGENTS.md + istemler | Kanal/bağlam başına dinamik |
| Oturum depolama | `~/.pi/agent/sessions/` | `~/.openclaw/agents/<agentId>/sessions/` (veya `$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/`) |
| Auth | Tek kimlik bilgisi | Döndürmeli çoklu profile |
| Uzantılar | Diskten yüklenir | Programatik + disk yolları |
| Olay işleme | TUI render etme | Callback tabanlı (`onBlockReply` vb.) |
| Görünüm | Pi CLI | Gömülü OpenClaw |
| -------------- | ----------------------- | ----------------------------------------------------------------------------------------------- |
| Çağırma | `pi` komutu / RPC | `createAgentSession()` aracılığıyla SDK |
| Araçlar | Varsayılan kodlama araçları | Özel OpenClaw araç paketi |
| Sistem istemi | AGENTS.md + istemler | Kanal/bağlama göre dinamik |
| Oturum depolama | `~/.pi/agent/sessions/` | `~/.openclaw/agents/<agentId>/sessions/` (veya `$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/`) |
| Kimlik doğrulama | Tek kimlik bilgisi | Döndürmeli çoklu profil |
| Uzantılar | Diskten yüklenir | Programatik + disk yolları |
| Olay işleme | TUI işleme | Callback tabanlı (`onBlockReply` vb.) |
## Geleceğe dönük değerlendirmeler
## Geleceğe Yönelik Değerlendirmeler
Olası yeniden çalışma alanları:
1. **Araç imzası hizalaması**: Şu anda pi-agent-core ile pi-coding-agent imzaları arasında bağdaştırma yapılıyor
2. **Session manager sarmalama**: `guardSessionManager` güvenlik ekler ama karmaşıklığı artırır
3. **Uzantı yükleme**: pi'nin `ResourceLoader` yapısı daha doğrudan kullanılabilir
4. **Akış işleyici karmaşıklığı**: `subscribeEmbeddedPiSession` oldukça büyüdü
5. **Sağlayıcı tuhaflıkları**: pi'nin potansiyel olarak ele alabileceği birçok sağlayıcıya özgü kod yolu var
1. **Araç imzası hizalaması**: Şu anda pi-agent-core ve pi-coding-agent imzaları arasında uyarlama yapılıyor
2. **Oturum yöneticisi sarmalama**: `guardSessionManager` güvenlik ekliyor ancak karmaşıklığı artırıyor
3. **Uzantı yükleme**: Pi'nin `ResourceLoader` bileşeni daha doğrudan kullanılabilir
4. **Akış işleyici karmaşıklığı**: `subscribeEmbeddedPiSession` büyüdü
5. **Sağlayıcı tuhaflıkları**: Pi'nin potansiyel olarak yönetebileceği birçok sağlayıcıya özgü kod yolu var
## Testler
@ -571,11 +567,11 @@ Pi entegrasyon kapsamı şu paketlere yayılır:
Canlı/isteğe bağlı:
- `src/agents/pi-embedded-runner-extraparams.live.test.ts` (`OPENCLAW_LIVE_TEST=1` ile etkinleştirin)
- `src/agents/pi-embedded-runner-extraparams.live.test.ts` (`OPENCLAW_LIVE_TEST=1` etkinleştirilmelidir)
Geçerli çalıştırma komutları için bkz. [Pi Geliştirme İş Akışı](/tr/pi-dev).
## İlgili
- [Pi geliştirme iş akışı](/tr/pi-dev)
- [Kuruluma genel bakış](/tr/install)
- [Kurulum genel bakışı](/tr/install)

View File

@ -1,39 +1,39 @@
---
read_when:
- OpenClaw ile DeepSeek kullanmak istiyorsunuz
- API anahtarı ortam değişkenine veya CLI auth seçeneğine ihtiyacınız var
summary: DeepSeek kurulumu (auth + model seçimi)
- API anahtarı ortam değişkenine veya CLI kimlik doğrulama seçimine ihtiyacınız var
summary: DeepSeek kurulumu (kimlik doğrulama + model seçimi)
title: DeepSeek
x-i18n:
generated_at: "2026-04-24T09:25:35Z"
generated_at: "2026-04-24T15:21:52Z"
model: gpt-5.4
provider: openai
source_hash: ead407c67c05bd8700db1cba36defdd9d47bdc9a071c76a07c4b4fb82f6b80e2
source_hash: 5b0d2345c72328e14351d71c5784204dc6ed9dc922f919b6adfac394001c3261
source_path: providers/deepseek.md
workflow: 15
---
[DeepSeek](https://www.deepseek.com), OpenAI uyumlu bir API ile güçlü AI modelleri sunar.
[DeepSeek](https://www.deepseek.com), OpenAI uyumlu bir API ile güçlü yapay zeka modelleri sunar.
| Özellik | Değer |
| --------- | -------------------------- |
| Sağlayıcı | `deepseek` |
| Auth | `DEEPSEEK_API_KEY` |
| API | OpenAI-compatible |
| Base URL | `https://api.deepseek.com` |
| Özellik | Değer |
| -------- | ------------------------- |
| Sağlayıcı | `deepseek` |
| Kimlik Doğrulama | `DEEPSEEK_API_KEY` |
| API | OpenAI uyumlu |
| Temel URL | `https://api.deepseek.com` |
## Başlarken
## Başlangıç
<Steps>
<Step title="API anahtarınızı alın">
[platform.deepseek.com](https://platform.deepseek.com/api_keys) üzerinden bir API anahtarı oluşturun.
[platform.deepseek.com](https://platform.deepseek.com/api_keys) adresinde bir API anahtarı oluşturun.
</Step>
<Step title="Onboarding çalıştırın">
<Step title="Kurulumu çalıştırın">
```bash
openclaw onboard --auth-choice deepseek-api-key
```
Bu komut API anahtarınızı ister ve varsayılan model olarak `deepseek/deepseek-chat` ayarlar.
Bu işlem API anahtarınızı isteme istemi gösterir ve varsayılan model olarak `deepseek/deepseek-v4-flash` ayarlar.
</Step>
<Step title="Modellerin kullanılabilir olduğunu doğrulayın">
@ -45,7 +45,7 @@ x-i18n:
<AccordionGroup>
<Accordion title="Etkileşimsiz kurulum">
Betik tabanlı veya başsız kurulumlar için tüm bayrakları doğrudan verin:
Betikli veya başsız kurulumlar için tüm bayrakları doğrudan geçin:
```bash
openclaw onboard --non-interactive \
@ -60,20 +60,24 @@ x-i18n:
</AccordionGroup>
<Warning>
Gateway bir daemon olarak çalışıyorsa (launchd/systemd), `DEEPSEEK_API_KEY`
değerinin o süreç için erişilebilir olduğundan emin olun (örneğin `~/.openclaw/.env` içinde veya
`env.shellEnv` üzerinden).
Gateway bir daemon (launchd/systemd) olarak çalışıyorsa, `DEEPSEEK_API_KEY`
değişkeninin bu süreç için kullanılabilir olduğundan emin olun (örneğin, `~/.openclaw/.env` içinde veya
`env.shellEnv` aracılığıyla).
</Warning>
## Yerleşik katalog
| Model ref | Ad | Girdi | Bağlam | Maks çıktı | Notlar |
| ---------------------------- | ----------------- | ----- | ------- | ---------- | ------------------------------------------------- |
| `deepseek/deepseek-chat` | DeepSeek Chat | text | 131,072 | 8,192 | Varsayılan model; düşünmesiz DeepSeek V3.2 yüzeyi |
| `deepseek/deepseek-reasoner` | DeepSeek Reasoner | text | 131,072 | 65,536 | Düşünme etkin V3.2 yüzeyi |
| Model ref | Ad | Girdi | Bağlam | Maksimum çıktı | Notlar |
| ---------------------------- | --------------- | ----- | --------- | -------------- | ------------------------------------------ |
| `deepseek/deepseek-v4-flash` | DeepSeek V4 Flash | text | 1,000,000 | 384,000 | Varsayılan model; V4 düşünme destekli yüzey |
| `deepseek/deepseek-v4-pro` | DeepSeek V4 Pro | text | 1,000,000 | 384,000 | V4 düşünme destekli yüzey |
| `deepseek/deepseek-chat` | DeepSeek Chat | text | 131,072 | 8,192 | DeepSeek V3.2 düşünmesiz yüzey |
| `deepseek/deepseek-reasoner` | DeepSeek Reasoner | text | 131,072 | 65,536 | Akıl yürütme etkin V3.2 yüzeyi |
<Tip>
Paketli iki model de şu anda kaynakta akış kullanımı uyumluluğu bildiriyor.
V4 modelleri, DeepSeek'in `thinking` denetimini destekler. OpenClaw ayrıca
takip eden dönüşlerde DeepSeek `reasoning_content` içeriğini yeniden oynatır; böylece araç
çağrılarına sahip düşünme oturumları devam edebilir.
</Tip>
## Yapılandırma örneği
@ -83,7 +87,7 @@ Paketli iki model de şu anda kaynakta akış kullanımı uyumluluğu bildiriyor
env: { DEEPSEEK_API_KEY: "sk-..." },
agents: {
defaults: {
model: { primary: "deepseek/deepseek-chat" },
model: { primary: "deepseek/deepseek-v4-flash" },
},
},
}
@ -92,10 +96,10 @@ Paketli iki model de şu anda kaynakta akış kullanımı uyumluluğu bildiriyor
## İlgili
<CardGroup cols={2}>
<Card title="Model selection" href="/tr/concepts/model-providers" icon="layers">
Sağlayıcıları, model ref'lerini ve failover davranışını seçme.
<Card title="Model seçimi" href="/tr/concepts/model-providers" icon="layers">
Sağlayıcıları, model ref'lerini ve yük devretme davranışını seçme.
</Card>
<Card title="Configuration reference" href="/tr/gateway/configuration-reference" icon="gear">
Agent'ler, modeller ve sağlayıcılar için tam yapılandırma başvurusu.
<Card title="Yapılandırma başvurusu" href="/tr/gateway/configuration-reference" icon="gear">
Aracılar, modeller ve sağlayıcılar için tam yapılandırma başvurusu.
</Card>
</CardGroup>

View File

@ -1,30 +1,30 @@
---
read_when:
- Plugin kurma veya yapılandırma
- Plugin keşfi ve yükleme kurallarını anlama
- Plugin'leri kurma veya yapılandırma
- Plugin keşfini ve yükleme kurallarını anlama
- Codex/Claude uyumlu Plugin paketleriyle çalışma
sidebarTitle: Install and Configure
summary: OpenClaw Plugin'lerini kurun, yapılandırın ve yönetin
summary: OpenClaw plugin'lerini kurun, yapılandırın ve yönetin
title: Plugin'ler
x-i18n:
generated_at: "2026-04-24T09:36:43Z"
generated_at: "2026-04-24T15:21:57Z"
model: gpt-5.4
provider: openai
source_hash: 83ab1218d6677ad518a4991ca546d55eed9648e1fa92b76b7433ecd5df569e28
source_hash: 947bb7ffc13280fd63f79bb68cb18a37c6614144b91a83afd38e5ac3c5187aed
source_path: tools/plugin.md
workflow: 15
---
Plugin'ler, OpenClaw'ı yeni yeteneklerle genişletir: kanallar, model sağlayıcıları,
ajan harness'leri, araçlar, Skills, konuşma, gerçek zamanlı transkripsiyon, gerçek zamanlı
ses, medya anlama, görsel üretimi, video üretimi, web fetch, web
search ve daha fazlası. Bazı Plugin'ler **çekirdek**tir (OpenClaw ile birlikte gelir), diğerleri
**harici**dir (topluluk tarafından npm üzerinde yayımlanır).
Plugin'ler OpenClaw'u yeni yeteneklerle genişletir: kanallar, model sağlayıcıları,
ajan koşumları, araçlar, beceriler, konuşma, gerçek zamanlı transkripsiyon, gerçek zamanlı
ses, medya anlama, görsel oluşturma, video oluşturma, web getirme, web
arama ve daha fazlası. Bazı Plugin'ler **çekirdektir** (OpenClaw ile birlikte gelir), diğerleri
ise **haricidir** (topluluk tarafından npm üzerinde yayımlanır).
## Hızlı başlangıç
<Steps>
<Step title="Nelerin yüklü olduğunu görün">
<Step title="Neyin yüklü olduğunu görün">
```bash
openclaw plugins list
```
@ -35,7 +35,7 @@ search ve daha fazlası. Bazı Plugin'ler **çekirdek**tir (OpenClaw ile birlikt
# npm'den
openclaw plugins install @openclaw/voice-call
# Yerel dizin veya arşivden
# Yerel bir dizinden veya arşivden
openclaw plugins install ./my-plugin
openclaw plugins install ./my-plugin.tgz
```
@ -52,7 +52,7 @@ search ve daha fazlası. Bazı Plugin'ler **çekirdek**tir (OpenClaw ile birlikt
</Step>
</Steps>
Sohbet yerel denetimi tercih ediyorsanız `commands.plugins: true` etkinleştirin ve şunu kullanın:
Sohbet yerel denetimi tercih ediyorsanız, `commands.plugins: true` etkinleştirin ve şunları kullanın:
```text
/plugin install clawhub:@openclaw/voice-call
@ -60,48 +60,47 @@ Sohbet yerel denetimi tercih ediyorsanız `commands.plugins: true` etkinleştiri
/plugin enable voice-call
```
Kurulum yolu, CLI ile aynı çözümleyiciyi kullanır: yerel yol/arşiv, açık
`clawhub:<pkg>` veya düz paket tanımı (önce ClawHub, sonra npm geri dönüşü).
Kurulum yolu, CLI ile aynı çözücüyü kullanır: yerel yol/arşiv, açık
`clawhub:<pkg>` ya da yalın paket belirtimi (önce ClawHub, sonra npm yedeği).
Yapılandırma geçersizse kurulum normalde fail closed olur ve sizi
`openclaw doctor --fix` komutuna yönlendirir. Tek kurtarma istisnası,
`openclaw.install.allowInvalidConfigRecovery`
özelliğini seçen Plugin'ler için dar bir paketlenmiş Plugin yeniden kurulum yoludur.
Yapılandırma geçersizse, kurulum normalde kapalı şekilde başarısız olur ve sizi
`openclaw doctor --fix` komutuna yönlendirir. Tek kurtarma istisnası, şunu seçen Plugin'ler için
dar kapsamlı bir paketlenmiş Plugin yeniden kurulum yoludur:
`openclaw.install.allowInvalidConfigRecovery`.
Paketlenmiş OpenClaw kurulumları, her paketlenmiş Plugin'in
çalışma zamanı bağımlılık ağacını eager olarak kurmaz. Paketlenmiş OpenClaw'a ait bir Plugin,
Plugin yapılandırmasından, eski kanal yapılandırmasından veya varsayılan etkin manifest'ten aktif olduğunda,
başlangıç yalnızca o Plugin'in ilan edilmiş çalışma zamanı bağımlılıklarını
içe aktarmadan önce onarır.
Harici Plugin'ler ve özel yükleme yolları yine de
Paketlenmiş OpenClaw kurulumları, birlikte gelen her Plugin'in
çalışma zamanı bağımlılık ağacını önceden kurmaz. Paketlenmiş ve OpenClaw'a ait bir Plugin
Plugin yapılandırması, eski kanal yapılandırması veya varsayılan etkin bir manifestodan etkin olduğunda,
başlangıç yalnızca o Plugin'in bildirilen çalışma zamanı bağımlılıklarını
içe aktarmadan önce onarır. Harici Plugin'ler ve özel yükleme yolları yine de
`openclaw plugins install` üzerinden kurulmalıdır.
## Plugin türleri
OpenClaw iki Plugin biçimini tanır:
| Biçim | Nasıl çalışır | Örnekler |
| ---------- | --------------------------------------------------------------- | ------------------------------------------------------- |
| **Native** | `openclaw.plugin.json` + çalışma zamanı modülü; süreç içinde yürütülür | Resmî Plugin'ler, topluluk npm paketleri |
| **Bundle** | Codex/Claude/Cursor uyumlu düzen; OpenClaw özelliklerine eşlenir | `.codex-plugin/`, `.claude-plugin/`, `.cursor-plugin/` |
| Biçim | Nasıl çalışır | Örnekler |
| ---------- | ----------------------------------------------------------------- | ------------------------------------------------------ |
| **Native** | `openclaw.plugin.json` + çalışma zamanı modülü; süreç içinde çalışır | Resmi Plugin'ler, topluluk npm paketleri |
| **Bundle** | Codex/Claude/Cursor uyumlu düzen; OpenClaw özelliklerine eşlenir | `.codex-plugin/`, `.claude-plugin/`, `.cursor-plugin/` |
Her ikisi de `openclaw plugins list` altında görünür. Bundle ayrıntıları için bkz. [Plugin Bundles](/tr/plugins/bundles).
Her ikisi de `openclaw plugins list` altında görünür. Paket ayrıntıları için [Plugin Paketleri](/tr/plugins/bundles) bölümüne bakın.
Yerel bir Plugin yazıyorsanız [Building Plugins](/tr/plugins/building-plugins)
ve [Plugin SDK Overview](/tr/plugins/sdk-overview) ile başlayın.
Bir native Plugin yazıyorsanız, [Plugin Oluşturma](/tr/plugins/building-plugins)
ve [Plugin SDK Genel Bakış](/tr/plugins/sdk-overview) ile başlayın.
## Resmî Plugin'ler
## Resmi Plugin'ler
### Kurulabilir (npm)
| Plugin | Paket | Belgeler |
| --------------- | --------------------- | ------------------------------------ |
| Matrix | `@openclaw/matrix` | [Matrix](/tr/channels/matrix) |
| Microsoft Teams | `@openclaw/msteams` | [Microsoft Teams](/tr/channels/msteams) |
| Nostr | `@openclaw/nostr` | [Nostr](/tr/channels/nostr) |
| Voice Call | `@openclaw/voice-call` | [Voice Call](/tr/plugins/voice-call) |
| Zalo | `@openclaw/zalo` | [Zalo](/tr/channels/zalo) |
| Zalo Personal | `@openclaw/zalouser` | [Zalo Personal](/tr/plugins/zalouser) |
| Plugin | Paket | Belgeler |
| --------------- | ---------------------- | ------------------------------------ |
| Matrix | `@openclaw/matrix` | [Matrix](/tr/channels/matrix) |
| Microsoft Teams | `@openclaw/msteams` | [Microsoft Teams](/tr/channels/msteams) |
| Nostr | `@openclaw/nostr` | [Nostr](/tr/channels/nostr) |
| Voice Call | `@openclaw/voice-call` | [Voice Call](/tr/plugins/voice-call) |
| Zalo | `@openclaw/zalo` | [Zalo](/tr/channels/zalo) |
| Zalo Personal | `@openclaw/zalouser` | [Zalo Personal](/tr/plugins/zalouser) |
### Çekirdek (OpenClaw ile birlikte gelir)
@ -115,8 +114,8 @@ ve [Plugin SDK Overview](/tr/plugins/sdk-overview) ile başlayın.
</Accordion>
<Accordion title="Bellek Plugin'leri">
- `memory-core` — paketlenmiş bellek arama (varsayılan olarak `plugins.slots.memory` üzerinden)
- `memory-lancedb`isteğe bağlı kurulumla uzun vadeli bellek, otomatik geri çağırma/yakalama ile (şunu ayarlayın: `plugins.slots.memory = "memory-lancedb"`)
- `memory-core` — paketlenmiş bellek araması (`plugins.slots.memory` üzerinden varsayılan)
- `memory-lancedb`otomatik geri çağırma/yakalama ile isteğe bağlı kurulan uzun vadeli bellek (`plugins.slots.memory = "memory-lancedb"` olarak ayarlayın)
</Accordion>
<Accordion title="Konuşma sağlayıcıları (varsayılan olarak etkin)">
@ -124,12 +123,12 @@ ve [Plugin SDK Overview](/tr/plugins/sdk-overview) ile başlayın.
</Accordion>
<Accordion title="Diğer">
- `browser`browser aracı, `openclaw browser` CLI, `browser.request` Gateway yöntemi, browser çalışma zamanı ve varsayılan browser denetim hizmeti için paketlenmiş browser Plugin'i (varsayılan olarak etkin; değiştirmeden önce devre dışı bırakın)
- `browser`tarayıcı aracı, `openclaw browser` CLI'si, `browser.request` Gateway yöntemi, tarayıcı çalışma zamanı ve varsayılan tarayıcı denetim hizmeti için paketlenmiş tarayıcı Plugin'i (varsayılan olarak etkindir; değiştirmeden önce devre dışı bırakın)
- `copilot-proxy` — VS Code Copilot Proxy köprüsü (varsayılan olarak devre dışı)
</Accordion>
</AccordionGroup>
Üçüncü taraf Plugin'ler mi arıyorsunuz? [Community Plugins](/tr/plugins/community) sayfasına bakın.
Üçüncü taraf Plugin'ler mi arıyorsunuz? [Topluluk Plugin'leri](/tr/plugins/community) bölümüne bakın.
## Yapılandırma
@ -147,23 +146,34 @@ ve [Plugin SDK Overview](/tr/plugins/sdk-overview) ile başlayın.
}
```
| Alan | Açıklama |
| ---------------- | ------------------------------------------------------- |
| `enabled` | Ana anahtar (varsayılan: `true`) |
| `allow` | Plugin izin listesi (isteğe bağlı) |
| `deny` | Plugin engelleme listesi (isteğe bağlı; deny kazanır) |
| `load.paths` | Ek Plugin dosyaları/dizinleri |
| `slots` | Ayrıcalıklı slot seçicileri (örn. `memory`, `contextEngine`) |
| `entries.\<id\>` | Plugin başına anahtarlar + yapılandırma |
| Alan | Açıklama |
| ---------------- | --------------------------------------------------------- |
| `enabled` | Ana anahtar (varsayılan: `true`) |
| `allow` | Plugin izin listesi (isteğe bağlı) |
| `deny` | Plugin engelleme listesi (isteğe bağlı; engelleme önceliklidir) |
| `load.paths` | Ek Plugin dosyaları/dizinleri |
| `slots` | Özel yuva seçicileri (örn. `memory`, `contextEngine`) |
| `entries.\<id\>` | Plugin başına anahtarlar + yapılandırma |
Yapılandırma değişiklikleri **Gateway yeniden başlatması gerektirir**. Gateway yapılandırma
izleme + süreç içi yeniden başlatma etkin olarak çalışıyorsa (varsayılan `openclaw gateway` yolu),
bu yeniden başlatma genellikle yapılandırma yazımı düştükten kısa süre sonra otomatik olarak yapılır.
bu yeniden başlatma genellikle yapılandırma yazımı tamamlandıktan kısa bir süre sonra otomatik olarak gerçekleştirilir.
Native Plugin çalışma zamanı kodu veya yaşam döngüsü kancaları için desteklenen bir sıcak yeniden yükleme yolu yoktur;
güncellenmiş `register(api)` kodunun, `api.on(...)` kancalarının, araçların, hizmetlerin veya
sağlayıcı/çalışma zamanı kancalarının çalışmasını beklemeden önce canlı kanala hizmet veren
Gateway sürecini yeniden başlatın.
<Accordion title="Plugin durumları: disabled vs missing vs invalid">
- **Disabled**: Plugin vardır ama etkinleştirme kuralları onu kapatmıştır. Yapılandırma korunur.
- **Missing**: yapılandırma, keşfin bulamadığı bir Plugin kimliğine başvurur.
- **Invalid**: Plugin vardır ama yapılandırması bildirilen şemayla eşleşmez.
`openclaw plugins list`, yerel bir CLI/yapılandırma anlık görüntüsüdür. Orada bir Plugin'in `loaded` olması,
Plugin'in o CLI çağrısının gördüğü yapılandırma/dosyalardan keşfedilebilir ve yüklenebilir olduğu
anlamına gelir. Bu, hâlihazırda çalışan uzak bir Gateway alt sürecinin
aynı Plugin koduyla yeniden başlatıldığını kanıtlamaz. Sarmalayıcı süreçlere sahip VPS/container kurulumlarında,
yeniden başlatma sinyallerini gerçek `openclaw gateway run` sürecine gönderin veya
çalışan Gateway'e karşı `openclaw gateway restart` kullanın.
<Accordion title="Plugin durumları: devre dışı vs eksik vs geçersiz">
- **Devre dışı**: Plugin vardır ancak etkinleştirme kuralları onu kapatmıştır. Yapılandırma korunur.
- **Eksik**: yapılandırma, keşfin bulamadığı bir Plugin kimliğine başvurur.
- **Geçersiz**: Plugin vardır ancak yapılandırması bildirilen şemayla eşleşmez.
</Accordion>
## Keşif ve öncelik
@ -192,22 +202,43 @@ OpenClaw Plugin'leri şu sırayla tarar (ilk eşleşme kazanır):
### Etkinleştirme kuralları
- `plugins.enabled: false` tüm Plugin'leri devre dışı bırakır
- `plugins.deny`, her zaman allow üzerinde kazanır
- `plugins.entries.\<id\>.enabled: false` ilgili Plugin'i devre dışı bırakır
- `plugins.deny` her zaman `allow` üzerinde önceliklidir
- `plugins.entries.\<id\>.enabled: false` o Plugin'i devre dışı bırakır
- Çalışma alanı kaynaklı Plugin'ler **varsayılan olarak devre dışıdır** (açıkça etkinleştirilmelidir)
- Paketlenmiş Plugin'ler, geçersiz kılınmadığı sürece yerleşik varsayılan-açık kümeyi izler
- Ayrıcalıklı slotlar, o slot için seçilen Plugin'i zorla etkinleştirebilir
- Bazı paketlenmiş opt-in Plugin'ler, yapılandırma bir
Plugin'e ait yüzey adlandırdığında otomatik olarak etkinleştirilir;
örneğin sağlayıcı model başvurusu, kanal yapılandırması veya harness çalışma zamanı
- Paketlenmiş Plugin'ler, geçersiz kılınmadıkça yerleşik varsayılan etkin kümesini izler
- Özel yuvalar, o yuva için seçilen Plugin'i zorla etkinleştirebilir
- Bazı paketlenmiş isteğe bağlı Plugin'ler, yapılandırma bir
Plugin'e ait yüzeyi adlandırdığında otomatik olarak etkinleştirilir; örneğin bir sağlayıcı model başvurusu, kanal yapılandırması veya harness
çalışma zamanı
- OpenAI ailesi Codex yolları ayrı Plugin sınırlarını korur:
`openai-codex/*`, OpenAI Plugin'ine aittir; paketlenmiş Codex
`openai-codex/*` OpenAI Plugin'ine aittir; paketlenmiş Codex
app-server Plugin'i ise `embeddedHarness.runtime: "codex"` veya eski
`codex/*` model başvurularıyla seçilir
`codex/*` model başvuruları ile seçilir
## Plugin slotları (ayrıcalıklı kategoriler)
## Çalışma Zamanı Kancalarında Sorun Giderme
Bazı kategoriler ayrıcalıklıdır (aynı anda yalnızca biri etkin olabilir):
Bir Plugin `plugins list` içinde görünüyorsa ancak `register(api)` yan etkileri veya kancaları
canlı sohbet trafiğinde çalışmıyorsa, önce şunları kontrol edin:
- `openclaw gateway status --deep --require-rpc` komutunu çalıştırın ve etkin
Gateway URL'si, profil, yapılandırma yolu ve sürecin düzenlediğinizle aynı olduğunu doğrulayın.
- Plugin kurulum/yapılandırma/kod değişikliklerinden sonra canlı Gateway'i yeniden başlatın. Sarmalayıcı
container'larda, PID 1 yalnızca bir gözetmen olabilir; alt
`openclaw gateway run` sürecini yeniden başlatın veya ona sinyal gönderin.
- Kanca kayıtlarını ve tanılamayı doğrulamak için `openclaw plugins inspect <id> --json` kullanın.
`llm_input`,
`llm_output` ve `agent_end` gibi paketlenmemiş konuşma kancaları için
`plugins.entries.<id>.hooks.allowConversationAccess=true` gerekir.
- Model değiştirme için `before_model_resolve` tercih edin. Bu kanca, ajan dönüşleri için model
çözümlemesinden önce çalışır; `llm_output` ise yalnızca bir model denemesi
asistan çıktısı ürettikten sonra çalışır.
- Etkin oturum modeli kanıtı için `openclaw sessions` veya
Gateway oturum/durum yüzeylerini kullanın ve sağlayıcı yüklerini hata ayıklarken
Gateway'i `--raw-stream --raw-stream-path <path>` ile başlatın.
## Plugin yuvaları (özel kategoriler)
Bazı kategoriler özeldir (aynı anda yalnızca biri etkin olabilir):
```json5
{
@ -220,21 +251,21 @@ Bazı kategoriler ayrıcalıklıdır (aynı anda yalnızca biri etkin olabilir):
}
```
| Slot | Ne denetler | Varsayılan |
| --------------- | ------------------------ | ----------------- |
| `memory` | Etkin bellek Plugin'i | `memory-core` |
| `contextEngine` | Etkin bağlam motoru | `legacy` (yerleşik) |
| Yuva | Ne denetler | Varsayılan |
| --------------- | ---------------------- | ------------------- |
| `memory` | Active Memory Plugin'i | `memory-core` |
| `contextEngine` | Etkin bağlam motoru | `legacy` (yerleşik) |
## CLI başvurusu
```bash
openclaw plugins list # kompakt envanter
openclaw plugins list --enabled # yalnızca yüklü Plugin'ler
openclaw plugins list --enabled # yalnızca yüklenmiş Plugin'ler
openclaw plugins list --verbose # Plugin başına ayrıntı satırları
openclaw plugins list --json # makine tarafından okunabilir envanter
openclaw plugins inspect <id> # derin ayrıntı
openclaw plugins inspect <id> --json # makine tarafından okunabilir
openclaw plugins inspect --all # tüm filo tablosu
openclaw plugins inspect --all # tüm filoya ait tablo
openclaw plugins info <id> # inspect takma adı
openclaw plugins doctor # tanılama
@ -245,7 +276,7 @@ openclaw plugins install <path> # yerel yoldan kur
openclaw plugins install -l <path> # geliştirme için bağla (kopyalama yok)
openclaw plugins install <plugin> --marketplace <source>
openclaw plugins install <plugin> --marketplace https://github.com/<owner>/<repo>
openclaw plugins install <spec> --pin # tam çözümlenmiş npm spec'ini kaydet
openclaw plugins install <spec> --pin # tam çözümlenmiş npm belirtimini kaydet
openclaw plugins install <spec> --dangerously-force-unsafe-install
openclaw plugins update <id-or-npm-spec> # tek bir Plugin'i güncelle
openclaw plugins update <id-or-npm-spec> --dangerously-force-unsafe-install
@ -261,57 +292,59 @@ openclaw plugins disable <id>
Paketlenmiş Plugin'ler OpenClaw ile birlikte gelir. Birçoğu varsayılan olarak etkindir (örneğin
paketlenmiş model sağlayıcıları, paketlenmiş konuşma sağlayıcıları ve paketlenmiş browser
Plugin'i). Diğer paketlenmiş Plugin'ler yine de `openclaw plugins enable <id>` gerektirir.
Plugin'i). Diğer paketlenmiş Plugin'ler için yine de `openclaw plugins enable <id>` gerekir.
`--force`, mevcut kurulu bir Plugin'i veya hook paketini yerinde üzerine yazar. İzlenen npm
Plugin'lerinin rutin yükseltmeleri için `openclaw plugins update <id-or-npm-spec>` kullanın.
Bu, kaynağı kopyalamak yerine
yönetilen kurulum hedefi yerine kaynak yolu yeniden kullandığı için `--link` ile desteklenmez.
Kaynak yolu, yönetilen kurulum hedefinin üzerine kopyalamak yerine yeniden kullandığı için
bu seçenek `--link` ile desteklenmez.
`plugins.allow` zaten ayarlıysa `openclaw plugins install`,
kurulan Plugin kimliğini etkinleştirmeden önce bu allowlist'e ekler; böylece kurulumlar
yeniden başlatmadan sonra hemen yüklenebilir olur.
`plugins.allow` zaten ayarlıysa, `openclaw plugins install`
kurulan Plugin kimliğini etkinleştirmeden önce bu izin listesine ekler; böylece kurulumlar
yeniden başlatmanın ardından hemen yüklenebilir olur.
`openclaw plugins update <id-or-npm-spec>`, izlenen kurulumlara uygulanır.
Bir dist-tag veya tam sürüm içeren npm paket tanımı geçirmek, paket adını
izlenen Plugin kaydına geri çözümler ve gelecekteki güncellemeler için yeni tanımı kaydeder.
Sürüm belirtmeden paket adını geçirmek, tam sabitlenmiş kurulumu yeniden
kayıt defterinin varsayılan sürüm hattına taşır. Kurulu npm Plugin'i zaten çözümlenmiş sürümle
ve kaydedilmiş artefakt kimliğiyle eşleşiyorsa OpenClaw indirme,
yeniden kurma veya yapılandırma yazımı yapmadan güncellemeyi atlar.
`openclaw plugins update <id-or-npm-spec>` izlenen kurulumlara uygulanır. Bir
dist-tag veya tam sürüm içeren npm paket belirtimi geçirilirse, paket adı yeniden
izlenen Plugin kaydına çözümlenir ve yeni belirtim gelecekteki güncellemeler için kaydedilir.
Sürüm olmadan paket adı geçirilirse, tam olarak sabitlenmiş bir kurulum yeniden
kayıt defterinin varsayılan yayın hattına taşınır. Kurulu npm Plugin'i zaten
çözümlenen sürümle ve kaydedilmiş yapıt kimliğiyle eşleşiyorsa, OpenClaw
indirme, yeniden kurma veya yapılandırmayı yeniden yazma yapmadan güncellemeyi atlar.
`--pin` yalnızca npm içindir. `--marketplace` ile desteklenmez, çünkü
marketplace kurulumları npm tanımı yerine marketplace kaynak meta verisini kalıcılaştırır.
`--pin` yalnızca npm içindir. `--marketplace` ile desteklenmez çünkü
marketplace kurulumları, npm belirtimi yerine marketplace kaynak meta verisini kalıcı hale getirir.
`--dangerously-force-unsafe-install`, yerleşik tehlikeli kod tarayıcısından gelen false positive'ler için acil durum geçersiz kılmasıdır. Plugin kurulumlarının
ve Plugin güncellemelerinin yerleşik `critical` bulgulara rağmen devam etmesine izin verir, ancak
yine de Plugin `before_install` ilke bloklarını veya tarama başarısızlığı engellemesini aşmaz.
`--dangerously-force-unsafe-install`, yerleşik tehlikeli kod tarayıcısından gelen yanlış
pozitifler için acil durum geçersiz kılma seçeneğidir. Yerleşik `critical` bulgularına rağmen
Plugin kurulumlarının ve Plugin güncellemelerinin devam etmesine izin verir, ancak yine de
Plugin `before_install` ilke engellerini veya tarama başarısızlığı engellemesini aşmaz.
Bu CLI bayrağı yalnızca Plugin kurulum/güncelleme akışlarına uygulanır. Gateway destekli skill
bağımlılık kurulumları bunun yerine eşleşen `dangerouslyForceUnsafeInstall` istek geçersiz kılmasını kullanır; `openclaw skills install` ise ayrı ClawHub
skill indirme/kurma akışı olarak kalır.
Bu CLI bayrağı yalnızca Plugin kurulum/güncelleme akışlarına uygulanır. Gateway destekli Skill
bağımlılığı kurulumları bunun yerine eşleşen `dangerouslyForceUnsafeInstall` istek
geçersiz kılmasını kullanır; `openclaw skills install` ise ayrı ClawHub
Skill indirme/kurulum akışı olarak kalır.
Uyumlu bundle'lar aynı Plugin listeleme/inceleme/etkinleştirme/devre dışı bırakma
akışına katılır. Mevcut çalışma zamanı desteği; bundle Skills, Claude command-skills,
Claude `settings.json` varsayılanları, Claude `.lsp.json` ve manifest ile bildirilen
Uyumlu paketler aynı Plugin listeleme/inceleme/etkinleştirme/devre dışı bırakma
akışına katılır. Mevcut çalışma zamanı desteği; paket Skill'leri, Claude command-skills,
Claude `settings.json` varsayılanları, Claude `.lsp.json` ve manifestte bildirilen
`lspServers` varsayılanları, Cursor command-skills ve uyumlu Codex hook
dizinlerini içerir.
`openclaw plugins inspect <id>`, bundle destekli Plugin'ler için algılanan bundle yeteneklerini ve
desteklenen veya desteklenmeyen MCP ve LSP sunucu girdilerini de raporlar.
`openclaw plugins inspect <id>`, paket destekli Plugin'ler için algılanan paket yeteneklerini
ve desteklenen ya da desteklenmeyen MCP ve LSP sunucu girdilerini de bildirir.
Marketplace kaynakları, `~/.claude/plugins/known_marketplaces.json`
içinden bir Claude bilinen-marketplace adı, yerel bir marketplace kökü veya
`marketplace.json` yolu, `owner/repo` gibi bir GitHub kısayolu, bir GitHub depo
URL'si veya bir git URL'si olabilir. Uzak marketplace'ler için Plugin girdileri
klonlanan marketplace deposu içinde kalmalı ve yalnızca göreli yol kaynakları kullanmalıdır.
dosyasındaki Claude bilinen-marketplace adı, yerel bir marketplace kökü veya
`marketplace.json` yolu, `owner/repo` gibi GitHub kısa gösterimi, bir GitHub depo
URL'si ya da bir git URL'si olabilir. Uzak marketplace'lerde, Plugin girdileri
klonlanan marketplace deposunun içinde kalmalı ve yalnızca göreli yol kaynakları kullanmalıdır.
Tam ayrıntılar için [`openclaw plugins` CLI başvurusu](/tr/cli/plugins) sayfasına bakın.
Tam ayrıntılar için [`openclaw plugins` CLI başvurusu](/tr/cli/plugins) bölümüne bakın.
## Plugin API genel bakışı
Yerel Plugin'ler, `register(api)`ığa çıkaran bir giriş nesnesi dışa aktarır. Eski
Plugin'ler hâlâ eski takma ad olarak `activate(api)` kullanıyor olabilir, ancak yeni Plugin'ler
Native Plugin'ler `register(api)` sunan bir giriş nesnesi dışa aktarır. Eski
Plugin'ler hâlâ eski takma ad olarak `activate(api)` kullanabilir, ancak yeni Plugin'ler
`register` kullanmalıdır.
```typescript
@ -332,48 +365,49 @@ export default definePluginEntry({
});
```
OpenClaw giriş nesnesini yükler ve Plugin etkinleştirmesi sırasında `register(api)` çağırır.
Yükleyici eski Plugin'ler için hâlâ `activate(api)` çağrısına geri düşer,
ancak paketlenmiş Plugin'ler ve yeni harici Plugin'ler `register` değerini herkese açık sözleşme olarak değerlendirmelidir.
OpenClaw giriş nesnesini yükler ve Plugin etkinleştirmesi sırasında
`register(api)` çağrısını yapar. Yükleyici eski Plugin'ler için hâlâ `activate(api)` kullanımına geri döner,
ancak paketlenmiş Plugin'ler ve yeni harici Plugin'ler `register` yöntemini
genel sözleşme olarak görmelidir.
Yaygın kayıt yöntemleri:
| Yöntem | Kaydettiği şey |
| Yöntem | Ne kaydeder |
| --------------------------------------- | --------------------------- |
| `registerProvider` | Model sağlayıcısı (LLM) |
| `registerChannel` | Sohbet kanalı |
| `registerTool` | Ajan aracı |
| `registerHook` / `on(...)` | Yaşam döngüsü hook'ları |
| `registerSpeechProvider` | Metinden konuşma / STT |
| `registerRealtimeTranscriptionProvider` | Akışlı STT |
| `registerHook` / `on(...)` | Yaşam döngüsü kancaları |
| `registerSpeechProvider` | Metinden konuşmaya / STT |
| `registerRealtimeTranscriptionProvider` | Akışkan STT |
| `registerRealtimeVoiceProvider` | Çift yönlü gerçek zamanlı ses |
| `registerMediaUnderstandingProvider` | Görsel/ses analizi |
| `registerImageGenerationProvider` | Görsel üretimi |
| `registerMusicGenerationProvider` | Müzik üretimi |
| `registerVideoGenerationProvider` | Video üretimi |
| `registerWebFetchProvider` | Web fetch / scrape sağlayıcısı |
| `registerImageGenerationProvider` | Görsel oluşturma |
| `registerMusicGenerationProvider` | Müzik oluşturma |
| `registerVideoGenerationProvider` | Video oluşturma |
| `registerWebFetchProvider` | Web getirme / kazıma sağlayıcısı |
| `registerWebSearchProvider` | Web arama |
| `registerHttpRoute` | HTTP uç noktası |
| `registerCommand` / `registerCli` | CLI komutları |
| `registerContextEngine` | Bağlam motoru |
| `registerService` | Arka plan hizmeti |
Tiplenmiş yaşam döngüsü hook'ları için hook guard davranışı:
Türlendirilmiş yaşam döngüsü kancaları için kanca koruma davranışı:
- `before_tool_call`: `{ block: true }` terminaldir; daha düşük öncelikli işleyiciler atlanır.
- `before_tool_call`: `{ block: false }` işlemsizdir ve daha önceki bir engellemeyi temizlemez.
- `before_install`: `{ block: true }` terminaldir; daha düşük öncelikli işleyiciler atlanır.
- `before_install`: `{ block: false }` işlemsizdir ve daha önceki bir engellemeyi temizlemez.
- `message_sending`: `{ cancel: true }` terminaldir; daha düşük öncelikli işleyiciler atlanır.
- `message_sending`: `{ cancel: false }` işlemsizdir ve daha önceki bir iptali temizlemez.
- `before_tool_call`: `{ block: true }` nihaidir; daha düşük öncelikli işleyiciler atlanır.
- `before_tool_call`: `{ block: false }` etkisizdir ve daha önceki bir engellemeyi temizlemez.
- `before_install`: `{ block: true }` nihaidir; daha düşük öncelikli işleyiciler atlanır.
- `before_install`: `{ block: false }` etkisizdir ve daha önceki bir engellemeyi temizlemez.
- `message_sending`: `{ cancel: true }` nihaidir; daha düşük öncelikli işleyiciler atlanır.
- `message_sending`: `{ cancel: false }` etkisizdir ve daha önceki bir iptali temizlemez.
Tam tiplenmiş hook davranışı için bkz. [SDK Overview](/tr/plugins/sdk-overview#hook-decision-semantics).
Tam türlendirilmiş kanca davranışı için [SDK Genel Bakış](/tr/plugins/sdk-overview#hook-decision-semantics) bölümüne bakın.
## İlgili
- [Plugin oluşturma](/tr/plugins/building-plugins) — kendi Plugin'inizi oluşturun
- [Plugin Bundles](/tr/plugins/bundles) — Codex/Claude/Cursor bundle uyumluluğu
- [Plugin Manifest](/tr/plugins/manifest) — manifest şeması
- [Araç kaydetme](/tr/plugins/building-plugins#registering-agent-tools) — bir Plugin içinde ajan araçları ekleme
- [Plugin iç yapıları](/tr/plugins/architecture) — yetenek modeli ve yükleme hattı
- [Topluluk Plugin'leri](/tr/plugins/community) — üçüncü taraf listeler
- [Plugin Oluşturma](/tr/plugins/building-plugins) — kendi Plugin'inizi oluşturun
- [Plugin Paketleri](/tr/plugins/bundles) — Codex/Claude/Cursor paket uyumluluğu
- [Plugin Manifesti](/tr/plugins/manifest) — manifest şeması
- [Araç Kaydetme](/tr/plugins/building-plugins#registering-agent-tools) — bir Plugin'e ajan araçları ekleyin
- [Plugin İç Yapısı](/tr/plugins/architecture) — yetenek modeli ve yükleme hattı
- [Topluluk Plugin'leri](/tr/plugins/community) — üçüncü taraf listeleri