chore(i18n): refresh tr translations
This commit is contained in:
parent
751ffc91ac
commit
482d1288f3
@ -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,
|
||||
açı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ı açık bir `clawhub:<package>` konumlayıcısı kullanır:
|
||||
ClawHub kurulumları açı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ı açıkça geçirmek istediğinizde `--marketplace` kullanın:
|
||||
Marketplace kaynağını açı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
|
||||
|
||||
|
||||
@ -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, pi‑ai 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, pi‑ai 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, pi‑ai 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, pi‑ai 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, pi‑ai 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, pi‑ai 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, pi‑ai 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ı
|
||||
|
||||
292
docs/tr/pi.md
292
docs/tr/pi.md
@ -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 bağımlılıkları
|
||||
## Paket Bağı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)
|
||||
|
||||
@ -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>
|
||||
|
||||
@ -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çığ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
|
||||
|
||||
Loading…
Reference in New Issue
Block a user