From 4ae90d76fc9ac0e1a0ee7e6a53db76cb5f303895 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Wed, 8 Apr 2026 08:49:49 +0000 Subject: [PATCH] chore(i18n): refresh tr translations --- docs/tr/channels/discord.md | 462 ++++---- docs/tr/concepts/dreaming.md | 114 +- docs/tr/gateway/configuration-reference.md | 1154 ++++++++++---------- docs/tr/plugins/sdk-migration.md | 424 ++++--- docs/tr/plugins/sdk-overview.md | 565 +++++----- docs/tr/providers/google.md | 97 +- docs/tr/providers/ollama.md | 118 +- 7 files changed, 1507 insertions(+), 1427 deletions(-) diff --git a/docs/tr/channels/discord.md b/docs/tr/channels/discord.md index def2e9345..4f329d5d8 100644 --- a/docs/tr/channels/discord.md +++ b/docs/tr/channels/discord.md @@ -1,26 +1,26 @@ --- read_when: - Discord kanal özellikleri üzerinde çalışırken -summary: Discord bot desteği durumu, yetenekleri ve yapılandırması +summary: Discord bot desteğinin durumu, yetenekleri ve yapılandırması title: Discord x-i18n: - generated_at: "2026-04-06T03:08:11Z" + generated_at: "2026-04-08T08:45:59Z" model: gpt-5.4 provider: openai - source_hash: 54af2176a1b4fa1681e3f07494def0c652a2730165058848000e71a59e2a9d08 + source_hash: 3cd2886fad941ae2129e681911309539e9a65a2352b777b538d7f4686a68f73f source_path: channels/discord.md workflow: 15 --- # Discord (Bot API) -Durum: resmi Discord gateway üzerinden DM'ler ve sunucu kanalları için hazır. +Durum: resmi Discord ağ geçidi üzerinden DM'ler ve sunucu kanalları için hazır. - - Discord DM'leri varsayılan olarak eşleme modundadır. + + Discord DM'leri varsayılan olarak eşleştirme modundadır. - + Yerel komut davranışı ve komut kataloğu. @@ -30,22 +30,22 @@ Durum: resmi Discord gateway üzerinden DM'ler ve sunucu kanalları için hazır ## Hızlı kurulum -Bot içeren yeni bir uygulama oluşturmanız, botu sunucunuza eklemeniz ve OpenClaw ile eşlemeniz gerekir. Botunuzu kendi özel sunucunuza eklemenizi öneririz. Henüz bir sunucunuz yoksa önce [bir tane oluşturun](https://support.discord.com/hc/en-us/articles/204849977-How-do-I-create-a-server) (**Create My Own > For me and my friends** seçin). +Bot içeren yeni bir uygulama oluşturmanız, botu sunucunuza eklemeniz ve OpenClaw ile eşleştirmeniz gerekir. Botunuzu kendi özel sunucunuza eklemenizi öneririz. Henüz bir sunucunuz yoksa, önce [bir tane oluşturun](https://support.discord.com/hc/en-us/articles/204849977-How-do-I-create-a-server) (**Create My Own > For me and my friends** seçin). - [Discord Developer Portal](https://discord.com/developers/applications) adresine gidin ve **New Application** seçeneğine tıklayın. Adını "OpenClaw" gibi bir şey yapın. + [Discord Developer Portal](https://discord.com/developers/applications) sayfasına gidin ve **New Application** seçeneğine tıklayın. Adını "OpenClaw" gibi bir şey yapın. - Kenar çubuğunda **Bot** seçeneğine tıklayın. **Username** alanını, OpenClaw ajanınıza verdiğiniz ad olarak ayarlayın. + Kenar çubuğunda **Bot** seçeneğine tıklayın. **Username** alanını OpenClaw ajanınıza verdiğiniz adla ayarlayın. - Hâlâ **Bot** sayfasındayken aşağı kaydırıp **Privileged Gateway Intents** bölümünde şunları etkinleştirin: + Hâlâ **Bot** sayfasındayken, aşağı kaydırarak **Privileged Gateway Intents** bölümüne gelin ve şunları etkinleştirin: - **Message Content Intent** (gerekli) - - **Server Members Intent** (önerilir; rol izin listeleri ve adtan-kimlik eşlemesi için gereklidir) - - **Presence Intent** (isteğe bağlı; yalnızca presence güncellemeleri için gerekir) + - **Server Members Intent** (önerilir; rol izin listeleri ve addan kimliğe eşleştirme için gereklidir) + - **Presence Intent** (isteğe bağlı; yalnızca varlık güncellemeleri için gereklidir) @@ -53,22 +53,22 @@ Bot içeren yeni bir uygulama oluşturmanız, botu sunucunuza eklemeniz ve OpenC **Bot** sayfasında tekrar yukarı kaydırın ve **Reset Token** seçeneğine tıklayın. - Adına rağmen bu işlem ilk token'ınızı oluşturur — hiçbir şey "sıfırlanmıyor". + İsmine rağmen bu işlem ilk token'ınızı oluşturur — hiçbir şey "sıfırlanmıyor". - Token'ı kopyalayın ve bir yere kaydedin. Bu sizin **Bot Token**'ınızdır ve kısa süre içinde buna ihtiyacınız olacak. + Token'ı kopyalayın ve bir yere kaydedin. Bu sizin **Bot Token** değerinizdir ve birazdan buna ihtiyacınız olacak. Kenar çubuğunda **OAuth2** seçeneğine tıklayın. Botu sunucunuza eklemek için doğru izinlere sahip bir davet URL'si oluşturacaksınız. - Aşağı kaydırıp **OAuth2 URL Generator** bölümünde şunları etkinleştirin: + Aşağı kaydırarak **OAuth2 URL Generator** bölümüne gelin ve şunları etkinleştirin: - `bot` - `applications.commands` - Altında bir **Bot Permissions** bölümü görünecektir. Şunları etkinleştirin: + Aşağıda bir **Bot Permissions** bölümü görünecek. Şunları etkinleştirin: - View Channels - Send Messages @@ -77,30 +77,30 @@ Bot içeren yeni bir uygulama oluşturmanız, botu sunucunuza eklemeniz ve OpenC - Attach Files - Add Reactions (isteğe bağlı) - Alttaki oluşturulmuş URL'yi kopyalayın, tarayıcınıza yapıştırın, sunucunuzu seçin ve bağlamak için **Continue** seçeneğine tıklayın. Artık Discord sunucusunda botunuzu görmelisiniz. + Alttaki oluşturulan URL'yi kopyalayın, tarayıcınıza yapıştırın, sunucunuzu seçin ve bağlamak için **Continue** seçeneğine tıklayın. Artık botunuzu Discord sunucusunda görmelisiniz. - Discord uygulamasına geri dönün; dahili kimlikleri kopyalayabilmek için Developer Mode'u etkinleştirmeniz gerekir. + Tekrar Discord uygulamasına dönün; dahili kimlikleri kopyalayabilmek için Developer Mode'u etkinleştirmeniz gerekir. - 1. **User Settings**'e (avatarınızın yanındaki dişli simgesi) tıklayın → **Advanced** → **Developer Mode** seçeneğini açın - 2. Kenar çubuğunda **sunucu simgenize** sağ tıklayın → **Copy Server ID** - 3. **Kendi avatarınıza** sağ tıklayın → **Copy User ID** + 1. **User Settings** (avatarınızın yanındaki dişli simgesi) → **Advanced** → **Developer Mode** seçeneğini açın + 2. Kenar çubuğunda **server icon** öğenize sağ tıklayın → **Copy Server ID** + 3. Kendi **avatar** öğenize sağ tıklayın → **Copy User ID** - **Server ID** ve **User ID** değerlerinizi Bot Token'ınızla birlikte kaydedin — sonraki adımda üçünü de OpenClaw'a göndereceksiniz. + **Server ID** ve **User ID** değerlerinizi Bot Token ile birlikte kaydedin — sonraki adımda üçünü de OpenClaw'a göndereceksiniz. - - Eşlemenin çalışması için Discord'un botunuzun size DM göndermesine izin vermesi gerekir. **Sunucu simgenize** sağ tıklayın → **Privacy Settings** → **Direct Messages** seçeneğini açın. + + Eşleştirmenin çalışması için Discord'un botunuzun size DM göndermesine izin vermesi gerekir. **server icon** öğenize sağ tıklayın → **Privacy Settings** → **Direct Messages** seçeneğini açın. - Bu, sunucu üyelerinin (botlar dahil) size DM göndermesine izin verir. OpenClaw ile Discord DM'lerini kullanmak istiyorsanız bunu etkin bırakın. Yalnızca sunucu kanallarını kullanmayı planlıyorsanız eşlemeden sonra DM'leri devre dışı bırakabilirsiniz. + Bu, sunucu üyelerinin (botlar dahil) size DM göndermesine izin verir. OpenClaw ile Discord DM'lerini kullanmak istiyorsanız bunu etkin bırakın. Yalnızca sunucu kanallarını kullanmayı planlıyorsanız, eşleştirmeden sonra DM'leri kapatabilirsiniz. - Discord bot token'ınız bir sırdır (parola gibi). Ajanınıza mesaj atmadan önce OpenClaw'ı çalıştıran makinede ayarlayın. + Discord bot token'ınız bir gizlidir (parola gibi). Ajanınıza mesaj göndermeden önce bunu OpenClaw çalıştıran makinede ayarlayın. ```bash export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN" @@ -114,16 +114,16 @@ openclaw gateway - + - OpenClaw ajanınızla mevcut herhangi bir kanalda (ör. Telegram) sohbet edin ve bunu söyleyin. Discord ilk kanalınızsa bunun yerine CLI / yapılandırma sekmesini kullanın. + OpenClaw ajanınızla mevcut herhangi bir kanalda (ör. Telegram) sohbet edin ve bunu söyleyin. Discord ilk kanalınızsa bunun yerine CLI / config sekmesini kullanın. - > "Discord bot token'ımı yapılandırmada zaten ayarladım. Lütfen User ID `` ve Server ID `` ile Discord kurulumunu tamamla." + > "Discord bot token'ımı zaten config içinde ayarladım. Lütfen User ID `` ve Server ID `` ile Discord kurulumunu tamamla." - - Dosya tabanlı yapılandırmayı tercih ediyorsanız şunu ayarlayın: + + Dosya tabanlı yapılandırmayı tercih ediyorsanız, şunu ayarlayın: ```json5 { @@ -146,21 +146,21 @@ openclaw gateway DISCORD_BOT_TOKEN=... ``` - Düz metin `token` değerleri desteklenir. SecretRef değerleri de `channels.discord.token` için env/file/exec sağlayıcıları genelinde desteklenir. Bkz. [Secrets Management](/tr/gateway/secrets). + Düz metin `token` değerleri desteklenir. `channels.discord.token` için env/file/exec sağlayıcılarında SecretRef değerleri de desteklenir. Bkz. [Secrets Management](/tr/gateway/secrets). - - Gateway çalışana kadar bekleyin, ardından Discord'da botunuza DM gönderin. Bot bir eşleme koduyla yanıt verecektir. + + Ağ geçidi çalışana kadar bekleyin, ardından Discord'da botunuza DM gönderin. Size bir eşleştirme koduyla yanıt verecektir. - Eşleme kodunu mevcut kanalınızda ajanınıza gönderin: + Eşleştirme kodunu mevcut kanalınızdaki ajanınıza gönderin: - > "Bu Discord eşleme kodunu onayla: ``" + > "Bu Discord eşleştirme kodunu onayla: ``" @@ -172,7 +172,7 @@ openclaw pairing approve discord - Eşleme kodlarının süresi 1 saat sonra dolar. + Eşleştirme kodlarının süresi 1 saat sonra dolar. Artık Discord'da ajanınızla DM üzerinden sohbet edebilmelisiniz. @@ -180,23 +180,23 @@ openclaw pairing approve discord -Token çözümlemesi hesap farkındalığına sahiptir. Yapılandırmadaki token değerleri env fallback'e üstün gelir. `DISCORD_BOT_TOKEN` yalnızca varsayılan hesap için kullanılır. -Gelişmiş giden çağrılarda (mesaj aracı/kanal işlemleri), açık bir çağrı başına `token` değeri o çağrı için kullanılır. Bu, gönderme ve okuma/probe tarzı işlemler için geçerlidir (örneğin read/search/fetch/thread/pins/permissions). Hesap ilkesi/yeniden deneme ayarları ise etkin çalışma zamanı anlık görüntüsünde seçili hesaptan gelmeye devam eder. +Token çözümlemesi hesap farkındalığına sahiptir. Config içindeki token değerleri env fallback değerlerinin önüne geçer. `DISCORD_BOT_TOKEN` yalnızca varsayılan hesap için kullanılır. +Gelişmiş giden çağrılar için (message tool/channel actions), açık bir çağrı başına `token` o çağrı için kullanılır. Bu, gönderme ve okuma/probe tarzı eylemler için geçerlidir (örneğin read/search/fetch/thread/pins/permissions). Hesap politikası/yeniden deneme ayarları ise yine etkin çalışma zamanı anlık görüntüsünde seçilen hesaptan gelir. ## Önerilen: Bir sunucu çalışma alanı kurun -DM'ler çalıştıktan sonra, Discord sunucunuzu tam bir çalışma alanı olarak kurabilirsiniz; burada her kanal kendi bağlamına sahip kendi ajan oturumunu alır. Bu, yalnızca siz ve botunuzun bulunduğu özel sunucular için önerilir. +DM'ler çalıştıktan sonra, Discord sunucunuzu her kanalın kendi bağlamına sahip kendi ajan oturumunu aldığı tam bir çalışma alanı olarak ayarlayabilirsiniz. Bu, yalnızca siz ve botunuzun bulunduğu özel sunucular için önerilir. - Bu, ajanınızın yalnızca DM'lerde değil, sunucunuzdaki herhangi bir kanalda yanıt verebilmesini sağlar. + Bu, ajanınızın yalnızca DM'lerde değil, sunucunuzdaki herhangi bir kanalda yanıt vermesini sağlar. > "Discord Server ID `` değerimi sunucu izin listesine ekle" - + ```json5 { @@ -219,14 +219,14 @@ DM'ler çalıştıktan sonra, Discord sunucunuzu tam bir çalışma alanı olara - - Varsayılan olarak ajanınız sunucu kanallarında yalnızca @mention aldığında yanıt verir. Özel bir sunucu için, muhtemelen her mesaja yanıt vermesini istersiniz. + + Varsayılan olarak ajanınız sunucu kanallarında yalnızca @mention yapıldığında yanıt verir. Özel bir sunucu için muhtemelen her mesaja yanıt vermesini istersiniz. - > "Ajanımın bu sunucuda @mention edilmeden yanıt verebilmesine izin ver" + > "Ajanımın bu sunucuda @mention yapılmasına gerek kalmadan yanıt vermesine izin ver" - + Sunucu yapılandırmanızda `requireMention: false` ayarlayın: ```json5 @@ -248,40 +248,40 @@ DM'ler çalıştıktan sonra, Discord sunucunuzu tam bir çalışma alanı olara - - Varsayılan olarak, uzun süreli bellek (MEMORY.md) yalnızca DM oturumlarında yüklenir. Sunucu kanalları MEMORY.md'yi otomatik yüklemez. + + Varsayılan olarak uzun vadeli bellek (MEMORY.md) yalnızca DM oturumlarında yüklenir. Sunucu kanalları MEMORY.md'yi otomatik olarak yüklemez. - > "Discord kanallarında soru sorduğumda, MEMORY.md'den uzun süreli bağlam gerekirse memory_search veya memory_get kullan." + > "Discord kanallarında soru sorduğumda, MEMORY.md içindeki uzun vadeli bağlama ihtiyaç duyarsan memory_search veya memory_get kullan." - - Her kanalda ortak bağlama ihtiyacınız varsa, sabit yönergeleri `AGENTS.md` veya `USER.md` içine koyun (bunlar her oturuma enjekte edilir). Uzun süreli notları `MEMORY.md` içinde tutun ve gerektiğinde bellek araçlarıyla erişin. + + Her kanalda paylaşılan bağlama ihtiyacınız varsa, kalıcı yönergeleri `AGENTS.md` veya `USER.md` içine koyun (bunlar her oturuma enjekte edilir). Uzun vadeli notları `MEMORY.md` içinde tutun ve gerektiğinde memory araçlarıyla erişin. -Şimdi Discord sunucunuzda bazı kanallar oluşturun ve sohbet etmeye başlayın. Ajanınız kanal adını görebilir ve her kanal kendi yalıtılmış oturumunu alır — böylece `#coding`, `#home`, `#research` veya iş akışınıza uyan başka kanallar kurabilirsiniz. +Şimdi Discord sunucunuzda birkaç kanal oluşturun ve sohbete başlayın. Ajanınız kanal adını görebilir ve her kanal kendi yalıtılmış oturumunu alır — böylece `#coding`, `#home`, `#research` veya iş akışınıza uyan her neyse onları kurabilirsiniz. ## Çalışma zamanı modeli -- Gateway, Discord bağlantısını sahiplenir. -- Yanıt yönlendirmesi belirleyicidir: Discord'dan gelen yanıtlar tekrar Discord'a gider. +- Discord bağlantısının sahibi gateway'dir. +- Yanıt yönlendirmesi deterministiktir: Discord'dan gelen yanıtlar tekrar Discord'a gider. - Varsayılan olarak (`session.dmScope=main`), doğrudan sohbetler ajanın ana oturumunu paylaşır (`agent:main:main`). - Sunucu kanalları yalıtılmış oturum anahtarlarıdır (`agent::discord:channel:`). - Grup DM'leri varsayılan olarak yok sayılır (`channels.discord.dm.groupEnabled=false`). -- Yerel slash komutları, yönlendirilen sohbet oturumuna `CommandTargetSessionKey` taşımaya devam ederken yalıtılmış komut oturumlarında çalışır (`agent::discord:slash:`). +- Yerel slash komutları yalıtılmış komut oturumlarında çalışır (`agent::discord:slash:`), ancak yine de `CommandTargetSessionKey` değerini yönlendirilen konuşma oturumuna taşır. ## Forum kanalları Discord forum ve medya kanalları yalnızca ileti dizisi gönderilerini kabul eder. OpenClaw bunları oluşturmak için iki yolu destekler: -- İleti dizisini otomatik oluşturmak için forum üst öğesine (`channel:`) mesaj gönderin. İleti dizisi başlığı, mesajınızın boş olmayan ilk satırını kullanır. -- Bir ileti dizisini doğrudan oluşturmak için `openclaw message thread create` kullanın. Forum kanalları için `--message-id` geçmeyin. +- Bir ileti dizisini otomatik oluşturmak için forum üst öğesine (`channel:`) mesaj gönderin. İleti dizisi başlığı, mesajınızın ilk boş olmayan satırını kullanır. +- Doğrudan bir ileti dizisi oluşturmak için `openclaw message thread create` kullanın. Forum kanalları için `--message-id` geçmeyin. -Örnek: ileti dizisi oluşturmak için forum üst öğesine gönderim +Örnek: ileti dizisi oluşturmak için forum üst öğesine gönderme ```bash openclaw message send --channel discord --target channel: \ @@ -299,25 +299,25 @@ Forum üst öğeleri Discord bileşenlerini kabul etmez. Bileşenlere ihtiyacın ## Etkileşimli bileşenler -OpenClaw, ajan mesajları için Discord components v2 container desteği sunar. `components` yükü ile mesaj aracını kullanın. Etkileşim sonuçları normal gelen mesajlar olarak tekrar ajana yönlendirilir ve mevcut Discord `replyToMode` ayarlarını izler. +OpenClaw, ajan mesajları için Discord components v2 kapsayıcılarını destekler. `components` yüküyle message tool kullanın. Etkileşim sonuçları normal gelen mesajlar olarak ajana geri yönlendirilir ve mevcut Discord `replyToMode` ayarlarını izler. Desteklenen bloklar: - `text`, `section`, `separator`, `actions`, `media-gallery`, `file` -- Action row'lar en fazla 5 düğmeye veya tek bir seçim menüsüne izin verir +- Eylem satırları en fazla 5 düğmeye veya tek bir seçim menüsüne izin verir - Seçim türleri: `string`, `user`, `role`, `mentionable`, `channel` -Varsayılan olarak bileşenler tek kullanımlıktır. Düğmelerin, seçimlerin ve formların süreleri dolana kadar birden çok kez kullanılmasına izin vermek için `components.reusable=true` ayarlayın. +Varsayılan olarak bileşenler tek kullanımlıktır. Düğmelerin, seçimlerin ve formların süreleri dolana kadar birden fazla kez kullanılmasına izin vermek için `components.reusable=true` ayarlayın. -Bir düğmeye kimlerin tıklayabileceğini kısıtlamak için o düğmede `allowedUsers` ayarlayın (Discord kullanıcı kimlikleri, etiketler veya `*`). Yapılandırıldığında, eşleşmeyen kullanıcılar geçici bir red yanıtı alır. +Bir düğmeye kimlerin tıklayabileceğini kısıtlamak için o düğmede `allowedUsers` ayarlayın (Discord kullanıcı kimlikleri, etiketler veya `*`). Yapılandırıldığında, eşleşmeyen kullanıcılar geçici bir ret alır. -`/model` ve `/models` slash komutları, sağlayıcı ve model açılır menülerinin yanı sıra bir Submit adımı içeren etkileşimli bir model seçici açar. Seçici yanıtı geçicidir ve yalnızca komutu çağıran kullanıcı bunu kullanabilir. +`/model` ve `/models` slash komutları, sağlayıcı ve model açılır menülerinin yanı sıra bir Submit adımı içeren etkileşimli bir model seçiciyi açar. Seçici yanıtı ephemeral olur ve yalnızca komutu çağıran kullanıcı bunu kullanabilir. Dosya ekleri: -- `file` blokları bir ek referansını göstermelidir (`attachment://`) -- Eki `media`/`path`/`filePath` ile sağlayın (tek dosya); birden fazla dosya için `media-gallery` kullanın -- Yükleme adının ek referansıyla eşleşmesi gerektiğinde bunu geçersiz kılmak için `filename` kullanın +- `file` blokları bir ek başvurusuna işaret etmelidir (`attachment://`) +- Eki `media`/`path`/`filePath` ile sağlayın (tek dosya); birden çok dosya için `media-gallery` kullanın +- Yükleme adının ek başvurusu ile eşleşmesi gerektiğinde bunu geçersiz kılmak için `filename` kullanın Modal formlar: @@ -332,45 +332,45 @@ Modal formlar: channel: "discord", action: "send", to: "channel:123456789012345678", - message: "Optional fallback text", + message: "İsteğe bağlı fallback metni", components: { reusable: true, - text: "Choose a path", + text: "Bir yol seçin", blocks: [ { type: "actions", buttons: [ { - label: "Approve", + label: "Onayla", style: "success", allowedUsers: ["123456789012345678"], }, - { label: "Decline", style: "danger" }, + { label: "Reddet", style: "danger" }, ], }, { type: "actions", select: { type: "string", - placeholder: "Pick an option", + placeholder: "Bir seçenek seçin", options: [ - { label: "Option A", value: "a" }, - { label: "Option B", value: "b" }, + { label: "Seçenek A", value: "a" }, + { label: "Seçenek B", value: "b" }, ], }, }, ], modal: { - title: "Details", - triggerLabel: "Open form", + title: "Ayrıntılar", + triggerLabel: "Formu aç", fields: [ - { type: "text", label: "Requester" }, + { type: "text", label: "Talep eden" }, { type: "select", - label: "Priority", + label: "Öncelik", options: [ - { label: "Low", value: "low" }, - { label: "High", value: "high" }, + { label: "Düşük", value: "low" }, + { label: "Yüksek", value: "high" }, ], }, ], @@ -383,19 +383,19 @@ Modal formlar: - `channels.discord.dmPolicy`, DM erişimini denetler (eski: `channels.discord.dm.policy`): + `channels.discord.dmPolicy` DM erişimini denetler (eski: `channels.discord.dm.policy`): - `pairing` (varsayılan) - `allowlist` - - `open` (`channels.discord.allowFrom` içine `"*"` eklenmesini gerektirir; eski: `channels.discord.dm.allowFrom`) + - `open` (`channels.discord.allowFrom` içinde `"*"` bulunmasını gerektirir; eski: `channels.discord.dm.allowFrom`) - `disabled` - DM ilkesi açık değilse, bilinmeyen kullanıcılar engellenir (veya `pairing` modunda eşleme istenir). + DM ilkesi açık değilse, bilinmeyen kullanıcılar engellenir (veya `pairing` modunda eşleştirme istenir). Çoklu hesap önceliği: - `channels.discord.accounts.default.allowFrom` yalnızca `default` hesabına uygulanır. - - Adlandırılmış hesaplar, kendi `allowFrom` değeri ayarlanmamışsa `channels.discord.allowFrom` değerini devralır. + - Adlandırılmış hesaplar, kendi `allowFrom` değerleri ayarlanmamışsa `channels.discord.allowFrom` değerini devralır. - Adlandırılmış hesaplar `channels.discord.accounts.default.allowFrom` değerini devralmaz. Teslimat için DM hedef biçimi: @@ -403,27 +403,27 @@ Modal formlar: - `user:` - `<@id>` mention - Yalın sayısal kimlikler belirsizdir ve açık bir kullanıcı/kanal hedef türü verilmedikçe reddedilir. + Düz sayısal kimlikler belirsizdir ve açık bir user/channel hedef türü sağlanmadıkça reddedilir. - Sunucu işleme, `channels.discord.groupPolicy` ile denetlenir: + Sunucu işleme `channels.discord.groupPolicy` ile denetlenir: - `open` - `allowlist` - `disabled` - `channels.discord` mevcut olduğunda güvenli taban çizgisi `allowlist`tir. + `channels.discord` mevcut olduğunda güvenli temel çizgi `allowlist` olur. `allowlist` davranışı: - sunucu `channels.discord.guilds` ile eşleşmelidir (`id` tercih edilir, slug kabul edilir) - - isteğe bağlı gönderen izin listeleri: `users` (kararlı kimlikler önerilir) ve `roles` (yalnızca rol kimlikleri); bunlardan biri yapılandırılmışsa, gönderenler `users` VEYA `roles` ile eşleştiğinde izinli sayılır - - doğrudan ad/etiket eşleştirmesi varsayılan olarak devre dışıdır; bunu yalnızca acil durum uyumluluk modu olarak etkinleştirmek için `channels.discord.dangerouslyAllowNameMatching: true` kullanın - - `users` için adlar/etiketler desteklenir, ancak kimlikler daha güvenlidir; `openclaw security audit`, ad/etiket girdileri kullanıldığında uyarı verir - - bir sunucuda `channels` yapılandırılmışsa, listelenmeyen kanallar reddedilir - - bir sunucuda `channels` bloğu yoksa, izin listesine alınmış o sunucudaki tüm kanallara izin verilir + - isteğe bağlı gönderici izin listeleri: `users` (kalıcı kimlikler önerilir) ve `roles` (yalnızca rol kimlikleri); bunlardan biri yapılandırılmışsa, göndericilere `users` VEYA `roles` ile eşleşiyorlarsa izin verilir + - doğrudan ad/etiket eşleştirmesi varsayılan olarak devre dışıdır; yalnızca acil durum uyumluluk modu olarak `channels.discord.dangerouslyAllowNameMatching: true` etkinleştirin + - `users` için adlar/etiketler desteklenir, ancak kimlikler daha güvenlidir; `openclaw security audit`, ad/etiket girdileri kullanıldığında uyarır + - bir sunucuda `channels` yapılandırılmışsa, listede olmayan kanallar reddedilir + - bir sunucuda `channels` bloğu yoksa, izin listesindeki o sunucudaki tüm kanallara izin verilir Örnek: @@ -449,21 +449,21 @@ Modal formlar: } ``` - Yalnızca `DISCORD_BOT_TOKEN` ayarlayıp bir `channels.discord` bloğu oluşturmazsanız, çalışma zamanı fallback değeri `groupPolicy="allowlist"` olur (günlüklerde bir uyarıyla), `channels.defaults.groupPolicy` değeri `open` olsa bile. + Yalnızca `DISCORD_BOT_TOKEN` ayarlayıp `channels.discord` bloğu oluşturmazsanız, çalışma zamanı fallback değeri `groupPolicy="allowlist"` olur (günlüklerde bir uyarıyla), `channels.defaults.groupPolicy` değeri `open` olsa bile. - Sunucu mesajları varsayılan olarak mention ile kapılanır. + Sunucu mesajları varsayılan olarak mention kapılıdır. - Mention algılama şunları içerir: + Mention algılaması şunları içerir: - - açık bot mention + - açık bot mention'ı - yapılandırılmış mention desenleri (`agents.list[].groupChat.mentionPatterns`, fallback `messages.groupChat.mentionPatterns`) - - desteklenen durumlarda bota dolaylı yanıt davranışı + - desteklenen durumlarda örtük bota-yanıt davranışı - `requireMention`, sunucu/kanal başına yapılandırılır (`channels.discord.guilds...`). - `ignoreOtherMentions`, bot dışında başka bir kullanıcıdan/rolden bahseden mesajları isteğe bağlı olarak düşürür (@everyone/@here hariç). + `requireMention` sunucu/kanal başına yapılandırılır (`channels.discord.guilds...`). + `ignoreOtherMentions`, başka bir kullanıcıya/role mention yapan ancak bottan bahsetmeyen mesajları isteğe bağlı olarak düşürür (@everyone/@here hariç). Grup DM'leri: @@ -475,7 +475,7 @@ Modal formlar: ### Role dayalı ajan yönlendirme -Discord sunucu üyelerini rol kimliğine göre farklı ajanlara yönlendirmek için `bindings[].match.roles` kullanın. Role dayalı bağlamalar yalnızca rol kimliklerini kabul eder ve peer veya parent-peer bağlamalarından sonra, yalnızca sunucu bağlamalarından önce değerlendirilir. Bir bağlama başka eşleşme alanları da ayarlıyorsa (örneğin `peer` + `guildId` + `roles`), yapılandırılan tüm alanlar eşleşmelidir. +Discord sunucu üyelerini rol kimliğine göre farklı ajanlara yönlendirmek için `bindings[].match.roles` kullanın. Role dayalı bağlamalar yalnızca rol kimliklerini kabul eder ve peer veya parent-peer bağlamalarından sonra, yalnızca sunucu bağlamalarından önce değerlendirilir. Bir bağlama başka eşleşme alanları da ayarlarsa (örneğin `peer` + `guildId` + `roles`), yapılandırılmış tüm alanlar eşleşmelidir. ```json5 { @@ -511,12 +511,12 @@ Discord sunucu üyelerini rol kimliğine göre farklı ajanlara yönlendirmek i - **Bot -> Privileged Gateway Intents** içinde şunları etkinleştirin: + **Bot -> Privileged Gateway Intents** bölümünde şunları etkinleştirin: - Message Content Intent - Server Members Intent (önerilir) - Presence intent isteğe bağlıdır ve yalnızca presence güncellemeleri almak istiyorsanız gerekir. Bot presence ayarlamak (`setPresence`) üyeler için presence güncellemelerini etkinleştirmeyi gerektirmez. + Presence intent isteğe bağlıdır ve yalnızca varlık güncellemelerini almak istiyorsanız gereklidir. Bot varlığını ayarlamak (`setPresence`) üyeler için varlık güncellemelerini etkinleştirmeyi gerektirmez. @@ -534,7 +534,7 @@ Discord sunucu üyelerini rol kimliğine göre farklı ajanlara yönlendirmek i - Attach Files - Add Reactions (isteğe bağlı) - Açıkça gerekli değilse `Administrator` kullanmayın. + Açıkça gerekmedikçe `Administrator` kullanmaktan kaçının. @@ -545,20 +545,20 @@ Discord sunucu üyelerini rol kimliğine göre farklı ajanlara yönlendirmek i - kanal kimliği - kullanıcı kimliği - Güvenilir denetimler ve probelar için OpenClaw yapılandırmasında sayısal kimlikleri tercih edin. + Güvenilir denetimler ve probe'lar için OpenClaw config içinde sayısal kimlikleri tercih edin. ## Yerel komutlar ve komut kimlik doğrulaması -- `commands.native` varsayılan olarak `"auto"` değerini alır ve Discord için etkindir. +- `commands.native` varsayılan olarak `"auto"` değerindedir ve Discord için etkindir. - Kanal başına geçersiz kılma: `channels.discord.commands.native`. -- `commands.native=false`, daha önce kaydedilmiş Discord yerel komutlarını açıkça temizler. -- Yerel komut kimlik doğrulaması, normal mesaj işlemenin kullandığı aynı Discord izin listelerini/ilkelerini kullanır. -- Komutlar yetkisiz kullanıcılar için Discord arayüzünde hâlâ görünebilir; ancak yürütme OpenClaw yetkilendirmesini yine de uygular ve "not authorized" döndürür. +- `commands.native=false`, önceden kaydedilmiş Discord yerel komutlarını açıkça temizler. +- Yerel komut kimlik doğrulaması, normal mesaj işlemeyle aynı Discord izin listelerini/ilkelerini kullanır. +- Komutlar, yetkili olmayan kullanıcılar için Discord arayüzünde yine de görünür olabilir; yürütme yine de OpenClaw kimlik doğrulamasını uygular ve "not authorized" döndürür. -Komut kataloğu ve davranış için [Slash commands](/tr/tools/slash-commands) bölümüne bakın. +Komut kataloğu ve davranış için bkz. [Slash commands](/tr/tools/slash-commands). Varsayılan slash komut ayarları: @@ -580,26 +580,26 @@ Varsayılan slash komut ayarları: - `all` - `batched` - Not: `off`, dolaylı yanıt zincirlemeyi devre dışı bırakır. Açık `[[reply_to_*]]` etiketleri yine de dikkate alınır. - `first`, turdaki ilk giden Discord mesajına dolaylı yerel yanıt referansını her zaman ekler. - `batched`, Discord'un dolaylı yerel yanıt referansını yalnızca - gelen turun birden çok mesajdan oluşan debounce edilmiş bir toplu işlem olduğu durumda ekler. Bu, - yerel yanıtları çoğunlukla belirsiz, patlamalı sohbetler için isteyip her - tek mesajlı tur için istemediğiniz durumlarda faydalıdır. + Not: `off`, örtük yanıt ileti dizilemesini devre dışı bırakır. Açık `[[reply_to_*]]` etiketlerine yine de uyulur. + `first`, tur için ilk giden Discord mesajına örtük yerel yanıt başvurusunu her zaman ekler. + `batched`, Discord'un örtük yerel yanıt başvurusunu yalnızca + gelen turun birden çok mesajdan oluşan gecikmeli bir toplu işlem olduğu durumda ekler. Bu, + yerel yanıtları çoğunlukla belirsiz ve patlamalı sohbetlerde istemeniz, her + tek mesajlık turda istememeniz durumunda faydalıdır. - Mesaj kimlikleri bağlamda/geçmişte görünür, böylece ajanlar belirli mesajları hedefleyebilir. + Mesaj kimlikleri bağlam/geçmiş içinde görünür, böylece ajanlar belirli mesajları hedefleyebilir. - OpenClaw, geçici bir mesaj gönderip metin geldikçe bunu düzenleyerek taslak yanıtları akıtabilir. + OpenClaw, geçici bir mesaj gönderip metin geldikçe düzenleyerek taslak yanıtları akış halinde verebilir. - - `channels.discord.streaming`, önizleme akışını denetler (`off` | `partial` | `block` | `progress`, varsayılan: `off`). - - Varsayılan değer `off` olarak kalır; çünkü Discord önizleme düzenlemeleri, özellikle aynı hesabı veya sunucu trafiğini birden fazla bot ya da gateway paylaşıyorsa hızla oran sınırlarına takılabilir. - - `progress`, kanallar arası tutarlılık için kabul edilir ve Discord'da `partial` ile eşlenir. - - `channels.discord.streamMode` eski bir takma addır ve otomatik olarak geçirilir. + - `channels.discord.streaming` önizleme akışını denetler (`off` | `partial` | `block` | `progress`, varsayılan: `off`). + - Varsayılan `off` olarak kalır çünkü Discord önizleme düzenlemeleri özellikle aynı hesap veya sunucu trafiğini birden çok bot ya da gateway paylaştığında hızla rate limit'e takılabilir. + - `progress`, kanallar arası tutarlılık için kabul edilir ve Discord'da `partial` değerine eşlenir. + - `channels.discord.streamMode` eski bir takma addır ve otomatik olarak taşınır. - `partial`, token'lar geldikçe tek bir önizleme mesajını düzenler. - - `block`, taslak boyutunda parçalar yayımlar (boyutu ve kesme noktalarını ayarlamak için `draftChunk` kullanın). + - `block`, taslak boyutunda parçalar üretir (boyutu ve bölünme noktalarını ayarlamak için `draftChunk` kullanın). Örnek: @@ -630,21 +630,21 @@ Varsayılan slash komut ayarları: } ``` - Önizleme akışı yalnızca metin içindir; medya yanıtları normal teslimata geri döner. + Önizleme akışı yalnızca metin içindir; medya yanıtları normal teslimata fallback yapar. Not: önizleme akışı, blok akışından ayrıdır. Discord için blok akışı açıkça - etkinleştirildiğinde OpenClaw, çift akışı önlemek için önizleme akışını atlar. + etkinleştirildiğinde, OpenClaw çift akıştan kaçınmak için önizleme akışını atlar. - Sunucu geçmişi bağlamı: + Sunucu geçmiş bağlamı: - `channels.discord.historyLimit` varsayılan `20` - fallback: `messages.groupChat.historyLimit` - `0` devre dışı bırakır - DM geçmişi denetimleri: + DM geçmiş denetimleri: - `channels.discord.dmHistoryLimit` - `channels.discord.dms[""].historyLimit` @@ -652,27 +652,27 @@ Varsayılan slash komut ayarları: İleti dizisi davranışı: - Discord ileti dizileri kanal oturumları olarak yönlendirilir - - üst ileti dizisi meta verileri üst oturum bağlantısı için kullanılabilir - - ileti dizisi yapılandırması, ileti dizisine özel bir girdi yoksa üst kanal yapılandırmasını devralır + - üst ileti dizisi meta verileri, üst-oturum bağlantısı için kullanılabilir + - ileti dizisine özgü bir girdi yoksa ileti dizisi config'i üst kanal config'ini devralır - Kanal konuları **güvenilmeyen** bağlam olarak enjekte edilir (sistem istemi olarak değil). - Yanıt ve alıntılanmış mesaj bağlamı şu anda alındığı gibi kalır. - Discord izin listeleri öncelikle ajanın kim tarafından tetiklenebileceğini kapılar; bu tam bir ek bağlam redaksiyon sınırı değildir. + Kanal konuları **güvenilmeyen** bağlam olarak enjekte edilir (system prompt olarak değil). + Yanıt ve alıntılanan mesaj bağlamı şu anda alındığı gibi kalır. + Discord izin listeleri öncelikle ajanın kim tarafından tetiklenebileceğini denetler, tam bir ek-bağlam redaksiyon sınırı değildir. - Discord, bir ileti dizisini bir oturum hedefine bağlayabilir; böylece o ileti dizisindeki sonraki mesajlar aynı oturuma yönlendirilmeye devam eder (alt ajan oturumları dahil). + Discord, bir ileti dizisini oturum hedefine bağlayabilir; böylece o ileti dizisindeki takip mesajları aynı oturuma yönlenmeye devam eder (alt ajan oturumları dahil). Komutlar: - `/focus ` geçerli/yeni ileti dizisini bir alt ajan/oturum hedefine bağla - - `/unfocus` geçerli ileti dizisi bağlamasını kaldır - - `/agents` etkin çalıştırmaları ve bağlama durumunu göster - - `/session idle ` odaklı bağlamalar için etkin olmama durumunda otomatik odak kaldırmayı incele/güncelle - - `/session max-age ` odaklı bağlamalar için kesin azami yaşı incele/güncelle + - `/unfocus` geçerli ileti dizisi bağını kaldır + - `/agents` etkin çalıştırmaları ve bağlanma durumunu göster + - `/session idle ` odaklı bağlamalar için hareketsizlikte otomatik odak kaldırmayı incele/güncelle + - `/session max-age ` odaklı bağlamalar için katı azami yaşı incele/güncelle - Yapılandırma: + Config: ```json5 { @@ -689,7 +689,7 @@ Varsayılan slash komut ayarları: enabled: true, idleHours: 24, maxAgeHours: 0, - spawnSubagentSessions: false, // isteğe bağlı etkinleştirme + spawnSubagentSessions: false, // isteğe bağlı olarak açılır }, }, }, @@ -699,19 +699,19 @@ Varsayılan slash komut ayarları: Notlar: - `session.threadBindings.*` genel varsayılanları ayarlar. - - `channels.discord.threadBindings.*`, Discord davranışını geçersiz kılar. - - `spawnSubagentSessions`, `sessions_spawn({ thread: true })` için ileti dizilerini otomatik oluşturup bağlamak üzere true olmalıdır. - - `spawnAcpSessions`, ACP için ileti dizilerini otomatik oluşturup bağlamak üzere true olmalıdır (`/acp spawn ... --thread ...` veya `sessions_spawn({ runtime: "acp", thread: true })`). - - Bir hesap için ileti dizisi bağlamaları devre dışıysa `/focus` ve ilgili ileti dizisi bağlama işlemleri kullanılamaz. + - `channels.discord.threadBindings.*` Discord davranışını geçersiz kılar. + - `sessions_spawn({ thread: true })` için ileti dizilerini otomatik oluşturmak/bağlamak üzere `spawnSubagentSessions` true olmalıdır. + - ACP için ileti dizilerini otomatik oluşturmak/bağlamak üzere `spawnAcpSessions` true olmalıdır (`/acp spawn ... --thread ...` veya `sessions_spawn({ runtime: "acp", thread: true })`). + - Bir hesap için ileti dizisi bağlamaları devre dışıysa, `/focus` ve ilgili ileti dizisi bağlama işlemleri kullanılamaz. Bkz. [Sub-agents](/tr/tools/subagents), [ACP Agents](/tr/tools/acp-agents) ve [Configuration Reference](/tr/gateway/configuration-reference). - Kararlı "her zaman açık" ACP çalışma alanları için, Discord sohbetlerini hedefleyen üst düzey türlenmiş ACP bağlamaları yapılandırın. + Kararlı, "her zaman açık" ACP çalışma alanları için Discord konuşmalarını hedefleyen üst düzey türlenmiş ACP bağlamaları yapılandırın. - Yapılandırma yolu: + Config yolu: - `type: "acp"` ve `match.channel: "discord"` ile `bindings[]` @@ -765,15 +765,15 @@ Varsayılan slash komut ayarları: Notlar: - - `/acp spawn codex --bind here`, geçerli Discord kanalını veya ileti dizisini yerinde bağlar ve gelecekteki mesajların aynı ACP oturumuna yönlendirilmesini sağlar. + - `/acp spawn codex --bind here`, mevcut Discord kanalını veya ileti dizisini yerinde bağlar ve gelecekteki mesajların aynı ACP oturumuna yönlenmesini sağlar. - Bu yine de "yeni bir Codex ACP oturumu başlat" anlamına gelebilir, ancak kendi başına yeni bir Discord ileti dizisi oluşturmaz. Mevcut kanal sohbet yüzeyi olarak kalır. - - Codex yine de disk üzerindeki kendi `cwd` veya backend çalışma alanında çalışabilir. Bu çalışma alanı Discord ileti dizisi değil, çalışma zamanı durumudur. - - İleti dizisi mesajları üst kanal ACP bağlamasını devralabilir. + - Codex yine de diskte kendi `cwd` veya backend çalışma alanında çalışabilir. Bu çalışma alanı Discord ileti dizisi değil, çalışma zamanı durumudur. + - İleti dizisi mesajları üst kanal ACP bağını devralabilir. - Bağlı bir kanal veya ileti dizisinde `/new` ve `/reset`, aynı ACP oturumunu yerinde sıfırlar. - - Geçici ileti dizisi bağlamaları hâlâ çalışır ve etkin olduklarında hedef çözümlemeyi geçersiz kılabilir. - - `spawnAcpSessions`, yalnızca OpenClaw'ın `--thread auto|here` üzerinden bir alt ileti dizisi oluşturup bağlaması gerektiğinde zorunludur. Geçerli kanaldaki `/acp spawn ... --bind here` için gerekli değildir. + - Geçici ileti dizisi bağlamaları yine çalışır ve etkinken hedef çözümlemesini geçersiz kılabilir. + - `spawnAcpSessions`, yalnızca OpenClaw'ın `--thread auto|here` üzerinden bir alt ileti dizisini oluşturması/bağlaması gerektiğinde gerekir. Mevcut kanalda `/acp spawn ... --bind here` için gerekli değildir. - Bağlama davranışı ayrıntıları için [ACP Agents](/tr/tools/acp-agents) bölümüne bakın. + Bağlama davranışı ayrıntıları için bkz. [ACP Agents](/tr/tools/acp-agents). @@ -785,11 +785,11 @@ Varsayılan slash komut ayarları: - `all` - `allowlist` (`guilds..users` kullanır) - Tepki olayları sistem olaylarına dönüştürülür ve yönlendirilen Discord oturumuna eklenir. + Tepki olayları system event'lere dönüştürülür ve yönlendirilen Discord oturumuna eklenir. - + `ackReaction`, OpenClaw gelen bir mesajı işlerken bir onay emojisi gönderir. Çözümleme sırası: @@ -797,7 +797,7 @@ Varsayılan slash komut ayarları: - `channels.discord.accounts..ackReaction` - `channels.discord.ackReaction` - `messages.ackReaction` - - ajan kimliği emoji fallback'i (`agents.list[].identity.emoji`, aksi hâlde "👀") + - ajan kimlik emojisi fallback'i (`agents.list[].identity.emoji`, yoksa "👀") Notlar: @@ -806,8 +806,8 @@ Varsayılan slash komut ayarları: - - Kanal tarafından başlatılan yapılandırma yazımları varsayılan olarak etkindir. + + Kanal tarafından başlatılan config yazımları varsayılan olarak etkindir. Bu, `/config set|unset` akışlarını etkiler (komut özellikleri etkin olduğunda). @@ -826,7 +826,7 @@ Varsayılan slash komut ayarları: - `channels.discord.proxy` ile Discord gateway WebSocket trafiğini ve başlangıç REST aramalarını (uygulama kimliği + izin listesi çözümleme) bir HTTP(S) proxy üzerinden yönlendirin. + Discord gateway WebSocket trafiğini ve başlangıç REST aramalarını (uygulama kimliği + izin listesi çözümlemesi) `channels.discord.proxy` ile bir HTTP(S) proxy üzerinden yönlendirin. ```json5 { @@ -857,7 +857,7 @@ Varsayılan slash komut ayarları: - Proxy edilen mesajları sistem üyesi kimliğine eşlemek için PluralKit çözümlemesini etkinleştirin: + Proxy'lenen mesajları sistem üyesi kimliğine eşlemek için PluralKit çözümlemesini etkinleştirin: ```json5 { @@ -877,7 +877,7 @@ Varsayılan slash komut ayarları: - izin listeleri `pk:` kullanabilir - üye görünen adları yalnızca `channels.discord.dangerouslyAllowNameMatching: true` olduğunda ad/slug ile eşleştirilir - aramalar özgün mesaj kimliğini kullanır ve zaman penceresiyle sınırlıdır - - arama başarısız olursa, proxy edilen mesajlar bot mesajı olarak değerlendirilir ve `allowBots=true` olmadıkça düşürülür + - arama başarısız olursa, proxy'lenen mesajlar bot mesajı olarak kabul edilir ve `allowBots=true` olmadığı sürece düşürülür @@ -902,20 +902,20 @@ Varsayılan slash komut ayarları: { channels: { discord: { - activity: "Focus time", + activity: "Odak zamanı", activityType: 4, }, }, } ``` - Streaming örneği: + Akış örneği: ```json5 { channels: { discord: { - activity: "Live coding", + activity: "Canlı kodlama", activityType: 1, activityUrl: "https://twitch.tv/openclaw", }, @@ -942,67 +942,65 @@ Varsayılan slash komut ayarları: enabled: true, intervalMs: 30000, minUpdateIntervalMs: 15000, - exhaustedText: "token exhausted", + exhaustedText: "token tükendi", }, }, }, } ``` - Otomatik presence, çalışma zamanı kullanılabilirliğini Discord durumuna eşler: sağlıklı => online, bozulmuş veya bilinmeyen => idle, tükenmiş veya kullanılamaz => dnd. İsteğe bağlı metin geçersiz kılmaları: + Otomatik presence, çalışma zamanı kullanılabilirliğini Discord durumuna eşler: sağlıklı => online, bozulmuş veya bilinmiyor => idle, tükenmiş veya kullanılamıyor => dnd. İsteğe bağlı metin geçersiz kılmaları: - `autoPresence.healthyText` - `autoPresence.degradedText` - - `autoPresence.exhaustedText` (`{reason}` yer tutucusunu destekler) + - `autoPresence.exhaustedText` (`{reason}` placeholder'ını destekler) - - Discord, DM'lerde düğme tabanlı onay işlemeyi destekler ve isteğe bağlı olarak onay istemlerini kaynak kanalda paylaşabilir. + + Discord, DM'lerde düğme tabanlı onay işlemeyi destekler ve isteğe bağlı olarak onay istemlerini kaynak kanalda yayımlayabilir. - Yapılandırma yolu: + Config yolu: - `channels.discord.execApprovals.enabled` - `channels.discord.execApprovals.approvers` (isteğe bağlı; mümkün olduğunda `commands.ownerAllowFrom` değerine fallback yapar) - `channels.discord.execApprovals.target` (`dm` | `channel` | `both`, varsayılan: `dm`) - `agentFilter`, `sessionFilter`, `cleanupAfterResolve` - Discord, `enabled` ayarlanmamışsa veya `"auto"` ise ve en az bir onaylayıcı çözümlenebiliyorsa yerel exec onaylarını otomatik etkinleştirir; bu çözümleme ya `execApprovals.approvers` üzerinden ya da `commands.ownerAllowFrom` üzerinden olabilir. Discord, kanal `allowFrom`, eski `dm.allowFrom` veya doğrudan mesaj `defaultTo` değerlerinden exec onaylayıcıları türetmez. Discord'u yerel onay istemcisi olarak açıkça devre dışı bırakmak için `enabled: false` ayarlayın. + Discord, `enabled` ayarlanmamış veya `"auto"` olduğunda ve en az bir onaylayıcı çözümlenebildiğinde yerel exec onaylarını otomatik etkinleştirir; bu ya `execApprovals.approvers` içinden ya da `commands.ownerAllowFrom` içinden olabilir. Discord, exec onaylayıcılarını kanal `allowFrom`, eski `dm.allowFrom` veya doğrudan mesaj `defaultTo` değerinden çıkarmaz. Discord'u yerel onay istemcisi olarak açıkça devre dışı bırakmak için `enabled: false` ayarlayın. - `target` değeri `channel` veya `both` olduğunda, onay istemi kanalda görünür. Yalnızca çözümlenmiş onaylayıcılar düğmeleri kullanabilir; diğer kullanıcılar geçici bir red yanıtı alır. Onay istemleri komut metnini içerir; bu nedenle kanal teslimatını yalnızca güvenilen kanallarda etkinleştirin. Kanal kimliği oturum anahtarından türetilemezse OpenClaw DM teslimatına fallback yapar. + `target` değeri `channel` veya `both` olduğunda onay istemi kanalda görünür olur. Düğmeleri yalnızca çözümlenmiş onaylayıcılar kullanabilir; diğer kullanıcılar ephemeral bir ret alır. Onay istemleri komut metnini içerir, bu nedenle kanal teslimatını yalnızca güvenilen kanallarda etkinleştirin. Kanal kimliği oturum anahtarından türetilemezse OpenClaw DM teslimatına fallback yapar. - Discord ayrıca diğer sohbet kanallarının kullandığı paylaşılan onay düğmelerini de işler. Yerel Discord adaptörü esas olarak onaylayıcı DM yönlendirmesi ve kanal fanout ekler. - Bu düğmeler mevcut olduğunda, bunlar birincil onay UX'idir; OpenClaw - yalnızca araç sonucu sohbet onaylarının kullanılamadığını veya manuel - onayın tek yol olduğunu söylüyorsa manuel bir `/approve` komutu içermelidir. + Discord ayrıca diğer sohbet kanallarının kullandığı ortak onay düğmelerini de işler. Yerel Discord bağdaştırıcısı esas olarak onaylayıcı DM yönlendirmesi ve kanal yayılımı ekler. + Bu düğmeler mevcut olduğunda birincil onay UX'i onlardır; OpenClaw + yalnızca araç sonucu sohbet onaylarının kullanılamadığını söylediğinde veya + tek yol manuel onaysa elle `/approve` komutu eklemelidir. - Bu işleyici için Gateway kimlik doğrulaması, diğer Gateway istemcileriyle aynı paylaşılan kimlik bilgisi çözümleme sözleşmesini kullanır: + Bu işleyici için gateway kimlik doğrulaması, diğer Gateway istemcileriyle aynı paylaşılan kimlik bilgisi çözümleme sözleşmesini kullanır: - - env öncelikli yerel kimlik doğrulama (`OPENCLAW_GATEWAY_TOKEN` / `OPENCLAW_GATEWAY_PASSWORD`, ardından `gateway.auth.*`) - - yerel modda, `gateway.auth.*` ayarlanmamışsa `gateway.remote.*` yalnızca fallback olarak kullanılabilir; yapılandırılmış ancak çözümlenmemiş yerel SecretRef değerleri kapalı başarısız olur - - uygun olduğunda `gateway.remote.*` üzerinden uzak mod desteği - - URL geçersiz kılmaları güvenli geçersiz kılma mantığına sahiptir: CLI geçersiz kılmaları dolaylı kimlik bilgilerini yeniden kullanmaz ve env geçersiz kılmaları yalnızca env kimlik bilgilerini kullanır + - env-öncelikli yerel kimlik doğrulama (`OPENCLAW_GATEWAY_TOKEN` / `OPENCLAW_GATEWAY_PASSWORD`, ardından `gateway.auth.*`) + - yerel modda, `gateway.auth.*` ayarlanmamışsa `gateway.remote.*` yalnızca fallback olarak kullanılabilir; yapılandırılmış ancak çözümlenmemiş yerel SecretRef'ler fail closed olur + - uygulanabildiğinde `gateway.remote.*` ile uzaktan mod desteği + - URL geçersiz kılmaları override-safe'dir: CLI geçersiz kılmaları örtük kimlik bilgilerini yeniden kullanmaz ve env geçersiz kılmaları yalnızca env kimlik bilgilerini kullanır Onay çözümleme davranışı: - - `plugin:` önekli kimlikler `plugin.approval.resolve` üzerinden çözülür. + - `plugin:` öneki taşıyan kimlikler `plugin.approval.resolve` üzerinden çözülür. - Diğer kimlikler `exec.approval.resolve` üzerinden çözülür. - - Discord burada ek bir exec-to-plugin fallback sıçraması yapmaz; hangi - Gateway yönteminin çağrılacağını kimlik öneki belirler. + - Discord burada ekstra bir exec-to-plugin fallback sıçraması yapmaz; hangi gateway yöntemini çağıracağını kimlik öneki belirler. - Exec onaylarının süresi varsayılan olarak 30 dakika sonra dolar. Onaylar - bilinmeyen onay kimlikleriyle başarısız olursa onaylayıcı çözümlemesini, - özellik etkinliğini ve teslim edilen onay kimliği türünün bekleyen istekle - eşleştiğini doğrulayın. + Exec onaylarının varsayılan süresi 30 dakika sonra dolar. Onaylar + bilinmeyen onay kimlikleriyle başarısız olursa, onaylayıcı çözümlemesini, özellik etkinliğini ve + teslim edilen onay kimliği türünün bekleyen istekle eşleştiğini doğrulayın. İlgili belgeler: [Exec approvals](/tr/tools/exec-approvals) -## Araçlar ve işlem kapıları +## Araçlar ve eylem kapıları -Discord mesaj işlemleri mesajlaşma, kanal yönetimi, moderasyon, presence ve meta veri işlemlerini içerir. +Discord mesaj eylemleri; mesajlaşma, kanal yönetimi, moderasyon, presence ve meta veri eylemlerini içerir. Temel örnekler: @@ -1011,11 +1009,13 @@ Temel örnekler: - moderasyon: `timeout`, `kick`, `ban` - presence: `setPresence` -İşlem kapıları `channels.discord.actions.*` altında bulunur. +`event-create` eylemi, planlanan etkinlik kapak görselini ayarlamak için isteğe bağlı bir `image` parametresini (URL veya yerel dosya yolu) kabul eder. + +Eylem kapıları `channels.discord.actions.*` altında bulunur. Varsayılan kapı davranışı: -| İşlem grubu | Varsayılan | +| Eylem grubu | Varsayılan | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- | | reactions, messages, threads, pins, polls, search, memberInfo, roleInfo, channelInfo, channels, voiceStatus, events, stickers, emojiUploads, stickerUploads, permissions | etkin | | roles | devre dışı | @@ -1024,10 +1024,10 @@ Varsayılan kapı davranışı: ## Components v2 UI -OpenClaw, exec onayları ve bağlamlar arası işaretleyiciler için Discord components v2 kullanır. Discord mesaj işlemleri, özel UI için `components` de kabul edebilir (gelişmiş; discord aracı üzerinden bir bileşen yükü oluşturmayı gerektirir), ancak eski `embeds` hâlâ kullanılabilir olsa da önerilmez. +OpenClaw, exec onayları ve bağlamlar arası işaretçiler için Discord components v2 kullanır. Discord mesaj eylemleri özel UI için `components` de kabul edebilir (ileri düzey; discord tool üzerinden bir bileşen yükü oluşturmayı gerektirir), ancak eski `embeds` hâlâ kullanılabilir ve önerilmez. -- `channels.discord.ui.components.accentColor`, Discord bileşen container'ları tarafından kullanılan vurgu rengini ayarlar (hex). -- Hesap başına ayarlamak için `channels.discord.accounts..ui.components.accentColor` kullanın. +- `channels.discord.ui.components.accentColor`, Discord bileşen kapsayıcılarında kullanılan vurgu rengini ayarlar (hex). +- Hesap başına `channels.discord.accounts..ui.components.accentColor` ile ayarlayın. - components v2 mevcut olduğunda `embeds` yok sayılır. Örnek: @@ -1048,7 +1048,7 @@ OpenClaw, exec onayları ve bağlamlar arası işaretleyiciler için Discord com ## Ses kanalları -OpenClaw, gerçek zamanlı ve sürekli sohbetler için Discord ses kanallarına katılabilir. Bu, sesli mesaj eklerinden ayrıdır. +OpenClaw, gerçek zamanlı ve sürekli konuşmalar için Discord ses kanallarına katılabilir. Bu, sesli mesaj eklerinden ayrıdır. Gereksinimler: @@ -1056,7 +1056,7 @@ Gereksinimler: - `channels.discord.voice` yapılandırın. - Botun hedef ses kanalında Connect + Speak izinlerine ihtiyacı vardır. -Oturumları denetlemek için yalnızca Discord'a özgü `/vc join|leave|status` yerel komutunu kullanın. Komut, hesabın varsayılan ajanını kullanır ve diğer Discord komutlarıyla aynı izin listesi ve grup ilkesi kurallarını izler. +Oturumları denetlemek için yalnızca Discord'a özel yerel `/vc join|leave|status` komutunu kullanın. Komut, hesabın varsayılan ajanını kullanır ve diğer Discord komutlarıyla aynı izin listesi ve sunucu ilkesi kurallarını izler. Otomatik katılma örneği: @@ -1086,23 +1086,23 @@ Otomatik katılma örneği: Notlar: -- `voice.tts`, yalnızca ses oynatma için `messages.tts` değerini geçersiz kılar. -- Ses transkript turları, sahip durumunu Discord `allowFrom` (veya `dm.allowFrom`) üzerinden türetir; sahip olmayan konuşmacılar yalnızca sahip araçlarına erişemez (örneğin `gateway` ve `cron`). +- `voice.tts`, yalnızca ses oynatımı için `messages.tts` değerini geçersiz kılar. +- Ses transkript turları, sahip durumunu Discord `allowFrom` (veya `dm.allowFrom`) üzerinden türetir; sahip olmayan konuşmacılar yalnızca sahibin kullanabildiği araçlara erişemez (örneğin `gateway` ve `cron`). - Ses varsayılan olarak etkindir; devre dışı bırakmak için `channels.discord.voice.enabled=false` ayarlayın. -- `voice.daveEncryption` ve `voice.decryptionFailureTolerance`, `@discordjs/voice` katılma seçeneklerine olduğu gibi geçirilir. -- Ayarlanmamışsa `@discordjs/voice` varsayılanları `daveEncryption=true` ve `decryptionFailureTolerance=24` olur. -- OpenClaw ayrıca alma şifre çözme başarısızlıklarını izler ve kısa bir pencerede tekrarlanan başarısızlıklardan sonra ses kanalından ayrılıp yeniden katılarak otomatik toparlanır. -- Alma günlüklerinde tekrar tekrar `DecryptionFailed(UnencryptedWhenPassthroughDisabled)` görünüyorsa, bu [discord.js #11419](https://github.com/discordjs/discord.js/issues/11419) içinde izlenen yukarı akış `@discordjs/voice` alma hatası olabilir. +- `voice.daveEncryption` ve `voice.decryptionFailureTolerance`, `@discordjs/voice` katılma seçeneklerine olduğu gibi aktarılır. +- `@discordjs/voice` varsayılanları, ayarlanmamışsa `daveEncryption=true` ve `decryptionFailureTolerance=24` değerleridir. +- OpenClaw ayrıca alma tarafındaki şifre çözme hatalarını izler ve kısa bir zaman penceresinde yinelenen hatalardan sonra ses kanalından ayrılıp yeniden katılarak otomatik kurtarma yapar. +- Alma günlükleri tekrar tekrar `DecryptionFailed(UnencryptedWhenPassthroughDisabled)` gösteriyorsa, bu [discord.js #11419](https://github.com/discordjs/discord.js/issues/11419) içinde izlenen yukarı akış `@discordjs/voice` alma hatası olabilir. ## Sesli mesajlar -Discord sesli mesajları bir dalga formu önizlemesi gösterir ve OGG/Opus ses ile meta veri gerektirir. OpenClaw dalga formunu otomatik oluşturur, ancak ses dosyalarını incelemek ve dönüştürmek için gateway ana makinesinde `ffmpeg` ve `ffprobe` erişilebilir olmalıdır. +Discord sesli mesajları bir dalga biçimi önizlemesi gösterir ve OGG/Opus ses ile meta veri gerektirir. OpenClaw dalga biçimini otomatik olarak üretir, ancak ses dosyalarını incelemek ve dönüştürmek için gateway ana makinesinde `ffmpeg` ve `ffprobe` erişilebilir olmalıdır. -Gereksinimler ve kısıtlamalar: +Gereksinimler ve kısıtlar: - Bir **yerel dosya yolu** sağlayın (URL'ler reddedilir). -- Metin içeriğini atlayın (Discord, aynı yükte metin + sesli mesaja izin vermez). -- Herhangi bir ses biçimi kabul edilir; OpenClaw gerektiğinde bunu OGG/Opus'a dönüştürür. +- Metin içeriğini atlayın (Discord aynı yükte metin + sesli mesaja izin vermez). +- Her türlü ses biçimi kabul edilir; gerektiğinde OpenClaw bunu OGG/Opus'a dönüştürür. Örnek: @@ -1125,7 +1125,7 @@ message(action="send", channel="discord", target="channel:123", path="/path/to/a - `groupPolicy` değerini doğrulayın - `channels.discord.guilds` altındaki sunucu izin listesini doğrulayın - - sunucu `channels` haritası varsa, yalnızca listelenen kanallara izin verilir + - sunucu `channels` eşlemesi varsa, yalnızca listelenen kanallara izin verilir - `requireMention` davranışını ve mention desenlerini doğrulayın Yararlı kontroller: @@ -1138,16 +1138,16 @@ openclaw logs --follow - + Yaygın nedenler: - eşleşen sunucu/kanal izin listesi olmadan `groupPolicy="allowlist"` - `requireMention` yanlış yerde yapılandırılmış (mutlaka `channels.discord.guilds` veya kanal girdisi altında olmalıdır) - - gönderen sunucu/kanal `users` izin listesi tarafından engelleniyor + - gönderici sunucu/kanal `users` izin listesi tarafından engelleniyor - + Tipik günlükler: @@ -1160,7 +1160,7 @@ openclaw logs --follow - tek hesap: `channels.discord.eventQueue.listenerTimeout` - çoklu hesap: `channels.discord.accounts..eventQueue.listenerTimeout` - Worker çalıştırma zaman aşımı ayarı: + Worker çalışma zaman aşımı ayarı: - tek hesap: `channels.discord.inboundWorker.runTimeoutMs` - çoklu hesap: `channels.discord.accounts..inboundWorker.runTimeoutMs` @@ -1187,49 +1187,47 @@ openclaw logs --follow } ``` - Yavaş listener kurulumu için `eventQueue.listenerTimeout`, kuyruklanan ajan turları için - ayrı bir güvenlik vanası istiyorsanız ise yalnızca `inboundWorker.runTimeoutMs` - kullanın. + Yavaş listener kurulumu için `eventQueue.listenerTimeout`, kuyruklanan ajan turları için ayrı bir güvenlik supabı istiyorsanız ise yalnızca `inboundWorker.runTimeoutMs` kullanın. - - `channels status --probe` izin kontrolleri yalnızca sayısal kanal kimlikleriyle çalışır. + + `channels status --probe` izin kontrolleri yalnızca sayısal kanal kimlikleri için çalışır. - Slug anahtarları kullanırsanız çalışma zamanı eşleştirmesi yine de çalışabilir, ancak probe izinleri tam olarak doğrulayamaz. + Slug anahtarları kullanıyorsanız çalışma zamanı eşleştirmesi yine de çalışabilir, ancak probe izinleri tam olarak doğrulayamaz. - + - DM devre dışı: `channels.discord.dm.enabled=false` - DM ilkesi devre dışı: `channels.discord.dmPolicy="disabled"` (eski: `channels.discord.dm.policy`) - - `pairing` modunda eşleme onayı bekleniyor + - `pairing` modunda eşleştirme onayı bekleniyor - Varsayılan olarak bot tarafından yazılan mesajlar yok sayılır. + Varsayılan olarak bot tarafından yazılmış mesajlar yok sayılır. - `channels.discord.allowBots=true` ayarlarsanız döngü davranışını önlemek için katı mention ve izin listesi kuralları kullanın. + `channels.discord.allowBots=true` ayarlarsanız, döngü davranışını önlemek için katı mention ve izin listesi kuralları kullanın. Yalnızca bottan mention alan bot mesajlarını kabul etmek için `channels.discord.allowBots="mentions"` tercih edin. - - Discord ses alma toparlama mantığının mevcut olduğundan emin olmak için OpenClaw'ı güncel tutun (`openclaw update`) - - `channels.discord.voice.daveEncryption=true` (varsayılan) olduğunu doğrulayın - - `channels.discord.voice.decryptionFailureTolerance=24` (upstream varsayılanı) ile başlayın ve yalnızca gerekirse ayarlayın + - Discord ses alma kurtarma mantığının mevcut olduğundan emin olmak için OpenClaw'ı güncel tutun (`openclaw update`) + - `channels.discord.voice.daveEncryption=true` değerini doğrulayın (varsayılan) + - `channels.discord.voice.decryptionFailureTolerance=24` (yukarı akış varsayılanı) ile başlayın ve yalnızca gerekirse ayarlayın - günlüklerde şunları izleyin: - `discord voice: DAVE decrypt failures detected` - `discord voice: repeated decrypt failures; attempting rejoin` - - otomatik yeniden katılmadan sonra başarısızlıklar sürerse günlükleri toplayın ve [discord.js #11419](https://github.com/discordjs/discord.js/issues/11419) ile karşılaştırın + - otomatik yeniden katılmadan sonra da hatalar sürerse günlükleri toplayın ve [discord.js #11419](https://github.com/discordjs/discord.js/issues/11419) ile karşılaştırın -## Yapılandırma referansı işaretçileri +## Yapılandırma başvuru işaretçileri Birincil başvuru: @@ -1241,29 +1239,29 @@ Yüksek sinyalli Discord alanları: - ilke: `groupPolicy`, `dm.*`, `guilds.*`, `guilds.*.channels.*` - komut: `commands.native`, `commands.useAccessGroups`, `configWrites`, `slashCommand.*` - olay kuyruğu: `eventQueue.listenerTimeout` (listener bütçesi), `eventQueue.maxQueueSize`, `eventQueue.maxConcurrency` -- gelen worker: `inboundWorker.runTimeoutMs` +- inbound worker: `inboundWorker.runTimeoutMs` - yanıt/geçmiş: `replyToMode`, `historyLimit`, `dmHistoryLimit`, `dms.*.historyLimit` - teslimat: `textChunkLimit`, `chunkMode`, `maxLinesPerMessage` - akış: `streaming` (eski takma ad: `streamMode`), `draftChunk`, `blockStreaming`, `blockStreamingCoalesce` - medya/yeniden deneme: `mediaMaxMb`, `retry` - - `mediaMaxMb`, giden Discord yüklemelerini sınırlar (varsayılan: `100MB`) -- işlemler: `actions.*` + - `mediaMaxMb` giden Discord yüklemelerini sınırlar (varsayılan: `100MB`) +- eylemler: `actions.*` - presence: `activity`, `status`, `activityType`, `activityUrl` - UI: `ui.components.accentColor` - özellikler: `threadBindings`, üst düzey `bindings[]` (`type: "acp"`), `pluralkit`, `execApprovals`, `intents`, `agentComponents`, `heartbeat`, `responsePrefix` ## Güvenlik ve işlemler -- Bot token'larını sır olarak ele alın (denetlenen ortamlarda `DISCORD_BOT_TOKEN` tercih edilir). -- En az ayrıcalık veren Discord izinlerini verin. -- Komut dağıtımı/durumu bayatsa, gateway'i yeniden başlatın ve `openclaw channels status --probe` ile yeniden kontrol edin. +- Bot token'larını gizli bilgiler olarak ele alın (denetimli ortamlarda `DISCORD_BOT_TOKEN` tercih edilir). +- En az ayrıcalık ilkesine göre Discord izinleri verin. +- Komut dağıtımı/durumu bayatsa, gateway'i yeniden başlatın ve `openclaw channels status --probe` ile tekrar kontrol edin. ## İlgili -- [Eşleme](/tr/channels/pairing) +- [Eşleştirme](/tr/channels/pairing) - [Gruplar](/tr/channels/groups) - [Kanal yönlendirme](/tr/channels/channel-routing) - [Güvenlik](/tr/gateway/security) - [Çoklu ajan yönlendirme](/tr/concepts/multi-agent) - [Sorun giderme](/tr/channels/troubleshooting) -- [Slash komutları](/tr/tools/slash-commands) +- [Slash commands](/tr/tools/slash-commands) diff --git a/docs/tr/concepts/dreaming.md b/docs/tr/concepts/dreaming.md index 397127da2..58a8e9c06 100644 --- a/docs/tr/concepts/dreaming.md +++ b/docs/tr/concepts/dreaming.md @@ -2,23 +2,23 @@ read_when: - Bellek yükseltmenin otomatik olarak çalışmasını istiyorsunuz - Her rüya görme aşamasının ne yaptığını anlamak istiyorsunuz - - Pekiştirmeyi `MEMORY.md` dosyasını kirletmeden ayarlamak istiyorsunuz -summary: Hafif, derin ve REM aşamaları ile bir Rüya Günlüğünü içeren arka plan bellek pekiştirmesi + - Birleştirmeyi `MEMORY.md` dosyasını kirletmeden ayarlamak istiyorsunuz +summary: Hafif, derin ve REM aşamalarıyla arka plan bellek birleştirmesi ve bir Rüya Günlüğü title: Rüya Görme (deneysel) x-i18n: - generated_at: "2026-04-06T08:49:09Z" + generated_at: "2026-04-08T08:43:28Z" model: gpt-5.4 provider: openai - source_hash: 36c4b1e70801d662090dc8ce20608c2f141c23cd7ce53c54e3dcf332c801fd4e + source_hash: 0254f3b0949158264e583c12f36f2b1a83d1b44dc4da01a1b272422d38e8655d source_path: concepts/dreaming.md workflow: 15 --- # Rüya Görme (deneysel) -Rüya görme, `memory-core` içindeki arka plan bellek pekiştirme sistemidir. +Rüya görme, `memory-core` içindeki arka plan bellek birleştirme sistemidir. OpenClaw'ın güçlü kısa süreli sinyalleri kalıcı belleğe taşımasına yardımcı olurken -sürecin açıklanabilir ve incelenebilir kalmasını sağlar. +süreci açıklanabilir ve gözden geçirilebilir tutar. Rüya görme **isteğe bağlıdır** ve varsayılan olarak devre dışıdır. @@ -26,81 +26,87 @@ Rüya görme **isteğe bağlıdır** ve varsayılan olarak devre dışıdır. Rüya görme iki tür çıktı tutar: -- `memory/.dreams/` içinde **makine durumu** (hatırlama deposu, aşama sinyalleri, içe aktarma denetim noktaları, kilitler). -- `DREAMS.md` içinde (veya mevcut `dreams.md` içinde) **insan tarafından okunabilir çıktı** ve `memory/dreaming//YYYY-MM-DD.md` altındaki isteğe bağlı aşama raporu dosyaları. +- `memory/.dreams/` içinde **Makine durumu** (anımsama deposu, aşama sinyalleri, içe alma denetim noktaları, kilitler). +- `DREAMS.md` içinde (veya mevcut `dreams.md`) **İnsan tarafından okunabilir çıktı** ve `memory/dreaming//YYYY-MM-DD.md` altında isteğe bağlı aşama raporu dosyaları. Uzun vadeli yükseltme yine yalnızca `MEMORY.md` dosyasına yazar. ## Aşama modeli -Rüya görme üç işbirlikçi aşama kullanır: +Rüya görme üç iş birliği yapan aşama kullanır: -| Aşama | Amaç | Kalıcı yazma | -| ----- | ----------------------------------------- | ----------------- | -| Hafif | Son kısa süreli materyali sıralamak ve hazırlamak | Hayır | +| Aşama | Amaç | Kalıcı yazım | +| ----- | ----------------------------------------- | ------------------ | +| Hafif | Son kısa süreli materyali sıralamak ve hazırlamak | Hayır | | Derin | Kalıcı adayları puanlamak ve yükseltmek | Evet (`MEMORY.md`) | -| REM | Temalar ve tekrarlayan fikirler üzerine düşünmek | Hayır | +| REM | Temalar ve tekrar eden fikirler üzerine düşünmek | Hayır | -Bu aşamalar, ayrı kullanıcı tarafından yapılandırılan -"modlar" değil, dahili uygulama ayrıntılarıdır. +Bu aşamalar ayrı kullanıcı tarafından yapılandırılan +"modlar" değil, iç uygulama ayrıntılarıdır. ### Hafif aşama -Hafif aşama, son günlük bellek sinyallerini ve hatırlama izlerini içe alır, bunları yinelenenlerden arındırır -ve aday satırları hazırlar. +Hafif aşama son günlük bellek sinyallerini ve anımsama izlerini içe alır, bunların +yinelenenlerini kaldırır ve aday satırları hazırlar. -- Kısa süreli hatırlama durumundan ve son günlük bellek dosyalarından okur. +- Kısa süreli anımsama durumundan, son günlük bellek dosyalarından ve mevcut olduğunda sansürlenmiş oturum dökümlerinden okur. - Depolama satır içi çıktı içerdiğinde yönetilen bir `## Light Sleep` bloğu yazar. -- Daha sonraki derin sıralama için pekiştirme sinyallerini kaydeder. +- Daha sonra derin sıralama için pekiştirme sinyalleri kaydeder. - Asla `MEMORY.md` dosyasına yazmaz. ### Derin aşama -Derin aşama, neyin uzun vadeli belleğe dönüşeceğine karar verir. +Derin aşama neyin uzun vadeli bellek olacağına karar verir. -- Adayları ağırlıklı puanlama ve eşik kapıları kullanarak sıralar. +- Adayları ağırlıklı puanlama ve eşik geçitleri kullanarak sıralar. - Geçmek için `minScore`, `minRecallCount` ve `minUniqueQueries` gerektirir. -- Yazmadan önce parçacıkları canlı günlük dosyalardan yeniden yükler; bu nedenle eski/silinmiş parçacıklar atlanır. +- Yazmadan önce parçaları canlı günlük dosyalardan yeniden alır; böylece eski/silinmiş parçalar atlanır. - Yükseltilen girdileri `MEMORY.md` dosyasına ekler. -- `DREAMS.md` içine bir `## Deep Sleep` özeti yazar ve isteğe bağlı olarak `memory/dreaming/deep/YYYY-MM-DD.md` dosyasını yazar. +- `DREAMS.md` içine bir `## Deep Sleep` özeti yazar ve isteğe bağlı olarak `memory/dreaming/deep/YYYY-MM-DD.md` dosyasına yazar. ### REM aşaması -REM aşaması kalıpları ve yansıtıcı sinyalleri çıkarır. +REM aşaması örüntüleri ve yansıtıcı sinyalleri çıkarır. -- Son kısa süreli izlerden tema ve düşünsel özetler oluşturur. +- Son kısa süreli izlerden tema ve düşünüm özetleri oluşturur. - Depolama satır içi çıktı içerdiğinde yönetilen bir `## REM Sleep` bloğu yazar. - Derin sıralamada kullanılan REM pekiştirme sinyallerini kaydeder. - Asla `MEMORY.md` dosyasına yazmaz. +## Oturum dökümü içe alma + +Rüya görme, sansürlenmiş oturum dökümlerini rüya görme bütüncesine içe alabilir. Dökümler +mevcut olduğunda, bunlar günlük bellek sinyalleri ve anımsama izleriyle birlikte hafif +aşamaya beslenir. Kişisel ve hassas içerik içe almadan önce sansürlenir. + ## Rüya Günlüğü -Rüya görme ayrıca `DREAMS.md` içinde anlatı biçiminde bir **Rüya Günlüğü** tutar. -Her aşama yeterli materyale sahip olduktan sonra `memory-core`, en iyi çaba ilkesine dayalı bir arka plan -alt aracı turu çalıştırır (varsayılan çalışma zamanı modeli kullanılarak) ve kısa bir günlük girdisi ekler. +Rüya görme ayrıca `DREAMS.md` içinde anlatı tarzında bir **Rüya Günlüğü** tutar. +Her aşama yeterli materyale sahip olduktan sonra, `memory-core` en iyi çaba ile bir arka plan +alt ajan dönüşü çalıştırır (varsayılan çalışma zamanı modeli kullanılarak) ve kısa bir günlük girdisi ekler. -Bu günlük, yükseltme kaynağı değil, Dreams kullanıcı arayüzünde insan tarafından okunmak içindir. +Bu günlük, yükseltme kaynağı değil, Dreams kullanıcı arayüzünde insanlar tarafından okunmak içindir. ## Derin sıralama sinyalleri -Derin sıralama, aşama pekiştirmesine ek olarak altı ağırlıklı temel sinyal kullanır: +Derin sıralama altı ağırlıklı temel sinyal ve aşama pekiştirmesi kullanır: | Sinyal | Ağırlık | Açıklama | | ------------------- | ------ | ------------------------------------------------ | -| Sıklık | 0.24 | Girdinin biriktirdiği kısa süreli sinyal sayısı | -| İlgililik | 0.30 | Girdi için ortalama alma kalitesi | +| Sıklık | 0.24 | Girdinin kaç kısa süreli sinyal biriktirdiği | +| İlgililik | 0.30 | Girdi için ortalama geri getirme kalitesi | | Sorgu çeşitliliği | 0.15 | Onu ortaya çıkaran farklı sorgu/gün bağlamları | -| Yakınlık | 0.15 | Zamana göre azalan tazelik puanı | -| Pekiştirme | 0.10 | Çok günlük tekrar gücü | -| Kavramsal zenginlik | 0.06 | Parçacık/yoldan kavram etiketi yoğunluğu | +| Güncellik | 0.15 | Zamana göre azalan tazelik puanı | +| Birleştirme | 0.10 | Çok günlük tekrar gücü | +| Kavramsal zenginlik | 0.06 | Parça/yoldan gelen kavram etiketi yoğunluğu | Hafif ve REM aşaması isabetleri, -`memory/.dreams/phase-signals.json` içinden yakınlığa göre azalan küçük bir artış ekler. +`memory/.dreams/phase-signals.json` içinden güncelliğe göre azalan küçük bir artış ekler. ## Zamanlama -Etkinleştirildiğinde `memory-core`, tam bir rüya görme -taraması için tek bir cron job'ı otomatik olarak yönetir. Her tarama aşamaları sırayla çalıştırır: hafif -> REM -> derin. +Etkinleştirildiğinde, `memory-core` tam bir rüya görme +taraması için bir cron işini otomatik olarak yönetir. Her tarama aşamaları sırayla çalıştırır: hafif -> REM -> derin. Varsayılan sıklık davranışı: @@ -128,7 +134,7 @@ Rüya görmeyi etkinleştirin: } ``` -Özel bir tarama sıklığı ile rüya görmeyi etkinleştirin: +Özel bir tarama sıklığıyla rüya görmeyi etkinleştirin: ```json { @@ -148,7 +154,7 @@ Rüya görmeyi etkinleştirin: } ``` -## Slash komutu +## Eğik çizgi komutu ``` /dreaming status @@ -159,7 +165,7 @@ Rüya görmeyi etkinleştirin: ## CLI iş akışı -Önizleme veya manuel uygulama için CLI yükseltmesini kullanın: +Önizleme veya elle uygulama için CLI yükseltmesini kullanın: ```bash openclaw memory promote @@ -168,18 +174,16 @@ openclaw memory promote --limit 5 openclaw memory status --deep ``` -Manuel `memory promote`, CLI bayraklarıyla geçersiz kılınmadığı sürece varsayılan olarak -derin aşama eşiklerini kullanır. +Elle `memory promote`, CLI bayraklarıyla geçersiz kılınmadıkça varsayılan olarak derin aşama eşiklerini kullanır. -Belirli bir adayın neden yükseltileceğini veya yükseltilmeyeceğini açıklayın: +Belirli bir adayın neden yükseleceğini veya yükselmeyeceğini açıklayın: ```bash openclaw memory promote-explain "router vlan" openclaw memory promote-explain "router vlan" --json ``` -REM yansımalarını, aday gerçekleri ve derin yükseltme çıktısını -hiçbir şey yazmadan önizleyin: +Hiçbir şey yazmadan REM düşüncelerini, aday doğruları ve derin yükseltme çıktısını önizleyin: ```bash openclaw memory rem-harness @@ -195,20 +199,20 @@ Tüm ayarlar `plugins.entries.memory-core.config.dreaming` altında bulunur. | `enabled` | `false` | | `frequency` | `0 3 * * *` | -Aşama politikası, eşikler ve depolama davranışı dahili uygulama -ayrıntılarıdır (kullanıcıya dönük yapılandırma değildir). +Aşama ilkesi, eşikler ve depolama davranışı iç uygulama +ayrıntılarıdır (kullanıcıya yönelik yapılandırma değildir). -Tam anahtar listesi için [Bellek yapılandırma başvurusu](/tr/reference/memory-config#dreaming-experimental) bölümüne bakın. +Tam anahtar listesi için [Bellek yapılandırma başvurusu](/tr/reference/memory-config#dreaming-experimental) sayfasına bakın. ## Dreams kullanıcı arayüzü -Etkinleştirildiğinde Gateway **Dreams** sekmesi şunları gösterir: +Etkinleştirildiğinde, Gateway içindeki **Dreams** sekmesi şunları gösterir: -- geçerli rüya görme etkin durumunu -- aşama düzeyi durumu ve yönetilen tarama varlığını -- kısa vadeli, uzun vadeli ve bugün yükseltilen sayıları -- bir sonraki zamanlanmış çalıştırmanın zamanlamasını -- `doctor.memory.dreamDiary` tarafından desteklenen genişletilebilir bir Rüya Günlüğü okuyucusunu +- mevcut rüya görme etkin durumu +- aşama düzeyinde durum ve yönetilen tarama varlığı +- kısa süreli, uzun süreli ve bugün yükseltilen sayıları +- bir sonraki zamanlanmış çalıştırmanın zamanı +- `doctor.memory.dreamDiary` tarafından desteklenen genişletilebilir bir Rüya Günlüğü okuyucusu ## İlgili diff --git a/docs/tr/gateway/configuration-reference.md b/docs/tr/gateway/configuration-reference.md index 1b0c26a1f..edfd74e02 100644 --- a/docs/tr/gateway/configuration-reference.md +++ b/docs/tr/gateway/configuration-reference.md @@ -1,65 +1,65 @@ --- read_when: - - Tam alan düzeyinde yapılandırma semantiğine veya varsayılanlara ihtiyacınız var + - Tam alan düzeyi yapılandırma anlamlarına veya varsayılanlara ihtiyacınız var - Kanal, model, gateway veya araç yapılandırma bloklarını doğruluyorsunuz -summary: Çekirdek OpenClaw anahtarları, varsayılanlar ve özel alt sistem başvurularına bağlantılar için Gateway yapılandırma başvurusu +summary: Temel OpenClaw anahtarları, varsayılanlar ve ayrılmış alt sistem başvurularına bağlantılar için Gateway yapılandırma başvurusu title: Yapılandırma Başvurusu x-i18n: - generated_at: "2026-04-08T06:06:05Z" + generated_at: "2026-04-08T08:49:48Z" model: gpt-5.4 provider: openai - source_hash: 2f9ab34fb56897a77cb038d95bea21e8530d8f0402b66d1ee97c73822a1e8fd4 + source_hash: fd5f69050455e610fc7c825d95f546a16aa867b8a9c0d692a48de36419b0afc2 source_path: gateway/configuration-reference.md workflow: 15 --- # Yapılandırma Başvurusu -`~/.openclaw/openclaw.json` için çekirdek yapılandırma başvurusu. Görev odaklı bir genel bakış için [Configuration](/tr/gateway/configuration) sayfasına bakın. +`~/.openclaw/openclaw.json` için temel yapılandırma başvurusu. Görev odaklı genel bakış için bkz. [Yapılandırma](/tr/gateway/configuration). -Bu sayfa, ana OpenClaw yapılandırma yüzeylerini kapsar ve bir alt sistemin kendine ait daha derin bir başvurusu olduğunda oraya bağlantı verir. **Her** kanal/eklentiye ait komut kataloğunu veya her derin bellek/QMD ayarını tek sayfada satır içine almaya çalışmaz. +Bu sayfa başlıca OpenClaw yapılandırma yüzeylerini kapsar ve bir alt sistemin kendine ait daha ayrıntılı bir başvurusu olduğunda buna bağlantı verir. Her kanal/plugin'a ait komut kataloğunu veya her derin bellek/QMD ayarını tek bir sayfaya satır içi eklemeye **çalışmaz**. -Kod gerçekliği: +Kod gerçeği: -- `openclaw config schema`, doğrulama ve Control UI için kullanılan canlı JSON Şemasını yazdırır; uygun olduğunda paketlenmiş/eklenti/kanal metaverileri birleştirilir -- `config.schema.lookup`, ayrıntılı inceleme araçları için tek bir yol kapsamlı şema düğümü döndürür -- `pnpm config:docs:check` / `pnpm config:docs:gen`, yapılandırma-belgeleri temel hash’ini mevcut şema yüzeyine karşı doğrular +- `openclaw config schema`, doğrulama ve Control UI için kullanılan canlı JSON Schema'yı yazdırır; mevcut olduğunda paketlenmiş/plugin/kanal meta verileri de birleştirilir +- `config.schema.lookup`, derinlemesine inceleme araçları için yol kapsamlı tek bir şema düğümü döndürür +- `pnpm config:docs:check` / `pnpm config:docs:gen`, yapılandırma dokümanı temel hash'ini geçerli şema yüzeyine karşı doğrular -Özel derin başvurular: +Ayrı ayrıntılı başvurular: -- `agents.defaults.memorySearch.*`, `memory.qmd.*`, `memory.citations` ve `plugins.entries.memory-core.config.dreaming` altındaki dreaming yapılandırması için [Memory configuration reference](/tr/reference/memory-config) -- Güncel yerleşik + paketlenmiş komut kataloğu için [Slash Commands](/tr/tools/slash-commands) -- Kanala özgü komut yüzeyleri için ilgili kanal/eklenti sayfaları +- `agents.defaults.memorySearch.*`, `memory.qmd.*`, `memory.citations` ve `plugins.entries.memory-core.config.dreaming` altındaki dreaming yapılandırması için [Bellek yapılandırma başvurusu](/tr/reference/memory-config) +- güncel yerleşik + paketlenmiş komut kataloğu için [Slash Komutları](/tr/tools/slash-commands) +- kanala/plugin'a ait komut yüzeyleri için ilgili kanal/plugin sayfaları -Yapılandırma biçimi **JSON5**’tir (yorumlar + sondaki virgüller desteklenir). Tüm alanlar isteğe bağlıdır — OpenClaw, atlandıklarında güvenli varsayılanlar kullanır. +Yapılandırma biçimi **JSON5**'tir (yorumlara + sondaki virgüllere izin verilir). Tüm alanlar isteğe bağlıdır — OpenClaw, atlandıklarında güvenli varsayılanlar kullanır. --- ## Kanallar -Her kanal, yapılandırma bölümü mevcut olduğunda otomatik başlar (`enabled: false` olmadığı sürece). +Her kanal, yapılandırma bölümü موجود olduğunda otomatik olarak başlatılır (`enabled: false` değilse). ### DM ve grup erişimi Tüm kanallar DM ilkelerini ve grup ilkelerini destekler: -| DM ilkesi | Davranış | -| ------------------- | ------------------------------------------------------------- | -| `pairing` (varsayılan) | Bilinmeyen gönderenler tek kullanımlık bir eşleştirme kodu alır; sahibin onayı gerekir | -| `allowlist` | Yalnızca `allowFrom` içindeki gönderenler (veya eşleştirilmiş izin deposu) | -| `open` | Tüm gelen DM’lere izin ver (gerektirir: `allowFrom: ["*"]`) | -| `disabled` | Tüm gelen DM’leri yok say | +| DM ilkesi | Davranış | +| ------------------ | ---------------------------------------------------------------- | +| `pairing` (varsayılan) | Bilinmeyen göndericiler tek kullanımlık bir eşleme kodu alır; sahibin onaylaması gerekir | +| `allowlist` | Yalnızca `allowFrom` içindeki göndericiler (veya eşlenmiş izin deposu) | +| `open` | Tüm gelen DM'lere izin ver ( `allowFrom: ["*"]` gerektirir ) | +| `disabled` | Tüm gelen DM'leri yok say | -| Grup ilkesi | Davranış | -| --------------------- | ---------------------------------------------------- | +| Grup ilkesi | Davranış | +| --------------------- | ------------------------------------------------------ | | `allowlist` (varsayılan) | Yalnızca yapılandırılmış izin listesiyle eşleşen gruplar | -| `open` | Grup izin listelerini atla (mention-gating yine de uygulanır) | -| `disabled` | Tüm grup/oda mesajlarını engelle | +| `open` | Grup izin listelerini atla (mention geçitlemesi yine uygulanır) | +| `disabled` | Tüm grup/oda mesajlarını engelle | -`channels.defaults.groupPolicy`, bir sağlayıcının `groupPolicy` değeri ayarlanmadığında varsayılanı belirler. -Eşleştirme kodlarının süresi 1 saat sonra dolar. Bekleyen DM eşleştirme istekleri **kanal başına 3** ile sınırlandırılır. -Bir sağlayıcı bloğu tamamen eksikse (`channels.` yoksa), çalışma zamanındaki grup ilkesi `allowlist` olarak geri döner (fail-closed) ve başlangıçta bir uyarı verilir. +`channels.defaults.groupPolicy`, bir sağlayıcının `groupPolicy` değeri ayarlı olmadığında varsayılanı belirler. +Eşleme kodlarının süresi 1 saat sonra dolar. Bekleyen DM eşleme istekleri **kanal başına 3** ile sınırlıdır. +Bir sağlayıcı bloğu tamamen yoksa (`channels.` yoksa), çalışma zamanı grup ilkesi başlangıç uyarısıyla birlikte `allowlist` (başarısızlıkta kapalı) değerine geri döner. ### Kanal model geçersiz kılmaları @@ -105,15 +105,15 @@ Sağlayıcılar arasında paylaşılan grup ilkesi ve heartbeat davranışı iç } ``` -- `channels.defaults.groupPolicy`: bir sağlayıcı düzeyindeki `groupPolicy` ayarlanmadığında kullanılan yedek grup ilkesi. -- `channels.defaults.contextVisibility`: tüm kanallar için varsayılan ek bağlam görünürlük modu. Değerler: `all` (varsayılan, tüm alıntı/konu/geçmiş bağlamını dahil et), `allowlist` (yalnızca izin verilen gönderenlerden gelen bağlamı dahil et), `allowlist_quote` (allowlist ile aynı, ancak açık alıntı/yanıt bağlamını korur). Kanal başına geçersiz kılma: `channels..contextVisibility`. +- `channels.defaults.groupPolicy`: sağlayıcı düzeyinde `groupPolicy` ayarlı olmadığında geri dönüş grup ilkesi. +- `channels.defaults.contextVisibility`: tüm kanallar için varsayılan ek bağlam görünürlük modu. Değerler: `all` (varsayılan, alıntılanmış/başlıklı/geçmiş bağlamın tümünü ekler), `allowlist` (yalnızca izinli göndericilerden gelen bağlamı ekler), `allowlist_quote` (allowlist ile aynı, ancak açık alıntı/yanıt bağlamını korur). Kanal başına geçersiz kılma: `channels..contextVisibility`. - `channels.defaults.heartbeat.showOk`: sağlıklı kanal durumlarını heartbeat çıktısına dahil et. -- `channels.defaults.heartbeat.showAlerts`: bozulmuş/hata durumlarını heartbeat çıktısına dahil et. +- `channels.defaults.heartbeat.showAlerts`: bozulmuş/hatalı durumları heartbeat çıktısına dahil et. - `channels.defaults.heartbeat.useIndicator`: kompakt gösterge tarzı heartbeat çıktısı oluştur. ### WhatsApp -WhatsApp, gateway’nin web kanalı (Baileys Web) üzerinden çalışır. Bağlı bir oturum olduğunda otomatik başlar. +WhatsApp, gateway'in web kanalı (Baileys Web) üzerinden çalışır. Bağlı bir oturum mevcut olduğunda otomatik başlar. ```json5 { @@ -164,9 +164,9 @@ WhatsApp, gateway’nin web kanalı (Baileys Web) üzerinden çalışır. Bağl } ``` -- Giden komutlar, varsa varsayılan olarak `default` hesabını kullanır; aksi halde yapılandırılmış ilk hesap kimliği kullanılır (sıralanmış). -- İsteğe bağlı `channels.whatsapp.defaultAccount`, yapılandırılmış bir hesap kimliğiyle eşleştiğinde bu yedek varsayılan hesap seçimini geçersiz kılar. -- Eski tek hesaplı Baileys kimlik doğrulama dizini, `openclaw doctor` tarafından `whatsapp/default` altına taşınır. +- Giden komutlar, varsa varsayılan olarak `default` hesabını kullanır; aksi halde ilk yapılandırılmış hesap kimliğini (sıralı) kullanır. +- İsteğe bağlı `channels.whatsapp.defaultAccount`, yapılandırılmış bir hesap kimliğiyle eşleştiğinde bu geri dönüş varsayılan hesap seçimini geçersiz kılar. +- Eski tek hesaplı Baileys kimlik doğrulama dizini, `openclaw doctor` tarafından `whatsapp/default` içine taşınır. - Hesap başına geçersiz kılmalar: `channels.whatsapp.accounts..sendReadReceipts`, `channels.whatsapp.accounts..dmPolicy`, `channels.whatsapp.accounts..allowFrom`. @@ -185,24 +185,24 @@ WhatsApp, gateway’nin web kanalı (Baileys Web) üzerinden çalışır. Bağl "*": { requireMention: true }, "-1001234567890": { allowFrom: ["@admin"], - systemPrompt: "Yanıtları kısa tut.", + systemPrompt: "Keep answers brief.", topics: { "99": { requireMention: false, skills: ["search"], - systemPrompt: "Konudan sapma.", + systemPrompt: "Stay on topic.", }, }, }, }, customCommands: [ - { command: "backup", description: "Git yedeği" }, - { command: "generate", description: "Bir görsel oluştur" }, + { command: "backup", description: "Git backup" }, + { command: "generate", description: "Create an image" }, ], historyLimit: 50, replyToMode: "first", // off | first | all | batched linkPreview: true, - streaming: "partial", // off | partial | block | progress (varsayılan: off; önizleme-düzenleme oran sınırlarını önlemek için açıkça etkinleştirin) + streaming: "partial", // off | partial | block | progress (default: off; preview-edit rate limits'ten kaçınmak için açıkça etkinleştirin) actions: { reactions: true, sendMessage: true }, reactionNotifications: "own", // off | own | all mediaMaxMb: 100, @@ -225,13 +225,13 @@ WhatsApp, gateway’nin web kanalı (Baileys Web) üzerinden çalışır. Bağl } ``` -- Bot belirteci: `channels.telegram.botToken` veya `channels.telegram.tokenFile` (yalnızca normal dosya; symlink’ler reddedilir), varsayılan hesap için yedek olarak `TELEGRAM_BOT_TOKEN`. +- Bot token: `channels.telegram.botToken` veya `channels.telegram.tokenFile` (yalnızca normal dosya; symlink'ler reddedilir); varsayılan hesap için geri dönüş olarak `TELEGRAM_BOT_TOKEN` kullanılır. - İsteğe bağlı `channels.telegram.defaultAccount`, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar. -- Çok hesaplı kurulumlarda (2+ hesap kimliği), yedek yönlendirmeyi önlemek için açık bir varsayılan ayarlayın (`channels.telegram.defaultAccount` veya `channels.telegram.accounts.default`); bu eksik veya geçersiz olduğunda `openclaw doctor` uyarı verir. -- `configWrites: false`, Telegram tarafından başlatılan yapılandırma yazımlarını engeller (supergroup kimlik taşıma işlemleri, `/config set|unset`). -- Üst düzey `bindings[]` girdilerinde `type: "acp"` ile forum konuları için kalıcı ACP bağları yapılandırılır (`match.peer.id` içinde standart `chatId:topic:topicId` kullanın). Alan semantiği [ACP Agents](/tr/tools/acp-agents#channel-specific-settings) ile ortaktır. +- Çok hesaplı kurulumlarda (2+ hesap kimliği), geri dönüş yönlendirmesini önlemek için açık bir varsayılan ayarlayın (`channels.telegram.defaultAccount` veya `channels.telegram.accounts.default`); bu eksik veya geçersiz olduğunda `openclaw doctor` uyarı verir. +- `configWrites: false`, Telegram tarafından başlatılan yapılandırma yazımlarını engeller (supergroup ID taşımaları, `/config set|unset`). +- `type: "acp"` içeren üst düzey `bindings[]` girdileri, forum başlıkları için kalıcı ACP bağlamaları yapılandırır (`match.peer.id` içinde standart `chatId:topic:topicId` kullanın). Alan anlamları [ACP Agents](/tr/tools/acp-agents#channel-specific-settings) içinde ortaktır. - Telegram akış önizlemeleri `sendMessage` + `editMessageText` kullanır (doğrudan ve grup sohbetlerinde çalışır). -- Yeniden deneme ilkesi: bkz. [Retry policy](/tr/concepts/retry). +- Yeniden deneme ilkesi: bkz. [Yeniden deneme ilkesi](/tr/concepts/retry). ### Discord @@ -278,7 +278,7 @@ WhatsApp, gateway’nin web kanalı (Baileys Web) üzerinden çalışır. Bağl requireMention: true, users: ["987654321098765432"], skills: ["docs"], - systemPrompt: "Yalnızca kısa yanıtlar.", + systemPrompt: "Short answers only.", }, }, }, @@ -286,7 +286,7 @@ WhatsApp, gateway’nin web kanalı (Baileys Web) üzerinden çalışır. Bağl historyLimit: 20, textChunkLimit: 2000, chunkMode: "length", // length | newline - streaming: "off", // off | partial | block | progress (progress, Discord’da partial’a eşlenir) + streaming: "off", // off | partial | block | progress (progress, Discord'da partial'a eşlenir) maxLinesPerMessage: 17, ui: { components: { @@ -297,7 +297,7 @@ WhatsApp, gateway’nin web kanalı (Baileys Web) üzerinden çalışır. Bağl enabled: true, idleHours: 24, maxAgeHours: 0, - spawnSubagentSessions: false, // sessions_spawn({ thread: true }) için isteğe bağlı etkinleştirme + spawnSubagentSessions: false, // sessions_spawn({ thread: true }) için açık katılım }, voice: { enabled: true, @@ -333,36 +333,36 @@ WhatsApp, gateway’nin web kanalı (Baileys Web) üzerinden çalışır. Bağl } ``` -- Belirteç: `channels.discord.token`, varsayılan hesap için yedek olarak `DISCORD_BOT_TOKEN`. -- Açık bir Discord `token` sağlayan doğrudan giden çağrılar, çağrı için o belirteci kullanır; hesap yeniden deneme/ilke ayarları yine de etkin çalışma zamanı anlık görüntüsünde seçilen hesaptan gelir. +- Token: `channels.discord.token`; varsayılan hesap için geri dönüş olarak `DISCORD_BOT_TOKEN` kullanılır. +- Açık bir Discord `token` sağlayan doğrudan giden çağrılar, çağrı için o token'ı kullanır; hesap yeniden deneme/ilke ayarları ise etkin çalışma zamanı anlık görüntüsünde seçilen hesaptan gelmeye devam eder. - İsteğe bağlı `channels.discord.defaultAccount`, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar. -- Teslim hedefleri için `user:` (DM) veya `channel:` (guild kanalı) kullanın; çıplak sayısal kimlikler reddedilir. -- Guild slug’ları küçük harflidir ve boşluklar `-` ile değiştirilir; kanal anahtarları slug’lanmış adı kullanır (`#` yok). Guild kimliklerini tercih edin. -- Bot tarafından yazılan mesajlar varsayılan olarak yok sayılır. `allowBots: true` bunu etkinleştirir; yalnızca botu mention eden bot mesajlarını kabul etmek için `allowBots: "mentions"` kullanın (kendi mesajları yine filtrelenir). -- `channels.discord.guilds..ignoreOtherMentions` (ve kanal geçersiz kılmaları), bot hariç başka bir kullanıcıyı veya rolü mention eden mesajları düşürür (@everyone/@here hariç). -- `maxLinesPerMessage` (varsayılan 17), 2000 karakterin altında olsa bile yüksek mesajları böler. -- `channels.discord.threadBindings`, Discord iş parçacığı bağlı yönlendirmeyi kontrol eder: - - `enabled`: iş parçacığı bağlı oturum özellikleri için Discord geçersiz kılması (`/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age` ve bağlı teslim/yönlendirme) - - `idleHours`: saat cinsinden etkinliksizlik sonrası otomatik odak kaldırma için Discord geçersiz kılması (`0` devre dışı bırakır) +- Teslim hedefleri için `user:` (DM) veya `channel:` (guild channel) kullanın; çıplak sayısal kimlikler reddedilir. +- Guild slug'ları küçük harftir ve boşluklar `-` ile değiştirilir; kanal anahtarları sluglaştırılmış adı kullanır (`#` yok). Guild kimliklerini tercih edin. +- Bot tarafından yazılan mesajlar varsayılan olarak yok sayılır. `allowBots: true` bunları etkinleştirir; yalnızca botu mention eden bot mesajlarını kabul etmek için `allowBots: "mentions"` kullanın (kendi mesajları yine süzülür). +- `channels.discord.guilds..ignoreOtherMentions` (ve kanal geçersiz kılmaları), botu mention etmeyen ancak başka bir kullanıcıyı veya rolü mention eden mesajları düşürür (@everyone/@here hariç). +- `maxLinesPerMessage` (varsayılan 17), 2000 karakterin altında olsa bile uzun mesajları böler. +- `channels.discord.threadBindings`, Discord thread'e bağlı yönlendirmeyi kontrol eder: + - `enabled`: thread'e bağlı oturum özellikleri için Discord geçersiz kılması (`/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age` ve bağlı teslimat/yönlendirme) + - `idleHours`: etkinliksizlik sonrası otomatik odak kaldırma için saat cinsinden Discord geçersiz kılması (`0` devre dışı bırakır) - `maxAgeHours`: saat cinsinden katı maksimum yaş için Discord geçersiz kılması (`0` devre dışı bırakır) - - `spawnSubagentSessions`: `sessions_spawn({ thread: true })` otomatik iş parçacığı oluşturma/bağlama için isteğe bağlı anahtar -- Üst düzey `bindings[]` girdilerinde `type: "acp"` ile kanallar ve iş parçacıkları için kalıcı ACP bağları yapılandırılır (`match.peer.id` içinde kanal/iş parçacığı kimliğini kullanın). Alan semantiği [ACP Agents](/tr/tools/acp-agents#channel-specific-settings) ile ortaktır. + - `spawnSubagentSessions`: `sessions_spawn({ thread: true })` otomatik thread oluşturma/bağlama için açık katılım anahtarı +- `type: "acp"` içeren üst düzey `bindings[]` girdileri, kanallar ve thread'ler için kalıcı ACP bağlamaları yapılandırır (`match.peer.id` içinde channel/thread id kullanın). Alan anlamları [ACP Agents](/tr/tools/acp-agents#channel-specific-settings) içinde ortaktır. - `channels.discord.ui.components.accentColor`, Discord components v2 kapsayıcıları için vurgu rengini ayarlar. - `channels.discord.voice`, Discord ses kanalı konuşmalarını ve isteğe bağlı otomatik katılma + TTS geçersiz kılmalarını etkinleştirir. -- `channels.discord.voice.daveEncryption` ve `channels.discord.voice.decryptionFailureTolerance`, `@discordjs/voice` DAVE seçeneklerine doğrudan aktarılır (varsayılan olarak `true` ve `24`). -- OpenClaw ayrıca, tekrarlanan şifre çözme hatalarından sonra ses oturumundan çıkıp yeniden katılarak ses alma kurtarması denemesi yapar. -- `channels.discord.streaming`, standart akış modu anahtarıdır. Eski `streamMode` ve mantıksal `streaming` değerleri otomatik olarak taşınır. +- `channels.discord.voice.daveEncryption` ve `channels.discord.voice.decryptionFailureTolerance`, `@discordjs/voice` DAVE seçeneklerine doğrudan geçirilir (varsayılan olarak `true` ve `24`). +- OpenClaw ayrıca, tekrarlanan şifre çözme hatalarından sonra bir ses oturumundan ayrılıp yeniden katılarak ses alımını kurtarmayı dener. +- `channels.discord.streaming` standart akış modu anahtarıdır. Eski `streamMode` ve boolean `streaming` değerleri otomatik taşınır. - `channels.discord.autoPresence`, çalışma zamanı kullanılabilirliğini bot varlığına eşler (sağlıklı => online, bozulmuş => idle, tükenmiş => dnd) ve isteğe bağlı durum metni geçersiz kılmalarına izin verir. -- `channels.discord.dangerouslyAllowNameMatching`, değişebilir ad/etiket eşleştirmesini yeniden etkinleştirir (acil durum uyumluluk modu). -- `channels.discord.execApprovals`: Discord yerel exec onay teslimi ve onaylayıcı yetkilendirmesi. +- `channels.discord.dangerouslyAllowNameMatching`, değiştirilebilir ad/etiket eşleştirmesini yeniden etkinleştirir (acil durum uyumluluk modu). +- `channels.discord.execApprovals`: Discord yerel exec onay teslimatı ve onaylayıcı yetkilendirmesi. - `enabled`: `true`, `false` veya `"auto"` (varsayılan). Otomatik modda exec onayları, `approvers` veya `commands.ownerAllowFrom` üzerinden onaylayıcılar çözümlenebildiğinde etkinleşir. - `approvers`: exec isteklerini onaylamasına izin verilen Discord kullanıcı kimlikleri. Atlandığında `commands.ownerAllowFrom` değerine geri döner. - - `agentFilter`: isteğe bağlı ajan kimliği izin listesi. Tüm ajanlar için onay iletmek istiyorsanız atlayın. + - `agentFilter`: isteğe bağlı agent ID izin listesi. Tüm agent'lar için onay iletmek istiyorsanız atlayın. - `sessionFilter`: isteğe bağlı oturum anahtarı desenleri (alt dize veya regex). - - `target`: onay istemlerinin nereye gönderileceği. `"dm"` (varsayılan) onaylayıcı DM’lerine gönderir, `"channel"` kaynak kanala gönderir, `"both"` her ikisine gönderir. Hedef `"channel"` içerdiğinde, düğmeler yalnızca çözümlenmiş onaylayıcılar tarafından kullanılabilir. - - `cleanupAfterResolve`: `true` olduğunda, onay, ret veya zaman aşımından sonra onay DM’lerini siler. + - `target`: onay istemlerinin nereye gönderileceği. `"dm"` (varsayılan) onaylayıcı DM'lerine gönderir, `"channel"` kaynak kanala gönderir, `"both"` her ikisine de gönderir. Hedef `"channel"` içerdiğinde düğmeler yalnızca çözümlenmiş onaylayıcılar tarafından kullanılabilir. + - `cleanupAfterResolve`: `true` olduğunda, onay, ret veya zaman aşımı sonrasında onay DM'lerini siler. -**Tepki bildirimi modları:** `off` (yok), `own` (botun mesajları, varsayılan), `all` (tüm mesajlar), `allowlist` (`guilds..users` içindekilerden tüm mesajlar). +**Reaction bildirim modları:** `off` (yok), `own` (botun mesajları, varsayılan), `all` (tüm mesajlar), `allowlist` (`guilds..users` içinden tüm mesajlarda). ### Google Chat @@ -393,11 +393,11 @@ WhatsApp, gateway’nin web kanalı (Baileys Web) üzerinden çalışır. Bağl } ``` -- Hizmet hesabı JSON’u: satır içi (`serviceAccount`) veya dosya tabanlı (`serviceAccountFile`). +- Hizmet hesabı JSON'u: satır içi (`serviceAccount`) veya dosya tabanlı (`serviceAccountFile`). - Hizmet hesabı SecretRef de desteklenir (`serviceAccountRef`). -- Ortam yedekleri: `GOOGLE_CHAT_SERVICE_ACCOUNT` veya `GOOGLE_CHAT_SERVICE_ACCOUNT_FILE`. +- Ortam geri dönüşleri: `GOOGLE_CHAT_SERVICE_ACCOUNT` veya `GOOGLE_CHAT_SERVICE_ACCOUNT_FILE`. - Teslim hedefleri için `spaces/` veya `users/` kullanın. -- `channels.googlechat.dangerouslyAllowNameMatching`, değişebilir e-posta principal eşleştirmesini yeniden etkinleştirir (acil durum uyumluluk modu). +- `channels.googlechat.dangerouslyAllowNameMatching`, değiştirilebilir e-posta asıl eşleştirmesini yeniden etkinleştirir (acil durum uyumluluk modu). ### Slack @@ -419,7 +419,7 @@ WhatsApp, gateway’nin web kanalı (Baileys Web) üzerinden çalışır. Bağl allowBots: false, users: ["U123"], skills: ["docs"], - systemPrompt: "Yalnızca kısa yanıtlar.", + systemPrompt: "Short answers only.", }, }, historyLimit: 50, @@ -449,7 +449,7 @@ WhatsApp, gateway’nin web kanalı (Baileys Web) üzerinden çalışır. Bağl chunkMode: "length", streaming: { mode: "partial", // off | partial | block | progress - nativeTransport: true, // mode=partial olduğunda Slack yerel akış API’sini kullan + nativeTransport: true, // mode=partial olduğunda Slack yerel akış API'sini kullan }, mediaMaxMb: 20, execApprovals: { @@ -464,34 +464,40 @@ WhatsApp, gateway’nin web kanalı (Baileys Web) üzerinden çalışır. Bağl } ``` -- **Socket mode**, hem `botToken` hem de `appToken` gerektirir (varsayılan hesap ortam yedeği için `SLACK_BOT_TOKEN` + `SLACK_APP_TOKEN`). -- **HTTP mode**, `botToken` ile birlikte `signingSecret` gerektirir (kök düzeyde veya hesap başına). -- `botToken`, `appToken`, `signingSecret` ve `userToken`, düz metin dizeleri veya SecretRef nesnelerini kabul eder. -- Slack hesap anlık görüntüleri, `botTokenSource`, `botTokenStatus`, `appTokenStatus` ve HTTP modunda `signingSecretStatus` gibi kimlik bilgisi kaynağı/durum alanlarını gösterir. `configured_unavailable`, hesabın SecretRef aracılığıyla yapılandırıldığı ancak mevcut komut/çalışma zamanı yolunun gizli değeri çözemediği anlamına gelir. +- **Socket mode** için hem `botToken` hem `appToken` gerekir (varsayılan hesap ortam geri dönüşü için `SLACK_BOT_TOKEN` + `SLACK_APP_TOKEN`). +- **HTTP mode** için `botToken` ile birlikte `signingSecret` gerekir (kök düzeyde veya hesap başına). +- `botToken`, `appToken`, `signingSecret` ve `userToken`, düz metin + dizeleri veya SecretRef nesnelerini kabul eder. +- Slack hesap anlık görüntüleri, hesap başına kimlik bilgisi kaynağı/durum alanlarını gösterir; örneğin + `botTokenSource`, `botTokenStatus`, `appTokenStatus` ve HTTP mode'da + `signingSecretStatus`. + `configured_unavailable`, hesabın + SecretRef aracılığıyla yapılandırıldığını ancak mevcut komut/çalışma yolu + secret değerini çözemediğini belirtir. - `configWrites: false`, Slack tarafından başlatılan yapılandırma yazımlarını engeller. - İsteğe bağlı `channels.slack.defaultAccount`, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar. -- `channels.slack.streaming.mode`, standart Slack akış modu anahtarıdır. `channels.slack.streaming.nativeTransport`, Slack’in yerel akış taşımasını kontrol eder. Eski `streamMode`, mantıksal `streaming` ve `nativeStreaming` değerleri otomatik olarak taşınır. +- `channels.slack.streaming.mode`, standart Slack akış modu anahtarıdır. `channels.slack.streaming.nativeTransport`, Slack'in yerel akış aktarımını kontrol eder. Eski `streamMode`, boolean `streaming` ve `nativeStreaming` değerleri otomatik taşınır. - Teslim hedefleri için `user:` (DM) veya `channel:` kullanın. -**Tepki bildirimi modları:** `off`, `own` (varsayılan), `all`, `allowlist` (`reactionAllowlist` içinden). +**Reaction bildirim modları:** `off`, `own` (varsayılan), `all`, `allowlist` (`reactionAllowlist` içinden). -**İş parçacığı oturum yalıtımı:** `thread.historyScope` iş parçacığı başına (varsayılan) veya kanal genelinde paylaşılır. `thread.inheritParent`, üst kanal dökümünü yeni iş parçacıklarına kopyalar. +**Thread oturum yalıtımı:** `thread.historyScope`, thread başına (varsayılan) veya kanal genelinde paylaşımlıdır. `thread.inheritParent`, üst kanal dökümünü yeni thread'lere kopyalar. -- Slack yerel akışı ve Slack yardımcı tarzı "yazıyor..." iş parçacığı durumu, yanıt iş parçacığı hedefi gerektirir. Üst düzey DM’ler varsayılan olarak iş parçacığı dışıdır, bu nedenle iş parçacığı tarzı önizleme yerine `typingReaction` veya normal teslim kullanırlar. -- `typingReaction`, yanıt çalışırken gelen Slack mesajına geçici bir tepki ekler, ardından tamamlandığında kaldırır. `"hourglass_flowing_sand"` gibi bir Slack emoji kısa kodu kullanın. -- `channels.slack.execApprovals`: Slack yerel exec onay teslimi ve onaylayıcı yetkilendirmesi. Discord ile aynı şema: `enabled` (`true`/`false`/`"auto"`), `approvers` (Slack kullanıcı kimlikleri), `agentFilter`, `sessionFilter` ve `target` (`"dm"`, `"channel"` veya `"both"`). +- Slack yerel akışı ve Slack asistan tarzı "is typing..." thread durumu için bir yanıt thread hedefi gerekir. Üst düzey DM'ler varsayılan olarak thread dışıdır, bu nedenle thread tarzı önizleme yerine `typingReaction` veya normal teslimat kullanırlar. +- `typingReaction`, bir yanıt çalışırken gelen Slack mesajına geçici bir reaction ekler, sonra tamamlandığında kaldırır. `"hourglass_flowing_sand"` gibi bir Slack emoji kısa kodu kullanın. +- `channels.slack.execApprovals`: Slack yerel exec onay teslimatı ve onaylayıcı yetkilendirmesi. Şema Discord ile aynıdır: `enabled` (`true`/`false`/`"auto"`), `approvers` (Slack kullanıcı kimlikleri), `agentFilter`, `sessionFilter` ve `target` (`"dm"`, `"channel"` veya `"both"`). -| Eylem grubu | Varsayılan | Notlar | -| ----------- | ---------- | ----------------------- | +| Eylem grubu | Varsayılan | Notlar | +| ----------- | ---------- | ---------------------- | | reactions | etkin | Tepki ver + tepkileri listele | -| messages | etkin | Oku/gönder/düzenle/sil | -| pins | etkin | Sabitle/kaldır/listele | -| memberInfo | etkin | Üye bilgisi | -| emojiList | etkin | Özel emoji listesi | +| messages | etkin | Oku/gönder/düzenle/sil | +| pins | etkin | Sabitle/sabit kaldır/listele | +| memberInfo | etkin | Üye bilgisi | +| emojiList | etkin | Özel emoji listesi | ### Mattermost -Mattermost bir eklenti olarak gelir: `openclaw plugins install @openclaw/mattermost`. +Mattermost bir plugin olarak gelir: `openclaw plugins install @openclaw/mattermost`. ```json5 { @@ -508,7 +514,7 @@ Mattermost bir eklenti olarak gelir: `openclaw plugins install @openclaw/matterm "team-channel-id": { requireMention: false }, }, commands: { - native: true, // isteğe bağlı etkinleştirme + native: true, // açık katılım nativeSkills: true, callbackPath: "/api/channels/mattermost/command", // Ters proxy/genel dağıtımlar için isteğe bağlı açık URL @@ -521,19 +527,24 @@ Mattermost bir eklenti olarak gelir: `openclaw plugins install @openclaw/matterm } ``` -Sohbet modları: `oncall` (@-mention olduğunda yanıt ver, varsayılan), `onmessage` (her mesaj), `onchar` (tetikleyici önekle başlayan mesajlar). +Sohbet modları: `oncall` (@-mention üzerine yanıt ver, varsayılan), `onmessage` (her mesaj), `onchar` (tetikleyici önekle başlayan mesajlar). -Mattermost yerel komutları etkinleştirildiğinde: +Mattermost yerel komutları etkin olduğunda: - `commands.callbackPath`, tam URL değil bir yol olmalıdır (örneğin `/api/channels/mattermost/command`). - `commands.callbackUrl`, OpenClaw gateway uç noktasına çözülmeli ve Mattermost sunucusundan erişilebilir olmalıdır. -- Yerel slash callback’leri, Mattermost’un slash komut kaydı sırasında döndürdüğü komut başına belirteçlerle kimlik doğrular. Kayıt başarısız olursa veya hiçbir komut etkinleştirilmezse, OpenClaw callback’leri şu hatayla reddeder: +- Yerel slash geri çağrıları, slash komut kaydı sırasında Mattermost tarafından + döndürülen komut başına token'larla kimlik doğrular. + Kayıt başarısız olursa veya hiçbir komut etkinleştirilmezse, + OpenClaw geri çağrıları `Unauthorized: invalid command token.` -- Özel/tailnet/iç callback ana bilgisayarları için Mattermost, `ServiceSettings.AllowedUntrustedInternalConnections` içinde callback ana bilgisayarı/alan adının yer almasını gerektirebilir. - Tam URL değil, ana bilgisayar/alan adı değerleri kullanın. -- `channels.mattermost.configWrites`: Mattermost tarafından başlatılan yapılandırma yazımlarına izin ver veya engelle. + ile reddeder. +- Özel/tailnet/iç callback ana bilgisayarları için Mattermost, + `ServiceSettings.AllowedUntrustedInternalConnections` içinde callback ana bilgisayarını/alanını gerektirebilir. + Tam URL değil ana bilgisayar/alan değerleri kullanın. +- `channels.mattermost.configWrites`: Mattermost tarafından başlatılan yapılandırma yazımlarına izin ver veya reddet. - `channels.mattermost.requireMention`: kanallarda yanıt vermeden önce `@mention` gerektir. -- `channels.mattermost.groups..requireMention`: kanal başına mention-gating geçersiz kılması (varsayılan için `"*"`). +- `channels.mattermost.groups..requireMention`: kanal başına mention geçitleme geçersiz kılması (varsayılan için `"*"`). - İsteğe bağlı `channels.mattermost.defaultAccount`, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar. ### Signal @@ -555,15 +566,15 @@ Mattermost yerel komutları etkinleştirildiğinde: } ``` -**Tepki bildirimi modları:** `off`, `own` (varsayılan), `all`, `allowlist` (`reactionAllowlist` içinden). +**Reaction bildirim modları:** `off`, `own` (varsayılan), `all`, `allowlist` (`reactionAllowlist` içinden). -- `channels.signal.account`: kanal başlangıcını belirli bir Signal hesap kimliğine sabitle. -- `channels.signal.configWrites`: Signal tarafından başlatılan yapılandırma yazımlarına izin ver veya engelle. +- `channels.signal.account`: kanal başlatmayı belirli bir Signal hesap kimliğine sabitle. +- `channels.signal.configWrites`: Signal tarafından başlatılan yapılandırma yazımlarına izin ver veya reddet. - İsteğe bağlı `channels.signal.defaultAccount`, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar. ### BlueBubbles -BlueBubbles, önerilen iMessage yoludur (eklenti destekli, `channels.bluebubbles` altında yapılandırılır). +BlueBubbles önerilen iMessage yoludur (plugin destekli, `channels.bluebubbles` altında yapılandırılır). ```json5 { @@ -571,21 +582,21 @@ BlueBubbles, önerilen iMessage yoludur (eklenti destekli, `channels.bluebubbles bluebubbles: { enabled: true, dmPolicy: "pairing", - // serverUrl, password, webhookPath, group controls ve gelişmiş eylemler: + // serverUrl, password, webhookPath, group controls ve gelişmiş actions: // bkz. /channels/bluebubbles }, }, } ``` -- Burada kapsanan çekirdek anahtar yolları: `channels.bluebubbles`, `channels.bluebubbles.dmPolicy`. +- Burada kapsanan temel anahtar yolları: `channels.bluebubbles`, `channels.bluebubbles.dmPolicy`. - İsteğe bağlı `channels.bluebubbles.defaultAccount`, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar. -- Üst düzey `bindings[]` girdilerinde `type: "acp"` ile BlueBubbles konuşmaları kalıcı ACP oturumlarına bağlanabilir. `match.peer.id` içinde bir BlueBubbles tanıtıcısı veya hedef dizesi kullanın (`chat_id:*`, `chat_guid:*`, `chat_identifier:*`). Ortak alan semantiği: [ACP Agents](/tr/tools/acp-agents#channel-specific-settings). -- Tam BlueBubbles kanal yapılandırması [BlueBubbles](/tr/channels/bluebubbles) sayfasında belgelenmiştir. +- `type: "acp"` içeren üst düzey `bindings[]` girdileri, BlueBubbles konuşmalarını kalıcı ACP oturumlarına bağlayabilir. `match.peer.id` içinde bir BlueBubbles handle veya hedef dize (`chat_id:*`, `chat_guid:*`, `chat_identifier:*`) kullanın. Ortak alan anlamları: [ACP Agents](/tr/tools/acp-agents#channel-specific-settings). +- Tam BlueBubbles kanal yapılandırması [BlueBubbles](/tr/channels/bluebubbles) içinde belgelenmiştir. ### iMessage -OpenClaw `imsg rpc` (stdio üzerinden JSON-RPC) başlatır. Daemon veya port gerekmez. +OpenClaw `imsg rpc` üretir (stdio üzerinden JSON-RPC). Daemon veya port gerekmez. ```json5 { @@ -613,13 +624,13 @@ OpenClaw `imsg rpc` (stdio üzerinden JSON-RPC) başlatır. Daemon veya port ger - Messages DB için Full Disk Access gerekir. - `chat_id:` hedeflerini tercih edin. Sohbetleri listelemek için `imsg chats --limit 20` kullanın. -- `cliPath` bir SSH sarmalayıcısına işaret edebilir; SCP ek dosya getirme için `remoteHost` (`host` veya `user@host`) ayarlayın. -- `attachmentRoots` ve `remoteAttachmentRoots`, gelen ek dosya yollarını kısıtlar (varsayılan: `/Users/*/Library/Messages/Attachments`). -- SCP, katı ana bilgisayar anahtarı denetimi kullanır; bu nedenle aktarma ana bilgisayar anahtarının `~/.ssh/known_hosts` içinde zaten bulunduğundan emin olun. -- `channels.imessage.configWrites`: iMessage tarafından başlatılan yapılandırma yazımlarına izin ver veya engelle. -- Üst düzey `bindings[]` girdilerinde `type: "acp"` ile iMessage konuşmaları kalıcı ACP oturumlarına bağlanabilir. `match.peer.id` içinde normalleştirilmiş bir tanıtıcı veya açık sohbet hedefi (`chat_id:*`, `chat_guid:*`, `chat_identifier:*`) kullanın. Ortak alan semantiği: [ACP Agents](/tr/tools/acp-agents#channel-specific-settings). +- `cliPath` bir SSH sarmalayıcısını gösterebilir; SCP ile ek getirmek için `remoteHost` (`host` veya `user@host`) ayarlayın. +- `attachmentRoots` ve `remoteAttachmentRoots`, gelen ek yollarını sınırlar (varsayılan: `/Users/*/Library/Messages/Attachments`). +- SCP katı ana bilgisayar anahtarı denetimi kullanır; bu nedenle aktarma ana bilgisayar anahtarının zaten `~/.ssh/known_hosts` içinde bulunduğundan emin olun. +- `channels.imessage.configWrites`: iMessage tarafından başlatılan yapılandırma yazımlarına izin ver veya reddet. +- `type: "acp"` içeren üst düzey `bindings[]` girdileri, iMessage konuşmalarını kalıcı ACP oturumlarına bağlayabilir. `match.peer.id` içinde normalize edilmiş bir handle veya açık sohbet hedefi (`chat_id:*`, `chat_guid:*`, `chat_identifier:*`) kullanın. Ortak alan anlamları: [ACP Agents](/tr/tools/acp-agents#channel-specific-settings). - + ```bash #!/usr/bin/env bash @@ -630,7 +641,7 @@ exec ssh -T gateway-host imsg "$@" ### Matrix -Matrix uzantı desteklidir ve `channels.matrix` altında yapılandırılır. +Matrix, uzantı desteklidir ve `channels.matrix` altında yapılandırılır. ```json5 { @@ -645,7 +656,7 @@ Matrix uzantı desteklidir ve `channels.matrix` altında yapılandırılır. defaultAccount: "ops", accounts: { ops: { - name: "Operasyonlar", + name: "Ops", userId: "@ops:example.org", accessToken: "syt_ops_xxx", }, @@ -660,25 +671,25 @@ Matrix uzantı desteklidir ve `channels.matrix` altında yapılandırılır. } ``` -- Belirteç kimlik doğrulaması `accessToken` kullanır; parola kimlik doğrulaması `userId` + `password` kullanır. +- Token kimlik doğrulama `accessToken` kullanır; parola kimlik doğrulama `userId` + `password` kullanır. - `channels.matrix.proxy`, Matrix HTTP trafiğini açık bir HTTP(S) proxy üzerinden yönlendirir. Adlandırılmış hesaplar bunu `channels.matrix.accounts..proxy` ile geçersiz kılabilir. -- `channels.matrix.network.dangerouslyAllowPrivateNetwork`, özel/iç homeserver’lara izin verir. `proxy` ve bu ağ etkinleştirmesi birbirinden bağımsız kontrollerdir. +- `channels.matrix.network.dangerouslyAllowPrivateNetwork`, özel/iç homeserver'lara izin verir. `proxy` ve bu ağ açık katılımı birbirinden bağımsız kontrollerdir. - `channels.matrix.defaultAccount`, çok hesaplı kurulumlarda tercih edilen hesabı seçer. -- `channels.matrix.autoJoin` varsayılan olarak `off` olduğundan, davet edilen odalar ve yeni DM tarzı davetler siz `autoJoin: "allowlist"` ile `autoJoinAllowlist` ayarlayana veya `autoJoin: "always"` kullanana kadar yok sayılır. -- `channels.matrix.execApprovals`: Matrix yerel exec onay teslimi ve onaylayıcı yetkilendirmesi. +- `channels.matrix.autoJoin` varsayılan olarak `off` olduğundan, davet edilen odalar ve yeni DM tarzı davetler siz `autoJoin: "allowlist"` ile `autoJoinAllowlist` veya `autoJoin: "always"` ayarlayana kadar yok sayılır. +- `channels.matrix.execApprovals`: Matrix yerel exec onay teslimatı ve onaylayıcı yetkilendirmesi. - `enabled`: `true`, `false` veya `"auto"` (varsayılan). Otomatik modda exec onayları, `approvers` veya `commands.ownerAllowFrom` üzerinden onaylayıcılar çözümlenebildiğinde etkinleşir. - `approvers`: exec isteklerini onaylamasına izin verilen Matrix kullanıcı kimlikleri (örn. `@owner:example.org`). - - `agentFilter`: isteğe bağlı ajan kimliği izin listesi. Tüm ajanlar için onay iletmek istiyorsanız atlayın. + - `agentFilter`: isteğe bağlı agent ID izin listesi. Tüm agent'lar için onay iletmek istiyorsanız atlayın. - `sessionFilter`: isteğe bağlı oturum anahtarı desenleri (alt dize veya regex). - `target`: onay istemlerinin nereye gönderileceği. `"dm"` (varsayılan), `"channel"` (kaynak oda) veya `"both"`. - Hesap başına geçersiz kılmalar: `channels.matrix.accounts..execApprovals`. -- `channels.matrix.dm.sessionScope`, Matrix DM’lerinin oturumlar içinde nasıl gruplanacağını kontrol eder: `per-user` (varsayılan) yönlendirilmiş eşe göre paylaşır, `per-room` ise her DM odasını yalıtır. -- Matrix durum yoklamaları ve canlı dizin aramaları, çalışma zamanı trafiğiyle aynı proxy ilkesini kullanır. -- Tam Matrix yapılandırması, hedefleme kuralları ve kurulum örnekleri [Matrix](/tr/channels/matrix) sayfasında belgelenmiştir. +- `channels.matrix.dm.sessionScope`, Matrix DM'lerinin oturumlar içinde nasıl gruplanacağını kontrol eder: `per-user` (varsayılan) yönlendirilmiş eşe göre paylaşır, `per-room` ise her DM odasını yalıtır. +- Matrix durum probları ve canlı dizin aramaları, çalışma zamanı trafiğiyle aynı proxy ilkesini kullanır. +- Tam Matrix yapılandırması, hedefleme kuralları ve kurulum örnekleri [Matrix](/tr/channels/matrix) içinde belgelenmiştir. ### Microsoft Teams -Microsoft Teams uzantı desteklidir ve `channels.msteams` altında yapılandırılır. +Microsoft Teams, uzantı desteklidir ve `channels.msteams` altında yapılandırılır. ```json5 { @@ -686,19 +697,19 @@ Microsoft Teams uzantı desteklidir ve `channels.msteams` altında yapılandır msteams: { enabled: true, configWrites: true, - // appId, appPassword, tenantId, webhook, takım/kanal ilkeleri: + // appId, appPassword, tenantId, webhook, team/channel policies: // bkz. /channels/msteams }, }, } ``` -- Burada kapsanan çekirdek anahtar yolları: `channels.msteams`, `channels.msteams.configWrites`. -- Tam Teams yapılandırması (kimlik bilgileri, webhook, DM/grup ilkesi, takım/kanal başına geçersiz kılmalar) [Microsoft Teams](/tr/channels/msteams) sayfasında belgelenmiştir. +- Burada kapsanan temel anahtar yolları: `channels.msteams`, `channels.msteams.configWrites`. +- Tam Teams yapılandırması (kimlik bilgileri, webhook, DM/grup ilkesi, takım/kanal başına geçersiz kılmalar) [Microsoft Teams](/tr/channels/msteams) içinde belgelenmiştir. ### IRC -IRC uzantı desteklidir ve `channels.irc` altında yapılandırılır. +IRC, uzantı desteklidir ve `channels.irc` altında yapılandırılır. ```json5 { @@ -719,13 +730,13 @@ IRC uzantı desteklidir ve `channels.irc` altında yapılandırılır. } ``` -- Burada kapsanan çekirdek anahtar yolları: `channels.irc`, `channels.irc.dmPolicy`, `channels.irc.configWrites`, `channels.irc.nickserv.*`. +- Burada kapsanan temel anahtar yolları: `channels.irc`, `channels.irc.dmPolicy`, `channels.irc.configWrites`, `channels.irc.nickserv.*`. - İsteğe bağlı `channels.irc.defaultAccount`, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar. -- Tam IRC kanal yapılandırması (host/port/TLS/kanallar/izin listeleri/mention gating) [IRC](/tr/channels/irc) sayfasında belgelenmiştir. +- Tam IRC kanal yapılandırması (host/port/TLS/channels/allowlist'ler/mention geçitleme) [IRC](/tr/channels/irc) içinde belgelenmiştir. ### Çok hesaplı (tüm kanallar) -Kanal başına birden çok hesap çalıştırın (her birinin kendi `accountId` değeri vardır): +Kanal başına birden fazla hesap çalıştırın (her birinin kendi `accountId` değeri vardır): ```json5 { @@ -733,11 +744,11 @@ Kanal başına birden çok hesap çalıştırın (her birinin kendi `accountId` telegram: { accounts: { default: { - name: "Birincil bot", + name: "Primary bot", botToken: "123456:ABC...", }, alerts: { - name: "Uyarı botu", + name: "Alerts bot", botToken: "987654:XYZ...", }, }, @@ -747,27 +758,27 @@ Kanal başına birden çok hesap çalıştırın (her birinin kendi `accountId` ``` - `default`, `accountId` atlandığında kullanılır (CLI + yönlendirme). -- Ortam belirteçleri yalnızca **default** hesap için geçerlidir. -- Temel kanal ayarları, hesap başına geçersiz kılınmadıkları sürece tüm hesaplara uygulanır. -- Her hesabı farklı bir ajana yönlendirmek için `bindings[].match.accountId` kullanın. -- Tek hesaplı üst düzey kanal yapılandırmasındayken `openclaw channels add` (veya kanal onboarding) ile varsayılan olmayan bir hesap eklerseniz, OpenClaw önce hesap kapsamlı üst düzey tek hesap değerlerini kanal hesap eşlemesine taşır, böylece özgün hesap çalışmaya devam eder. Çoğu kanal bunları `channels..accounts.default` içine taşır; Matrix ise mevcut eşleşen adlandırılmış/varsayılan hedefi koruyabilir. -- Mevcut yalnızca kanal bağları (`accountId` olmadan) varsayılan hesapla eşleşmeye devam eder; hesap kapsamlı bağlar isteğe bağlı kalır. -- `openclaw doctor --fix` ayrıca karışık şekilleri de onarır; hesap kapsamlı üst düzey tek hesap değerlerini o kanal için seçilen yükseltilmiş hesaba taşır. Çoğu kanal `accounts.default` kullanır; Matrix ise mevcut eşleşen adlandırılmış/varsayılan hedefi koruyabilir. +- Ortam token'ları yalnızca **default** hesap için geçerlidir. +- Temel kanal ayarları, hesap başına geçersiz kılınmadıkça tüm hesaplara uygulanır. +- Her hesabı farklı bir agent'a yönlendirmek için `bindings[].match.accountId` kullanın. +- Tek hesaplı üst düzey kanal yapılandırmasındayken `openclaw channels add` (veya kanal onboarding) ile varsayılan olmayan bir hesap eklerseniz, OpenClaw önce hesap kapsamlı üst düzey tek hesap değerlerini kanal hesap haritasına taşır; böylece özgün hesap çalışmaya devam eder. Çoğu kanal bunları `channels..accounts.default` altına taşır; Matrix ise mevcut bir eşleşen named/default hedefi koruyabilir. +- Var olan yalnızca kanal düzeyindeki bağlamalar (`accountId` olmadan), varsayılan hesapla eşleşmeye devam eder; hesap kapsamlı bağlamalar isteğe bağlı olmaya devam eder. +- `openclaw doctor --fix`, hesap kapsamlı üst düzey tek hesap değerlerini o kanal için seçilmiş yükseltilmiş hesaba taşıyarak karışık şekilleri de onarır. Çoğu kanal `accounts.default` kullanır; Matrix ise mevcut bir eşleşen named/default hedefi koruyabilir. ### Diğer uzantı kanalları -Birçok uzantı kanalı `channels.` olarak yapılandırılır ve kendi özel kanal sayfalarında belgelenir (örneğin Feishu, Matrix, LINE, Nostr, Zalo, Nextcloud Talk, Synology Chat ve Twitch). -Tam kanal dizini için bkz.: [Channels](/tr/channels). +Birçok uzantı kanalı `channels.` olarak yapılandırılır ve ayrılmış kanal sayfalarında belgelenir (örneğin Feishu, Matrix, LINE, Nostr, Zalo, Nextcloud Talk, Synology Chat ve Twitch). +Tam kanal dizinine bakın: [Kanallar](/tr/channels). -### Grup sohbeti mention gating +### Grup sohbetinde mention geçitleme -Grup mesajları varsayılan olarak **mention gerektirir** (metadata mention veya güvenli regex desenleri). WhatsApp, Telegram, Discord, Google Chat ve iMessage grup sohbetlerinde uygulanır. +Grup mesajları varsayılan olarak **mention gerektirir** (meta veri mention veya güvenli regex desenleri). WhatsApp, Telegram, Discord, Google Chat ve iMessage grup sohbetleri için geçerlidir. **Mention türleri:** -- **Metadata mentions**: Yerel platform @-mention’ları. WhatsApp self-chat modunda yok sayılır. -- **Metin desenleri**: `agents.list[].groupChat.mentionPatterns` içindeki güvenli regex desenleri. Geçersiz desenler ve güvenli olmayan iç içe tekrarlar yok sayılır. -- Mention gating, yalnızca algılama mümkün olduğunda uygulanır (yerel mention’lar veya en az bir desen). +- **Meta veri mention'ları**: Yerel platform @-mention'ları. WhatsApp self-chat modunda yok sayılır. +- **Metin desenleri**: `agents.list[].groupChat.mentionPatterns` içindeki güvenli regex desenleri. Geçersiz desenler ve güvensiz iç içe tekrarlar yok sayılır. +- Mention geçitlemesi yalnızca algılama mümkün olduğunda uygulanır (yerel mention'lar veya en az bir desen). ```json5 { @@ -780,7 +791,7 @@ Grup mesajları varsayılan olarak **mention gerektirir** (metadata mention veya } ``` -`messages.groupChat.historyLimit`, genel varsayılanı ayarlar. Kanallar bunu `channels..historyLimit` ile (veya hesap başına) geçersiz kılabilir. Devre dışı bırakmak için `0` ayarlayın. +`messages.groupChat.historyLimit` genel varsayılanı belirler. Kanallar bunu `channels..historyLimit` (veya hesap başına) ile geçersiz kılabilir. Devre dışı bırakmak için `0` ayarlayın. #### DM geçmiş sınırları @@ -797,13 +808,13 @@ Grup mesajları varsayılan olarak **mention gerektirir** (metadata mention veya } ``` -Çözümleme: DM başına geçersiz kılma → sağlayıcı varsayılanı → sınır yok (tümü tutulur). +Çözümleme: DM başına geçersiz kılma → sağlayıcı varsayılanı → sınır yok (hepsi tutulur). Desteklenenler: `telegram`, `whatsapp`, `discord`, `slack`, `signal`, `imessage`, `msteams`. #### Self-chat modu -Self-chat modunu etkinleştirmek için kendi numaranızı `allowFrom` içine ekleyin (yerel @-mention’ları yok sayar, yalnızca metin desenlerine yanıt verir): +Self-chat modunu etkinleştirmek için kendi numaranızı `allowFrom` içine ekleyin (yerel @-mention'ları yok sayar, yalnızca metin desenlerine yanıt verir): ```json5 { @@ -824,7 +835,7 @@ Self-chat modunu etkinleştirmek için kendi numaranızı `allowFrom` içine ekl } ``` -### Commands (sohbet komutu işleme) +### Komutlar (sohbet komutu işleme) ```json5 { @@ -832,13 +843,13 @@ Self-chat modunu etkinleştirmek için kendi numaranızı `allowFrom` içine ekl native: "auto", // desteklendiğinde yerel komutları kaydet nativeSkills: "auto", // desteklendiğinde yerel skill komutlarını kaydet text: true, // sohbet mesajlarında /commands ayrıştır - bash: false, // ! izin ver (takma ad: /bash) + bash: false, // ! öğesine izin ver (takma ad: /bash) bashForegroundMs: 2000, config: false, // /config izin ver mcp: false, // /mcp izin ver plugins: false, // /plugins izin ver debug: false, // /debug izin ver - restart: true, // /restart + gateway yeniden başlatma aracı izin ver + restart: true, // /restart + gateway restart tool izin ver ownerAllowFrom: ["discord:123456789012345678"], ownerDisplay: "raw", // raw | hash ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}", @@ -853,30 +864,30 @@ Self-chat modunu etkinleştirmek için kendi numaranızı `allowFrom` içine ekl -- Bu blok komut yüzeylerini yapılandırır. Mevcut yerleşik + paketlenmiş komut kataloğu için [Slash Commands](/tr/tools/slash-commands) sayfasına bakın. -- Bu sayfa bir **config-key başvurusu**dur, tam komut kataloğu değildir. QQ Bot `/bot-ping` `/bot-help` `/bot-logs`, LINE `/card`, device-pair `/pair`, memory `/dreaming`, phone-control `/phone` ve Talk `/voice` gibi kanala/eklentiye ait komutlar, kendi kanal/eklenti sayfalarında ve [Slash Commands](/tr/tools/slash-commands) altında belgelenmiştir. +- Bu blok komut yüzeylerini yapılandırır. Güncel yerleşik + paketlenmiş komut kataloğu için bkz. [Slash Komutları](/tr/tools/slash-commands). +- Bu sayfa tam komut kataloğu değil, bir **yapılandırma anahtarı başvurusudur**. QQ Bot `/bot-ping` `/bot-help` `/bot-logs`, LINE `/card`, device-pair `/pair`, memory `/dreaming`, phone-control `/phone` ve Talk `/voice` gibi kanala/plugin'a ait komutlar, kanal/plugin sayfalarında ve [Slash Komutları](/tr/tools/slash-commands) içinde belgelenmiştir. - Metin komutları, başında `/` bulunan **bağımsız** mesajlar olmalıdır. - `native: "auto"`, Discord/Telegram için yerel komutları açar, Slack için kapalı bırakır. - `nativeSkills: "auto"`, Discord/Telegram için yerel skill komutlarını açar, Slack için kapalı bırakır. - Kanal başına geçersiz kılma: `channels.discord.commands.native` (bool veya `"auto"`). `false`, önceden kaydedilmiş komutları temizler. - Yerel skill kaydını kanal başına `channels..commands.nativeSkills` ile geçersiz kılın. -- `channels.telegram.customCommands`, Telegram bot menüsüne ek girişler ekler. -- `bash: true`, ana bilgisayar kabuğu için `! ` etkinleştirir. `tools.elevated.enabled` ve gönderenin `tools.elevated.allowFrom.` içinde olmasını gerektirir. -- `config: true`, `/config` komutunu etkinleştirir (`openclaw.json` okur/yazar). Gateway `chat.send` istemcileri için kalıcı `/config set|unset` yazımları ayrıca `operator.admin` gerektirir; salt okunur `/config show`, normal yazma kapsamlı operatör istemcilerine açık kalır. +- `channels.telegram.customCommands`, ek Telegram bot menü girdileri ekler. +- `bash: true`, ana makine shell'i için `! ` öğesini etkinleştirir. `tools.elevated.enabled` ve gönderenin `tools.elevated.allowFrom.` içinde olması gerekir. +- `config: true`, `/config` komutunu etkinleştirir (`openclaw.json` okur/yazar). Gateway `chat.send` istemcileri için kalıcı `/config set|unset` yazımları ayrıca `operator.admin` gerektirir; salt okunur `/config show` normal yazma kapsamlı operator istemcilerinde kullanılabilir kalır. - `mcp: true`, `mcp.servers` altındaki OpenClaw tarafından yönetilen MCP sunucu yapılandırması için `/mcp` komutunu etkinleştirir. -- `plugins: true`, eklenti keşfi, kurulum ve etkinleştirme/devre dışı bırakma denetimleri için `/plugins` komutunu etkinleştirir. -- `channels..configWrites`, kanal başına yapılandırma mutasyonlarını sınırlar (varsayılan: true). -- Çok hesaplı kanallarda `channels..accounts..configWrites`, o hesabı hedefleyen yazımları da sınırlar (örneğin `/allowlist --config --account ` veya `/config set channels..accounts....`). -- `restart: false`, `/restart` ve gateway yeniden başlatma aracı eylemlerini devre dışı bırakır. Varsayılan: `true`. -- `ownerAllowFrom`, yalnızca sahip için olan komutlar/araçlar için açık sahip izin listesidir. `allowFrom` ile ayrı tutulur. -- `ownerDisplay: "hash"`, sahip kimliklerini sistem isteminde hash’ler. Hashlemeyi kontrol etmek için `ownerDisplaySecret` ayarlayın. -- `allowFrom`, sağlayıcı başınadır. Ayarlandığında tek yetkilendirme kaynağı **budur** (kanal izin listeleri/eşleştirme ve `useAccessGroups` yok sayılır). -- `useAccessGroups: false`, `allowFrom` ayarlanmamışsa komutların erişim grubu ilkelerini atlamasına izin verir. -- Komut belgeleri eşlemesi: - - yerleşik + paketlenmiş katalog: [Slash Commands](/tr/tools/slash-commands) - - kanala özgü komut yüzeyleri: [Channels](/tr/channels) +- `plugins: true`, plugin keşfi, kurulum ve etkinleştirme/devre dışı bırakma denetimleri için `/plugins` komutunu etkinleştirir. +- `channels..configWrites`, kanal başına yapılandırma değişikliklerini kapıdan geçirir (varsayılan: true). +- Çok hesaplı kanallarda `channels..accounts..configWrites`, o hesabı hedefleyen yazımları da kapıdan geçirir (örneğin `/allowlist --config --account ` veya `/config set channels..accounts....`). +- `restart: false`, `/restart` ve gateway restart tool eylemlerini devre dışı bırakır. Varsayılan: `true`. +- `ownerAllowFrom`, yalnızca sahip komutları/araçları için açık sahip izin listesidir. `allowFrom` listesinden ayrıdır. +- `ownerDisplay: "hash"`, sahip kimliklerini sistem prompt'unda hash'ler. Hashlemeyi kontrol etmek için `ownerDisplaySecret` ayarlayın. +- `allowFrom`, sağlayıcı başınadır. Ayarlandığında **tek** yetkilendirme kaynağı olur (kanal allowlist/pairing ve `useAccessGroups` yok sayılır). +- `useAccessGroups: false`, `allowFrom` ayarlı değilse komutların erişim grubu ilkelerini atlamasına izin verir. +- Komut dokümantasyon haritası: + - yerleşik + paketlenmiş katalog: [Slash Komutları](/tr/tools/slash-commands) + - kanala özgü komut yüzeyleri: [Kanallar](/tr/channels) - QQ Bot komutları: [QQ Bot](/tr/channels/qqbot) - - eşleştirme komutları: [Pairing](/tr/channels/pairing) + - eşleme komutları: [Eşleme](/tr/channels/pairing) - LINE kart komutu: [LINE](/tr/channels/line) - memory dreaming: [Dreaming](/tr/concepts/dreaming) @@ -884,7 +895,7 @@ Self-chat modunu etkinleştirmek için kendi numaranızı `allowFrom` içine ekl --- -## Ajan varsayılanları +## Agent varsayılanları ### `agents.defaults.workspace` @@ -898,7 +909,7 @@ Varsayılan: `~/.openclaw/workspace`. ### `agents.defaults.repoRoot` -Sistem isteminin Runtime satırında gösterilen isteğe bağlı depo kökü. Ayarlanmamışsa OpenClaw, workspace’ten yukarı doğru yürüyerek otomatik algılar. +Sistem prompt'unun Runtime satırında gösterilen isteğe bağlı depo kökü. Ayarlı değilse OpenClaw, workspace'ten yukarı doğru yürüyerek otomatik algılar. ```json5 { @@ -908,25 +919,26 @@ Sistem isteminin Runtime satırında gösterilen isteğe bağlı depo kökü. Ay ### `agents.defaults.skills` -`agents.list[].skills` ayarlamayan ajanlar için isteğe bağlı varsayılan skill izin listesi. +`agents.list[].skills` ayarlamayan agent'lar için isteğe bağlı varsayılan skill izin listesi. ```json5 { agents: { defaults: { skills: ["github", "weather"] }, list: [ - { id: "writer" }, // github, weather devralır - { id: "docs", skills: ["docs-search"] }, // varsayılanların yerine geçer + { id: "writer" }, // github, weather kalıtım alır + { id: "docs", skills: ["docs-search"] }, // varsayılanların yerini alır { id: "locked-down", skills: [] }, // skill yok ], }, } ``` -- Varsayılan olarak sınırsız skill için `agents.defaults.skills` değerini atlayın. -- Varsayılanları devralmak için `agents.list[].skills` değerini atlayın. -- Skill olmaması için `agents.list[].skills: []` ayarlayın. -- Boş olmayan bir `agents.list[].skills` listesi, o ajan için nihai kümedir; varsayılanlarla birleşmez. +- Varsayılan olarak sınırsız skills için `agents.defaults.skills` değerini atlayın. +- Varsayılanları kalıtmak için `agents.list[].skills` değerini atlayın. +- Skills olmaması için `agents.list[].skills: []` ayarlayın. +- Boş olmayan bir `agents.list[].skills` listesi, o agent için nihai kümedir; + varsayılanlarla birleşmez. ### `agents.defaults.skipBootstrap` @@ -940,9 +952,9 @@ Workspace bootstrap dosyalarının (`AGENTS.md`, `SOUL.md`, `TOOLS.md`, `IDENTIT ### `agents.defaults.contextInjection` -Workspace bootstrap dosyalarının sistem istemine ne zaman enjekte edileceğini kontrol eder. Varsayılan: `"always"`. +Workspace bootstrap dosyalarının sistem prompt'una ne zaman enjekte edileceğini kontrol eder. Varsayılan: `"always"`. -- `"continuation-skip"`: güvenli devam turları (tamamlanmış bir asistan yanıtından sonra), workspace bootstrap yeniden enjeksiyonunu atlar ve istem boyutunu azaltır. Heartbeat çalışmaları ve sıkıştırma sonrası yeniden denemeler yine bağlamı yeniden oluşturur. +- `"continuation-skip"`: güvenli devam turları (tamamlanmış bir asistan yanıtından sonra) workspace bootstrap yeniden enjeksiyonunu atlar ve prompt boyutunu azaltır. Heartbeat çalıştırmaları ve sıkıştırma sonrası yeniden denemeler yine bağlamı yeniden kurar. ```json5 { @@ -952,7 +964,7 @@ Workspace bootstrap dosyalarının sistem istemine ne zaman enjekte edileceğini ### `agents.defaults.bootstrapMaxChars` -Kırpma öncesi workspace bootstrap dosyası başına en fazla karakter. Varsayılan: `20000`. +Kırpma öncesinde workspace bootstrap dosyası başına en fazla karakter. Varsayılan: `20000`. ```json5 { @@ -962,7 +974,7 @@ Kırpma öncesi workspace bootstrap dosyası başına en fazla karakter. Varsay ### `agents.defaults.bootstrapTotalMaxChars` -Tüm workspace bootstrap dosyalarından enjekte edilen toplam en fazla karakter. Varsayılan: `150000`. +Tüm workspace bootstrap dosyaları boyunca en fazla enjekte edilen toplam karakter. Varsayılan: `150000`. ```json5 { @@ -972,12 +984,12 @@ Tüm workspace bootstrap dosyalarından enjekte edilen toplam en fazla karakter. ### `agents.defaults.bootstrapPromptTruncationWarning` -Bootstrap bağlamı kırpıldığında ajana görünen uyarı metnini kontrol eder. +Bootstrap bağlamı kırpıldığında agent'a görünür uyarı metnini kontrol eder. Varsayılan: `"once"`. -- `"off"`: sistem istemine asla uyarı metni enjekte etme. -- `"once"`: her benzersiz kırpma imzası için bir kez uyarı enjekte et (önerilir). -- `"always"`: kırpma mevcut olduğunda her çalıştırmada uyarı enjekte et. +- `"off"`: sistem prompt'una asla uyarı metni enjekte etme. +- `"once"`: uyarıyı benzersiz her kırpma imzası için bir kez enjekte et (önerilir). +- `"always"`: kırpma mevcut olduğunda her çalıştırmada uyarıyı enjekte et. ```json5 { @@ -987,11 +999,11 @@ Varsayılan: `"once"`. ### `agents.defaults.imageMaxDimensionPx` -Sağlayıcı çağrılarından önce döküm/araç görsel bloklarında en uzun görsel kenarı için en büyük piksel boyutu. +Sağlayıcı çağrılarından önce transcript/tool image bloklarında en uzun görüntü kenarı için azami piksel boyutu. Varsayılan: `1200`. -Daha düşük değerler genellikle görsel belirteç kullanımını ve istek yük boyutunu azaltır. -Daha yüksek değerler daha fazla görsel ayrıntı korur. +Daha düşük değerler genellikle yoğun ekran görüntüsü içeren çalıştırmalarda vision-token kullanımını ve istek yük boyutunu azaltır. +Daha yüksek değerler daha fazla görsel ayrıntıyı korur. ```json5 { @@ -1001,7 +1013,7 @@ Daha yüksek değerler daha fazla görsel ayrıntı korur. ### `agents.defaults.userTimezone` -Sistem istemi bağlamı için saat dilimi (mesaj zaman damgaları değil). Ana bilgisayar saat dilimine geri döner. +Sistem prompt bağlamı için saat dilimi (mesaj zaman damgaları için değil). Ana makine saat dilimine geri döner. ```json5 { @@ -1011,7 +1023,7 @@ Sistem istemi bağlamı için saat dilimi (mesaj zaman damgaları değil). Ana b ### `agents.defaults.timeFormat` -Sistem istemindeki zaman biçimi. Varsayılan: `auto` (OS tercihi). +Sistem prompt'undaki zaman biçimi. Varsayılan: `auto` (işletim sistemi tercihi). ```json5 { @@ -1049,7 +1061,7 @@ Sistem istemindeki zaman biçimi. Varsayılan: `auto` (OS tercihi). primary: "anthropic/claude-opus-4-6", fallbacks: ["openai/gpt-5.4-mini"], }, - params: { cacheRetention: "long" }, // küresel varsayılan sağlayıcı parametreleri + params: { cacheRetention: "long" }, // genel varsayılan provider parametreleri pdfMaxBytesMb: 10, pdfMaxPages: 20, thinkingDefault: "low", @@ -1064,64 +1076,64 @@ Sistem istemindeki zaman biçimi. Varsayılan: `auto` (OS tercihi). } ``` -- `model`: bir dize (`"provider/model"`) veya bir nesne (`{ primary, fallbacks }`) kabul eder. +- `model`: ya bir dize (`"provider/model"`) ya da nesne (`{ primary, fallbacks }`) kabul eder. - Dize biçimi yalnızca birincil modeli ayarlar. - - Nesne biçimi, birincil modeli ve sıralı yedek modelleri ayarlar. -- `imageModel`: bir dize (`"provider/model"`) veya bir nesne (`{ primary, fallbacks }`) kabul eder. - - `image` araç yolu tarafından görsel model yapılandırması olarak kullanılır. - - Ayrıca seçilen/varsayılan model görsel girdiyi kabul edemediğinde yedek yönlendirme olarak da kullanılır. -- `imageGenerationModel`: bir dize (`"provider/model"`) veya bir nesne (`{ primary, fallbacks }`) kabul eder. - - Paylaşılan görsel üretme yeteneği ve görsel üreten gelecekteki tüm araç/eklenti yüzeyleri tarafından kullanılır. - - Tipik değerler: yerel Gemini görsel üretimi için `google/gemini-3.1-flash-image-preview`, fal için `fal/fal-ai/flux/dev` veya OpenAI Images için `openai/gpt-image-1`. - - Bir sağlayıcı/modeli doğrudan seçerseniz, eşleşen sağlayıcı kimlik doğrulamasını/API anahtarını da yapılandırın (örneğin `google/*` için `GEMINI_API_KEY` veya `GOOGLE_API_KEY`, `openai/*` için `OPENAI_API_KEY`, `fal/*` için `FAL_KEY`). - - Atlanırsa `image_generate` yine de kimlik doğrulama destekli bir sağlayıcı varsayılanı çıkarabilir. Önce mevcut varsayılan sağlayıcıyı, ardından sağlayıcı kimliği sırasına göre kalan kayıtlı görsel üretim sağlayıcılarını dener. -- `musicGenerationModel`: bir dize (`"provider/model"`) veya bir nesne (`{ primary, fallbacks }`) kabul eder. - - Paylaşılan müzik üretim yeteneği ve yerleşik `music_generate` aracı tarafından kullanılır. + - Nesne biçimi birincil modeli ve sıralı failover modellerini ayarlar. +- `imageModel`: ya bir dize (`"provider/model"`) ya da nesne (`{ primary, fallbacks }`) kabul eder. + - `image` tool yolu tarafından vision-model yapılandırması olarak kullanılır. + - Ayrıca seçilen/varsayılan model image girişini kabul edemediğinde geri dönüş yönlendirmesi olarak kullanılır. +- `imageGenerationModel`: ya bir dize (`"provider/model"`) ya da nesne (`{ primary, fallbacks }`) kabul eder. + - Paylaşılan image-generation yeteneği ve gelecekte görsel üreten tüm tool/plugin yüzeyleri tarafından kullanılır. + - Tipik değerler: yerel Gemini image generation için `google/gemini-3.1-flash-image-preview`, fal için `fal/fal-ai/flux/dev` veya OpenAI Images için `openai/gpt-image-1`. + - Doğrudan bir provider/model seçerseniz eşleşen provider auth/API anahtarını da yapılandırın (örneğin `google/*` için `GEMINI_API_KEY` veya `GOOGLE_API_KEY`, `openai/*` için `OPENAI_API_KEY`, `fal/*` için `FAL_KEY`). + - Atlanırsa, `image_generate` yine de auth destekli bir provider varsayılanı çıkarabilir. Önce mevcut varsayılan provider'ı, sonra provider-id sırasındaki kalan kayıtlı image-generation provider'larını dener. +- `musicGenerationModel`: ya bir dize (`"provider/model"`) ya da nesne (`{ primary, fallbacks }`) kabul eder. + - Paylaşılan music-generation yeteneği ve yerleşik `music_generate` tool'u tarafından kullanılır. - Tipik değerler: `google/lyria-3-clip-preview`, `google/lyria-3-pro-preview` veya `minimax/music-2.5+`. - - Atlanırsa `music_generate` yine de kimlik doğrulama destekli bir sağlayıcı varsayılanı çıkarabilir. Önce mevcut varsayılan sağlayıcıyı, ardından sağlayıcı kimliği sırasına göre kalan kayıtlı müzik üretim sağlayıcılarını dener. - - Bir sağlayıcı/modeli doğrudan seçerseniz, eşleşen sağlayıcı kimlik doğrulamasını/API anahtarını da yapılandırın. -- `videoGenerationModel`: bir dize (`"provider/model"`) veya bir nesne (`{ primary, fallbacks }`) kabul eder. - - Paylaşılan video üretim yeteneği ve yerleşik `video_generate` aracı tarafından kullanılır. + - Atlanırsa, `music_generate` yine de auth destekli bir provider varsayılanı çıkarabilir. Önce mevcut varsayılan provider'ı, sonra provider-id sırasındaki kalan kayıtlı music-generation provider'larını dener. + - Doğrudan bir provider/model seçerseniz eşleşen provider auth/API anahtarını da yapılandırın. +- `videoGenerationModel`: ya bir dize (`"provider/model"`) ya da nesne (`{ primary, fallbacks }`) kabul eder. + - Paylaşılan video-generation yeteneği ve yerleşik `video_generate` tool'u tarafından kullanılır. - Tipik değerler: `qwen/wan2.6-t2v`, `qwen/wan2.6-i2v`, `qwen/wan2.6-r2v`, `qwen/wan2.6-r2v-flash` veya `qwen/wan2.7-r2v`. - - Atlanırsa `video_generate` yine de kimlik doğrulama destekli bir sağlayıcı varsayılanı çıkarabilir. Önce mevcut varsayılan sağlayıcıyı, ardından sağlayıcı kimliği sırasına göre kalan kayıtlı video üretim sağlayıcılarını dener. - - Bir sağlayıcı/modeli doğrudan seçerseniz, eşleşen sağlayıcı kimlik doğrulamasını/API anahtarını da yapılandırın. - - Paketlenmiş Qwen video üretim sağlayıcısı şu anda en fazla 1 çıktı videosu, 1 girdi görseli, 4 girdi videosu, 10 saniye süre ve sağlayıcı düzeyinde `size`, `aspectRatio`, `resolution`, `audio` ve `watermark` seçeneklerini destekler. -- `pdfModel`: bir dize (`"provider/model"`) veya bir nesne (`{ primary, fallbacks }`) kabul eder. - - `pdf` aracı tarafından model yönlendirme için kullanılır. - - Atlanırsa PDF aracı sırasıyla `imageModel`e, ardından çözümlenmiş oturum/varsayılan modele geri döner. -- `pdfMaxBytesMb`: çağrı sırasında `maxBytesMb` geçirilmediğinde `pdf` aracı için varsayılan PDF boyut sınırı. -- `pdfMaxPages`: `pdf` aracındaki çıkarım yedek modu tarafından dikkate alınan varsayılan en fazla sayfa. -- `verboseDefault`: ajanlar için varsayılan ayrıntı düzeyi. Değerler: `"off"`, `"on"`, `"full"`. Varsayılan: `"off"`. -- `elevatedDefault`: ajanlar için varsayılan elevated-output düzeyi. Değerler: `"off"`, `"on"`, `"ask"`, `"full"`. Varsayılan: `"on"`. -- `model.primary`: `provider/model` biçimi (örn. `openai/gpt-5.4`). Sağlayıcıyı atlayırsanız OpenClaw önce bir takma adı, sonra tam model kimliği için benzersiz yapılandırılmış sağlayıcı eşleşmesini dener ve ancak sonrasında yapılandırılmış varsayılan sağlayıcıya geri döner (eski uyumluluk davranışı, bu yüzden açık `provider/model` tercih edin). Bu sağlayıcı artık yapılandırılmış varsayılan modeli sunmuyorsa, OpenClaw eski kaldırılmış sağlayıcı varsayılanını göstermek yerine yapılandırılmış ilk sağlayıcı/modele geri döner. -- `models`: `/model` için yapılandırılmış model kataloğu ve izin listesi. Her girdi `alias` (kısayol) ve `params` (sağlayıcıya özgü; örn. `temperature`, `maxTokens`, `cacheRetention`, `context1m`) içerebilir. -- `params`: tüm modellere uygulanan küresel varsayılan sağlayıcı parametreleri. `agents.defaults.params` altında ayarlanır (örn. `{ cacheRetention: "long" }`). -- `params` birleştirme önceliği (yapılandırma): `agents.defaults.params` (küresel temel), `agents.defaults.models["provider/model"].params` (model başına) tarafından geçersiz kılınır, ardından `agents.list[].params` (eşleşen ajan kimliği) anahtar bazında bunu geçersiz kılar. Ayrıntılar için [Prompt Caching](/tr/reference/prompt-caching) sayfasına bakın. -- Bu alanları değiştiren yapılandırma yazarları (örn. `/models set`, `/models set-image` ve fallback ekle/kaldır komutları) standart nesne biçimini kaydeder ve mümkün olduğunda mevcut yedek listelerini korur. -- `maxConcurrent`: oturumlar arasında en fazla paralel ajan çalıştırma sayısı (her oturum yine de seri çalışır). Varsayılan: 4. + - Atlanırsa, `video_generate` yine de auth destekli bir provider varsayılanı çıkarabilir. Önce mevcut varsayılan provider'ı, sonra provider-id sırasındaki kalan kayıtlı video-generation provider'larını dener. + - Doğrudan bir provider/model seçerseniz eşleşen provider auth/API anahtarını da yapılandırın. + - Paketlenmiş Qwen video-generation provider'ı şu anda en fazla 1 çıktı videosu, 1 giriş resmi, 4 giriş videosu, 10 saniye süre ve provider düzeyinde `size`, `aspectRatio`, `resolution`, `audio` ve `watermark` seçeneklerini destekler. +- `pdfModel`: ya bir dize (`"provider/model"`) ya da nesne (`{ primary, fallbacks }`) kabul eder. + - Model yönlendirmesi için `pdf` tool'u tarafından kullanılır. + - Atlanırsa PDF tool'u `imageModel` değerine, sonra çözümlenmiş oturum/varsayılan modele geri döner. +- `pdfMaxBytesMb`: çağrı anında `maxBytesMb` geçirilmediğinde `pdf` tool'u için varsayılan PDF boyut sınırı. +- `pdfMaxPages`: `pdf` tool'undaki çıkarım geri dönüş modu tarafından dikkate alınan varsayılan azami sayfa sayısı. +- `verboseDefault`: agent'lar için varsayılan verbose düzeyi. Değerler: `"off"`, `"on"`, `"full"`. Varsayılan: `"off"`. +- `elevatedDefault`: agent'lar için varsayılan elevated-output düzeyi. Değerler: `"off"`, `"on"`, `"ask"`, `"full"`. Varsayılan: `"on"`. +- `model.primary`: biçim `provider/model` (örn. `openai/gpt-5.4`). Sağlayıcıyı atlarsanız OpenClaw önce bir takma adı, ardından tam o model kimliği için benzersiz yapılandırılmış-provider eşleşmesini dener ve ancak sonra yapılandırılmış varsayılan provider'a geri döner (kullanımdan kaldırılmış uyumluluk davranışı, bu yüzden açık `provider/model` tercih edin). Bu provider artık yapılandırılmış varsayılan modeli sunmuyorsa OpenClaw, eski kaldırılmış-provider varsayılanını göstermek yerine ilk yapılandırılmış provider/model'e geri döner. +- `models`: `/model` için yapılandırılmış model kataloğu ve izin listesi. Her giriş `alias` (kısayol) ve `params` (sağlayıcıya özgü; örneğin `temperature`, `maxTokens`, `cacheRetention`, `context1m`) içerebilir. +- `params`: tüm modellere uygulanan genel varsayılan provider parametreleri. `agents.defaults.params` altında ayarlanır (örn. `{ cacheRetention: "long" }`). +- `params` birleşme önceliği (config): `agents.defaults.params` (genel taban), `agents.defaults.models["provider/model"].params` (model başına) tarafından geçersiz kılınır, ardından `agents.list[].params` (eşleşen agent id) anahtar bazında geçersiz kılar. Ayrıntılar için [Prompt Caching](/tr/reference/prompt-caching) bölümüne bakın. +- Bu alanları değiştiren yapılandırma yazarları (örneğin `/models set`, `/models set-image` ve fallback ekle/kaldır komutları), standart nesne biçimini kaydeder ve mümkün olduğunda mevcut fallback listelerini korur. +- `maxConcurrent`: oturumlar arasında en fazla paralel agent çalıştırma sayısı (her oturum yine serileştirilir). Varsayılan: 4. -**Yerleşik takma ad kısaltmaları** (yalnızca model `agents.defaults.models` içinde olduğunda geçerlidir): +**Yerleşik alias kısaltmaları** (`agents.defaults.models` içinde model bulunduğunda geçerlidir): -| Takma ad | Model | -| ------------------ | -------------------------------------- | -| `opus` | `anthropic/claude-opus-4-6` | -| `sonnet` | `anthropic/claude-sonnet-4-6` | -| `gpt` | `openai/gpt-5.4` | -| `gpt-mini` | `openai/gpt-5.4-mini` | -| `gpt-nano` | `openai/gpt-5.4-nano` | -| `gemini` | `google/gemini-3.1-pro-preview` | -| `gemini-flash` | `google/gemini-3-flash-preview` | +| Alias | Model | +| ------------------- | -------------------------------------- | +| `opus` | `anthropic/claude-opus-4-6` | +| `sonnet` | `anthropic/claude-sonnet-4-6` | +| `gpt` | `openai/gpt-5.4` | +| `gpt-mini` | `openai/gpt-5.4-mini` | +| `gpt-nano` | `openai/gpt-5.4-nano` | +| `gemini` | `google/gemini-3.1-pro-preview` | +| `gemini-flash` | `google/gemini-3-flash-preview` | | `gemini-flash-lite` | `google/gemini-3.1-flash-lite-preview` | -Yapılandırdığınız takma adlar her zaman varsayılanların önüne geçer. +Yapılandırdığınız alias'lar her zaman varsayılanların önüne geçer. -Z.AI GLM-4.x modelleri, siz `--thinking off` ayarlamadığınız veya `agents.defaults.models["zai/"].params.thinking` değerini kendiniz tanımlamadığınız sürece thinking modunu otomatik olarak etkinleştirir. -Z.AI modelleri, araç çağrısı akışı için varsayılan olarak `tool_stream` etkinleştirir. Devre dışı bırakmak için `agents.defaults.models["zai/"].params.tool_stream` değerini `false` yapın. -Anthropic Claude 4.6 modelleri, açık bir thinking düzeyi ayarlanmadığında varsayılan olarak `adaptive` thinking kullanır. +Z.AI GLM-4.x modelleri, `--thinking off` ayarlamazsanız veya `agents.defaults.models["zai/"].params.thinking` değerini kendiniz tanımlamazsanız düşünme modunu otomatik etkinleştirir. +Z.AI modelleri, tool çağrı akışı için varsayılan olarak `tool_stream` etkinleştirir. Devre dışı bırakmak için `agents.defaults.models["zai/"].params.tool_stream` değerini `false` yapın. +Anthropic Claude 4.6 modelleri, açık bir düşünme düzeyi ayarlanmadığında varsayılan olarak `adaptive` düşünme kullanır. ### `agents.defaults.cliBackends` -Metin ağırlıklı yedek çalıştırmalar için isteğe bağlı CLI arka uçları (araç çağrısı yok). API sağlayıcıları başarısız olduğunda yedek olarak kullanışlıdır. +Metin odaklı geri dönüş çalıştırmaları için isteğe bağlı CLI backend'leri (tool çağrısı yok). API provider'ları başarısız olduğunda yedek olarak kullanışlıdır. ```json5 { @@ -1149,9 +1161,23 @@ Metin ağırlıklı yedek çalıştırmalar için isteğe bağlı CLI arka uçla } ``` -- CLI arka uçları öncelikle metin odaklıdır; araçlar her zaman devre dışıdır. -- `sessionArg` ayarlı olduğunda oturumlar desteklenir. -- `imageArg` dosya yollarını kabul ettiğinde görsel geçişi desteklenir. +- CLI backend'leri metin önceliklidir; tools her zaman devre dışıdır. +- `sessionArg` ayarlandığında oturumlar desteklenir. +- `imageArg` dosya yollarını kabul ettiğinde görüntü geçişi desteklenir. + +### `agents.defaults.systemPromptOverride` + +OpenClaw tarafından oluşturulan sistem prompt'un tamamını sabit bir dizeyle değiştirin. Varsayılan düzeyde (`agents.defaults.systemPromptOverride`) veya agent başına (`agents.list[].systemPromptOverride`) ayarlayın. Agent başına değerler önceliklidir; boş veya yalnızca boşluk içeren değer yok sayılır. Kontrollü prompt denemeleri için kullanışlıdır. + +```json5 +{ + agents: { + defaults: { + systemPromptOverride: "You are a helpful assistant.", + }, + }, +} +``` ### `agents.defaults.heartbeat` @@ -1165,13 +1191,14 @@ Periyodik heartbeat çalıştırmaları. every: "30m", // 0m devre dışı bırakır model: "openai/gpt-5.4-mini", includeReasoning: false, - lightContext: false, // varsayılan: false; true olduğunda workspace bootstrap dosyalarından yalnızca HEARTBEAT.md tutulur - isolatedSession: false, // varsayılan: false; true olduğunda her heartbeat yeni bir oturumda çalışır (konuşma geçmişi yok) + includeSystemPromptSection: true, // varsayılan: true; false, sistem prompt'undan Heartbeat bölümünü çıkarır + lightContext: false, // varsayılan: false; true, workspace bootstrap dosyalarından yalnızca HEARTBEAT.md dosyasını tutar + isolatedSession: false, // varsayılan: false; true, her heartbeat'i yeni bir oturumda çalıştırır (konuşma geçmişi yok) session: "main", to: "+15555550123", directPolicy: "allow", // allow (varsayılan) | block target: "none", // varsayılan: none | seçenekler: last | whatsapp | telegram | discord | ... - prompt: "Varsa HEARTBEAT.md dosyasını oku...", + prompt: "Read HEARTBEAT.md if it exists...", ackMaxChars: 300, suppressToolErrorWarnings: false, }, @@ -1181,12 +1208,13 @@ Periyodik heartbeat çalıştırmaları. ``` - `every`: süre dizesi (ms/s/m/h). Varsayılan: `30m` (API-key auth) veya `1h` (OAuth auth). Devre dışı bırakmak için `0m` ayarlayın. -- `suppressToolErrorWarnings`: true olduğunda heartbeat çalışmaları sırasında araç hata uyarısı yükleri bastırılır. +- `includeSystemPromptSection`: false olduğunda Heartbeat bölümünü sistem prompt'undan çıkarır ve `HEARTBEAT.md` enjeksiyonunu bootstrap bağlamına dahil etmez. Varsayılan: `true`. +- `suppressToolErrorWarnings`: true olduğunda heartbeat çalıştırmaları sırasında tool hata uyarısı yüklerini bastırır. - `directPolicy`: doğrudan/DM teslim ilkesi. `allow` (varsayılan) doğrudan hedef teslimine izin verir. `block`, doğrudan hedef teslimini bastırır ve `reason=dm-blocked` üretir. -- `lightContext`: true olduğunda heartbeat çalışmaları hafif bootstrap bağlamı kullanır ve workspace bootstrap dosyalarından yalnızca `HEARTBEAT.md` dosyasını tutar. -- `isolatedSession`: true olduğunda her heartbeat önceki konuşma geçmişi olmayan yeni bir oturumda çalışır. Cron `sessionTarget: "isolated"` ile aynı yalıtım düzeni. Heartbeat başına belirteç maliyetini yaklaşık ~100K’den ~2-5K belirtece düşürür. -- Ajan başına: `agents.list[].heartbeat` ayarlayın. Herhangi bir ajan `heartbeat` tanımlarsa heartbeat çalıştıranlar **yalnızca o ajanlar** olur. -- Heartbeat’ler tam ajan turları çalıştırır — daha kısa aralıklar daha fazla belirteç tüketir. +- `lightContext`: true olduğunda heartbeat çalıştırmaları hafif bootstrap bağlamı kullanır ve workspace bootstrap dosyalarından yalnızca `HEARTBEAT.md` dosyasını korur. +- `isolatedSession`: true olduğunda her heartbeat, önceki konuşma geçmişi olmayan yeni bir oturumda çalışır. Cron `sessionTarget: "isolated"` ile aynı yalıtım deseni. Heartbeat başına token maliyetini ~100K'dan ~2-5K token'a düşürür. +- Agent başına: `agents.list[].heartbeat` ayarlayın. Herhangi bir agent `heartbeat` tanımlarsa, heartbeat yalnızca **o agent'lar** için çalışır. +- Heartbeat'ler tam agent turları çalıştırır — daha kısa aralıklar daha fazla token yakar. ### `agents.defaults.compaction` @@ -1196,19 +1224,19 @@ Periyodik heartbeat çalıştırmaları. defaults: { compaction: { mode: "safeguard", // default | safeguard - provider: "my-provider", // kayıtlı bir compaction sağlayıcı eklentisinin kimliği (isteğe bağlı) + provider: "my-provider", // kayıtlı compaction provider plugin'inin id'si (isteğe bağlı) timeoutSeconds: 900, reserveTokensFloor: 24000, identifierPolicy: "strict", // strict | off | custom - identifierInstructions: "Dağıtım kimliklerini, bilet kimliklerini ve host:port çiftlerini tam olarak koru.", // identifierPolicy=custom olduğunda kullanılır + identifierInstructions: "Preserve deployment IDs, ticket IDs, and host:port pairs exactly.", // identifierPolicy=custom olduğunda kullanılır postCompactionSections: ["Session Startup", "Red Lines"], // [] yeniden enjeksiyonu devre dışı bırakır - model: "openrouter/anthropic/claude-sonnet-4-6", // yalnızca compaction için isteğe bağlı model geçersiz kılması - notifyUser: true, // compaction başladığında kullanıcıya kısa bir bildirim gönder (varsayılan: false) + model: "openrouter/anthropic/claude-sonnet-4-6", // isteğe bağlı yalnızca compaction model geçersiz kılması + notifyUser: true, // compaction başladığında kısa bir bildirim gönder (varsayılan: false) memoryFlush: { enabled: true, softThresholdTokens: 6000, - systemPrompt: "Oturum sıkıştırmaya yaklaşıyor. Kalıcı anıları şimdi depola.", - prompt: "Kalıcı notları memory/YYYY-MM-DD.md dosyasına yaz; depolanacak bir şey yoksa tam sessiz belirteç NO_REPLY ile yanıt ver.", + systemPrompt: "Session nearing compaction. Store durable memories now.", + prompt: "Write any lasting notes to memory/YYYY-MM-DD.md; reply with the exact silent token NO_REPLY if nothing to store.", }, }, }, @@ -1217,18 +1245,18 @@ Periyodik heartbeat çalıştırmaları. ``` - `mode`: `default` veya `safeguard` (uzun geçmişler için parçalı özetleme). Bkz. [Compaction](/tr/concepts/compaction). -- `provider`: kayıtlı bir compaction sağlayıcı eklentisinin kimliği. Ayarlandığında yerleşik LLM özetleme yerine sağlayıcının `summarize()` yöntemi çağrılır. Başarısızlıkta yerleşik çözüme geri döner. Bir sağlayıcı ayarlamak `mode: "safeguard"` kullanımını zorunlu kılar. Bkz. [Compaction](/tr/concepts/compaction). -- `timeoutSeconds`: OpenClaw’ın iptal etmeden önce tek bir compaction işlemi için izin verdiği en fazla saniye. Varsayılan: `900`. -- `identifierPolicy`: `strict` (varsayılan), `off` veya `custom`. `strict`, compaction özetleme sırasında yerleşik opak tanımlayıcı koruma yönergelerini öne ekler. +- `provider`: kayıtlı bir compaction provider plugin'inin id'si. Ayarlandığında yerleşik LLM özetleme yerine provider'ın `summarize()` işlevi çağrılır. Başarısızlıkta yerleşik davranışa geri döner. Bir provider ayarlamak `mode: "safeguard"` değerini zorunlu kılar. Bkz. [Compaction](/tr/concepts/compaction). +- `timeoutSeconds`: OpenClaw'ın iptal etmesinden önce tek bir compaction işlemine izin verilen azami saniye sayısı. Varsayılan: `900`. +- `identifierPolicy`: `strict` (varsayılan), `off` veya `custom`. `strict`, compaction özetleme sırasında yerleşik opak tanımlayıcı koruma yönergelerini başa ekler. - `identifierInstructions`: `identifierPolicy=custom` olduğunda kullanılan isteğe bağlı özel tanımlayıcı koruma metni. -- `postCompactionSections`: compaction sonrası yeniden enjekte edilecek isteğe bağlı AGENTS.md H2/H3 bölüm adları. Varsayılan olarak `["Session Startup", "Red Lines"]`; devre dışı bırakmak için `[]` ayarlayın. Ayarlanmamışsa veya açıkça bu varsayılan çift ayarlanmışsa, eski `Every Session`/`Safety` başlıkları da eski uyumluluk yedeği olarak kabul edilir. -- `model`: yalnızca compaction özetleme için isteğe bağlı `provider/model-id` geçersiz kılması. Ana oturum bir modeli kullanırken compaction özetleri başka bir modelde çalışsın istiyorsanız bunu kullanın; ayarlanmadığında compaction, oturumun birincil modelini kullanır. -- `notifyUser`: `true` olduğunda compaction başladığında kullanıcıya kısa bir bildirim gönderir (örneğin, "Bağlam sıkıştırılıyor..."). Compaction’ı sessiz tutmak için varsayılan olarak devre dışıdır. -- `memoryFlush`: otomatik compaction’dan önce kalıcı anıları depolamak için sessiz ajan turu. Workspace salt okunursa atlanır. +- `postCompactionSections`: compaction sonrasında yeniden enjekte edilecek isteğe bağlı AGENTS.md H2/H3 bölüm adları. Varsayılan `["Session Startup", "Red Lines"]`; devre dışı bırakmak için `[]` ayarlayın. Ayarlanmadığında veya açıkça o varsayılan çift olarak ayarlandığında eski `Every Session`/`Safety` başlıkları da eski geri dönüş olarak kabul edilir. +- `model`: yalnızca compaction özetleme için isteğe bağlı `provider/model-id` geçersiz kılması. Ana oturum bir modeli kullanmaya devam ederken compaction özetleri başka bir modelle çalışsın istiyorsanız bunu kullanın; ayarlanmadığında compaction oturumun birincil modelini kullanır. +- `notifyUser`: `true` olduğunda compaction başladığında kullanıcıya kısa bir bildirim gönderir (örneğin, "Compacting context..."). Compaction'ı sessiz tutmak için varsayılan olarak devre dışıdır. +- `memoryFlush`: otomatik compaction öncesinde kalıcı anıları depolamak için sessiz agentic tur. Workspace salt okunursa atlanır. ### `agents.defaults.contextPruning` -LLM’ye göndermeden önce bellekteki bağlamdan **eski araç sonuçlarını** budar. Diskteki oturum geçmişini **değiştirmez**. +LLM'ye göndermeden önce bellek içi bağlamdan **eski tool sonuçlarını** budar. Diskteki oturum geçmişini **değiştirmez**. ```json5 { @@ -1242,7 +1270,7 @@ LLM’ye göndermeden önce bellekteki bağlamdan **eski araç sonuçlarını** hardClearRatio: 0.5, minPrunableToolChars: 50000, softTrim: { maxChars: 4000, headChars: 1500, tailChars: 1500 }, - hardClear: { enabled: true, placeholder: "[Eski araç sonuç içeriği temizlendi]" }, + hardClear: { enabled: true, placeholder: "[Old tool result content cleared]" }, tools: { deny: ["browser", "canvas"] }, }, }, @@ -1250,25 +1278,25 @@ LLM’ye göndermeden önce bellekteki bağlamdan **eski araç sonuçlarını** } ``` - + -- `mode: "cache-ttl"`, budama geçişlerini etkinleştirir. -- `ttl`, budamanın ne sıklıkta yeniden çalışabileceğini kontrol eder (son önbellek dokunuşundan sonra). -- Budama önce büyük araç sonuçlarını yumuşak biçimde kırpar, gerekirse daha eski araç sonuçlarını sert biçimde temizler. +- `mode: "cache-ttl"` budama geçişlerini etkinleştirir. +- `ttl`, son önbellek dokunuşundan sonra budamanın ne sıklıkla tekrar çalışabileceğini kontrol eder. +- Budama önce büyük tool sonuçlarını yumuşak kırpar, sonra gerekirse daha eski tool sonuçlarını tamamen temizler. -**Yumuşak kırpma**, başı + sonu tutar ve ortaya `...` ekler. +**Soft-trim**, başlangıç + sonu korur ve ortasına `...` ekler. -**Sert temizleme**, tüm araç sonucunu yer tutucuyla değiştirir. +**Hard-clear**, tüm tool sonucunu yer tutucuyla değiştirir. Notlar: -- Görsel blokları asla kırpılmaz/temizlenmez. -- Oranlar tam belirteç sayıları değil, karakter tabanlıdır (yaklaşık). -- `keepLastAssistants` kadar asistan mesajı yoksa budama atlanır. +- Image blokları asla kırpılmaz/temizlenmez. +- Oranlar, tam token sayıları değil, karakter tabanlıdır (yaklaşık). +- `keepLastAssistants` sayısından daha az assistant mesajı varsa budama atlanır. -Davranış ayrıntıları için [Session Pruning](/tr/concepts/session-pruning) sayfasına bakın. +Davranış ayrıntıları için [Session Pruning](/tr/concepts/session-pruning) bölümüne bakın. ### Blok akışı @@ -1286,13 +1314,13 @@ Davranış ayrıntıları için [Session Pruning](/tr/concepts/session-pruning) } ``` -- Telegram dışındaki kanallar, blok yanıtlarını etkinleştirmek için açık `*.blockStreaming: true` gerektirir. -- Kanal geçersiz kılmaları: `channels..blockStreamingCoalesce` (ve hesap başına varyantları). Signal/Slack/Discord/Google Chat varsayılanı `minChars: 1500`. -- `humanDelay`: blok yanıtları arasındaki rastgele duraklama. `natural` = 800–2500ms. Ajan başına geçersiz kılma: `agents.list[].humanDelay`. +- Telegram dışındaki kanallar, blok yanıtları etkinleştirmek için açık `*.blockStreaming: true` gerektirir. +- Kanal geçersiz kılmaları: `channels..blockStreamingCoalesce` (ve hesap başına varyantlar). Signal/Slack/Discord/Google Chat varsayılanı `minChars: 1500`. +- `humanDelay`: blok yanıtlar arasında rastgele duraklama. `natural` = 800–2500 ms. Agent başına geçersiz kılma: `agents.list[].humanDelay`. -Davranış + parçalama ayrıntıları için [Streaming](/tr/concepts/streaming) sayfasına bakın. +Davranış + parça ayrıntıları için [Streaming](/tr/concepts/streaming) bölümüne bakın. -### Yazma göstergeleri +### Yazıyor göstergeleri ```json5 { @@ -1305,7 +1333,7 @@ Davranış + parçalama ayrıntıları için [Streaming](/tr/concepts/streaming) } ``` -- Varsayılanlar: doğrudan sohbetler/mention’lar için `instant`, mention içermeyen grup sohbetleri için `message`. +- Varsayılanlar: doğrudan sohbetler/mention'lar için `instant`, mention edilmeyen grup sohbetleri için `message`. - Oturum başına geçersiz kılmalar: `session.typingMode`, `session.typingIntervalSeconds`. Bkz. [Typing Indicators](/tr/concepts/typing-indicators). @@ -1314,7 +1342,7 @@ Bkz. [Typing Indicators](/tr/concepts/typing-indicators). ### `agents.defaults.sandbox` -Gömülü ajan için isteğe bağlı sandboxing. Tam kılavuz için [Sandboxing](/tr/gateway/sandboxing) sayfasına bakın. +Gömülü agent için isteğe bağlı sandboxing. Tam kılavuz için [Sandboxing](/tr/gateway/sandboxing) bölümüne bakın. ```json5 { @@ -1360,7 +1388,7 @@ Gömülü ajan için isteğe bağlı sandboxing. Tam kılavuz için [Sandboxing] identityFile: "~/.ssh/id_ed25519", certificateFile: "~/.ssh/id_ed25519-cert.pub", knownHostsFile: "~/.ssh/known_hosts", - // SecretRef / satır içi içerik de desteklenir: + // SecretRef / satır içi içerikler de desteklenir: // identityData: { source: "env", provider: "default", id: "SSH_IDENTITY" }, // certificateData: { source: "env", provider: "default", id: "SSH_CERTIFICATE" }, // knownHostsData: { source: "env", provider: "default", id: "SSH_KNOWN_HOSTS" }, @@ -1411,52 +1439,53 @@ Gömülü ajan için isteğe bağlı sandboxing. Tam kılavuz için [Sandboxing] -**Arka uç:** +**Backend:** - `docker`: yerel Docker çalışma zamanı (varsayılan) - `ssh`: genel SSH destekli uzak çalışma zamanı - `openshell`: OpenShell çalışma zamanı `backend: "openshell"` seçildiğinde, çalışma zamanına özgü ayarlar -`plugins.entries.openshell.config` altına taşınır. +`plugins.entries.openshell.config` +altına taşınır. -**SSH arka uç yapılandırması:** +**SSH backend yapılandırması:** - `target`: `user@host[:port]` biçiminde SSH hedefi - `command`: SSH istemci komutu (varsayılan: `ssh`) -- `workspaceRoot`: kapsam başına workspace’ler için kullanılan mutlak uzak kök -- `identityFile` / `certificateFile` / `knownHostsFile`: OpenSSH’ye geçirilen mevcut yerel dosyalar -- `identityData` / `certificateData` / `knownHostsData`: OpenClaw’ın çalışma zamanında geçici dosyalara dönüştürdüğü satır içi içerikler veya SecretRef’ler +- `workspaceRoot`: kapsam başına workspace'ler için kullanılan mutlak uzak kök +- `identityFile` / `certificateFile` / `knownHostsFile`: OpenSSH'ye geçirilen mevcut yerel dosyalar +- `identityData` / `certificateData` / `knownHostsData`: OpenClaw'ın çalışma anında geçici dosyalara dönüştürdüğü satır içi içerikler veya SecretRef'ler - `strictHostKeyChecking` / `updateHostKeys`: OpenSSH host-key ilkesi düğmeleri **SSH auth önceliği:** -- `identityData`, `identityFile` üzerine kazanır -- `certificateData`, `certificateFile` üzerine kazanır -- `knownHostsData`, `knownHostsFile` üzerine kazanır -- SecretRef destekli `*Data` değerleri, sandbox oturumu başlamadan önce etkin secrets çalışma zamanı anlık görüntüsünden çözümlenir +- `identityData`, `identityFile` değerinin önüne geçer +- `certificateData`, `certificateFile` değerinin önüne geçer +- `knownHostsData`, `knownHostsFile` değerinin önüne geçer +- SecretRef destekli `*Data` değerleri, sandbox oturumu başlamadan önce etkin secrets çalışma zamanı anlık görüntüsünden çözülür -**SSH arka uç davranışı:** +**SSH backend davranışı:** -- oluşturma veya yeniden oluşturma sonrasında uzak workspace’i bir kez tohumlar -- ardından uzak SSH workspace’ini standart tutar -- `exec`, dosya araçları ve medya yollarını SSH üzerinden yönlendirir -- uzak değişiklikleri otomatik olarak ana bilgisayara geri senkronize etmez -- sandbox tarayıcı kapsayıcılarını desteklemez +- oluşturma veya yeniden oluşturma sonrasında uzak workspace'i bir kez tohumlar +- ardından uzak SSH workspace'ini standart tutar +- `exec`, dosya tools ve medya yollarını SSH üzerinden yönlendirir +- uzak değişiklikleri otomatik olarak ana makineye geri senkronize etmez +- sandbox browser kapsayıcılarını desteklemez **Workspace erişimi:** - `none`: `~/.openclaw/sandboxes` altında kapsam başına sandbox workspace -- `ro`: `/workspace` altındaki sandbox workspace, `/agent` altındaki ajan workspace salt okunur bağlanır -- `rw`: ajan workspace `/workspace` altına okuma/yazma olarak bağlanır +- `ro`: sandbox workspace `/workspace` altında, agent workspace salt okunur olarak `/agent` altında bağlanır +- `rw`: agent workspace okuma/yazma olarak `/workspace` altında bağlanır -**Kapsam:** +**Scope:** - `session`: oturum başına kapsayıcı + workspace -- `agent`: ajan başına bir kapsayıcı + workspace (varsayılan) +- `agent`: agent başına bir kapsayıcı + workspace (varsayılan) - `shared`: paylaşılan kapsayıcı ve workspace (oturumlar arası yalıtım yok) -**OpenShell eklenti yapılandırması:** +**OpenShell plugin yapılandırması:** ```json5 { @@ -1471,7 +1500,7 @@ Gömülü ajan için isteğe bağlı sandboxing. Tam kılavuz için [Sandboxing] remoteAgentWorkspaceDir: "/agent", gateway: "lab", // isteğe bağlı gatewayEndpoint: "https://lab.example", // isteğe bağlı - policy: "strict", // isteğe bağlı OpenShell ilke kimliği + policy: "strict", // isteğe bağlı OpenShell policy id providers: ["openai"], // isteğe bağlı autoProviders: true, timeoutSeconds: 120, @@ -1484,32 +1513,33 @@ Gömülü ajan için isteğe bağlı sandboxing. Tam kılavuz için [Sandboxing] **OpenShell modu:** -- `mirror`: exec öncesi uzak tarafı yerelden tohumla, exec sonrası geri senkronize et; yerel workspace standart kalır -- `remote`: sandbox oluşturulduğunda uzak tarafı bir kez tohumla, ardından uzak workspace standart kalır +- `mirror`: exec öncesinde uzaktaki alanı yerelden tohumla, exec sonrasında geri senkronize et; yerel workspace standart kalır +- `remote`: sandbox oluşturulduğunda uzaktaki alanı bir kez tohumla, ardından uzak workspace standart kalsın -`remote` modunda, OpenClaw dışında ana bilgisayarda yapılan yerel düzenlemeler tohumlama adımından sonra otomatik olarak sandbox’a senkronize edilmez. -Taşıma SSH ile OpenShell sandbox’ına yapılır, ancak sandbox yaşam döngüsünü ve isteğe bağlı mirror senkronizasyonunu eklenti yönetir. +`remote` modunda, OpenClaw dışında ana makinede yapılan yerel düzenlemeler tohum adımından sonra otomatik olarak sandbox içine senkronize edilmez. +Aktarım, OpenShell sandbox içine SSH ile yapılır; ancak sandbox yaşam döngüsü ve isteğe bağlı mirror sync plugin tarafından yönetilir. -**`setupCommand`**, kapsayıcı oluşturulduktan sonra bir kez çalışır (`sh -lc` ile). Ağ çıkışı, yazılabilir kök ve root kullanıcı gerektirir. +**`setupCommand`**, kapsayıcı oluşturulduktan sonra bir kez çalışır (`sh -lc` üzerinden). Ağ çıkışı, yazılabilir kök ve root kullanıcı gerekir. -**Kapsayıcılar varsayılan olarak `network: "none"` ile gelir** — ajan dış erişime ihtiyaç duyuyorsa `"bridge"` (veya özel bir bridge ağı) olarak ayarlayın. -`"host"` engellenir. `"container:"` varsayılan olarak engellenir; bunu yalnızca açıkça -`sandbox.docker.dangerouslyAllowContainerNamespaceJoin: true` ayarlarsanız kullanabilirsiniz (acil durum). +**Kapsayıcılar varsayılan olarak `network: "none"` kullanır** — agent'ın dış erişime ihtiyacı varsa `"bridge"` (veya özel bir bridge network) olarak ayarlayın. +`"host"` engellenir. `"container:"`, yalnızca +`sandbox.docker.dangerouslyAllowContainerNamespaceJoin: true` ayarlarsanız +varsayılan olarak engellenmez (acil durum modu). -**Gelen ek dosyalar**, etkin workspace içindeki `media/inbound/*` içine hazırlanır. +**Gelen ekler**, etkin workspace içinde `media/inbound/*` alanına hazırlanır. -**`docker.binds`**, ek ana bilgisayar dizinlerini bağlar; genel ve ajan başına binds birleştirilir. +**`docker.binds`**, ek ana makine dizinlerini bağlar; genel ve agent başına binds birleştirilir. -**Sandboxed browser** (`sandbox.browser.enabled`): kapsayıcı içinde Chromium + CDP. noVNC URL’si sistem istemine enjekte edilir. `openclaw.json` içinde `browser.enabled` gerektirmez. -noVNC gözlemci erişimi varsayılan olarak VNC auth kullanır ve OpenClaw, paylaşılan URL’de parolayı açığa çıkarmak yerine kısa ömürlü belirteç URL’si üretir. +**Sandboxed browser** (`sandbox.browser.enabled`): Kapsayıcı içinde Chromium + CDP. noVNC URL'si sistem prompt'una enjekte edilir. `openclaw.json` içinde `browser.enabled` gerektirmez. +noVNC gözlemci erişimi varsayılan olarak VNC auth kullanır ve OpenClaw, paylaşılan URL'de parola göstermek yerine kısa ömürlü token URL üretir. -- `allowHostControl: false` (varsayılan), sandbox oturumlarının ana bilgisayar tarayıcısını hedeflemesini engeller. -- `network` varsayılanı `openclaw-sandbox-browser` (özel bridge ağı). Genel bridge bağlantısı istiyorsanız yalnızca açıkça `bridge` ayarlayın. -- `cdpSourceRange`, isteğe bağlı olarak CDP girişini kapsayıcı kenarında bir CIDR aralığıyla sınırlar (örneğin `172.21.0.1/32`). -- `sandbox.browser.binds`, ek ana bilgisayar dizinlerini yalnızca sandbox tarayıcı kapsayıcısına bağlar. Ayarlandığında (`[]` dahil), tarayıcı kapsayıcısı için `docker.binds` yerine geçer. -- Başlatma varsayılanları `scripts/sandbox-browser-entrypoint.sh` içinde tanımlıdır ve kapsayıcı ana bilgisayarları için ayarlanmıştır: +- `allowHostControl: false` (varsayılan), sandboxed oturumların ana makine tarayıcısını hedeflemesini engeller. +- `network` varsayılanı `openclaw-sandbox-browser`'dır (ayrılmış bridge network). Küresel bridge bağlantısını açıkça istiyorsanız yalnızca `bridge` ayarlayın. +- `cdpSourceRange`, isteğe bağlı olarak CDP girişini kapsayıcı sınırında bir CIDR aralığına kısıtlar (örneğin `172.21.0.1/32`). +- `sandbox.browser.binds`, ek ana makine dizinlerini yalnızca sandbox browser kapsayıcısı içine bağlar. Ayarlandığında (`[]` dahil), browser kapsayıcısı için `docker.binds` değerinin yerini alır. +- Başlatma varsayılanları `scripts/sandbox-browser-entrypoint.sh` içinde tanımlanır ve kapsayıcı ana makineleri için ayarlanmıştır: - `--remote-debugging-address=127.0.0.1` - - `--remote-debugging-port=` + - `--remote-debugging-port=` - `--user-data-dir=${HOME}/.chrome` - `--no-first-run` - `--no-default-browser-check` @@ -1527,28 +1557,30 @@ noVNC gözlemci erişimi varsayılan olarak VNC auth kullanır ve OpenClaw, payl - `--disable-extensions` (varsayılan olarak etkin) - `--disable-3d-apis`, `--disable-software-rasterizer` ve `--disable-gpu` varsayılan olarak etkindir ve WebGL/3D kullanımı gerektiriyorsa - `OPENCLAW_BROWSER_DISABLE_GRAPHICS_FLAGS=0` ile devre dışı bırakılabilir. - - `OPENCLAW_BROWSER_DISABLE_EXTENSIONS=0`, iş akışınız buna bağlıysa - uzantıları yeniden etkinleştirir. - - `--renderer-process-limit=2`, şu değişkenle değiştirilebilir: - `OPENCLAW_BROWSER_RENDERER_PROCESS_LIMIT=`; Chromium’nun - varsayılan işlem sınırını kullanmak için `0` ayarlayın. - - artı `noSandbox` etkinse `--no-sandbox` ve `--disable-setuid-sandbox`. - - Varsayılanlar kapsayıcı görseli temel çizgisidir; kapsayıcı varsayılanlarını değiştirmek için özel - giriş noktasına sahip özel bir tarayıcı görseli kullanın. + `OPENCLAW_BROWSER_DISABLE_GRAPHICS_FLAGS=0` + ile devre dışı bırakılabilir. + - `OPENCLAW_BROWSER_DISABLE_EXTENSIONS=0`, iş akışınız + bunlara bağlıysa uzantıları yeniden etkinleştirir. + - `--renderer-process-limit=2`, + `OPENCLAW_BROWSER_RENDERER_PROCESS_LIMIT=` + ile değiştirilebilir; Chromium'un + varsayılan süreç sınırını kullanmak için `0` ayarlayın. + - ayrıca `noSandbox` etkin olduğunda `--no-sandbox` ve `--disable-setuid-sandbox`. + - Varsayılanlar kapsayıcı image taban çizgisidir; kapsayıcı varsayılanlarını değiştirmek için + özel entrypoint içeren özel bir browser image kullanın. -Tarayıcı sandboxing ve `sandbox.docker.binds` şu anda yalnızca Docker’da desteklenir. +Browser sandboxing ve `sandbox.docker.binds` şu anda yalnızca Docker içindir. -Görselleri oluşturun: +Image'leri oluşturun: ```bash -scripts/sandbox-setup.sh # ana sandbox görseli -scripts/sandbox-browser-setup.sh # isteğe bağlı tarayıcı görseli +scripts/sandbox-setup.sh # ana sandbox image'i +scripts/sandbox-browser-setup.sh # isteğe bağlı browser image'i ``` -### `agents.list` (ajan başına geçersiz kılmalar) +### `agents.list` (agent başına geçersiz kılmalar) ```json5 { @@ -1557,18 +1589,18 @@ scripts/sandbox-browser-setup.sh # isteğe bağlı tarayıcı görseli { id: "main", default: true, - name: "Ana Ajan", + name: "Main Agent", workspace: "~/.openclaw/workspace", agentDir: "~/.openclaw/agents/main/agent", model: "anthropic/claude-opus-4-6", // veya { primary, fallbacks } - thinkingDefault: "high", // ajan başına thinking düzeyi geçersiz kılması - reasoningDefault: "on", // ajan başına reasoning görünürlüğü geçersiz kılması - fastModeDefault: false, // ajan başına hızlı mod geçersiz kılması + thinkingDefault: "high", // agent başına düşünme düzeyi geçersiz kılması + reasoningDefault: "on", // agent başına muhakeme görünürlüğü geçersiz kılması + fastModeDefault: false, // agent başına fast mode geçersiz kılması params: { cacheRetention: "none" }, // eşleşen defaults.models params değerlerini anahtar bazında geçersiz kılar - skills: ["docs-search"], // ayarlanırsa agents.defaults.skills değerinin yerine geçer + skills: ["docs-search"], // ayarlanırsa agents.defaults.skills değerinin yerini alır identity: { name: "Samantha", - theme: "yardımsever tembel hayvan", + theme: "helpful sloth", emoji: "🦥", avatar: "avatars/samantha.png", }, @@ -1596,26 +1628,26 @@ scripts/sandbox-browser-setup.sh # isteğe bağlı tarayıcı görseli } ``` -- `id`: kararlı ajan kimliği (zorunlu). -- `default`: birden fazla ayarlıysa ilk olan kazanır (uyarı günlüğe yazılır). Hiçbiri ayarlı değilse listedeki ilk giriş varsayılandır. -- `model`: dize biçimi yalnızca `primary` değerini geçersiz kılar; nesne biçimi `{ primary, fallbacks }` her ikisini de geçersiz kılar (`[]`, küresel fallbacks’i devre dışı bırakır). Yalnızca `primary` geçersiz kılan cron işleri, siz `fallbacks: []` ayarlamazsanız varsayılan fallbacks’i devralmaya devam eder. -- `params`: `agents.defaults.models` içindeki seçili model girdisi üzerine birleştirilen ajan başına akış parametreleri. Tüm model kataloğunu kopyalamadan `cacheRetention`, `temperature` veya `maxTokens` gibi ajana özgü geçersiz kılmalar için bunu kullanın. -- `skills`: isteğe bağlı ajan başına skill izin listesi. Atlanırsa ajan, ayarlanmışsa `agents.defaults.skills` değerini devralır; açık bir liste varsayılanlarla birleşmek yerine onların yerine geçer ve `[]` skill olmadığını belirtir. -- `thinkingDefault`: isteğe bağlı ajan başına varsayılan thinking düzeyi (`off | minimal | low | medium | high | xhigh | adaptive`). Bu ajan için, mesaj başına veya oturum başına geçersiz kılma ayarlanmadığında `agents.defaults.thinkingDefault` değerini geçersiz kılar. -- `reasoningDefault`: isteğe bağlı ajan başına varsayılan reasoning görünürlüğü (`on | off | stream`). Mesaj başına veya oturum başına reasoning geçersiz kılması ayarlanmadığında uygulanır. -- `fastModeDefault`: isteğe bağlı ajan başına hızlı mod varsayılanı (`true | false`). Mesaj başına veya oturum başına hızlı mod geçersiz kılması ayarlanmadığında uygulanır. -- `runtime`: isteğe bağlı ajan başına çalışma zamanı tanımlayıcısı. Ajanın varsayılan olarak ACP harness oturumları kullanması gerektiğinde `type: "acp"` ile `runtime.acp` varsayılanlarını (`agent`, `backend`, `mode`, `cwd`) kullanın. -- `identity.avatar`: workspace’e göreli yol, `http(s)` URL’si veya `data:` URI. -- `identity` varsayılanları türetir: `ackReaction`, `emoji`den; `mentionPatterns`, `name`/`emoji`den. -- `subagents.allowAgents`: `sessions_spawn` için ajan kimlikleri izin listesi (`["*"]` = herhangi biri; varsayılan: yalnızca aynı ajan). -- Sandbox devralma koruması: istekte bulunan oturum sandbox içindeyse, `sessions_spawn` sandbox dışında çalışacak hedefleri reddeder. -- `subagents.requireAgentId`: true olduğunda `agentId` içermeyen `sessions_spawn` çağrılarını engeller (açık profil seçimini zorunlu kılar; varsayılan: false). +- `id`: kararlı agent kimliği (gerekli). +- `default`: birden fazla ayarlandığında ilk olan kazanır (uyarı kaydedilir). Hiçbiri ayarlı değilse ilk liste girdisi varsayılandır. +- `model`: dize biçimi yalnızca `primary` değerini geçersiz kılar; nesne biçimi `{ primary, fallbacks }` her ikisini de geçersiz kılar (`[]` genel fallbacks'i devre dışı bırakır). Yalnızca `primary` geçersiz kılan cron görevleri, `fallbacks: []` ayarlamadığınız sürece varsayılan fallbacks'i kalıtır. +- `params`: `agents.defaults.models` içindeki seçili model girdisi üzerine birleştirilen agent başına stream params. `cacheRetention`, `temperature` veya `maxTokens` gibi agent'a özgü geçersiz kılmalar için tüm model kataloğunu kopyalamadan bunu kullanın. +- `skills`: isteğe bağlı agent başına skill izin listesi. Atlanırsa agent, ayarlı olduğunda `agents.defaults.skills` değerini kalıtır; açık bir liste, varsayılanlarla birleşmek yerine onların yerini alır ve `[]` skills yok demektir. +- `thinkingDefault`: isteğe bağlı agent başına varsayılan düşünme düzeyi (`off | minimal | low | medium | high | xhigh | adaptive`). Mesaj başına veya oturum geçersiz kılması ayarlı olmadığında bu agent için `agents.defaults.thinkingDefault` değerinin yerini alır. +- `reasoningDefault`: isteğe bağlı agent başına varsayılan muhakeme görünürlüğü (`on | off | stream`). Mesaj başına veya oturum muhakeme geçersiz kılması ayarlı olmadığında uygulanır. +- `fastModeDefault`: fast mode için isteğe bağlı agent başına varsayılan (`true | false`). Mesaj başına veya oturum fast-mode geçersiz kılması ayarlı olmadığında uygulanır. +- `runtime`: isteğe bağlı agent başına çalışma zamanı tanımlayıcısı. Agent varsayılan olarak ACP harness oturumları kullanacaksa `runtime.acp` varsayılanları (`agent`, `backend`, `mode`, `cwd`) ile `type: "acp"` kullanın. +- `identity.avatar`: workspace'e göre göreli yol, `http(s)` URL veya `data:` URI. +- `identity`, varsayılanlar türetir: `emoji` üzerinden `ackReaction`, `name`/`emoji` üzerinden `mentionPatterns`. +- `subagents.allowAgents`: `sessions_spawn` için agent id izin listesi (`["*"]` = herhangi biri; varsayılan: yalnızca aynı agent). +- Sandbox kalıtım koruması: istekte bulunan oturum sandbox içindeyse, `sessions_spawn` sandbox dışında çalışacak hedefleri reddeder. +- `subagents.requireAgentId`: true olduğunda `agentId` belirtilmeden yapılan `sessions_spawn` çağrılarını engeller (açık profil seçimini zorlar; varsayılan: false). --- -## Çok ajanlı yönlendirme +## Çok agent'lı yönlendirme -Tek bir Gateway içinde birden çok yalıtılmış ajan çalıştırın. Bkz. [Multi-Agent](/tr/concepts/multi-agent). +Tek bir Gateway içinde birden fazla yalıtılmış agent çalıştırın. Bkz. [Multi-Agent](/tr/concepts/multi-agent). ```json5 { @@ -1632,10 +1664,10 @@ Tek bir Gateway içinde birden çok yalıtılmış ajan çalıştırın. Bkz. [M } ``` -### Bağ eşleştirme alanları +### Bağlama eşleşme alanları -- `type` (isteğe bağlı): normal yönlendirme için `route` (tip eksikse varsayılan route olur), kalıcı ACP konuşma bağları için `acp`. -- `match.channel` (zorunlu) +- `type` (isteğe bağlı): normal yönlendirme için `route` (type eksikse varsayılan route), kalıcı ACP konuşma bağlamaları için `acp`. +- `match.channel` (gerekli) - `match.accountId` (isteğe bağlı; `*` = herhangi bir hesap; atlanırsa = varsayılan hesap) - `match.peer` (isteğe bağlı; `{ kind: direct|group|channel, id }`) - `match.guildId` / `match.teamId` (isteğe bağlı; kanala özgü) @@ -1646,15 +1678,15 @@ Tek bir Gateway içinde birden çok yalıtılmış ajan çalıştırın. Bkz. [M 1. `match.peer` 2. `match.guildId` 3. `match.teamId` -4. `match.accountId` (tam eşleşme, peer/guild/team olmadan) +4. `match.accountId` (tam, peer/guild/team olmadan) 5. `match.accountId: "*"` (kanal genelinde) -6. Varsayılan ajan +6. Varsayılan agent -Her katmanda ilk eşleşen `bindings` girdisi kazanır. +Her kademede ilk eşleşen `bindings` girdisi kazanır. -`type: "acp"` girdileri için OpenClaw, tam konuşma kimliğine göre çözümler (`match.channel` + hesap + `match.peer.id`) ve yukarıdaki route binding katman sırasını kullanmaz. +`type: "acp"` girdileri için OpenClaw, tam konuşma kimliğine göre (`match.channel` + hesap + `match.peer.id`) çözümler ve yukarıdaki route binding kademe sırasını kullanmaz. -### Ajan başına erişim profilleri +### Agent başına erişim profilleri @@ -1674,7 +1706,7 @@ Her katmanda ilk eşleşen `bindings` girdisi kazanır. - + ```json5 { @@ -1749,11 +1781,11 @@ Her katmanda ilk eşleşen `bindings` girdisi kazanır. -Öncelik ayrıntıları için [Multi-Agent Sandbox & Tools](/tr/tools/multi-agent-sandbox-tools) sayfasına bakın. +Öncelik ayrıntıları için [Multi-Agent Sandbox & Tools](/tr/tools/multi-agent-sandbox-tools) bölümüne bakın. --- -## Session +## Oturum ```json5 { @@ -1775,7 +1807,7 @@ Her katmanda ilk eşleşen `bindings` girdisi kazanır. }, resetTriggers: ["/new", "/reset"], store: "~/.openclaw/agents/{agentId}/sessions/sessions.json", - parentForkMaxTokens: 100000, // üst iş parçacığı fork’u bu belirteç sayısının üzerinde atlanır (0 devre dışı bırakır) + parentForkMaxTokens: 100000, // bu token sayısının üstünde üst-thread çatallaması atlanır (0 devre dışı bırakır) maintenance: { mode: "warn", // warn | enforce pruneAfter: "30d", @@ -1787,8 +1819,8 @@ Her katmanda ilk eşleşen `bindings` girdisi kazanır. }, threadBindings: { enabled: true, - idleHours: 24, // varsayılan etkinliksizlik sonrası otomatik odak kaldırma saati (`0` devre dışı bırakır) - maxAgeHours: 0, // varsayılan katı maksimum yaş saati (`0` devre dışı bırakır) + idleHours: 24, // varsayılan etkinliksizlik sonrası otomatik odak kaldırma saat cinsinden (`0` devre dışı bırakır) + maxAgeHours: 0, // varsayılan katı maksimum yaş saat cinsinden (`0` devre dışı bırakır) }, mainKey: "main", // eski (çalışma zamanı her zaman "main" kullanır) agentToAgent: { maxPingPongTurns: 5 }, @@ -1803,31 +1835,31 @@ Her katmanda ilk eşleşen `bindings` girdisi kazanır. - **`scope`**: grup sohbeti bağlamları için temel oturum gruplama stratejisi. - - `per-sender` (varsayılan): her gönderen, kanal bağlamı içinde yalıtılmış bir oturum alır. - - `global`: kanal bağlamındaki tüm katılımcılar tek bir oturumu paylaşır (yalnızca paylaşılan bağlam isteniyorsa kullanın). -- **`dmScope`**: DM’lerin nasıl gruplanacağı. - - `main`: tüm DM’ler ana oturumu paylaşır. - - `per-peer`: gönderen kimliğine göre kanallar arası yalıtır. - - `per-channel-peer`: kanal + gönderen başına yalıtır (çok kullanıcılı gelen kutuları için önerilir). - - `per-account-channel-peer`: hesap + kanal + gönderen başına yalıtır (çok hesaplı kullanım için önerilir). -- **`identityLinks`**: kanallar arası oturum paylaşımı için standart kimlikleri sağlayıcı önekli eşlere eşleyen harita. -- **`reset`**: birincil sıfırlama ilkesi. `daily`, yerel saatle `atHour` değerinde sıfırlar; `idle`, `idleMinutes` sonrasında sıfırlar. Her ikisi de yapılandırıldıysa önce süresi dolan kazanır. + - `per-sender` (varsayılan): her gönderici, bir kanal bağlamı içinde yalıtılmış bir oturum alır. + - `global`: bir kanal bağlamındaki tüm katılımcılar tek bir oturumu paylaşır (yalnızca paylaşılan bağlam amaçlandığında kullanın). +- **`dmScope`**: DM'lerin nasıl gruplandığı. + - `main`: tüm DM'ler ana oturumu paylaşır. + - `per-peer`: kanallar arasında gönderici kimliğine göre yalıt. + - `per-channel-peer`: kanal + gönderici bazında yalıt (çok kullanıcılı gelen kutuları için önerilir). + - `per-account-channel-peer`: hesap + kanal + gönderici bazında yalıt (çok hesaplı kullanım için önerilir). +- **`identityLinks`**: kanallar arası oturum paylaşımı için standart kimlikleri provider önekli eşlere eşler. +- **`reset`**: birincil sıfırlama ilkesi. `daily`, yerel saate göre `atHour` saatinde sıfırlar; `idle`, `idleMinutes` sonra sıfırlar. Her ikisi de yapılandırılmışsa önce süresi dolan kazanır. - **`resetByType`**: tür başına geçersiz kılmalar (`direct`, `group`, `thread`). Eski `dm`, `direct` için takma ad olarak kabul edilir. -- **`parentForkMaxTokens`**: çatallanmış iş parçacığı oturumu oluştururken izin verilen en fazla üst oturum `totalTokens` değeri (varsayılan `100000`). - - Üst oturumun `totalTokens` değeri bunun üzerindeyse, OpenClaw üst döküm geçmişini devralmak yerine yeni bir iş parçacığı oturumu başlatır. - - Bu korumayı devre dışı bırakmak ve her zaman üst fork’a izin vermek için `0` ayarlayın. -- **`mainKey`**: eski alan. Çalışma zamanı artık ana doğrudan sohbet kovası için her zaman `"main"` kullanır. -- **`agentToAgent.maxPingPongTurns`**: ajanlar arası alışverişlerde ajanlar arasında izin verilen en fazla karşılıklı yanıt turu (tam sayı, aralık: `0`–`5`). `0`, ping-pong zincirlemeyi devre dışı bırakır. +- **`parentForkMaxTokens`**: çatallanmış bir thread oturumu oluştururken izin verilen en yüksek üst oturum `totalTokens` değeri (varsayılan `100000`). + - Üst `totalTokens` bu değerin üzerindeyse OpenClaw, üst transcript geçmişini devralmak yerine yeni bir thread oturumu başlatır. + - Bu korumayı devre dışı bırakmak ve her zaman üst çatallamaya izin vermek için `0` ayarlayın. +- **`mainKey`**: eski alandır. Çalışma zamanı artık ana doğrudan sohbet kovası için her zaman `"main"` kullanır. +- **`agentToAgent.maxPingPongTurns`**: agent'tan agent'a alışverişlerde agent'lar arasındaki en fazla geri yanıtlama turu (tamsayı, aralık: `0`–`5`). `0`, ping-pong zincirlemesini devre dışı bırakır. - **`sendPolicy`**: `channel`, `chatType` (`direct|group|channel`, eski `dm` takma adıyla), `keyPrefix` veya `rawKeyPrefix` ile eşleştirin. İlk deny kazanır. -- **`maintenance`**: oturum deposu temizliği + saklama denetimleri. - - `mode`: `warn` yalnızca uyarılar üretir; `enforce` temizliği uygular. - - `pruneAfter`: eski girdiler için yaş kesimi (varsayılan `30d`). - - `maxEntries`: `sessions.json` içindeki en fazla girdi sayısı (varsayılan `500`). - - `rotateBytes`: `sessions.json` bu boyutu aştığında döndürülür (varsayılan `10mb`). - - `resetArchiveRetention`: `*.reset.` döküm arşivleri için saklama süresi. Varsayılan olarak `pruneAfter` değerini kullanır; devre dışı bırakmak için `false` ayarlayın. - - `maxDiskBytes`: isteğe bağlı oturumlar dizini disk bütçesi. `warn` modunda uyarı yazar; `enforce` modunda en eski artifaktları/oturumları önce kaldırır. - - `highWaterBytes`: bütçe temizliği sonrası isteğe bağlı hedef. Varsayılan olarak `maxDiskBytes` değerinin `%80`’idir. -- **`threadBindings`**: iş parçacığı bağlı oturum özellikleri için küresel varsayılanlar. +- **`maintenance`**: oturum deposu temizleme + saklama denetimleri. + - `mode`: `warn` yalnızca uyarı üretir; `enforce` temizlemeyi uygular. + - `pruneAfter`: eski girdiler için yaş kesme noktası (varsayılan `30d`). + - `maxEntries`: `sessions.json` içindeki azami girdi sayısı (varsayılan `500`). + - `rotateBytes`: `sessions.json` bu boyutu aştığında döndür (varsayılan `10mb`). + - `resetArchiveRetention`: `*.reset.` transcript arşivleri için saklama süresi. Varsayılan `pruneAfter`; devre dışı bırakmak için `false` ayarlayın. + - `maxDiskBytes`: oturumlar dizini için isteğe bağlı disk bütçesi. `warn` modunda uyarı kaydeder; `enforce` modunda önce en eski yapıtları/oturumları kaldırır. + - `highWaterBytes`: bütçe temizliğinden sonraki isteğe bağlı hedef. Varsayılan olarak `maxDiskBytes` değerinin `%80`'idir. +- **`threadBindings`**: thread'e bağlı oturum özellikleri için genel varsayılanlar. - `enabled`: ana varsayılan anahtar (sağlayıcılar geçersiz kılabilir; Discord `channels.discord.threadBindings.enabled` kullanır) - `idleHours`: saat cinsinden varsayılan etkinliksizlik sonrası otomatik odak kaldırma (`0` devre dışı bırakır; sağlayıcılar geçersiz kılabilir) - `maxAgeHours`: saat cinsinden varsayılan katı maksimum yaş (`0` devre dışı bırakır; sağlayıcılar geçersiz kılabilir) @@ -1836,7 +1868,7 @@ Her katmanda ilk eşleşen `bindings` girdisi kazanır. --- -## Messages +## Mesajlar ```json5 { @@ -1870,36 +1902,36 @@ Her katmanda ilk eşleşen `bindings` girdisi kazanır. Kanal/hesap başına geçersiz kılmalar: `channels..responsePrefix`, `channels..accounts..responsePrefix`. -Çözümleme (en özeli kazanır): hesap → kanal → genel. `""` devre dışı bırakır ve zinciri durdurur. `"auto"`, `[{identity.name}]` türetir. +Çözümleme (en özelleşmiş kazanır): hesap → kanal → genel. `""` devre dışı bırakır ve zinciri durdurur. `"auto"`, `[{identity.name}]` türetir. **Şablon değişkenleri:** -| Değişken | Açıklama | Örnek | -| ---------------- | ---------------------- | --------------------------- | -| `{model}` | Kısa model adı | `claude-opus-4-6` | +| Değişken | Açıklama | Örnek | +| ---------------- | -------------------- | --------------------------- | +| `{model}` | Kısa model adı | `claude-opus-4-6` | | `{modelFull}` | Tam model tanımlayıcısı | `anthropic/claude-opus-4-6` | -| `{provider}` | Sağlayıcı adı | `anthropic` | -| `{thinkingLevel}` | Geçerli thinking düzeyi | `high`, `low`, `off` | -| `{identity.name}` | Ajan kimlik adı | (`"auto"` ile aynı) | +| `{provider}` | Sağlayıcı adı | `anthropic` | +| `{thinkingLevel}`| Geçerli düşünme düzeyi | `high`, `low`, `off` | +| `{identity.name}`| Agent kimlik adı | (`"auto"` ile aynı) | Değişkenler büyük/küçük harfe duyarsızdır. `{think}`, `{thinkingLevel}` için takma addır. -### Ack tepkisi +### Ack reaction -- Varsayılan olarak etkin ajanın `identity.emoji` değeri, yoksa `"👀"` kullanılır. Devre dışı bırakmak için `""` ayarlayın. +- Varsayılan olarak etkin agent'ın `identity.emoji` değeri kullanılır, aksi halde `"👀"`. Devre dışı bırakmak için `""` ayarlayın. - Kanal başına geçersiz kılmalar: `channels..ackReaction`, `channels..accounts..ackReaction`. -- Çözümleme sırası: hesap → kanal → `messages.ackReaction` → kimlik yedeği. +- Çözümleme sırası: hesap → kanal → `messages.ackReaction` → kimlik geri dönüşü. - Kapsam: `group-mentions` (varsayılan), `group-all`, `direct`, `all`. -- `removeAckAfterReply`, Slack, Discord ve Telegram’da yanıt sonrası ack’i kaldırır. -- `messages.statusReactions.enabled`, Slack, Discord ve Telegram’da yaşam döngüsü durum tepkilerini etkinleştirir. - Slack ve Discord’da ayarlanmamışsa, ack tepkileri etkin olduğunda durum tepkileri etkin kalır. - Telegram’da yaşam döngüsü durum tepkilerini etkinleştirmek için açıkça `true` ayarlayın. +- `removeAckAfterReply`: Slack, Discord ve Telegram'da yanıttan sonra ack kaldırır. +- `messages.statusReactions.enabled`: Slack, Discord ve Telegram'da yaşam döngüsü durum tepkilerini etkinleştirir. + Slack ve Discord'da ayarsız bırakılırsa, ack tepkileri etkin olduğunda durum tepkileri etkin kalır. + Telegram'da yaşam döngüsü durum tepkilerini etkinleştirmek için bunu açıkça `true` yapın. ### Gelen debounce -Aynı gönderenden hızla gelen yalnızca metin mesajlarını tek bir ajan turunda toplar. Medya/ek dosyalar hemen temizlenir. Denetim komutları debounce’u atlar. +Aynı göndericiden gelen hızlı salt metin mesajlarını tek bir agent turunda toplar. Medya/ekler hemen flush edilir. Kontrol komutları debounce'u atlar. -### TTS (metinden konuşmaya) +### TTS (text-to-speech) ```json5 { @@ -1940,12 +1972,12 @@ Aynı gönderenden hızla gelen yalnızca metin mesajlarını tek bir ajan turun } ``` -- `auto`, varsayılan otomatik TTS modunu kontrol eder: `off`, `always`, `inbound` veya `tagged`. `/tts on|off`, yerel tercihleri geçersiz kılabilir ve `/tts status` etkin durumu gösterir. +- `auto`, varsayılan otomatik TTS modunu kontrol eder: `off`, `always`, `inbound` veya `tagged`. `/tts on|off` yerel tercihleri geçersiz kılabilir ve `/tts status` etkin durumu gösterir. - `summaryModel`, otomatik özetleme için `agents.defaults.model.primary` değerini geçersiz kılar. -- `modelOverrides` varsayılan olarak etkindir; `modelOverrides.allowProvider` varsayılanı `false`tur (isteğe bağlı etkinleştirme). -- API anahtarları, yedek olarak `ELEVENLABS_API_KEY`/`XI_API_KEY` ve `OPENAI_API_KEY` kullanır. -- `openai.baseUrl`, OpenAI TTS uç noktasını geçersiz kılar. Çözümleme sırası: yapılandırma, sonra `OPENAI_TTS_BASE_URL`, sonra `https://api.openai.com/v1`. -- `openai.baseUrl`, OpenAI dışı bir uç noktaya işaret ettiğinde OpenClaw bunu OpenAI uyumlu bir TTS sunucusu olarak ele alır ve model/ses doğrulamasını gevşetir. +- `modelOverrides` varsayılan olarak etkindir; `modelOverrides.allowProvider` varsayılan olarak `false`'tur (açık katılım). +- API anahtarları `ELEVENLABS_API_KEY`/`XI_API_KEY` ve `OPENAI_API_KEY` değerlerine geri döner. +- `openai.baseUrl`, OpenAI TTS uç noktasını geçersiz kılar. Çözümleme sırası: config, ardından `OPENAI_TTS_BASE_URL`, ardından `https://api.openai.com/v1`. +- `openai.baseUrl` OpenAI dışı bir uç noktayı gösterdiğinde OpenClaw bunu OpenAI uyumlu bir TTS sunucusu olarak kabul eder ve model/ses doğrulamasını gevşetir. --- @@ -1975,13 +2007,13 @@ Talk modu için varsayılanlar (macOS/iOS/Android). } ``` -- `talk.provider`, birden çok Talk sağlayıcısı yapılandırıldığında `talk.providers` içindeki bir anahtarla eşleşmelidir. -- Eski düz Talk anahtarları (`talk.voiceId`, `talk.voiceAliases`, `talk.modelId`, `talk.outputFormat`, `talk.apiKey`) yalnızca uyumluluk içindir ve otomatik olarak `talk.providers.` altına taşınır. -- Ses kimlikleri yedek olarak `ELEVENLABS_VOICE_ID` veya `SAG_VOICE_ID` kullanır. -- `providers.*.apiKey`, düz metin dizeleri veya SecretRef nesnelerini kabul eder. -- `ELEVENLABS_API_KEY` yedeği, yalnızca hiçbir Talk API anahtarı yapılandırılmadığında uygulanır. +- `talk.provider`, birden fazla Talk provider yapılandırıldığında `talk.providers` içindeki bir anahtarla eşleşmelidir. +- Eski düz Talk anahtarları (`talk.voiceId`, `talk.voiceAliases`, `talk.modelId`, `talk.outputFormat`, `talk.apiKey`) yalnızca uyumluluk içindir ve otomatik olarak `talk.providers.` içine taşınır. +- Voice ID'ler, `ELEVENLABS_VOICE_ID` veya `SAG_VOICE_ID` değerlerine geri döner. +- `providers.*.apiKey`, düz metin dizeleri veya SecretRef nesneleri kabul eder. +- `ELEVENLABS_API_KEY` geri dönüşü yalnızca hiçbir Talk API anahtarı yapılandırılmadığında uygulanır. - `providers.*.voiceAliases`, Talk yönergelerinin kolay adlar kullanmasına izin verir. -- `silenceTimeoutMs`, Talk modunun kullanıcı sessizliğinden sonra dökümü göndermeden önce ne kadar bekleyeceğini kontrol eder. Ayarlanmamışsa platform varsayılan duraklama penceresi korunur (`macOS ve Android’de 700 ms, iOS’ta 900 ms`). +- `silenceTimeoutMs`, Talk modunun transcript'i göndermeden önce kullanıcı sessizliğinden sonra ne kadar bekleyeceğini kontrol eder. Ayarsız bırakılırsa platform varsayılan bekleme penceresi korunur (`macOS ve Android'de 700 ms, iOS'ta 900 ms`). --- @@ -1991,35 +2023,35 @@ Talk modu için varsayılanlar (macOS/iOS/Android). `tools.profile`, `tools.allow`/`tools.deny` öncesinde temel bir izin listesi ayarlar: -Yerel onboarding, ayarlanmamış yeni yerel yapılandırmalar için varsayılan olarak `tools.profile: "coding"` kullanır (mevcut açık profiller korunur). +Yerel onboarding, ayarsız yeni yerel yapılandırmaları varsayılan olarak `tools.profile: "coding"` yapar (mevcut açık profiller korunur). -| Profil | İçerir | -| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | -| `minimal` | yalnızca `session_status` | +| Profil | İçerir | +| ----------- | ------------------------------------------------------------------------------------------------------------------------------- | +| `minimal` | yalnızca `session_status` | | `coding` | `group:fs`, `group:runtime`, `group:web`, `group:sessions`, `group:memory`, `cron`, `image`, `image_generate`, `video_generate` | -| `messaging` | `group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status` | -| `full` | Kısıtlama yok (ayarlanmamış ile aynı) | +| `messaging` | `group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status` | +| `full` | Kısıtlama yok (ayarsız ile aynı) | ### Araç grupları -| Grup | Araçlar | -| ------------------ | ------------------------------------------------------------------------------------------------------------------------- | -| `group:runtime` | `exec`, `process`, `code_execution` (`bash`, `exec` için takma ad olarak kabul edilir) | -| `group:fs` | `read`, `write`, `edit`, `apply_patch` | +| Grup | Araçlar | +| ------------------ | ----------------------------------------------------------------------------------------------------------------------- | +| `group:runtime` | `exec`, `process`, `code_execution` (`bash`, `exec` için bir takma ad olarak kabul edilir) | +| `group:fs` | `read`, `write`, `edit`, `apply_patch` | | `group:sessions` | `sessions_list`, `sessions_history`, `sessions_send`, `sessions_spawn`, `sessions_yield`, `subagents`, `session_status` | -| `group:memory` | `memory_search`, `memory_get` | -| `group:web` | `web_search`, `x_search`, `web_fetch` | -| `group:ui` | `browser`, `canvas` | -| `group:automation` | `cron`, `gateway` | -| `group:messaging` | `message` | -| `group:nodes` | `nodes` | -| `group:agents` | `agents_list` | -| `group:media` | `image`, `image_generate`, `video_generate`, `tts` | -| `group:openclaw` | Tüm yerleşik araçlar (sağlayıcı eklentileri hariç) | +| `group:memory` | `memory_search`, `memory_get` | +| `group:web` | `web_search`, `x_search`, `web_fetch` | +| `group:ui` | `browser`, `canvas` | +| `group:automation` | `cron`, `gateway` | +| `group:messaging` | `message` | +| `group:nodes` | `nodes` | +| `group:agents` | `agents_list` | +| `group:media` | `image`, `image_generate`, `video_generate`, `tts` | +| `group:openclaw` | Tüm yerleşik tools (provider plugin'leri hariç) | ### `tools.allow` / `tools.deny` -Küresel araç izin/reddet ilkesi (deny kazanır). Büyük/küçük harfe duyarsızdır, `*` joker karakterlerini destekler. Docker sandbox kapalı olsa bile uygulanır. +Genel tool izin/verme politikası (deny kazanır). Büyük/küçük harfe duyarsızdır, `*` joker karakterlerini destekler. Docker sandbox kapalı olsa bile uygulanır. ```json5 { @@ -2029,7 +2061,7 @@ Küresel araç izin/reddet ilkesi (deny kazanır). Büyük/küçük harfe duyars ### `tools.byProvider` -Belirli sağlayıcılar veya modeller için araçları daha da kısıtlar. Sıra: temel profil → sağlayıcı profili → allow/deny. +Belirli provider'lar veya modeller için tools'u daha da kısıtlayın. Sıra: temel profil → provider profili → allow/deny. ```json5 { @@ -2061,9 +2093,9 @@ Sandbox dışındaki elevated exec erişimini kontrol eder: } ``` -- Ajan başına geçersiz kılma (`agents.list[].tools.elevated`) yalnızca daha fazla kısıtlama getirebilir. -- `/elevated on|off|ask|full`, durumu oturum başına saklar; satır içi yönergeler tek mesaja uygulanır. -- Elevated `exec`, sandboxing’i atlar ve yapılandırılmış çıkış yolunu kullanır (`gateway` varsayılan, `node` hedefi `node` ise `node`). +- Agent başına geçersiz kılma (`agents.list[].tools.elevated`) yalnızca daha da kısıtlayabilir. +- `/elevated on|off|ask|full`, durumu oturum başına depolar; satır içi yönergeler tek mesaja uygulanır. +- Elevated `exec`, sandboxing'i atlar ve yapılandırılmış kaçış yolunu kullanır (varsayılan olarak `gateway`, exec hedefi `node` olduğunda `node`). ### `tools.exec` @@ -2087,8 +2119,8 @@ Sandbox dışındaki elevated exec erişimini kontrol eder: ### `tools.loopDetection` -Araç döngüsü güvenlik denetimleri varsayılan olarak **devre dışıdır**. Algılamayı etkinleştirmek için `enabled: true` ayarlayın. -Ayarlar küresel olarak `tools.loopDetection` altında tanımlanabilir ve ajan başına `agents.list[].tools.loopDetection` ile geçersiz kılınabilir. +Tool döngüsü güvenlik kontrolleri varsayılan olarak **devre dışıdır**. Algılamayı etkinleştirmek için `enabled: true` ayarlayın. +Ayarlar genel olarak `tools.loopDetection` altında tanımlanabilir ve agent başına `agents.list[].tools.loopDetection` ile geçersiz kılınabilir. ```json5 { @@ -2109,12 +2141,12 @@ Ayarlar küresel olarak `tools.loopDetection` altında tanımlanabilir ve ajan b } ``` -- `historySize`: döngü analizi için tutulan en fazla araç çağrısı geçmişi. -- `warningThreshold`: uyarılar için tekrar eden ilerleme yok desen eşiği. +- `historySize`: döngü analizi için tutulan en fazla tool-call geçmişi. +- `warningThreshold`: uyarılar için tekrar eden ilerleme yok deseni eşiği. - `criticalThreshold`: kritik döngüleri engellemek için daha yüksek tekrar eşiği. -- `globalCircuitBreakerThreshold`: ilerleme olmayan herhangi bir çalıştırma için sert durdurma eşiği. -- `detectors.genericRepeat`: aynı araç/aynı argüman çağrılarının tekrarında uyar. -- `detectors.knownPollNoProgress`: bilinen poll araçlarında (`process.poll`, `command_status` vb.) uyar/engelle. +- `globalCircuitBreakerThreshold`: ilerleme olmayan herhangi bir çalışma için katı durdurma eşiği. +- `detectors.genericRepeat`: aynı tool/same-args çağrılarının tekrarında uyar. +- `detectors.knownPollNoProgress`: bilinen yoklama araçlarında (`process.poll`, `command_status` vb.) uyar/engelle. - `detectors.pingPong`: dönüşümlü ilerleme olmayan çift desenlerinde uyar/engelle. - `warningThreshold >= criticalThreshold` veya `criticalThreshold >= globalCircuitBreakerThreshold` ise doğrulama başarısız olur. @@ -2126,7 +2158,7 @@ Ayarlar küresel olarak `tools.loopDetection` altında tanımlanabilir ve ajan b web: { search: { enabled: true, - apiKey: "brave_api_key", // veya BRAVE_API_KEY ortam değişkeni + apiKey: "brave_api_key", // veya BRAVE_API_KEY env maxResults: 5, timeoutSeconds: 30, cacheTtlMinutes: 15, @@ -2150,7 +2182,7 @@ Ayarlar küresel olarak `tools.loopDetection` altında tanımlanabilir ve ajan b ### `tools.media` -Gelen medya anlama yapılandırması (görsel/ses/video): +Gelen medya anlamlandırmayı yapılandırır (image/audio/video): ```json5 { @@ -2158,7 +2190,7 @@ Gelen medya anlama yapılandırması (görsel/ses/video): media: { concurrency: 2, asyncCompletion: { - directSend: false, // isteğe bağlı etkinleştirme: tamamlanan eşzamansız müzik/video işlerini doğrudan kanala gönder + directSend: false, // açık katılım: tamamlanan async music/video'yu doğrudan kanala gönder }, audio: { enabled: true, @@ -2182,30 +2214,30 @@ Gelen medya anlama yapılandırması (görsel/ses/video): } ``` - + -**Sağlayıcı girdisi** (`type: "provider"` veya atlanmış): +**Provider girdisi** (`type: "provider"` veya atlanmış): -- `provider`: API sağlayıcı kimliği (`openai`, `anthropic`, `google`/`gemini`, `groq` vb.) -- `model`: model kimliği geçersiz kılması +- `provider`: API provider id (`openai`, `anthropic`, `google`/`gemini`, `groq` vb.) +- `model`: model id geçersiz kılması - `profile` / `preferredProfile`: `auth-profiles.json` profil seçimi **CLI girdisi** (`type: "cli"`): - `command`: çalıştırılacak yürütülebilir dosya -- `args`: şablonlu argümanlar (`{{MediaPath}}`, `{{Prompt}}`, `{{MaxChars}}` vb. desteklenir) +- `args`: şablonlanmış argümanlar (`{{MediaPath}}`, `{{Prompt}}`, `{{MaxChars}}` vb. desteklenir) **Ortak alanlar:** - `capabilities`: isteğe bağlı liste (`image`, `audio`, `video`). Varsayılanlar: `openai`/`anthropic`/`minimax` → image, `google` → image+audio+video, `groq` → audio. -- `prompt`, `maxChars`, `maxBytes`, `timeoutSeconds`, `language`: girdi başına geçersiz kılmalar. -- Hatalarda sonraki girdiye geri düşülür. +- `prompt`, `maxChars`, `maxBytes`, `timeoutSeconds`, `language`: giriş başına geçersiz kılmalar. +- Hatalar bir sonraki girdiye geri düşer. -Sağlayıcı auth standart sırayı izler: `auth-profiles.json` → ortam değişkenleri → `models.providers.*.apiKey`. +Provider auth standart sırayı izler: `auth-profiles.json` → env vars → `models.providers.*.apiKey`. -**Eşzamansız tamamlama alanları:** +**Async completion alanları:** -- `asyncCompletion.directSend`: `true` olduğunda tamamlanan eşzamansız `music_generate` +- `asyncCompletion.directSend`: `true` olduğunda, tamamlanan async `music_generate` ve `video_generate` görevleri önce doğrudan kanal teslimini dener. Varsayılan: `false` (eski requester-session wake/model-delivery yolu). @@ -2228,7 +2260,7 @@ Sağlayıcı auth standart sırayı izler: `auth-profiles.json` → ortam deği Oturum araçları (`sessions_list`, `sessions_history`, `sessions_send`) tarafından hangi oturumların hedeflenebileceğini kontrol eder. -Varsayılan: `tree` (mevcut oturum + onun tarafından oluşturulan oturumlar, örneğin subagent’lar). +Varsayılan: `tree` (mevcut oturum + onun tarafından spawn edilen oturumlar, örneğin subagents). ```json5 { @@ -2244,25 +2276,25 @@ Varsayılan: `tree` (mevcut oturum + onun tarafından oluşturulan oturumlar, ö Notlar: - `self`: yalnızca mevcut oturum anahtarı. -- `tree`: mevcut oturum + mevcut oturum tarafından oluşturulan oturumlar (subagent’lar). -- `agent`: mevcut ajan kimliğine ait herhangi bir oturum (aynı ajan kimliği altında gönderen başına oturumlar çalıştırıyorsanız başka kullanıcıları da içerebilir). -- `all`: herhangi bir oturum. Ajanlar arası hedefleme yine de `tools.agentToAgent` gerektirir. -- Sandbox clamp: mevcut oturum sandbox içindeyse ve `agents.defaults.sandbox.sessionToolsVisibility="spawned"` ise, `tools.sessions.visibility="all"` olsa bile görünürlük `tree` olarak zorlanır. +- `tree`: mevcut oturum + mevcut oturum tarafından spawn edilen oturumlar (subagents). +- `agent`: mevcut agent id'ye ait herhangi bir oturum (aynı agent id altında per-sender oturumları çalıştırırsanız diğer kullanıcıları da içerebilir). +- `all`: herhangi bir oturum. Çapraz agent hedefleme yine de `tools.agentToAgent` gerektirir. +- Sandbox kelepçesi: mevcut oturum sandbox içindeyse ve `agents.defaults.sandbox.sessionToolsVisibility="spawned"` ise, `tools.sessions.visibility="all"` olsa bile görünürlük `tree` olarak zorlanır. ### `tools.sessions_spawn` -`sessions_spawn` için satır içi ek dosya desteğini kontrol eder. +`sessions_spawn` için satır içi ek desteğini kontrol eder. ```json5 { tools: { sessions_spawn: { attachments: { - enabled: false, // isteğe bağlı etkinleştirme: satır içi dosya eklerine izin vermek için true yapın - maxTotalBytes: 5242880, // tüm dosyalar genelinde toplam 5 MB + enabled: false, // açık katılım: satır içi dosya eklerine izin vermek için true yapın + maxTotalBytes: 5242880, // tüm dosyalar için toplam 5 MB maxFiles: 50, maxFileBytes: 1048576, // dosya başına 1 MB - retainOnSessionKeep: false, // cleanup="keep" olduğunda ekleri koru + retainOnSessionKeep: false, // cleanup="keep" olduğunda ekleri tut }, }, }, @@ -2271,16 +2303,16 @@ Notlar: Notlar: -- Ek dosyalar yalnızca `runtime: "subagent"` için desteklenir. ACP çalışma zamanı bunları reddeder. -- Dosyalar alt workspace içine `.openclaw/attachments//` altında bir `.manifest.json` ile oluşturulur. -- Ek içeriği, döküm kalıcılığından otomatik olarak redakte edilir. -- Base64 girdileri, katı alfabe/dolgu denetimleri ve çözümleme öncesi boyut korumasıyla doğrulanır. +- Ekler yalnızca `runtime: "subagent"` için desteklenir. ACP çalışma zamanı bunları reddeder. +- Dosyalar çocuk workspace içine `.openclaw/attachments//` altında `.manifest.json` ile somutlaştırılır. +- Ek içeriği transcript kalıcılığından otomatik olarak sansürlenir. +- Base64 girişleri sıkı alfabe/dolgu denetimleri ve decode öncesi boyut korumasıyla doğrulanır. - Dosya izinleri dizinler için `0700`, dosyalar için `0600` olur. -- Temizleme, `cleanup` ilkesini izler: `delete` ekleri her zaman kaldırır; `keep`, yalnızca `retainOnSessionKeep: true` olduğunda ekleri korur. +- Temizleme `cleanup` ilkesini izler: `delete` her zaman ekleri kaldırır; `keep` bunları yalnızca `retainOnSessionKeep: true` olduğunda tutar. ### `tools.experimental` -Deneysel yerleşik araç bayrakları. Çalışma zamanına özgü otomatik etkinleştirme kuralı uygulanmadığı sürece varsayılan olarak kapalıdır. +Deneysel yerleşik tool bayrakları. Çalışma zamanına özgü bir otomatik etkinleştirme kuralı uygulanmadıkça varsayılan olarak kapalıdır. ```json5 { @@ -2294,9 +2326,9 @@ Deneysel yerleşik araç bayrakları. Çalışma zamanına özgü otomatik etkin Notlar: -- `planTool`: önemsiz olmayan çok adımlı iş takibi için yapılandırılmış `update_plan` aracını etkinleştirir. -- Varsayılan: OpenAI dışı sağlayıcılar için `false`. OpenAI ve OpenAI Codex çalıştırmaları, ayarlanmamışsa bunu otomatik etkinleştirir; bu otomatik etkinleştirmeyi devre dışı bırakmak için `false` ayarlayın. -- Etkin olduğunda sistem istemi ayrıca kullanım yönergeleri de ekler; model bunu yalnızca önemli işlerde kullanır ve en fazla bir adımı `in_progress` tutar. +- `planTool`: önemsiz olmayan çok adımlı iş takibi için yapılandırılmış `update_plan` tool'unu etkinleştirir. +- Varsayılan: OpenAI dışı provider'lar için `false`. OpenAI ve OpenAI Codex çalıştırmaları, ayarsız bırakıldığında bunu otomatik etkinleştirir; bu otomatik etkinleştirmeyi kapatmak için `false` ayarlayın. +- Etkinleştirildiğinde sistem prompt'u da kullanım yönergeleri ekler; böylece model bunu yalnızca önemli işler için kullanır ve en fazla bir adımı `in_progress` durumda tutar. ### `agents.defaults.subagents` @@ -2316,16 +2348,16 @@ Notlar: } ``` -- `model`: oluşturulan alt ajanlar için varsayılan model. Atlanırsa alt ajanlar çağıranın modelini devralır. -- `allowAgents`: istek yapan ajan kendi `subagents.allowAgents` değerini ayarlamadığında `sessions_spawn` için varsayılan hedef ajan kimliği izin listesi (`["*"]` = herhangi biri; varsayılan: yalnızca aynı ajan). -- `runTimeoutSeconds`: araç çağrısı `runTimeoutSeconds` atladığında `sessions_spawn` için varsayılan zaman aşımı (saniye). `0`, zaman aşımı olmadığı anlamına gelir. -- Alt ajan başına araç ilkesi: `tools.subagents.tools.allow` / `tools.subagents.tools.deny`. +- `model`: spawn edilen sub-agent'lar için varsayılan model. Atlanırsa sub-agent'lar çağıranın modelini kalıtır. +- `allowAgents`: istekte bulunan agent kendi `subagents.allowAgents` değerini ayarlamadığında `sessions_spawn` için hedef agent id'lerinin varsayılan izin listesi (`["*"]` = herhangi biri; varsayılan: yalnızca aynı agent). +- `runTimeoutSeconds`: tool çağrısı `runTimeoutSeconds` belirtmediğinde `sessions_spawn` için varsayılan zaman aşımı (saniye). `0`, zaman aşımı yok demektir. +- Subagent başına tool politikası: `tools.subagents.tools.allow` / `tools.subagents.tools.deny`. --- -## Özel sağlayıcılar ve temel URL’ler +## Özel provider'lar ve temel URL'ler -OpenClaw yerleşik model kataloğunu kullanır. Özel sağlayıcıları yapılandırmada `models.providers` veya `~/.openclaw/agents//agent/models.json` ile ekleyin. +OpenClaw yerleşik model kataloğunu kullanır. Özel provider'ları config içindeki `models.providers` üzerinden veya `~/.openclaw/agents//agent/models.json` üzerinden ekleyin. ```json5 { @@ -2354,49 +2386,49 @@ OpenClaw yerleşik model kataloğunu kullanır. Özel sağlayıcıları yapılan } ``` -- Özel auth gereksinimleri için `authHeader: true` + `headers` kullanın. -- Ajan yapılandırma kökünü `OPENCLAW_AGENT_DIR` ile geçersiz kılın (veya eski ortam değişkeni takma adı `PI_CODING_AGENT_DIR`). -- Eşleşen sağlayıcı kimlikleri için birleştirme önceliği: - - Boş olmayan ajan `models.json` `baseUrl` değerleri kazanır. - - Boş olmayan ajan `apiKey` değerleri yalnızca o sağlayıcı mevcut yapılandırma/auth-profile bağlamında SecretRef tarafından yönetilmiyorsa kazanır. - - SecretRef tarafından yönetilen sağlayıcı `apiKey` değerleri, çözümlenmiş gizlileri kalıcı yazmak yerine kaynak işaretlerinden (`ENV_VAR_NAME` env başvuruları için, `secretref-managed` dosya/exec başvuruları için) yenilenir. - - SecretRef tarafından yönetilen sağlayıcı üstbilgi değerleri, kaynak işaretlerinden (`secretref-env:ENV_VAR_NAME` env başvuruları için, `secretref-managed` dosya/exec başvuruları için) yenilenir. - - Boş veya eksik ajan `apiKey`/`baseUrl`, yapılandırmadaki `models.providers` değerlerine geri döner. - - Eşleşen model `contextWindow`/`maxTokens`, açık yapılandırma ile örtük katalog değerleri arasından yüksek olanı kullanır. - - Eşleşen model `contextTokens`, varsa açık çalışma zamanı üst sınırını korur; modelin yerel metadata’sını değiştirmeden etkin bağlamı sınırlamak için bunu kullanın. - - Yapılandırmanın `models.json` dosyasını tamamen yeniden yazmasını istiyorsanız `models.mode: "replace"` kullanın. - - Marker kalıcılığı kaynak odaklıdır: marker’lar, çözümlenmiş çalışma zamanı gizli değerlerinden değil, etkin kaynak yapılandırma anlık görüntüsünden (çözümleme öncesi) yazılır. +- Özel auth ihtiyaçları için `authHeader: true` + `headers` kullanın. +- Agent config kökünü `OPENCLAW_AGENT_DIR` ile geçersiz kılın (veya eski bir environment variable takma adı olan `PI_CODING_AGENT_DIR`). +- Eşleşen provider ID'leri için birleşme önceliği: + - Boş olmayan agent `models.json` `baseUrl` değerleri kazanır. + - Boş olmayan agent `apiKey` değerleri, yalnızca o provider geçerli config/auth-profile bağlamında SecretRef tarafından yönetilmiyorsa kazanır. + - SecretRef tarafından yönetilen provider `apiKey` değerleri, çözülmüş secret'ları kalıcılaştırmak yerine kaynak işaretçileri (`env` referansları için `ENV_VAR_NAME`, file/exec referansları için `secretref-managed`) üzerinden yenilenir. + - SecretRef tarafından yönetilen provider header değerleri, kaynak işaretçileri (`env` referansları için `secretref-env:ENV_VAR_NAME`, file/exec referansları için `secretref-managed`) üzerinden yenilenir. + - Boş veya eksik agent `apiKey`/`baseUrl` değerleri, config içindeki `models.providers` değerlerine geri döner. + - Eşleşen model `contextWindow`/`maxTokens`, açık config ile örtük katalog değerleri arasında daha yüksek olanı kullanır. + - Eşleşen model `contextTokens`, mevcut olduğunda açık çalışma zamanı üst sınırını korur; modelin yerel meta verisini değiştirmeden etkin bağlamı sınırlamak için bunu kullanın. + - Config'in `models.json` dosyasını tamamen yeniden yazmasını istiyorsanız `models.mode: "replace"` kullanın. + - İşaretçi kalıcılığı kaynak otoritelidir: işaretçiler, çözülmüş çalışma zamanı secret değerlerinden değil, etkin kaynak config anlık görüntüsünden (çözümleme öncesi) yazılır. -### Sağlayıcı alanı ayrıntıları +### Provider alan ayrıntıları -- `models.mode`: sağlayıcı katalog davranışı (`merge` veya `replace`). -- `models.providers`: sağlayıcı kimliğine göre anahtarlanmış özel sağlayıcı haritası. -- `models.providers.*.api`: istek bağdaştırıcısı (`openai-completions`, `openai-responses`, `anthropic-messages`, `google-generative-ai` vb). -- `models.providers.*.apiKey`: sağlayıcı kimlik bilgisi (SecretRef/env substitution tercih edilir). +- `models.mode`: provider katalog davranışı (`merge` veya `replace`). +- `models.providers`: provider id ile anahtarlanmış özel provider haritası. +- `models.providers.*.api`: istek bağdaştırıcısı (`openai-completions`, `openai-responses`, `anthropic-messages`, `google-generative-ai` vb.). +- `models.providers.*.apiKey`: provider kimlik bilgisi (SecretRef/env substitution tercih edin). - `models.providers.*.auth`: auth stratejisi (`api-key`, `token`, `oauth`, `aws-sdk`). - `models.providers.*.injectNumCtxForOpenAICompat`: Ollama + `openai-completions` için isteklere `options.num_ctx` enjekte et (varsayılan: `true`). - `models.providers.*.authHeader`: gerektiğinde kimlik bilgisinin `Authorization` üstbilgisinde taşınmasını zorla. -- `models.providers.*.baseUrl`: yukarı akış API temel URL’si. -- `models.providers.*.headers`: proxy/kiracı yönlendirmesi için ek statik üstbilgiler. -- `models.providers.*.request`: model-provider HTTP istekleri için taşıma geçersiz kılmaları. - - `request.headers`: ek üstbilgiler (sağlayıcı varsayılanlarıyla birleştirilir). Değerler SecretRef kabul eder. - - `request.auth`: auth stratejisi geçersiz kılması. Modlar: `"provider-default"` (sağlayıcının yerleşik auth’unu kullan), `"authorization-bearer"` (`token` ile), `"header"` (`headerName`, `value`, isteğe bağlı `prefix` ile). - - `request.proxy`: HTTP proxy geçersiz kılması. Modlar: `"env-proxy"` (`HTTP_PROXY`/`HTTPS_PROXY` ortam değişkenlerini kullan), `"explicit-proxy"` (`url` ile). Her iki mod da isteğe bağlı `tls` alt nesnesi kabul eder. +- `models.providers.*.baseUrl`: upstream API base URL'si. +- `models.providers.*.headers`: proxy/tenant yönlendirme için ek sabit üstbilgiler. +- `models.providers.*.request`: model-provider HTTP istekleri için aktarım geçersiz kılmaları. + - `request.headers`: ek üstbilgiler (provider varsayılanlarıyla birleşir). Değerler SecretRef kabul eder. + - `request.auth`: auth stratejisi geçersiz kılması. Modlar: `"provider-default"` (provider'ın yerleşik auth'unu kullan), `"authorization-bearer"` (`token` ile), `"header"` (`headerName`, `value`, isteğe bağlı `prefix` ile). + - `request.proxy`: HTTP proxy geçersiz kılması. Modlar: `"env-proxy"` (`HTTP_PROXY`/`HTTPS_PROXY` env vars kullan), `"explicit-proxy"` (`url` ile). Her iki mod da isteğe bağlı `tls` alt nesnesi kabul eder. - `request.tls`: doğrudan bağlantılar için TLS geçersiz kılması. Alanlar: `ca`, `cert`, `key`, `passphrase` (tümü SecretRef kabul eder), `serverName`, `insecureSkipVerify`. -- `models.providers.*.models`: açık sağlayıcı model katalog girdileri. -- `models.providers.*.models.*.contextWindow`: yerel model bağlam penceresi metadata’sı. +- `models.providers.*.models`: açık provider model katalog girdileri. +- `models.providers.*.models.*.contextWindow`: yerel model bağlam penceresi meta verisi. - `models.providers.*.models.*.contextTokens`: isteğe bağlı çalışma zamanı bağlam üst sınırı. Modelin yerel `contextWindow` değerinden daha küçük bir etkin bağlam bütçesi istiyorsanız bunu kullanın. -- `models.providers.*.models.*.compat.supportsDeveloperRole`: isteğe bağlı uyumluluk ipucu. `api: "openai-completions"` ile boş olmayan yerel olmayan bir `baseUrl` için (host `api.openai.com` değilse), OpenClaw bunu çalışma zamanında `false`a zorlar. Boş/atlanmış `baseUrl`, varsayılan OpenAI davranışını korur. -- `models.providers.*.models.*.compat.requiresStringContent`: yalnızca dize kabul eden OpenAI uyumlu sohbet uç noktaları için isteğe bağlı uyumluluk ipucu. `true` olduğunda OpenClaw, isteği göndermeden önce yalnızca metin içeren `messages[].content` dizilerini düz dizelere indirger. -- `plugins.entries.amazon-bedrock.config.discovery`: Bedrock otomatik keşif ayarları kökü. +- `models.providers.*.models.*.compat.supportsDeveloperRole`: isteğe bağlı uyumluluk ipucu. Yerel olmayan ve boş olmayan `baseUrl` içeren (`api.openai.com` olmayan host) `api: "openai-completions"` için OpenClaw bunu çalışma anında `false` olarak zorlar. Boş/atlanmış `baseUrl`, varsayılan OpenAI davranışını korur. +- `models.providers.*.models.*.compat.requiresStringContent`: yalnızca dize kullanan OpenAI uyumlu sohbet uç noktaları için isteğe bağlı uyumluluk ipucu. `true` olduğunda OpenClaw, istek göndermeden önce yalnızca metin içeren `messages[].content` dizilerini düz dizelere indirger. +- `plugins.entries.amazon-bedrock.config.discovery`: Bedrock otomatik keşif ayarlarının kökü. - `plugins.entries.amazon-bedrock.config.discovery.enabled`: örtük keşfi aç/kapat. - `plugins.entries.amazon-bedrock.config.discovery.region`: keşif için AWS bölgesi. -- `plugins.entries.amazon-bedrock.config.discovery.providerFilter`: hedefli keşif için isteğe bağlı sağlayıcı kimliği filtresi. +- `plugins.entries.amazon-bedrock.config.discovery.providerFilter`: hedeflenmiş keşif için isteğe bağlı provider-id filtresi. - `plugins.entries.amazon-bedrock.config.discovery.refreshInterval`: keşif yenileme yoklama aralığı. -- `plugins.entries.amazon-bedrock.config.discovery.defaultContextWindow`: keşfedilen modeller için yedek bağlam penceresi. -- `plugins.entries.amazon-bedrock.config.discovery.defaultMaxTokens`: keşfedilen modeller için yedek en büyük çıktı belirteci. +- `plugins.entries.amazon-bedrock.config.discovery.defaultContextWindow`: keşfedilen modeller için geri dönüş bağlam penceresi. +- `plugins.entries.amazon-bedrock.config.discovery.defaultMaxTokens`: keşfedilen modeller için geri dönüş azami çıktı token sayısı. -### Sağlayıcı örnekleri +### Provider örnekleri @@ -2432,7 +2464,7 @@ OpenClaw yerleşik model kataloğunu kullanır. Özel sağlayıcıları yapılan } ``` -Cerebras için `cerebras/zai-glm-4.7`; Z.AI doğrudan için `zai/glm-4.7` kullanın. +Cerebras için `cerebras/zai-glm-4.7`; Z.AI direct için `zai/glm-4.7` kullanın. @@ -2449,7 +2481,7 @@ Cerebras için `cerebras/zai-glm-4.7`; Z.AI doğrudan için `zai/glm-4.7` kullan } ``` -`OPENCODE_API_KEY` (veya `OPENCODE_ZEN_API_KEY`) ayarlayın. Zen kataloğu için `opencode/...`, Go kataloğu için `opencode-go/...` başvurularını kullanın. Kısayol: `openclaw onboard --auth-choice opencode-zen` veya `openclaw onboard --auth-choice opencode-go`. +`OPENCODE_API_KEY` (veya `OPENCODE_ZEN_API_KEY`) ayarlayın. Zen kataloğu için `opencode/...`, Go kataloğu için `opencode-go/...` referanslarını kullanın. Kısayol: `openclaw onboard --auth-choice opencode-zen` veya `openclaw onboard --auth-choice opencode-go`. @@ -2470,7 +2502,7 @@ Cerebras için `cerebras/zai-glm-4.7`; Z.AI doğrudan için `zai/glm-4.7` kullan - Genel uç nokta: `https://api.z.ai/api/paas/v4` - Kodlama uç noktası (varsayılan): `https://api.z.ai/api/coding/paas/v4` -- Genel uç nokta için, temel URL geçersiz kılmalı özel bir sağlayıcı tanımlayın. +- Genel uç nokta için temel URL geçersiz kılmalı özel bir provider tanımlayın. @@ -2512,9 +2544,9 @@ Cerebras için `cerebras/zai-glm-4.7`; Z.AI doğrudan için `zai/glm-4.7` kullan Çin uç noktası için: `baseUrl: "https://api.moonshot.cn/v1"` veya `openclaw onboard --auth-choice moonshot-api-key-cn`. Yerel Moonshot uç noktaları, paylaşılan -`openai-completions` taşımasında akış kullanımı uyumluluğu bildirir ve OpenClaw artık bunu -yalnızca yerleşik sağlayıcı kimliği yerine uç nokta -yeteneklerine göre anahtarlıyor. +`openai-completions` aktarımında akış kullanımı uyumluluğunu bildirir ve OpenClaw artık bunu +yalnızca yerleşik provider id yerine uç nokta +yeteneklerine göre anahtarlamaktadır. @@ -2532,11 +2564,11 @@ yeteneklerine göre anahtarlıyor. } ``` -Anthropic uyumlu, yerleşik sağlayıcı. Kısayol: `openclaw onboard --auth-choice kimi-code-api-key`. +Anthropic uyumlu, yerleşik provider. Kısayol: `openclaw onboard --auth-choice kimi-code-api-key`. - + ```json5 { @@ -2571,11 +2603,11 @@ Anthropic uyumlu, yerleşik sağlayıcı. Kısayol: `openclaw onboard --auth-cho } ``` -Temel URL `/v1` içermemelidir (Anthropic istemcisi bunu ekler). Kısayol: `openclaw onboard --auth-choice synthetic-api-key`. +Base URL `/v1` içermemelidir (Anthropic istemcisi bunu ekler). Kısayol: `openclaw onboard --auth-choice synthetic-api-key`. - + ```json5 { @@ -2614,17 +2646,19 @@ Temel URL `/v1` içermemelidir (Anthropic istemcisi bunu ekler). Kısayol: `open `MINIMAX_API_KEY` ayarlayın. Kısayollar: `openclaw onboard --auth-choice minimax-global-api` veya `openclaw onboard --auth-choice minimax-cn-api`. -Model kataloğu artık varsayılan olarak yalnızca M2.7 kullanır. -Anthropic uyumlu akış yolunda, siz açıkça `thinking` ayarlamadığınız sürece OpenClaw MiniMax thinking’i -varsayılan olarak devre dışı bırakır. `/fast on` veya -`params.fastMode: true`, `MiniMax-M2.7` değerini -`MiniMax-M2.7-highspeed` olarak yeniden yazar. +Model kataloğu artık varsayılan olarak yalnızca M2.7'dir. +Anthropic uyumlu akış yolunda OpenClaw, siz açıkça `thinking` ayarlamadıkça +varsayılan olarak MiniMax düşünmesini devre dışı bırakır. `/fast on` veya +`params.fastMode: true`, +`MiniMax-M2.7` değerini +`MiniMax-M2.7-highspeed` +olarak yeniden yazar. -Bkz. [Local Models](/tr/gateway/local-models). Kısaca: ciddi donanım üzerinde LM Studio Responses API ile büyük bir yerel model çalıştırın; yedek için barındırılan modelleri birleştirilmiş halde tutun. +Bkz. [Yerel Modeller](/tr/gateway/local-models). Kısaca: güçlü donanımda LM Studio Responses API ile büyük bir yerel model çalıştırın; geri dönüş için barındırılan modelleri birleştirilmiş halde tutun. @@ -2655,16 +2689,18 @@ Bkz. [Local Models](/tr/gateway/local-models). Kısaca: ciddi donanım üzerinde } ``` -- `allowBundled`: yalnızca paketlenmiş skill’ler için isteğe bağlı izin listesi (yönetilen/workspace skill’leri etkilenmez). +- `allowBundled`: yalnızca paketlenmiş skills için isteğe bağlı izin listesi (managed/workspace skills etkilenmez). - `load.extraDirs`: ek paylaşılan skill kökleri (en düşük öncelik). -- `install.preferBrew`: true olduğunda ve `brew` mevcutsa diğer yükleyici türlerine geri düşmeden önce Homebrew yükleyicilerini tercih eder. -- `install.nodeManager`: `metadata.openclaw.install` specs için node yükleyici tercihi (`npm` | `pnpm` | `yarn` | `bun`). -- `entries..enabled: false`, paketlenmiş/yüklü olsa bile bir skill’i devre dışı bırakır. -- `entries..apiKey`: birincil ortam değişkeni tanımlayan skill’ler için kolaylık alanı (düz metin dize veya SecretRef nesnesi). +- `install.preferBrew`: `brew` kullanılabilir olduğunda, diğer kurucu türlerine geri düşmeden önce + Homebrew kurucularını tercih eder. +- `install.nodeManager`: `metadata.openclaw.install` + belirtimleri için node kurucu tercihi (`npm` | `pnpm` | `yarn` | `bun`). +- `entries..enabled: false`, bir skill paketlenmiş/kurulmuş olsa bile onu devre dışı bırakır. +- `entries..apiKey`: birincil env var tanımlayan skills için kolaylık alanı (düz metin dize veya SecretRef nesnesi). --- -## Eklentiler +## Plugins ```json5 { @@ -2688,10 +2724,18 @@ Bkz. [Local Models](/tr/gateway/local-models). Kısaca: ciddi donanım üzerinde } ``` -- `~/.openclaw/extensions`, `/.openclaw/extensions` ve `plugins.load.paths` altından yüklenir. -- Keşif; yerel OpenClaw eklentilerini, uyumlu Codex paketlerini ve Claude paketlerini, manifest içermeyen Claude varsayılan düzen paketleri dahil olmak üzere kabul eder. -- **Yapılandırma değişiklikleri gateway yeniden başlatması gerektirir.** -- `allow`: isteğe bağlı izin listesi (yalnızca listelenen eklentiler yüklenir). `deny` kazanır. -- `plugins.entries..apiKey`: eklenti düzeyinde API anahtarı kolaylık alanı (eklenti destekliyorsa). -- `plugins.entries..env`: eklenti kapsamlı ortam değişkeni haritası. -- `plugins.entries..hooks.allowPromptInjection`: `false` olduğunda çekirdek `before_prompt_build` işlemini engeller ve eski `before_agent_start` içindeki istem mutasyonu yapan alanları yok sayar; eski `modelOverride` ve `providerOverride` değerlerini korur \ No newline at end of file +- `~/.openclaw/extensions`, `/.openclaw/extensions` ve `plugins.load.paths` üzerinden yüklenir. +- Keşif, yerel OpenClaw plugins'lerini ve manifest olmayan Claude varsayılan düzen paketleri dahil uyumlu Codex ve Claude paketlerini kabul eder. +- **Config değişiklikleri gateway restart gerektirir.** +- `allow`: isteğe bağlı izin listesi (yalnızca listelenen plugins yüklenir). `deny` kazanır. +- `plugins.entries..apiKey`: plugin destekliyorsa plugin düzeyinde API anahtarı kolaylık alanı. +- `plugins.entries..env`: plugin kapsamlı env var haritası. +- `plugins.entries..hooks.allowPromptInjection`: `false` olduğunda core, `before_prompt_build` engeller ve eski `before_agent_start` içinden gelen prompt değiştirici alanları yok sayar; eski `modelOverride` ve `providerOverride` korunur. Yerel plugin hooks'ları ve desteklenen bundle kaynaklı hook dizinleri için geçerlidir. +- `plugins.entries..subagent.allowModelOverride`: bu plugin'e, arka plan subagent çalıştırmaları için çalışma başına `provider` ve `model` geçersiz kılmaları istemesi konusunda açıkça güvenin. +- `plugins.entries..subagent.allowedModels`: güvenilen subagent geçersiz kılmaları için isteğe bağlı standart `provider/model` hedef izin listesi. Yalnızca herhangi bir modele izin vermek istiyorsanız `"*"` kullanın. +- `plugins.entries..config`: plugin tarafından tanımlanan config nesnesi (mevcut olduğunda yerel OpenClaw plugin şemasıyla doğrulanır). +- `plugins.entries.firecrawl.config.webFetch`: Firecrawl web-fetch provider ayarları. + - `apiKey`: Firecrawl API anahtarı (SecretRef kabul eder). `plugins.entries.firecrawl.config.webSearch.apiKey`, eski `tools.web.fetch.firecrawl.apiKey` veya `FIRECRAWL_API_KEY` env var değerine geri döner. + - `baseUrl`: Firecrawl API base URL'si (varsayılan: `https://api.firecrawl.dev`). + - `onlyMainContent`: sayfalardan yalnızca ana içeriği çıkar (varsayılan: `true`). + - `maxAgeMs`: azami önbellek yaşı \ No newline at end of file diff --git a/docs/tr/plugins/sdk-migration.md b/docs/tr/plugins/sdk-migration.md index 95cb744aa..1b11c5f3a 100644 --- a/docs/tr/plugins/sdk-migration.md +++ b/docs/tr/plugins/sdk-migration.md @@ -3,109 +3,105 @@ read_when: - OPENCLAW_PLUGIN_SDK_COMPAT_DEPRECATED uyarısını görüyorsunuz - OPENCLAW_EXTENSION_API_DEPRECATED uyarısını görüyorsunuz - Bir plugin'i modern plugin mimarisine güncelliyorsunuz - - Harici bir OpenClaw plugin'inin bakımını yapıyorsunuz + - Harici bir OpenClaw plugin'ini sürdürüyorsunuz sidebarTitle: Migrate to SDK -summary: Eski geriye dönük uyumluluk katmanından modern plugin SDK'ye geçiş yapın +summary: Eski geriye dönük uyumluluk katmanından modern plugin SDK'ya geçiş yapın title: Plugin SDK Geçişi x-i18n: - generated_at: "2026-04-08T02:17:18Z" + generated_at: "2026-04-08T08:45:14Z" model: gpt-5.4 provider: openai - source_hash: 155a8b14bc345319c8516ebdb8a0ccdea2c5f7fa07dad343442996daee21ecad + source_hash: d9a2ce7f5553563516a549ca87e776a6a71e8dd8533a773c5ddbecfae43e7b77 source_path: plugins/sdk-migration.md workflow: 15 --- # Plugin SDK Geçişi -OpenClaw, geniş bir geriye dönük uyumluluk katmanından, odaklı ve belgelenmiş -import'lara sahip modern bir plugin mimarisine geçti. Plugin'iniz yeni +OpenClaw, geniş bir geriye dönük uyumluluk katmanından, odaklanmış ve +belgelendirilmiş içe aktarmalara sahip modern bir plugin mimarisine geçti. Plugin'iniz yeni mimariden önce oluşturulduysa, bu kılavuz geçiş yapmanıza yardımcı olur. ## Neler değişiyor Eski plugin sistemi, plugin'lerin tek bir giriş noktasından ihtiyaç duydukları -her şeyi içe aktarmasına izin veren iki geniş açık yüzey sağlıyordu: +her şeyi içe aktarmasına izin veren iki geniş yüzey sağlıyordu: -- **`openclaw/plugin-sdk/compat`** — onlarca yardımcıyı yeniden dışa aktaran - tek bir import. Yeni plugin mimarisi oluşturulurken eski hook tabanlı - plugin'lerin çalışmaya devam etmesi için sunuldu. -- **`openclaw/extension-api`** — plugin'lere gömülü agent runner gibi - ana makine tarafı yardımcılarına doğrudan erişim veren bir köprü. +- **`openclaw/plugin-sdk/compat`** — düzinelerce yardımcıyı yeniden dışa aktaran + tek bir içe aktarma. Yeni plugin mimarisi oluşturulurken eski hook tabanlı + plugin'lerin çalışmasını sürdürmek için tanıtıldı. +- **`openclaw/extension-api`** — plugin'lere gömülü ajan çalıştırıcısı gibi + host tarafı yardımcılarına doğrudan erişim veren bir köprü. Bu iki yüzey artık **kullanımdan kaldırılmıştır**. Çalışma zamanında hâlâ -çalışırlar, ancak yeni plugin'ler bunları kullanmamalıdır ve mevcut plugin'ler +çalışırlar, ancak yeni plugin'ler bunları kullanmamalı ve mevcut plugin'ler bir sonraki büyük sürüm bunları kaldırmadan önce geçiş yapmalıdır. Geriye dönük uyumluluk katmanı gelecekteki bir büyük sürümde kaldırılacaktır. - Bu yüzeylerden hâlâ import yapan plugin'ler bu olduğunda bozulacaktır. + Bu yüzeylerden hâlâ içe aktarma yapan plugin'ler bu gerçekleştiğinde bozulacaktır. -## Bunun nedeni nedir +## Bu neden değişti -Eski yaklaşım bazı sorunlara neden oluyordu: +Eski yaklaşım sorunlara neden oluyordu: -- **Yavaş başlangıç** — tek bir yardımcıyı içe aktarmak onlarca ilgisiz modülü yüklüyordu -- **Döngüsel bağımlılıklar** — geniş yeniden dışa aktarmalar import döngüleri oluşturmayı kolaylaştırıyordu -- **Belirsiz API yüzeyi** — hangi dışa aktarımların kararlı, hangilerinin dahili olduğunu ayırt etmenin yolu yoktu +- **Yavaş başlangıç** — tek bir yardımcıyı içe aktarmak düzinelerce alakasız modülü yüklüyordu +- **Döngüsel bağımlılıklar** — geniş yeniden dışa aktarmalar içe aktarma döngüleri oluşturmayı kolaylaştırıyordu +- **Belirsiz API yüzeyi** — hangi dışa aktarmaların kararlı, hangilerinin iç kullanım için olduğunu ayırt etmenin bir yolu yoktu -Modern plugin SDK bunu düzeltir: her import yolu (`openclaw/plugin-sdk/\`) -net bir amaca ve belgelenmiş bir sözleşmeye sahip, küçük ve kendi içinde yeterli -bir modüldür. +Modern plugin SDK bunu düzeltir: her içe aktarma yolu (`openclaw/plugin-sdk/\`) +küçük, kendi içinde yeterli, açık amaçlı ve belgelenmiş sözleşmeye sahip bir modüldür. -Paketlenmiş kanallar için eski sağlayıcı kolaylık yüzeyleri de kaldırıldı. -`openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`, -`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`, -kanal markalı yardımcı yüzeyler ve -`openclaw/plugin-sdk/telegram-core` gibi import'lar özel mono-repo kısayollarıydı, -kararlı plugin sözleşmeleri değildi. Bunun yerine dar ve genel SDK alt yollarını kullanın. Paketlenmiş -plugin çalışma alanı içinde, sağlayıcıya ait yardımcıları ilgili plugin'in kendi +Paketlenmiş kanallar için eski sağlayıcı kolaylık seam'leri de kaldırıldı. `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`, `openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`, +kanal markalı yardımcı seam'leri ve +`openclaw/plugin-sdk/telegram-core` gibi içe aktarmalar, kararlı plugin sözleşmeleri değil, +özel mono-repo kısayollarıydı. Bunun yerine dar kapsamlı genel SDK alt yollarını kullanın. Paketlenmiş +plugin çalışma alanı içinde, sağlayıcıya ait yardımcıları o plugin'in kendi `api.ts` veya `runtime-api.ts` dosyasında tutun. -Geçerli paketlenmiş sağlayıcı örnekleri: +Güncel paketlenmiş sağlayıcı örnekleri: - Anthropic, Claude'a özgü akış yardımcılarını kendi `api.ts` / - `contract-api.ts` yüzeyinde tutar -- OpenAI, sağlayıcı oluşturucularını, varsayılan model yardımcılarını ve realtime sağlayıcı + `contract-api.ts` seam'inde tutar +- OpenAI, sağlayıcı oluşturucuları, varsayılan model yardımcılarını ve gerçek zamanlı sağlayıcı oluşturucularını kendi `api.ts` dosyasında tutar -- OpenRouter, sağlayıcı oluşturucu ile onboarding/yapılandırma yardımcılarını kendi +- OpenRouter, sağlayıcı oluşturucu ile ilk kurulum/yapılandırma yardımcılarını kendi `api.ts` dosyasında tutar ## Nasıl geçiş yapılır - - Onay yetenekli kanal plugin'leri artık yerel onay davranışını - `approvalCapability.nativeRuntime` ve paylaşılan runtime-context kayıt defteri aracılığıyla açığa çıkarır. + + Onay yeteneğine sahip kanal plugin'leri artık yerel onay davranışını + `approvalCapability.nativeRuntime` ve paylaşılan çalışma zamanı bağlamı kaydı aracılığıyla sunuyor. Temel değişiklikler: - `approvalCapability.handler.loadRuntime(...)` yerine `approvalCapability.nativeRuntime` kullanın - - Onaya özgü auth/delivery mantığını eski `plugin.auth` / - `plugin.approvals` bağlantısından çıkarıp `approvalCapability` üzerine taşıyın - - `ChannelPlugin.approvals`, genel channel-plugin + - Onaya özgü kimlik doğrulama/teslim mantığını eski `plugin.auth` / + `plugin.approvals` kablolamasından çıkarıp `approvalCapability` üzerine taşıyın + - `ChannelPlugin.approvals` genel kanal-plugin sözleşmesinden kaldırıldı; delivery/native/render alanlarını `approvalCapability` üzerine taşıyın - - `plugin.auth`, yalnızca kanal login/logout akışları için kalır; oradaki - onay auth hook'ları artık core tarafından okunmaz - - İstemciler, token'lar veya Bolt - uygulamaları gibi kanala ait runtime nesnelerini `openclaw/plugin-sdk/channel-runtime-context` - aracılığıyla kaydedin - - Yerel onay işleyicilerinden plugin'e ait reroute bildirimleri göndermeyin; - yönlendirilmiş-başka-yerde bildirimleri artık core gerçek delivery sonuçlarından sahiplenir - - `channelRuntime` değerini `createChannelManager(...)` içine geçirirken, - gerçek bir `createPluginRuntime().channel` yüzeyi sağlayın. Kısmi stub'lar reddedilir. + - `plugin.auth` yalnızca kanal giriş/çıkış akışları için kalır; oradaki onay kimlik doğrulama + hook'ları artık çekirdek tarafından okunmaz + - İstemciler, belirteçler veya Bolt + uygulamaları gibi kanala ait çalışma zamanı nesnelerini `openclaw/plugin-sdk/channel-runtime-context` aracılığıyla kaydedin + - Yerel onay işleyicilerinden plugin'e ait yeniden yönlendirme bildirimleri göndermeyin; + çekirdek artık gerçek teslim sonuçlarından gelen başka yere yönlendirilmiş bildirimlerin sahibidir + - `createChannelManager(...)` içine `channelRuntime` geçirirken gerçek bir + `createPluginRuntime().channel` yüzeyi sağlayın. Kısmi taslaklar reddedilir. - Geçerli approval capability - düzeni için `/plugins/sdk-channel-plugins` sayfasına bakın. + Geçerli onay yeteneği + düzeni için `/plugins/sdk-channel-plugins` bölümüne bakın. - - Plugin'iniz `openclaw/plugin-sdk/windows-spawn` kullanıyorsa, - çözümlenmemiş Windows `.cmd`/`.bat` wrapper'ları artık siz açıkça - `allowShellFallback: true` vermediğiniz sürece kapalı hata verir. + + Plugin'iniz `openclaw/plugin-sdk/windows-spawn` kullanıyorsa, çözümlenemeyen Windows + `.cmd`/`.bat` sarmalayıcıları artık siz açıkça + `allowShellFallback: true` geçmediğiniz sürece kapalı şekilde başarısız olur. ```typescript // Önce @@ -114,19 +110,19 @@ Geçerli paketlenmiş sağlayıcı örnekleri: // Sonra const program = applyWindowsSpawnProgramPolicy({ candidate, - // Bunu yalnızca bilerek shell aracılı geri dönüşü kabul eden + // Bunu yalnızca kasıtlı olarak kabuk aracılı geri dönüşü kabul eden // güvenilir uyumluluk çağıranları için ayarlayın. allowShellFallback: true, }); ``` - Çağıranınız bilerek shell fallback'e güvenmiyorsa `allowShellFallback` - ayarlamayın ve bunun yerine fırlatılan hatayı işleyin. + Çağıranınız kasıtlı olarak kabuk geri dönüşüne dayanmıyorsa, + `allowShellFallback` ayarlamayın ve bunun yerine fırlatılan hatayı işleyin. - - Plugin'inizde bu kullanımdan kaldırılmış yüzeylerden yapılan import'ları arayın: + + Plugin'inizde, kullanımdan kaldırılmış bu yüzeylerden herhangi birinden yapılan içe aktarmaları arayın: ```bash grep -r "plugin-sdk/compat" my-plugin/ @@ -135,8 +131,8 @@ Geçerli paketlenmiş sağlayıcı örnekleri: - - Eski yüzeydeki her dışa aktarma belirli bir modern import yoluna eşlenir: + + Eski yüzeydeki her dışa aktarma, belirli bir modern içe aktarma yoluna eşlenir: ```typescript // Önce (kullanımdan kaldırılmış geriye dönük uyumluluk katmanı) @@ -146,27 +142,27 @@ Geçerli paketlenmiş sağlayıcı örnekleri: resolveControlCommandGate, } from "openclaw/plugin-sdk/compat"; - // Sonra (modern odaklı import'lar) + // Sonra (modern odaklanmış içe aktarmalar) import { createChannelReplyPipeline } from "openclaw/plugin-sdk/channel-reply-pipeline"; import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store"; import { resolveControlCommandGate } from "openclaw/plugin-sdk/command-auth"; ``` - Ana makine tarafı yardımcıları için doğrudan import etmek yerine enjekte edilen - plugin runtime'ını kullanın: + Host tarafı yardımcılar için doğrudan içe aktarmak yerine eklenen + plugin çalışma zamanını kullanın: ```typescript // Önce (kullanımdan kaldırılmış extension-api köprüsü) import { runEmbeddedPiAgent } from "openclaw/extension-api"; const result = await runEmbeddedPiAgent({ sessionId, prompt }); - // Sonra (enjekte edilmiş runtime) + // Sonra (eklenen çalışma zamanı) const result = await api.runtime.agent.runEmbeddedPiAgent({ sessionId, prompt }); ``` Aynı desen diğer eski köprü yardımcıları için de geçerlidir: - | Eski import | Modern karşılığı | + | Eski içe aktarma | Modern karşılığı | | --- | --- | | `resolveAgentDir` | `api.runtime.agent.resolveAgentDir` | | `resolveAgentWorkspaceDir` | `api.runtime.agent.resolveAgentWorkspaceDir` | @@ -186,206 +182,206 @@ Geçerli paketlenmiş sağlayıcı örnekleri: -## Import yolu başvurusu +## İçe aktarma yolu başvurusu - - | Import path | Amaç | Temel dışa aktarımlar | + + | İçe aktarma yolu | Amaç | Temel dışa aktarmalar | | --- | --- | --- | | `plugin-sdk/plugin-entry` | Kanonik plugin giriş yardımcısı | `definePluginEntry` | | `plugin-sdk/core` | Kanal giriş tanımları/oluşturucuları için eski şemsiye yeniden dışa aktarma | `defineChannelPluginEntry`, `createChatChannelPlugin` | - | `plugin-sdk/config-schema` | Kök yapılandırma şeması dışa aktarımı | `OpenClawSchema` | + | `plugin-sdk/config-schema` | Kök yapılandırma şeması dışa aktarması | `OpenClawSchema` | | `plugin-sdk/provider-entry` | Tek sağlayıcılı giriş yardımcısı | `defineSingleProviderPluginEntry` | - | `plugin-sdk/channel-core` | Odaklı kanal giriş tanımları ve oluşturucuları | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` | + | `plugin-sdk/channel-core` | Odaklanmış kanal giriş tanımları ve oluşturucular | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` | | `plugin-sdk/setup` | Paylaşılan kurulum sihirbazı yardımcıları | Allowlist istemleri, kurulum durumu oluşturucuları | - | `plugin-sdk/setup-runtime` | Kurulum zamanı runtime yardımcıları | Import-safe kurulum yama bağdaştırıcıları, lookup-note yardımcıları, `promptResolvedAllowFrom`, `splitSetupEntries`, devredilmiş kurulum proxy'leri | - | `plugin-sdk/setup-adapter-runtime` | Kurulum bağdaştırıcı yardımcıları | `createEnvPatchedAccountSetupAdapter` | + | `plugin-sdk/setup-runtime` | Kurulum zamanı çalışma zamanı yardımcıları | İçe aktarması güvenli kurulum yama bağdaştırıcıları, lookup-note yardımcıları, `promptResolvedAllowFrom`, `splitSetupEntries`, devredilmiş kurulum vekilleri | + | `plugin-sdk/setup-adapter-runtime` | Kurulum bağdaştırıcısı yardımcıları | `createEnvPatchedAccountSetupAdapter` | | `plugin-sdk/setup-tools` | Kurulum araç yardımcıları | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` | - | `plugin-sdk/account-core` | Çoklu hesap yardımcıları | Hesap listesi/yapılandırma/eylem kapısı yardımcıları | - | `plugin-sdk/account-id` | Hesap kimliği yardımcıları | `DEFAULT_ACCOUNT_ID`, hesap kimliği normalleştirme | + | `plugin-sdk/account-core` | Çoklu hesap yardımcıları | Hesap listeleme/yapılandırma/eylem kapısı yardımcıları | + | `plugin-sdk/account-id` | Hesap kimliği yardımcıları | `DEFAULT_ACCOUNT_ID`, hesap kimliği normalizasyonu | | `plugin-sdk/account-resolution` | Hesap arama yardımcıları | Hesap arama + varsayılan geri dönüş yardımcıları | - | `plugin-sdk/account-helpers` | Dar hesap yardımcıları | Hesap listesi/hesap eylemi yardımcıları | + | `plugin-sdk/account-helpers` | Dar kapsamlı hesap yardımcıları | Hesap listesi/hesap eylemi yardımcıları | | `plugin-sdk/channel-setup` | Kurulum sihirbazı bağdaştırıcıları | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, ayrıca `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` | - | `plugin-sdk/channel-pairing` | DM eşleştirme ilkel öğeleri | `createChannelPairingController` | - | `plugin-sdk/channel-reply-pipeline` | Yanıt öneki + yazıyor bağlantısı | `createChannelReplyPipeline` | - | `plugin-sdk/channel-config-helpers` | Yapılandırma bağdaştırıcı fabrikaları | `createHybridChannelConfigAdapter` | + | `plugin-sdk/channel-pairing` | DM eşleme ilkelleri | `createChannelPairingController` | + | `plugin-sdk/channel-reply-pipeline` | Yanıt öneki + yazıyor göstergesi kablolaması | `createChannelReplyPipeline` | + | `plugin-sdk/channel-config-helpers` | Yapılandırma bağdaştırıcısı fabrikaları | `createHybridChannelConfigAdapter` | | `plugin-sdk/channel-config-schema` | Yapılandırma şeması oluşturucuları | Kanal yapılandırma şeması türleri | - | `plugin-sdk/telegram-command-config` | Telegram komut yapılandırma yardımcıları | Komut adı normalleştirme, açıklama kırpma, yinelenen/çakışma doğrulaması | - | `plugin-sdk/channel-policy` | Grup/DM ilke çözümleme | `resolveChannelGroupRequireMention` | + | `plugin-sdk/telegram-command-config` | Telegram komut yapılandırma yardımcıları | Komut adı normalizasyonu, açıklama kırpma, yinelenen/çakışma doğrulaması | + | `plugin-sdk/channel-policy` | Grup/DM ilkesi çözümlemesi | `resolveChannelGroupRequireMention` | | `plugin-sdk/channel-lifecycle` | Hesap durumu izleme | `createAccountStatusSink` | - | `plugin-sdk/inbound-envelope` | Gelen zarf yardımcıları | Paylaşılan route + zarf oluşturucu yardımcıları | - | `plugin-sdk/inbound-reply-dispatch` | Gelen yanıt yardımcıları | Paylaşılan record-and-dispatch yardımcıları | + | `plugin-sdk/inbound-envelope` | Gelen zarf yardımcıları | Paylaşılan rota + zarf oluşturucu yardımcıları | + | `plugin-sdk/inbound-reply-dispatch` | Gelen yanıt yardımcıları | Paylaşılan kaydetme ve dağıtım yardımcıları | | `plugin-sdk/messaging-targets` | Mesajlaşma hedefi ayrıştırma | Hedef ayrıştırma/eşleştirme yardımcıları | | `plugin-sdk/outbound-media` | Giden medya yardımcıları | Paylaşılan giden medya yükleme | - | `plugin-sdk/outbound-runtime` | Giden runtime yardımcıları | Giden kimlik/gönderme delege yardımcıları | - | `plugin-sdk/thread-bindings-runtime` | Thread-binding yardımcıları | Thread-binding yaşam döngüsü ve bağdaştırıcı yardımcıları | - | `plugin-sdk/agent-media-payload` | Eski medya payload yardımcıları | Eski alan düzenleri için agent medya payload oluşturucu | - | `plugin-sdk/channel-runtime` | Kullanımdan kaldırılmış uyumluluk shim'i | Yalnızca eski kanal runtime yardımcıları | + | `plugin-sdk/outbound-runtime` | Giden çalışma zamanı yardımcıları | Giden kimlik/gönderim delege yardımcıları | + | `plugin-sdk/thread-bindings-runtime` | İş parçacığı bağlama yardımcıları | İş parçacığı bağlama yaşam döngüsü ve bağdaştırıcı yardımcıları | + | `plugin-sdk/agent-media-payload` | Eski medya payload yardımcıları | Eski alan düzenleri için ajan medya payload oluşturucusu | + | `plugin-sdk/channel-runtime` | Kullanımdan kaldırılmış uyumluluk shim'i | Yalnızca eski kanal çalışma zamanı yardımcıları | | `plugin-sdk/channel-send-result` | Gönderim sonucu türleri | Yanıt sonuç türleri | - | `plugin-sdk/runtime-store` | Kalıcı plugin depolama | `createPluginRuntimeStore` | - | `plugin-sdk/runtime` | Geniş runtime yardımcıları | Runtime/logging/backup/plugin-install yardımcıları | - | `plugin-sdk/runtime-env` | Dar runtime env yardımcıları | Logger/runtime env, timeout, retry ve backoff yardımcıları | - | `plugin-sdk/plugin-runtime` | Paylaşılan plugin runtime yardımcıları | Plugin komutları/hook'lar/http/interactive yardımcıları | - | `plugin-sdk/hook-runtime` | Hook pipeline yardımcıları | Paylaşılan webhook/internal hook pipeline yardımcıları | - | `plugin-sdk/lazy-runtime` | Lazy runtime yardımcıları | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` | + | `plugin-sdk/runtime-store` | Kalıcı plugin depolaması | `createPluginRuntimeStore` | + | `plugin-sdk/runtime` | Geniş çalışma zamanı yardımcıları | Çalışma zamanı/günlükleme/yedekleme/plugin yükleme yardımcıları | + | `plugin-sdk/runtime-env` | Dar kapsamlı çalışma zamanı ortamı yardımcıları | Logger/çalışma zamanı ortamı, zaman aşımı, yeniden deneme ve backoff yardımcıları | + | `plugin-sdk/plugin-runtime` | Paylaşılan plugin çalışma zamanı yardımcıları | Plugin komutları/hook'ları/http/etkileşimli yardımcıları | + | `plugin-sdk/hook-runtime` | Hook ardışık düzen yardımcıları | Paylaşılan webhook/dahili hook ardışık düzen yardımcıları | + | `plugin-sdk/lazy-runtime` | Tembel çalışma zamanı yardımcıları | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` | | `plugin-sdk/process-runtime` | Süreç yardımcıları | Paylaşılan exec yardımcıları | - | `plugin-sdk/cli-runtime` | CLI runtime yardımcıları | Komut biçimlendirme, beklemeler, sürüm yardımcıları | - | `plugin-sdk/gateway-runtime` | Gateway yardımcıları | Gateway istemcisi ve channel-status yama yardımcıları | + | `plugin-sdk/cli-runtime` | CLI çalışma zamanı yardımcıları | Komut biçimlendirme, beklemeler, sürüm yardımcıları | + | `plugin-sdk/gateway-runtime` | Gateway yardımcıları | Gateway istemcisi ve kanal durumu yama yardımcıları | | `plugin-sdk/config-runtime` | Yapılandırma yardımcıları | Yapılandırma yükleme/yazma yardımcıları | | `plugin-sdk/telegram-command-config` | Telegram komut yardımcıları | Paketlenmiş Telegram sözleşme yüzeyi kullanılamadığında geri dönüşte kararlı Telegram komut doğrulama yardımcıları | - | `plugin-sdk/approval-runtime` | Onay istemi yardımcıları | Exec/plugin onay payload'ı, approval capability/profile yardımcıları, yerel onay yönlendirme/runtime yardımcıları | - | `plugin-sdk/approval-auth-runtime` | Onay auth yardımcıları | Onaylayıcı çözümleme, aynı sohbette eylem auth | - | `plugin-sdk/approval-client-runtime` | Onay istemci yardımcıları | Yerel exec onay profile/filter yardımcıları | - | `plugin-sdk/approval-delivery-runtime` | Onay delivery yardımcıları | Yerel approval capability/delivery bağdaştırıcıları | + | `plugin-sdk/approval-runtime` | Onay istemi yardımcıları | Exec/plugin onay payload'ı, onay yeteneği/profil yardımcıları, yerel onay yönlendirme/çalışma zamanı yardımcıları | + | `plugin-sdk/approval-auth-runtime` | Onay kimlik doğrulama yardımcıları | Onaylayıcı çözümleme, aynı sohbet eylem kimlik doğrulaması | + | `plugin-sdk/approval-client-runtime` | Onay istemci yardımcıları | Yerel exec onay profili/filtre yardımcıları | + | `plugin-sdk/approval-delivery-runtime` | Onay teslim yardımcıları | Yerel onay yeteneği/teslim bağdaştırıcıları | | `plugin-sdk/approval-gateway-runtime` | Onay gateway yardımcıları | Paylaşılan onay gateway çözümleme yardımcısı | - | `plugin-sdk/approval-handler-adapter-runtime` | Onay bağdaştırıcı yardımcıları | Sıcak kanal giriş noktaları için hafif yerel onay bağdaştırıcısı yükleme yardımcıları | - | `plugin-sdk/approval-handler-runtime` | Onay işleyici yardımcıları | Daha geniş onay işleyici runtime yardımcıları; dar bağdaştırıcı/gateway yüzeyleri yeterliyse onları tercih edin | - | `plugin-sdk/approval-native-runtime` | Onay hedef yardımcıları | Yerel onay hedefi/hesap bağlama yardımcıları | - | `plugin-sdk/approval-reply-runtime` | Onay yanıt yardımcıları | Exec/plugin onay yanıt payload yardımcıları | - | `plugin-sdk/channel-runtime-context` | Kanal runtime-context yardımcıları | Genel kanal runtime-context register/get/watch yardımcıları | - | `plugin-sdk/security-runtime` | Güvenlik yardımcıları | Paylaşılan trust, DM gating, external-content ve secret-collection yardımcıları | - | `plugin-sdk/ssrf-policy` | SSRF ilke yardımcıları | Ana makine izin listesi ve özel ağ ilke yardımcıları | - | `plugin-sdk/ssrf-runtime` | SSRF runtime yardımcıları | Pinned-dispatcher, guarded fetch, SSRF ilke yardımcıları | - | `plugin-sdk/collection-runtime` | Sınırlı önbellek yardımcıları | `pruneMapToMaxSize` | - | `plugin-sdk/diagnostic-runtime` | Tanılama geçidi yardımcıları | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` | - | `plugin-sdk/error-runtime` | Hata biçimlendirme yardımcıları | `formatUncaughtError`, `isApprovalNotFoundError`, hata grafı yardımcıları | - | `plugin-sdk/fetch-runtime` | Sarmalanmış fetch/proxy yardımcıları | `resolveFetch`, proxy yardımcıları | - | `plugin-sdk/host-runtime` | Ana makine normalleştirme yardımcıları | `normalizeHostname`, `normalizeScpRemoteHost` | - | `plugin-sdk/retry-runtime` | Retry yardımcıları | `RetryConfig`, `retryAsync`, ilke çalıştırıcıları | + | `plugin-sdk/approval-handler-adapter-runtime` | Onay bağdaştırıcısı yardımcıları | Sıcak kanal giriş noktaları için hafif yerel onay bağdaştırıcısı yükleme yardımcıları | + | `plugin-sdk/approval-handler-runtime` | Onay işleyici yardımcıları | Daha geniş onay işleyici çalışma zamanı yardımcıları; yeterli olduklarında daha dar bağdaştırıcı/gateway seam'lerini tercih edin | + | `plugin-sdk/approval-native-runtime` | Onay hedefi yardımcıları | Yerel onay hedefi/hesap bağlama yardımcıları | + | `plugin-sdk/approval-reply-runtime` | Onay yanıtı yardımcıları | Exec/plugin onay yanıt payload yardımcıları | + | `plugin-sdk/channel-runtime-context` | Kanal çalışma zamanı bağlamı yardımcıları | Genel kanal çalışma zamanı bağlamı kaydetme/alma/izleme yardımcıları | + | `plugin-sdk/security-runtime` | Güvenlik yardımcıları | Paylaşılan güven, DM geçitleme, harici içerik ve gizli bilgi toplama yardımcıları | + | `plugin-sdk/ssrf-policy` | SSRF ilke yardımcıları | Host allowlist ve özel ağ ilkesi yardımcıları | + | `plugin-sdk/ssrf-runtime` | SSRF çalışma zamanı yardımcıları | Sabitlenmiş dispatcher, korumalı fetch, SSRF ilkesi yardımcıları | + | `plugin-sdk/collection-runtime` | Sınırlandırılmış önbellek yardımcıları | `pruneMapToMaxSize` | + | `plugin-sdk/diagnostic-runtime` | Tanılama geçitleme yardımcıları | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` | + | `plugin-sdk/error-runtime` | Hata biçimlendirme yardımcıları | `formatUncaughtError`, `isApprovalNotFoundError`, hata grafiği yardımcıları | + | `plugin-sdk/fetch-runtime` | Sarılmış fetch/proxy yardımcıları | `resolveFetch`, proxy yardımcıları | + | `plugin-sdk/host-runtime` | Host normalizasyon yardımcıları | `normalizeHostname`, `normalizeScpRemoteHost` | + | `plugin-sdk/retry-runtime` | Yeniden deneme yardımcıları | `RetryConfig`, `retryAsync`, ilke çalıştırıcıları | | `plugin-sdk/allow-from` | Allowlist biçimlendirme | `formatAllowFromLowercase` | | `plugin-sdk/allowlist-resolution` | Allowlist girdi eşleme | `mapAllowlistResolutionInputs` | - | `plugin-sdk/command-auth` | Komut geçidi ve komut yüzeyi yardımcıları | `resolveControlCommandGate`, gönderen-yetkilendirme yardımcıları, komut kayıt defteri yardımcıları | - | `plugin-sdk/secret-input` | Secret girdi ayrıştırma | Secret girdi yardımcıları | + | `plugin-sdk/command-auth` | Komut geçitleme ve komut-yüzeyi yardımcıları | `resolveControlCommandGate`, gönderen yetkilendirme yardımcıları, komut kayıt yardımcıları | + | `plugin-sdk/secret-input` | Gizli girdi ayrıştırma | Gizli girdi yardımcıları | | `plugin-sdk/webhook-ingress` | Webhook istek yardımcıları | Webhook hedef yardımcıları | | `plugin-sdk/webhook-request-guards` | Webhook gövde koruma yardımcıları | İstek gövdesi okuma/sınır yardımcıları | - | `plugin-sdk/reply-runtime` | Paylaşılan yanıt runtime'ı | Gelen dispatch, heartbeat, yanıt planlayıcı, chunking | - | `plugin-sdk/reply-dispatch-runtime` | Dar yanıt dispatch yardımcıları | Finalize + provider dispatch yardımcıları | + | `plugin-sdk/reply-runtime` | Paylaşılan yanıt çalışma zamanı | Gelen dağıtım, heartbeat, yanıt planlayıcı, parçalama | + | `plugin-sdk/reply-dispatch-runtime` | Dar kapsamlı yanıt dağıtım yardımcıları | Sonlandırma + sağlayıcı dağıtım yardımcıları | | `plugin-sdk/reply-history` | Yanıt geçmişi yardımcıları | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` | - | `plugin-sdk/reply-reference` | Yanıt başvurusu planlama | `createReplyReferencePlanner` | - | `plugin-sdk/reply-chunking` | Yanıt parça yardımcıları | Metin/markdown chunking yardımcıları | + | `plugin-sdk/reply-reference` | Yanıt referansı planlama | `createReplyReferencePlanner` | + | `plugin-sdk/reply-chunking` | Yanıt parça yardımcıları | Metin/markdown parçalama yardımcıları | | `plugin-sdk/session-store-runtime` | Oturum deposu yardımcıları | Depo yolu + updated-at yardımcıları | - | `plugin-sdk/state-paths` | Durum yolu yardımcıları | Durum ve OAuth dizini yardımcıları | - | `plugin-sdk/routing` | Routing/session-key yardımcıları | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, session-key normalleştirme yardımcıları | - | `plugin-sdk/status-helpers` | Kanal durum yardımcıları | Kanal/hesap durum özeti oluşturucuları, runtime-state varsayılanları, issue meta veri yardımcıları | - | `plugin-sdk/target-resolver-runtime` | Hedef çözücü yardımcıları | Paylaşılan hedef çözücü yardımcıları | - | `plugin-sdk/string-normalization-runtime` | Dize normalleştirme yardımcıları | Slug/dize normalleştirme yardımcıları | - | `plugin-sdk/request-url` | İstek URL yardımcıları | Request benzeri girdilerden dize URL'leri çıkarma | - | `plugin-sdk/run-command` | Zamanlanmış komut yardımcıları | Normalize stdout/stderr ile zamanlanmış komut çalıştırıcı | - | `plugin-sdk/param-readers` | Param okuyucular | Yaygın araç/CLI param okuyucuları | - | `plugin-sdk/tool-send` | Tool send çıkarımı | Araç argümanlarından kanonik gönderim hedefi alanlarını çıkarma | - | `plugin-sdk/temp-path` | Geçici yol yardımcıları | Paylaşılan temp-download yol yardımcıları | - | `plugin-sdk/logging-core` | Logging yardımcıları | Alt sistem logger ve redaction yardımcıları | - | `plugin-sdk/markdown-table-runtime` | Markdown-table yardımcıları | Markdown tablo modu yardımcıları | + | `plugin-sdk/state-paths` | Durum yolu yardımcıları | Durum ve OAuth dizin yardımcıları | + | `plugin-sdk/routing` | Yönlendirme/oturum anahtarı yardımcıları | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, oturum anahtarı normalizasyon yardımcıları | + | `plugin-sdk/status-helpers` | Kanal durumu yardımcıları | Kanal/hesap durum özeti oluşturucuları, çalışma zamanı durumu varsayılanları, sorun meta verisi yardımcıları | + | `plugin-sdk/target-resolver-runtime` | Hedef çözümleyici yardımcıları | Paylaşılan hedef çözümleyici yardımcıları | + | `plugin-sdk/string-normalization-runtime` | Dizge normalizasyon yardımcıları | Slug/dizge normalizasyon yardımcıları | + | `plugin-sdk/request-url` | İstek URL yardımcıları | İstek benzeri girdilerden dizge URL'leri çıkarma | + | `plugin-sdk/run-command` | Zamanlanmış komut yardımcıları | Normalize stdout/stderr ile zamanlanmış komut çalıştırıcısı | + | `plugin-sdk/param-readers` | Parametre okuyucular | Yaygın araç/CLI parametre okuyucuları | + | `plugin-sdk/tool-payload` | Araç payload çıkarımı | Araç sonuç nesnelerinden normalize payload çıkarma | + | `plugin-sdk/tool-send` | Araç gönderim çıkarımı | Araç argümanlarından kanonik gönderim hedefi alanlarını çıkarma | + | `plugin-sdk/temp-path` | Geçici yol yardımcıları | Paylaşılan geçici indirme yolu yardımcıları | + | `plugin-sdk/logging-core` | Günlükleme yardımcıları | Alt sistem logger ve redaksiyon yardımcıları | + | `plugin-sdk/markdown-table-runtime` | Markdown tablo yardımcıları | Markdown tablo modu yardımcıları | | `plugin-sdk/reply-payload` | Mesaj yanıt türleri | Yanıt payload türleri | - | `plugin-sdk/provider-setup` | Özenle seçilmiş yerel/self-hosted sağlayıcı kurulum yardımcıları | Self-hosted sağlayıcı keşif/yapılandırma yardımcıları | - | `plugin-sdk/self-hosted-provider-setup` | Odaklı OpenAI-compatible self-hosted sağlayıcı kurulum yardımcıları | Aynı self-hosted sağlayıcı keşif/yapılandırma yardımcıları | - | `plugin-sdk/provider-auth-runtime` | Sağlayıcı runtime auth yardımcıları | Runtime API anahtarı çözümleme yardımcıları | - | `plugin-sdk/provider-auth-api-key` | Sağlayıcı API anahtarı kurulum yardımcıları | API anahtarı onboarding/profile-write yardımcıları | - | `plugin-sdk/provider-auth-result` | Sağlayıcı auth-result yardımcıları | Standart OAuth auth-result oluşturucu | - | `plugin-sdk/provider-auth-login` | Sağlayıcı etkileşimli login yardımcıları | Paylaşılan etkileşimli login yardımcıları | - | `plugin-sdk/provider-env-vars` | Sağlayıcı env-var yardımcıları | Sağlayıcı auth env-var arama yardımcıları | - | `plugin-sdk/provider-model-shared` | Paylaşılan sağlayıcı model/replay yardımcıları | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, paylaşılan replay-policy oluşturucuları, provider-endpoint yardımcıları ve model-id normalleştirme yardımcıları | + | `plugin-sdk/provider-setup` | Küratörlü yerel/kendi kendine barındırılan sağlayıcı kurulum yardımcıları | Kendi kendine barındırılan sağlayıcı keşfi/yapılandırma yardımcıları | + | `plugin-sdk/self-hosted-provider-setup` | Odaklanmış OpenAI uyumlu kendi kendine barındırılan sağlayıcı kurulum yardımcıları | Aynı kendi kendine barındırılan sağlayıcı keşfi/yapılandırma yardımcıları | + | `plugin-sdk/provider-auth-runtime` | Sağlayıcı çalışma zamanı kimlik doğrulama yardımcıları | Çalışma zamanı API anahtarı çözümleme yardımcıları | + | `plugin-sdk/provider-auth-api-key` | Sağlayıcı API anahtarı kurulum yardımcıları | API anahtarı ilk kurulum/profil yazma yardımcıları | + | `plugin-sdk/provider-auth-result` | Sağlayıcı auth-result yardımcıları | Standart OAuth auth-result oluşturucusu | + | `plugin-sdk/provider-auth-login` | Sağlayıcı etkileşimli giriş yardımcıları | Paylaşılan etkileşimli giriş yardımcıları | + | `plugin-sdk/provider-env-vars` | Sağlayıcı ortam değişkeni yardımcıları | Sağlayıcı auth ortam değişkeni arama yardımcıları | + | `plugin-sdk/provider-model-shared` | Paylaşılan sağlayıcı model/yeniden oynatma yardımcıları | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, paylaşılan replay-policy oluşturucuları, sağlayıcı uç nokta yardımcıları ve model kimliği normalizasyon yardımcıları | | `plugin-sdk/provider-catalog-shared` | Paylaşılan sağlayıcı katalog yardımcıları | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` | | `plugin-sdk/provider-onboard` | Sağlayıcı onboarding yamaları | Onboarding yapılandırma yardımcıları | - | `plugin-sdk/provider-http` | Sağlayıcı HTTP yardımcıları | Genel sağlayıcı HTTP/endpoint capability yardımcıları | - | `plugin-sdk/provider-web-fetch` | Sağlayıcı web-fetch yardımcıları | Web-fetch sağlayıcı kayıt/önbellek yardımcıları | - | `plugin-sdk/provider-web-search-contract` | Sağlayıcı web-search sözleşme yardımcıları | `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` ve kapsamlı kimlik bilgisi ayarlayıcıları/alıcıları gibi dar web-search yapılandırma/kimlik bilgisi sözleşme yardımcıları | - | `plugin-sdk/provider-web-search` | Sağlayıcı web-search yardımcıları | Web-search sağlayıcı kayıt/önbellek/runtime yardımcıları | - | `plugin-sdk/provider-tools` | Sağlayıcı araç/şema uyumluluk yardımcıları | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini şema temizliği + tanılama ve `resolveXaiModelCompatPatch` / `applyXaiModelCompat` gibi xAI uyumluluk yardımcıları | + | `plugin-sdk/provider-http` | Sağlayıcı HTTP yardımcıları | Genel sağlayıcı HTTP/uç nokta yeteneği yardımcıları | + | `plugin-sdk/provider-web-fetch` | Sağlayıcı web-fetch yardımcıları | Web-fetch sağlayıcı kaydı/önbellek yardımcıları | + | `plugin-sdk/provider-web-search-config-contract` | Sağlayıcı web-search yapılandırma yardımcıları | Plugin etkinleştirme kablolamasına ihtiyaç duymayan sağlayıcılar için dar kapsamlı web-search yapılandırma/kimlik bilgisi yardımcıları | + | `plugin-sdk/provider-web-search-contract` | Sağlayıcı web-search sözleşme yardımcıları | `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` ve kapsamlı kimlik bilgisi ayarlayıcıları/alıcıları gibi dar kapsamlı web-search yapılandırma/kimlik bilgisi sözleşme yardımcıları | + | `plugin-sdk/provider-web-search` | Sağlayıcı web-search yardımcıları | Web-search sağlayıcı kaydı/önbellek/çalışma zamanı yardımcıları | + | `plugin-sdk/provider-tools` | Sağlayıcı araç/şema uyumluluk yardımcıları | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini şema temizleme + tanılama ve `resolveXaiModelCompatPatch` / `applyXaiModelCompat` gibi xAI uyumluluk yardımcıları | | `plugin-sdk/provider-usage` | Sağlayıcı kullanım yardımcıları | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` ve diğer sağlayıcı kullanım yardımcıları | | `plugin-sdk/provider-stream` | Sağlayıcı akış sarmalayıcı yardımcıları | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, akış sarmalayıcı türleri ve paylaşılan Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot sarmalayıcı yardımcıları | | `plugin-sdk/keyed-async-queue` | Sıralı async kuyruk | `KeyedAsyncQueue` | - | `plugin-sdk/media-runtime` | Paylaşılan medya yardımcıları | Medya fetch/transform/store yardımcıları artı medya payload oluşturucuları | - | `plugin-sdk/media-generation-runtime` | Paylaşılan media-generation yardımcıları | Görüntü/video/müzik üretimi için paylaşılan failover yardımcıları, aday seçimi ve eksik model mesajlaşması | - | `plugin-sdk/media-understanding` | Media-understanding yardımcıları | Media understanding sağlayıcı türleri artı sağlayıcıya dönük görüntü/ses yardımcı dışa aktarımları | - | `plugin-sdk/text-runtime` | Paylaşılan metin yardımcıları | Assistanta görünür metin temizleme, markdown render/chunking/table yardımcıları, redaction yardımcıları, directive-tag yardımcıları, safe-text yardımcıları ve ilgili metin/logging yardımcıları | - | `plugin-sdk/text-chunking` | Metin parça yardımcıları | Giden metin chunking yardımcısı | - | `plugin-sdk/speech` | Konuşma yardımcıları | Konuşma sağlayıcı türleri artı sağlayıcıya dönük directive, registry ve doğrulama yardımcıları | - | `plugin-sdk/speech-core` | Paylaşılan konuşma çekirdeği | Konuşma sağlayıcı türleri, registry, directive'ler, normalleştirme | - | `plugin-sdk/realtime-transcription` | Realtime transcription yardımcıları | Sağlayıcı türleri ve registry yardımcıları | - | `plugin-sdk/realtime-voice` | Realtime voice yardımcıları | Sağlayıcı türleri ve registry yardımcıları | - | `plugin-sdk/image-generation-core` | Paylaşılan image-generation çekirdeği | Image-generation türleri, failover, auth ve registry yardımcıları | - | `plugin-sdk/music-generation` | Music-generation yardımcıları | Music-generation sağlayıcı/istek/sonuç türleri | - | `plugin-sdk/music-generation-core` | Paylaşılan music-generation çekirdeği | Music-generation türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma | - | `plugin-sdk/video-generation` | Video-generation yardımcıları | Video-generation sağlayıcı/istek/sonuç türleri | - | `plugin-sdk/video-generation-core` | Paylaşılan video-generation çekirdeği | Video-generation türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma | - | `plugin-sdk/interactive-runtime` | Etkileşimli yanıt yardımcıları | Etkileşimli yanıt payload normalleştirme/indirgeme | - | `plugin-sdk/channel-config-primitives` | Kanal yapılandırma ilkel öğeleri | Dar kanal config-schema ilkel öğeleri | - | `plugin-sdk/channel-config-writes` | Kanal config-write yardımcıları | Kanal config-write yetkilendirme yardımcıları | - | `plugin-sdk/channel-plugin-common` | Paylaşılan kanal başlangıç bölümü | Paylaşılan kanal plugin başlangıç dışa aktarımları | - | `plugin-sdk/channel-status` | Kanal durum yardımcıları | Paylaşılan kanal durum anlık görüntüsü/özet yardımcıları | + | `plugin-sdk/media-runtime` | Paylaşılan medya yardımcıları | Medya fetch/transform/store yardımcıları ile medya payload oluşturucuları | + | `plugin-sdk/media-generation-runtime` | Paylaşılan medya üretimi yardımcıları | Görüntü/video/müzik üretimi için paylaşılan failover yardımcıları, aday seçimi ve eksik model mesajları | + | `plugin-sdk/media-understanding` | Media-understanding yardımcıları | Media understanding sağlayıcı türleri ile sağlayıcıya dönük görüntü/ses yardımcı dışa aktarmaları | + | `plugin-sdk/text-runtime` | Paylaşılan metin yardımcıları | Asistan tarafından görünen metin temizleme, markdown işleme/parçalama/tablo yardımcıları, redaksiyon yardımcıları, directive-tag yardımcıları, güvenli metin yardımcıları ve ilgili metin/günlükleme yardımcıları | + | `plugin-sdk/text-chunking` | Metin parçalama yardımcıları | Giden metin parçalama yardımcısı | + | `plugin-sdk/speech` | Konuşma yardımcıları | Konuşma sağlayıcı türleri ile sağlayıcıya dönük directive, registry ve doğrulama yardımcıları | + | `plugin-sdk/speech-core` | Paylaşılan konuşma çekirdeği | Konuşma sağlayıcı türleri, kayıt, directive'ler, normalizasyon | + | `plugin-sdk/realtime-transcription` | Gerçek zamanlı transkripsiyon yardımcıları | Sağlayıcı türleri ve kayıt yardımcıları | + | `plugin-sdk/realtime-voice` | Gerçek zamanlı ses yardımcıları | Sağlayıcı türleri ve kayıt yardımcıları | + | `plugin-sdk/image-generation-core` | Paylaşılan görüntü üretimi çekirdeği | Görüntü üretimi türleri, failover, kimlik doğrulama ve kayıt yardımcıları | + | `plugin-sdk/music-generation` | Müzik üretimi yardımcıları | Müzik üretimi sağlayıcı/istek/sonuç türleri | + | `plugin-sdk/music-generation-core` | Paylaşılan müzik üretimi çekirdeği | Müzik üretimi türleri, failover yardımcıları, sağlayıcı araması ve model-ref ayrıştırma | + | `plugin-sdk/video-generation` | Video üretimi yardımcıları | Video üretimi sağlayıcı/istek/sonuç türleri | + | `plugin-sdk/video-generation-core` | Paylaşılan video üretimi çekirdeği | Video üretimi türleri, failover yardımcıları, sağlayıcı araması ve model-ref ayrıştırma | + | `plugin-sdk/interactive-runtime` | Etkileşimli yanıt yardımcıları | Etkileşimli yanıt payload normalizasyonu/indirgeme | + | `plugin-sdk/channel-config-primitives` | Kanal yapılandırma ilkelleri | Dar kapsamlı kanal config-schema ilkelleri | + | `plugin-sdk/channel-config-writes` | Kanal yapılandırma yazma yardımcıları | Kanal yapılandırma yazma yetkilendirme yardımcıları | + | `plugin-sdk/channel-plugin-common` | Paylaşılan kanal prelüdü | Paylaşılan kanal plugin prelüd dışa aktarmaları | + | `plugin-sdk/channel-status` | Kanal durumu yardımcıları | Paylaşılan kanal durumu anlık görüntü/özet yardımcıları | | `plugin-sdk/allowlist-config-edit` | Allowlist yapılandırma yardımcıları | Allowlist yapılandırma düzenleme/okuma yardımcıları | - | `plugin-sdk/group-access` | Grup erişim yardımcıları | Paylaşılan grup erişim kararı yardımcıları | - | `plugin-sdk/direct-dm` | Doğrudan-DM yardımcıları | Paylaşılan doğrudan-DM auth/guard yardımcıları | - | `plugin-sdk/extension-shared` | Paylaşılan extension yardımcıları | Passive-channel/status ve ambient proxy yardımcı ilkel öğeleri | - | `plugin-sdk/webhook-targets` | Webhook hedef yardımcıları | Webhook hedef kayıt defteri ve route-install yardımcıları | - | `plugin-sdk/webhook-path` | Webhook yol yardımcıları | Webhook yol normalleştirme yardımcıları | + | `plugin-sdk/group-access` | Grup erişim yardımcıları | Paylaşılan grup erişimi karar yardımcıları | + | `plugin-sdk/direct-dm` | Doğrudan-DM yardımcıları | Paylaşılan doğrudan-DM kimlik doğrulama/koruma yardımcıları | + | `plugin-sdk/extension-shared` | Paylaşılan extension yardımcıları | Pasif kanal/durum ve ortam proxy yardımcısı ilkelleri | + | `plugin-sdk/webhook-targets` | Webhook hedef yardımcıları | Webhook hedef kaydı ve rota kurulum yardımcıları | + | `plugin-sdk/webhook-path` | Webhook yol yardımcıları | Webhook yol normalizasyon yardımcıları | | `plugin-sdk/web-media` | Paylaşılan web medya yardımcıları | Uzak/yerel medya yükleme yardımcıları | - | `plugin-sdk/zod` | Zod yeniden dışa aktarma | Plugin SDK kullanıcıları için yeniden dışa aktarılan `zod` | - | `plugin-sdk/memory-core` | Paketlenmiş memory-core yardımcıları | Memory manager/config/file/CLI yardımcı yüzeyi | - | `plugin-sdk/memory-core-engine-runtime` | Memory engine runtime cephesi | Memory index/search runtime cephesi | - | `plugin-sdk/memory-core-host-engine-foundation` | Memory host foundation engine | Memory host foundation engine dışa aktarımları | - | `plugin-sdk/memory-core-host-engine-embeddings` | Memory host embedding engine | Memory host embedding engine dışa aktarımları | - | `plugin-sdk/memory-core-host-engine-qmd` | Memory host QMD engine | Memory host QMD engine dışa aktarımları | - | `plugin-sdk/memory-core-host-engine-storage` | Memory host storage engine | Memory host storage engine dışa aktarımları | - | `plugin-sdk/memory-core-host-multimodal` | Memory host multimodal yardımcıları | Memory host multimodal yardımcıları | - | `plugin-sdk/memory-core-host-query` | Memory host query yardımcıları | Memory host query yardımcıları | - | `plugin-sdk/memory-core-host-secret` | Memory host secret yardımcıları | Memory host secret yardımcıları | - | `plugin-sdk/memory-core-host-events` | Memory host event journal yardımcıları | Memory host event journal yardımcıları | - | `plugin-sdk/memory-core-host-status` | Memory host status yardımcıları | Memory host status yardımcıları | - | `plugin-sdk/memory-core-host-runtime-cli` | Memory host CLI runtime | Memory host CLI runtime yardımcıları | - | `plugin-sdk/memory-core-host-runtime-core` | Memory host core runtime | Memory host core runtime yardımcıları | - | `plugin-sdk/memory-core-host-runtime-files` | Memory host file/runtime yardımcıları | Memory host file/runtime yardımcıları | - | `plugin-sdk/memory-host-core` | Memory host core runtime takma adı | Memory host core runtime yardımcıları için satıcıdan bağımsız takma ad | - | `plugin-sdk/memory-host-events` | Memory host event journal takma adı | Memory host event journal yardımcıları için satıcıdan bağımsız takma ad | - | `plugin-sdk/memory-host-files` | Memory host file/runtime takma adı | Memory host file/runtime yardımcıları için satıcıdan bağımsız takma ad | - | `plugin-sdk/memory-host-markdown` | Yönetilen markdown yardımcıları | Memory'ye bitişik plugin'ler için paylaşılan managed-markdown yardımcıları | - | `plugin-sdk/memory-host-search` | Etkin memory search cephesi | Lazy active-memory search-manager runtime cephesi | - | `plugin-sdk/memory-host-status` | Memory host status takma adı | Memory host status yardımcıları için satıcıdan bağımsız takma ad | + | `plugin-sdk/zod` | Zod yeniden dışa aktarması | Plugin SDK tüketicileri için yeniden dışa aktarılan `zod` | + | `plugin-sdk/memory-core` | Paketlenmiş memory-core yardımcıları | Bellek yöneticisi/yapılandırma/dosya/CLI yardımcı yüzeyi | + | `plugin-sdk/memory-core-engine-runtime` | Bellek motoru çalışma zamanı cephesi | Bellek dizin/arama çalışma zamanı cephesi | + | `plugin-sdk/memory-core-host-engine-foundation` | Bellek host foundation motoru | Bellek host foundation motoru dışa aktarmaları | + | `plugin-sdk/memory-core-host-engine-embeddings` | Bellek host embedding motoru | Bellek host embedding motoru dışa aktarmaları | + | `plugin-sdk/memory-core-host-engine-qmd` | Bellek host QMD motoru | Bellek host QMD motoru dışa aktarmaları | + | `plugin-sdk/memory-core-host-engine-storage` | Bellek host depolama motoru | Bellek host depolama motoru dışa aktarmaları | + | `plugin-sdk/memory-core-host-multimodal` | Bellek host multimodal yardımcıları | Bellek host multimodal yardımcıları | + | `plugin-sdk/memory-core-host-query` | Bellek host sorgu yardımcıları | Bellek host sorgu yardımcıları | + | `plugin-sdk/memory-core-host-secret` | Bellek host secret yardımcıları | Bellek host secret yardımcıları | + | `plugin-sdk/memory-core-host-events` | Bellek host olay günlüğü yardımcıları | Bellek host olay günlüğü yardımcıları | + | `plugin-sdk/memory-core-host-status` | Bellek host durum yardımcıları | Bellek host durum yardımcıları | + | `plugin-sdk/memory-core-host-runtime-cli` | Bellek host CLI çalışma zamanı | Bellek host CLI çalışma zamanı yardımcıları | + | `plugin-sdk/memory-core-host-runtime-core` | Bellek host çekirdek çalışma zamanı | Bellek host çekirdek çalışma zamanı yardımcıları | + | `plugin-sdk/memory-core-host-runtime-files` | Bellek host dosya/çalışma zamanı yardımcıları | Bellek host dosya/çalışma zamanı yardımcıları | + | `plugin-sdk/memory-host-core` | Bellek host çekirdek çalışma zamanı takma adı | Bellek host çekirdek çalışma zamanı yardımcıları için sağlayıcıdan bağımsız takma ad | + | `plugin-sdk/memory-host-events` | Bellek host olay günlüğü takma adı | Bellek host olay günlüğü yardımcıları için sağlayıcıdan bağımsız takma ad | + | `plugin-sdk/memory-host-files` | Bellek host dosya/çalışma zamanı takma adı | Bellek host dosya/çalışma zamanı yardımcıları için sağlayıcıdan bağımsız takma ad | + | `plugin-sdk/memory-host-markdown` | Yönetilen markdown yardımcıları | Belleğe bitişik plugin'ler için paylaşılan yönetilen-markdown yardımcıları | + | `plugin-sdk/memory-host-search` | Etkin bellek arama cephesi | Tembel etkin bellek search-manager çalışma zamanı cephesi | + | `plugin-sdk/memory-host-status` | Bellek host durum takma adı | Bellek host durum yardımcıları için sağlayıcıdan bağımsız takma ad | | `plugin-sdk/memory-lancedb` | Paketlenmiş memory-lancedb yardımcıları | Memory-lancedb yardımcı yüzeyi | - | `plugin-sdk/testing` | Test yardımcı araçları | Test yardımcıları ve mock'lar | + | `plugin-sdk/testing` | Test yardımcıları | Test yardımcıları ve mock'lar | -Bu tablo, tüm SDK yüzeyi değil, bilinçli olarak yaygın geçiş alt kümesidir. -200'den fazla entrypoint'in tam listesi +Bu tablo kasıtlı olarak tam SDK yüzeyi değil, yaygın geçiş alt kümesidir. +200'den fazla giriş noktasının tam listesi `scripts/lib/plugin-sdk-entrypoints.json` içinde bulunur. -Bu liste hâlâ bazı paketlenmiş-plugin yardımcı yüzeylerini içerir; örneğin -`plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`, -`plugin-sdk/zalo-setup` ve `plugin-sdk/matrix*`. Bunlar paketlenmiş-plugin -bakımı ve uyumluluk için dışa aktarılmaya devam eder, ancak bilinçli olarak -yaygın geçiş tablosuna dahil edilmemiştir ve -yeni plugin kodu için önerilen hedef değildir. +Bu liste hâlâ `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`, +`plugin-sdk/zalo-setup` ve `plugin-sdk/matrix*` gibi bazı paketlenmiş-plugin yardımcı seam'lerini içerir. Bunlar +paketlenmiş-plugin bakımı ve uyumluluk için dışa aktarılmaya devam eder, ancak yaygın geçiş tablosuna bilerek +dahil edilmemiştir ve yeni plugin kodu için önerilen hedef değildir. -Aynı kural şu diğer paketlenmiş yardımcı aileleri için de geçerlidir: +Aynı kural diğer paketlenmiş yardımcı aileleri için de geçerlidir, örneğin: -- tarayıcı desteği yardımcıları: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` +- tarayıcı destek yardımcıları: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` - Matrix: `plugin-sdk/matrix*` - LINE: `plugin-sdk/line*` - IRC: `plugin-sdk/irc*` -- paketlenmiş yardımcı/plugin yüzeyleri, örneğin `plugin-sdk/googlechat`, +- `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles*`, `plugin-sdk/mattermost*`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch`, `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, - `plugin-sdk/thread-ownership` ve `plugin-sdk/voice-call` + `plugin-sdk/thread-ownership` ve `plugin-sdk/voice-call` gibi paketlenmiş yardımcı/plugin yüzeyleri -`plugin-sdk/github-copilot-token` şu anda dar token-helper +`plugin-sdk/github-copilot-token` şu anda dar kapsamlı belirteç yardımcı yüzeyi `DEFAULT_COPILOT_API_BASE_URL`, -`deriveCopilotApiBaseUrlFromToken` ve `resolveCopilotApiToken` değerlerini açığa çıkarır. +`deriveCopilotApiBaseUrlFromToken` ve `resolveCopilotApiToken`'ı sunar. -Yapılan işe uyan en dar import'u kullanın. Bir dışa aktarım bulamazsanız -`src/plugin-sdk/` içindeki kaynağı inceleyin veya Discord'da sorun. +İşinize en uygun en dar içe aktarmayı kullanın. Bir dışa aktarma bulamazsanız, +`src/plugin-sdk/` altındaki kaynağı kontrol edin veya Discord'da sorun. ## Kaldırma zaman çizelgesi -| Ne zaman | Ne olur | -| ---------------------- | ----------------------------------------------------------------------- | -| **Şimdi** | Kullanımdan kaldırılmış yüzeyler çalışma zamanında uyarı verir | -| **Bir sonraki büyük sürüm** | Kullanımdan kaldırılmış yüzeyler kaldırılır; bunları hâlâ kullanan plugin'ler başarısız olur | +| Ne zaman | Ne olur | +| ---------------------- | ---------------------------------------------------------------------- | +| **Şimdi** | Kullanımdan kaldırılmış yüzeyler çalışma zamanı uyarıları yayar | +| **Bir sonraki büyük sürüm** | Kullanımdan kaldırılmış yüzeyler kaldırılacaktır; bunları hâlâ kullanan plugin'ler başarısız olacaktır | -Tüm core plugin'ler zaten taşındı. Harici plugin'ler +Tüm çekirdek plugin'ler zaten geçirildi. Harici plugin'ler bir sonraki büyük sürümden önce geçiş yapmalıdır. ## Uyarıları geçici olarak bastırma @@ -402,8 +398,8 @@ Bu geçici bir kaçış kapağıdır, kalıcı bir çözüm değildir. ## İlgili - [Başlangıç](/tr/plugins/building-plugins) — ilk plugin'inizi oluşturun -- [SDK Genel Bakış](/tr/plugins/sdk-overview) — alt yollar için tam import başvurusu +- [SDK Genel Bakış](/tr/plugins/sdk-overview) — alt yol içe aktarmaları için tam başvuru - [Kanal Plugin'leri](/tr/plugins/sdk-channel-plugins) — kanal plugin'leri oluşturma - [Sağlayıcı Plugin'leri](/tr/plugins/sdk-provider-plugins) — sağlayıcı plugin'leri oluşturma -- [Plugin İç Yapısı](/tr/plugins/architecture) — mimariyi derinlemesine inceleme -- [Plugin Manifest'i](/tr/plugins/manifest) — manifest şeması başvurusu +- [Plugin İç Yapısı](/tr/plugins/architecture) — mimariye derinlemesine bakış +- [Plugin Manifesti](/tr/plugins/manifest) — manifest şeması başvurusu diff --git a/docs/tr/plugins/sdk-overview.md b/docs/tr/plugins/sdk-overview.md index 1f80a8372..125d67726 100644 --- a/docs/tr/plugins/sdk-overview.md +++ b/docs/tr/plugins/sdk-overview.md @@ -1,30 +1,31 @@ --- read_when: - - Hangi SDK alt yolundan içe aktarma yapmanız gerektiğini öğrenmeniz gerekiyor + - Hangi SDK alt yolundan içe aktarma yapmanız gerektiğini bilmeniz gerekiyor - OpenClawPluginApi üzerindeki tüm kayıt yöntemleri için bir başvuru istiyorsunuz - Belirli bir SDK dışa aktarımını arıyorsunuz sidebarTitle: SDK Overview -summary: Import map, kayıt API başvurusu ve SDK mimarisi +summary: İçe aktarma eşleme tablosu, kayıt API başvurusu ve SDK mimarisi title: Plugin SDK Genel Bakış x-i18n: - generated_at: "2026-04-08T02:17:58Z" + generated_at: "2026-04-08T08:44:45Z" model: gpt-5.4 provider: openai - source_hash: c5a41bd82d165dfbb7fbd6e4528cf322e9133a51efe55fa8518a7a0a626d9d30 + source_hash: 6e7b420eb0f3faa8916357d52df949f6c9a46f1c843a1e6a0c0b8bb26db6cbff source_path: plugins/sdk-overview.md workflow: 15 --- # Plugin SDK Genel Bakış -Plugin SDK, plugin'ler ile çekirdek arasındaki türlenmiş sözleşmedir. Bu sayfa, -**neyin içe aktarılacağı** ve **nelerin kaydedilebileceği** için başvurudur. +Plugin SDK, plugin'ler ile çekirdek arasındaki tiplenmiş sözleşmedir. Bu sayfa, +**neyin içe aktarılacağı** ve **nelerin kaydedilebileceği** için başvuru +kaynağıdır. **Nasıl yapılır kılavuzu mu arıyorsunuz?** - İlk plugin mi? [Başlangıç](/tr/plugins/building-plugins) ile başlayın - - Kanal plugin'i mi? [Kanal Plugin'leri](/tr/plugins/sdk-channel-plugins) bölümüne bakın - - Sağlayıcı plugin'i mi? [Sağlayıcı Plugin'leri](/tr/plugins/sdk-provider-plugins) bölümüne bakın + - Kanal plugin'i mi? [Kanal Plugin'leri](/tr/plugins/sdk-channel-plugins) sayfasına bakın + - Sağlayıcı plugin'i mi? [Sağlayıcı Plugin'leri](/tr/plugins/sdk-provider-plugins) sayfasına bakın ## İçe aktarma kuralı @@ -36,29 +37,41 @@ import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core"; ``` -Her alt yol küçük, kendi içinde tamamlanmış bir modüldür. Bu, başlangıcın hızlı kalmasını sağlar ve döngüsel bağımlılık sorunlarını önler. Kanala özgü giriş/oluşturma yardımcıları için `openclaw/plugin-sdk/channel-core` tercih edin; daha geniş şemsiye yüzey ve -`buildChannelConfigSchema` gibi paylaşılan yardımcılar için `openclaw/plugin-sdk/core` yolunu kullanın. +Her alt yol küçük, kendi içinde tamamlanmış bir modüldür. Bu, başlangıcın hızlı +kalmasını sağlar ve dairesel bağımlılık sorunlarını önler. Kanala özel +entry/build yardımcıları için `openclaw/plugin-sdk/channel-core` tercih edin; +daha geniş şemsiye yüzey ve `buildChannelConfigSchema` gibi paylaşılan +yardımcılar için `openclaw/plugin-sdk/core` kullanın. `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`, `openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp` veya -kanal markalı yardımcı yüzeyler gibi sağlayıcı adlı kolaylık katmanlarını eklemeyin veya bunlara bağımlı olmayın. Paketlenmiş plugin'ler, kendi `api.ts` veya `runtime-api.ts` barrel dosyalarında genel -SDK alt yollarını birleştirmelidir; çekirdek ise gerçekten kanallar arası bir ihtiyaç olduğunda ya bu plugin'e yerel barrel dosyalarını kullanmalı ya da dar bir genel SDK sözleşmesi eklemelidir. +kanal markalı yardımcı yüzeyler gibi sağlayıcı adlı kolaylık katmanları +eklemeyin ya da bunlara bağımlı olmayın. Paketlenmiş plugin'ler, kendi `api.ts` +veya `runtime-api.ts` barrel dosyaları içinde genel SDK alt yollarını +birleştirmelidir ve çekirdek, ihtiyaç gerçekten kanallar arası olduğunda ya bu +plugin-yerel barrel dosyalarını kullanmalı ya da dar bir genel SDK sözleşmesi +eklemelidir. -Üretilen export map hâlâ `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, -`plugin-sdk/zalo`, `plugin-sdk/zalo-setup` ve `plugin-sdk/matrix*` gibi az sayıda paketlenmiş plugin yardımcı yüzeyi içerir. Bu -alt yollar yalnızca paketlenmiş plugin bakımı ve uyumluluk için vardır; aşağıdaki ortak tabloda bilerek yer verilmemiştir ve yeni üçüncü taraf plugin'leri için önerilen içe aktarma yolu değildir. +Oluşturulmuş dışa aktarma eşleme tablosu hâlâ `plugin-sdk/feishu`, +`plugin-sdk/feishu-setup`, `plugin-sdk/zalo`, `plugin-sdk/zalo-setup` ve +`plugin-sdk/matrix*` gibi küçük bir paketlenmiş-plugin yardımcı yüzeyi kümesi +içerir. Bu alt yollar yalnızca paketlenmiş-plugin bakımı ve uyumluluk için +vardır; aşağıdaki ortak tabloda bilerek atlanmıştır ve yeni üçüncü taraf +plugin'leri için önerilen içe aktarma yolu değildir. ## Alt yol başvurusu -En sık kullanılan alt yollar, amaçlarına göre gruplandırılmıştır. 200+ alt yolun -üretilmiş tam listesi `scripts/lib/plugin-sdk-entrypoints.json` içinde bulunur. +Amaçlarına göre gruplandırılmış, en sık kullanılan alt yollar. Oluşturulmuş tam +200+ alt yol listesi `scripts/lib/plugin-sdk-entrypoints.json` içinde bulunur. -Ayrılmış paketlenmiş plugin yardımcı alt yolları bu üretilmiş listede görünmeye devam eder. -Bir doküman sayfası bunlardan birini açıkça genel olarak öne çıkarmadıkça, bunları uygulama ayrıntısı/uyumluluk yüzeyleri olarak değerlendirin. +Ayrılmış paketlenmiş-plugin yardımcı alt yolları bu oluşturulmuş listede yine +de görünür. Bir dokümantasyon sayfası bunlardan birini açıkça herkese açık +olarak tanıtmadıkça, bunları uygulama ayrıntısı/uyumluluk yüzeyleri olarak +değerlendirin. -### Plugin girişi +### Plugin entry -| Subpath | Temel dışa aktarımlar | +| Alt yol | Temel dışa aktarımlar | | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `plugin-sdk/plugin-entry` | `definePluginEntry` | | `plugin-sdk/core` | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema` | @@ -67,282 +80,288 @@ Bir doküman sayfası bunlardan birini açıkça genel olarak öne çıkarmadık - | Subpath | Temel dışa aktarımlar | + | Alt yol | Temel dışa aktarımlar | | --- | --- | | `plugin-sdk/channel-core` | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` | | `plugin-sdk/config-schema` | Kök `openclaw.json` Zod şema dışa aktarımı (`OpenClawSchema`) | | `plugin-sdk/channel-setup` | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, ayrıca `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` | - | `plugin-sdk/setup` | Paylaşılan kurulum sihirbazı yardımcıları, allowlist istemleri, kurulum durumu oluşturucuları | + | `plugin-sdk/setup` | Paylaşılan kurulum sihirbazı yardımcıları, izin listesi istemleri, kurulum durumu oluşturucuları | | `plugin-sdk/setup-runtime` | `createPatchedAccountSetupAdapter`, `createEnvPatchedAccountSetupAdapter`, `createSetupInputPresenceValidator`, `noteChannelLookupFailure`, `noteChannelLookupSummary`, `promptResolvedAllowFrom`, `splitSetupEntries`, `createAllowlistSetupWizardProxy`, `createDelegatedSetupWizardProxy` | | `plugin-sdk/setup-adapter-runtime` | `createEnvPatchedAccountSetupAdapter` | | `plugin-sdk/setup-tools` | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` | - | `plugin-sdk/account-core` | Çok hesaplı yapılandırma/eylem geçidi yardımcıları, varsayılan hesap geri dönüş yardımcıları | - | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, hesap kimliği normalleştirme yardımcıları | + | `plugin-sdk/account-core` | Çoklu hesap yapılandırma/eylem geçidi yardımcıları, varsayılan hesap geri dönüş yardımcıları | + | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, hesap kimliği normalizasyon yardımcıları | | `plugin-sdk/account-resolution` | Hesap arama + varsayılan geri dönüş yardımcıları | | `plugin-sdk/account-helpers` | Dar hesap listesi/hesap eylemi yardımcıları | | `plugin-sdk/channel-pairing` | `createChannelPairingController` | | `plugin-sdk/channel-reply-pipeline` | `createChannelReplyPipeline` | | `plugin-sdk/channel-config-helpers` | `createHybridChannelConfigAdapter` | - | `plugin-sdk/channel-config-schema` | Kanal yapılandırma şeması türleri | - | `plugin-sdk/telegram-command-config` | Paketlenmiş sözleşme geri dönüşü ile Telegram özel komut normalleştirme/doğrulama yardımcıları | + | `plugin-sdk/channel-config-schema` | Kanal yapılandırma şema türleri | + | `plugin-sdk/telegram-command-config` | Paketlenmiş sözleşme geri dönüşü ile Telegram özel komut normalizasyonu/doğrulama yardımcıları | | `plugin-sdk/channel-policy` | `resolveChannelGroupRequireMention` | | `plugin-sdk/channel-lifecycle` | `createAccountStatusSink` | - | `plugin-sdk/inbound-envelope` | Paylaşılan inbound route + envelope oluşturucu yardımcıları | - | `plugin-sdk/inbound-reply-dispatch` | Paylaşılan inbound kayıt ve dispatch yardımcıları | - | `plugin-sdk/messaging-targets` | Hedef ayrıştırma/eşleştirme yardımcıları | - | `plugin-sdk/outbound-media` | Paylaşılan outbound medya yükleme yardımcıları | - | `plugin-sdk/outbound-runtime` | Outbound kimlik/gönderme vekil yardımcıları | - | `plugin-sdk/thread-bindings-runtime` | Thread-binding yaşam döngüsü ve bağdaştırıcı yardımcıları | + | `plugin-sdk/inbound-envelope` | Paylaşılan gelen rota + zarf oluşturucu yardımcıları | + | `plugin-sdk/inbound-reply-dispatch` | Paylaşılan gelen kayıt ve dağıtım yardımcıları | + | `plugin-sdk/messaging-targets` | Hedef ayrıştırma/eşleme yardımcıları | + | `plugin-sdk/outbound-media` | Paylaşılan giden medya yükleme yardımcıları | + | `plugin-sdk/outbound-runtime` | Giden kimlik/gönderim delege yardımcıları | + | `plugin-sdk/thread-bindings-runtime` | İş parçacığı bağlama yaşam döngüsü ve bağdaştırıcı yardımcıları | | `plugin-sdk/agent-media-payload` | Eski agent medya payload oluşturucusu | - | `plugin-sdk/conversation-runtime` | Konuşma/thread binding, pairing ve yapılandırılmış binding yardımcıları | + | `plugin-sdk/conversation-runtime` | Konuşma/iş parçacığı bağlama, eşleştirme ve yapılandırılmış bağlama yardımcıları | | `plugin-sdk/runtime-config-snapshot` | Çalışma zamanı yapılandırma anlık görüntü yardımcısı | | `plugin-sdk/runtime-group-policy` | Çalışma zamanı grup ilkesi çözümleme yardımcıları | - | `plugin-sdk/channel-status` | Paylaşılan kanal durumu anlık görüntü/özet yardımcıları | - | `plugin-sdk/channel-config-primitives` | Dar kanal yapılandırma şeması primitive'leri | + | `plugin-sdk/channel-status` | Paylaşılan kanal durum anlık görüntüsü/özet yardımcıları | + | `plugin-sdk/channel-config-primitives` | Dar kanal yapılandırma-şeması ilkelleri | | `plugin-sdk/channel-config-writes` | Kanal yapılandırma yazma yetkilendirme yardımcıları | - | `plugin-sdk/channel-plugin-common` | Paylaşılan kanal plugin önyüzü dışa aktarımları | - | `plugin-sdk/allowlist-config-edit` | Allowlist yapılandırma düzenleme/okuma yardımcıları | + | `plugin-sdk/channel-plugin-common` | Paylaşılan kanal plugin prelude dışa aktarımları | + | `plugin-sdk/allowlist-config-edit` | İzin listesi yapılandırma düzenleme/okuma yardımcıları | | `plugin-sdk/group-access` | Paylaşılan grup erişim kararı yardımcıları | - | `plugin-sdk/direct-dm` | Paylaşılan doğrudan DM auth/koruma yardımcıları | - | `plugin-sdk/interactive-runtime` | Etkileşimli yanıt payload normalleştirme/indirgeme yardımcıları | - | `plugin-sdk/channel-inbound` | Inbound debounce, mention eşleme, mention-policy yardımcıları ve envelope yardımcıları | + | `plugin-sdk/direct-dm` | Paylaşılan doğrudan DM kimlik doğrulama/koruma yardımcıları | + | `plugin-sdk/interactive-runtime` | Etkileşimli yanıt payload normalizasyonu/indirgeme yardımcıları | + | `plugin-sdk/channel-inbound` | Gelen debounce, mention eşleme, mention ilkesi yardımcıları ve zarf yardımcıları | | `plugin-sdk/channel-send-result` | Yanıt sonuç türleri | | `plugin-sdk/channel-actions` | `createMessageToolButtonsSchema`, `createMessageToolCardSchema` | - | `plugin-sdk/channel-targets` | Hedef ayrıştırma/eşleştirme yardımcıları | - | `plugin-sdk/channel-contract` | Kanal sözleşmesi türleri | - | `plugin-sdk/channel-feedback` | Geri bildirim/tepki bağlama | - | `plugin-sdk/channel-secret-runtime` | `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment` gibi dar secret-contract yardımcıları ve secret hedef türleri | + | `plugin-sdk/channel-targets` | Hedef ayrıştırma/eşleme yardımcıları | + | `plugin-sdk/channel-contract` | Kanal sözleşme türleri | + | `plugin-sdk/channel-feedback` | Geri bildirim/reaksiyon bağlantısı | + | `plugin-sdk/channel-secret-runtime` | `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment` ve secret hedef türleri gibi dar secret-sözleşme yardımcıları | - | Subpath | Temel dışa aktarımlar | + | Alt yol | Temel dışa aktarımlar | | --- | --- | | `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` | | `plugin-sdk/provider-setup` | Düzenlenmiş yerel/self-hosted sağlayıcı kurulum yardımcıları | | `plugin-sdk/self-hosted-provider-setup` | Odaklanmış OpenAI uyumlu self-hosted sağlayıcı kurulum yardımcıları | - | `plugin-sdk/cli-backend` | CLI backend varsayılanları + watchdog sabitleri | + | `plugin-sdk/cli-backend` | CLI arka uç varsayılanları + watchdog sabitleri | | `plugin-sdk/provider-auth-runtime` | Sağlayıcı plugin'leri için çalışma zamanı API anahtarı çözümleme yardımcıları | | `plugin-sdk/provider-auth-api-key` | `upsertApiKeyProfile` gibi API anahtarı onboarding/profil yazma yardımcıları | - | `plugin-sdk/provider-auth-result` | Standart OAuth auth-result oluşturucusu | - | `plugin-sdk/provider-auth-login` | Sağlayıcı plugin'leri için paylaşılan etkileşimli giriş yardımcıları | - | `plugin-sdk/provider-env-vars` | Sağlayıcı auth env-var arama yardımcıları | + | `plugin-sdk/provider-auth-result` | Standart OAuth kimlik doğrulama sonuç oluşturucusu | + | `plugin-sdk/provider-auth-login` | Sağlayıcı plugin'leri için paylaşılan etkileşimli oturum açma yardımcıları | + | `plugin-sdk/provider-env-vars` | Sağlayıcı kimlik doğrulama ortam değişkeni arama yardımcıları | | `plugin-sdk/provider-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile`, `upsertApiKeyProfile`, `writeOAuthCredentials` | - | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, paylaşılan replay-policy oluşturucuları, sağlayıcı uç nokta yardımcıları ve `normalizeNativeXaiModelId` gibi model kimliği normalleştirme yardımcıları | + | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, paylaşılan replay-policy oluşturucuları, sağlayıcı uç nokta yardımcıları ve `normalizeNativeXaiModelId` gibi model-kimliği normalizasyon yardımcıları | | `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` | | `plugin-sdk/provider-http` | Genel sağlayıcı HTTP/uç nokta yetenek yardımcıları | | `plugin-sdk/provider-web-fetch-contract` | `enablePluginInConfig` ve `WebFetchProviderPlugin` gibi dar web-fetch yapılandırma/seçim sözleşmesi yardımcıları | - | `plugin-sdk/provider-web-fetch` | Web-fetch sağlayıcı kayıt/önbellek yardımcıları | - | `plugin-sdk/provider-web-search-contract` | `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` ve kapsamlı kimlik bilgisi ayarlayıcıları/getter'ları gibi dar web-search yapılandırma/kimlik bilgisi sözleşmesi yardımcıları | - | `plugin-sdk/provider-web-search` | Web-search sağlayıcı kayıt/önbellek/çalışma zamanı yardımcıları | - | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini şema temizleme + tanılama ve `resolveXaiModelCompatPatch` / `applyXaiModelCompat` gibi xAI uyumluluk yardımcıları | + | `plugin-sdk/provider-web-fetch` | Web-fetch sağlayıcı kaydı/önbellek yardımcıları | + | `plugin-sdk/provider-web-search-config-contract` | Plugin-etkinleştirme bağlantısına ihtiyaç duymayan sağlayıcılar için dar web-search yapılandırma/kimlik bilgisi yardımcıları | + | `plugin-sdk/provider-web-search-contract` | `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` ve kapsamlı kimlik bilgisi ayarlayıcıları/alıcıları gibi dar web-search yapılandırma/kimlik bilgisi sözleşmesi yardımcıları | + | `plugin-sdk/provider-web-search` | Web-search sağlayıcı kaydı/önbellek/çalışma zamanı yardımcıları | + | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini şema temizliği + tanılama ve `resolveXaiModelCompatPatch` / `applyXaiModelCompat` gibi xAI uyumluluk yardımcıları | | `plugin-sdk/provider-usage` | `fetchClaudeUsage` ve benzerleri | - | `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, stream wrapper türleri ve paylaşılan Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot wrapper yardımcıları | - | `plugin-sdk/provider-onboard` | Onboarding yapılandırma yamalama yardımcıları | - | `plugin-sdk/global-singleton` | Süreç yerel singleton/map/önbellek yardımcıları | + | `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, akış sarmalayıcı türleri ve paylaşılan Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot sarmalayıcı yardımcıları | + | `plugin-sdk/provider-onboard` | Onboarding yapılandırma yama yardımcıları | + | `plugin-sdk/global-singleton` | Süreç-yerel singleton/map/önbellek yardımcıları | - - | Subpath | Temel dışa aktarımlar | + + | Alt yol | Temel dışa aktarımlar | | --- | --- | - | `plugin-sdk/command-auth` | `resolveControlCommandGate`, komut kayıt yardımcıları, gönderici yetkilendirme yardımcıları | - | `plugin-sdk/approval-auth-runtime` | Onaylayıcı çözümleme ve aynı sohbet eylem-auth yardımcıları | - | `plugin-sdk/approval-client-runtime` | Native exec onay profili/filtre yardımcıları | - | `plugin-sdk/approval-delivery-runtime` | Native onay yeteneği/teslim bağdaştırıcıları | + | `plugin-sdk/command-auth` | `resolveControlCommandGate`, komut kayıt yardımcıları, gönderen yetkilendirme yardımcıları | + | `plugin-sdk/approval-auth-runtime` | Onaylayıcı çözümleme ve aynı sohbet eylem-kimlik doğrulama yardımcıları | + | `plugin-sdk/approval-client-runtime` | Yerel exec onay profili/filtre yardımcıları | + | `plugin-sdk/approval-delivery-runtime` | Yerel onay yeteneği/teslim bağdaştırıcıları | | `plugin-sdk/approval-gateway-runtime` | Paylaşılan onay gateway çözümleme yardımcısı | - | `plugin-sdk/approval-handler-adapter-runtime` | Sıcak kanal giriş noktaları için hafif native onay bağdaştırıcı yükleme yardımcıları | + | `plugin-sdk/approval-handler-adapter-runtime` | Sıcak kanal entrypoint'leri için hafif yerel onay bağdaştırıcısı yükleme yardımcıları | | `plugin-sdk/approval-handler-runtime` | Daha geniş onay işleyici çalışma zamanı yardımcıları; dar bağdaştırıcı/gateway yüzeyleri yeterliyse onları tercih edin | - | `plugin-sdk/approval-native-runtime` | Native onay hedefi + hesap bağlama yardımcıları | + | `plugin-sdk/approval-native-runtime` | Yerel onay hedefi + hesap bağlama yardımcıları | | `plugin-sdk/approval-reply-runtime` | Exec/plugin onay yanıt payload yardımcıları | - | `plugin-sdk/command-auth-native` | Native komut auth + native oturum hedef yardımçıları | + | `plugin-sdk/command-auth-native` | Yerel komut kimlik doğrulama + yerel oturum hedefi yardımcıları | | `plugin-sdk/command-detection` | Paylaşılan komut algılama yardımcıları | - | `plugin-sdk/command-surface` | Komut gövdesi normalleştirme ve komut yüzeyi yardımcıları | + | `plugin-sdk/command-surface` | Komut gövdesi normalizasyonu ve komut yüzeyi yardımcıları | | `plugin-sdk/allow-from` | `formatAllowFromLowercase` | - | `plugin-sdk/channel-secret-runtime` | Kanal/plugin secret yüzeyleri için dar secret-contract toplama yardımcıları | - | `plugin-sdk/secret-ref-runtime` | Secret-contract/yapılandırma ayrıştırması için dar `coerceSecretRef` ve SecretRef türleme yardımcıları | - | `plugin-sdk/security-runtime` | Paylaşılan güven, DM geçitleme, harici içerik ve secret toplama yardımcıları | - | `plugin-sdk/ssrf-policy` | Host allowlist ve private-network SSRF ilkesi yardımcıları | - | `plugin-sdk/ssrf-runtime` | Pinned-dispatcher, SSRF korumalı fetch ve SSRF ilkesi yardımcıları | - | `plugin-sdk/secret-input` | Secret giriş ayrıştırma yardımcıları | + | `plugin-sdk/channel-secret-runtime` | Kanal/plugin secret yüzeyleri için dar secret-sözleşmesi toplama yardımcıları | + | `plugin-sdk/secret-ref-runtime` | Secret-sözleşmesi/yapılandırma ayrıştırması için dar `coerceSecretRef` ve SecretRef türlendirme yardımcıları | + | `plugin-sdk/security-runtime` | Paylaşılan güven, DM geçidi, harici içerik ve secret toplama yardımcıları | + | `plugin-sdk/ssrf-policy` | Ana makine izin listesi ve özel ağ SSRF ilkesi yardımcıları | + | `plugin-sdk/ssrf-runtime` | Sabitlenmiş dispatcher, SSRF korumalı fetch ve SSRF ilkesi yardımcıları | + | `plugin-sdk/secret-input` | Secret girdi ayrıştırma yardımcıları | | `plugin-sdk/webhook-ingress` | Webhook istek/hedef yardımcıları | | `plugin-sdk/webhook-request-guards` | İstek gövdesi boyutu/zaman aşımı yardımcıları | - | Subpath | Temel dışa aktarımlar | + | Alt yol | Temel dışa aktarımlar | | --- | --- | - | `plugin-sdk/runtime` | Geniş çalışma zamanı/günlükleme/yedekleme/plugin kurulum yardımcıları | - | `plugin-sdk/runtime-env` | Dar çalışma zamanı env, logger, timeout, retry ve backoff yardımcıları | + | `plugin-sdk/runtime` | Geniş çalışma zamanı/günlükleme/yedekleme/plugin-kurulum yardımcıları | + | `plugin-sdk/runtime-env` | Dar çalışma zamanı env, logger, zaman aşımı, yeniden deneme ve backoff yardımcıları | | `plugin-sdk/channel-runtime-context` | Genel kanal çalışma zamanı bağlamı kaydı ve arama yardımcıları | | `plugin-sdk/runtime-store` | `createPluginRuntimeStore` | | `plugin-sdk/plugin-runtime` | Paylaşılan plugin komutu/hook/http/etkileşimli yardımcıları | - | `plugin-sdk/hook-runtime` | Paylaşılan webhook/dahili hook pipeline yardımcıları | + | `plugin-sdk/hook-runtime` | Paylaşılan webhook/dahili hook işlem hattı yardımcıları | | `plugin-sdk/lazy-runtime` | `createLazyRuntimeModule`, `createLazyRuntimeMethod` ve `createLazyRuntimeSurface` gibi tembel çalışma zamanı içe aktarma/bağlama yardımcıları | | `plugin-sdk/process-runtime` | Süreç exec yardımcıları | | `plugin-sdk/cli-runtime` | CLI biçimlendirme, bekleme ve sürüm yardımcıları | - | `plugin-sdk/gateway-runtime` | Gateway istemcisi ve kanal durumu yama yardımcıları | + | `plugin-sdk/gateway-runtime` | Gateway istemcisi ve kanal durum yaması yardımcıları | | `plugin-sdk/config-runtime` | Yapılandırma yükleme/yazma yardımcıları | - | `plugin-sdk/telegram-command-config` | Paketlenmiş Telegram sözleşme yüzeyi mevcut olmasa bile Telegram komut adı/açıklaması normalleştirme ve yineleme/çakışma kontrolleri | - | `plugin-sdk/approval-runtime` | Exec/plugin onay yardımcıları, onay yeteneği oluşturucuları, auth/profil yardımcıları, native yönlendirme/çalışma zamanı yardımcıları | - | `plugin-sdk/reply-runtime` | Paylaşılan inbound/yanıt çalışma zamanı yardımcıları, parçalara ayırma, dispatch, heartbeat, yanıt planlayıcı | - | `plugin-sdk/reply-dispatch-runtime` | Dar yanıt dispatch/finalize yardımcıları | - | `plugin-sdk/reply-history` | `buildHistoryContext`, `recordPendingHistoryEntry` ve `clearHistoryEntriesIfEnabled` gibi paylaşılan kısa pencereli yanıt geçmişi yardımcıları | + | `plugin-sdk/telegram-command-config` | Paketlenmiş Telegram sözleşme yüzeyi kullanılamadığında bile Telegram komut adı/açıklama normalizasyonu ve yinelenen/çakışma denetimleri | + | `plugin-sdk/approval-runtime` | Exec/plugin onay yardımcıları, onay-yetenek oluşturucuları, kimlik doğrulama/profil yardımcıları, yerel yönlendirme/çalışma zamanı yardımcıları | + | `plugin-sdk/reply-runtime` | Paylaşılan gelen/yanıt çalışma zamanı yardımcıları, parçalama, dağıtım, heartbeat, yanıt planlayıcı | + | `plugin-sdk/reply-dispatch-runtime` | Dar yanıt dağıtımı/tamamlama yardımcıları | + | `plugin-sdk/reply-history` | `buildHistoryContext`, `recordPendingHistoryEntry` ve `clearHistoryEntriesIfEnabled` gibi paylaşılan kısa pencere yanıt geçmişi yardımcıları | | `plugin-sdk/reply-reference` | `createReplyReferencePlanner` | - | `plugin-sdk/reply-chunking` | Dar metin/markdown parçalara ayırma yardımcıları | + | `plugin-sdk/reply-chunking` | Dar metin/markdown parçalama yardımcıları | | `plugin-sdk/session-store-runtime` | Oturum deposu yolu + updated-at yardımcıları | | `plugin-sdk/state-paths` | Durum/OAuth dizin yolu yardımcıları | - | `plugin-sdk/routing` | `resolveAgentRoute`, `buildAgentSessionKey` ve `resolveDefaultAgentBoundAccountId` gibi route/oturum anahtarı/hesap bağlama yardımcıları | - | `plugin-sdk/status-helpers` | Paylaşılan kanal/hesap durumu özeti yardımcıları, çalışma zamanı durumu varsayılanları ve sorun metadata yardımcıları | - | `plugin-sdk/target-resolver-runtime` | Paylaşılan hedef çözücü yardımcıları | - | `plugin-sdk/string-normalization-runtime` | Slug/string normalleştirme yardımcıları | - | `plugin-sdk/request-url` | Fetch/istek benzeri girdilerden string URL çıkarma | + | `plugin-sdk/routing` | `resolveAgentRoute`, `buildAgentSessionKey` ve `resolveDefaultAgentBoundAccountId` gibi rota/oturum anahtarı/hesap bağlama yardımcıları | + | `plugin-sdk/status-helpers` | Paylaşılan kanal/hesap durum özeti yardımcıları, çalışma zamanı durum varsayılanları ve sorun meta verisi yardımcıları | + | `plugin-sdk/target-resolver-runtime` | Paylaşılan hedef çözümleyici yardımcıları | + | `plugin-sdk/string-normalization-runtime` | Slug/dize normalizasyon yardımcıları | + | `plugin-sdk/request-url` | Fetch/istek benzeri girdilerden dize URL'leri çıkarın | | `plugin-sdk/run-command` | Normalleştirilmiş stdout/stderr sonuçlarıyla zamanlanmış komut çalıştırıcı | - | `plugin-sdk/param-readers` | Ortak araç/CLI param okurları | - | `plugin-sdk/tool-send` | Araç argümanlarından kanonik gönderim hedef alanlarını çıkarma | + | `plugin-sdk/param-readers` | Ortak araç/CLI parametre okuyucuları | + | `plugin-sdk/tool-payload` | Araç sonuç nesnelerinden normalleştirilmiş payload'ları çıkarın | + | `plugin-sdk/tool-send` | Araç bağımsız değişkenlerinden kanonik gönderim hedef alanlarını çıkarın | | `plugin-sdk/temp-path` | Paylaşılan geçici indirme yolu yardımcıları | - | `plugin-sdk/logging-core` | Alt sistem logger ve redaction yardımcıları | - | `plugin-sdk/markdown-table-runtime` | Markdown tablo kipi yardımcıları | + | `plugin-sdk/logging-core` | Alt sistem logger ve redaksiyon yardımcıları | + | `plugin-sdk/markdown-table-runtime` | Markdown tablo modu yardımcıları | | `plugin-sdk/json-store` | Küçük JSON durum okuma/yazma yardımcıları | | `plugin-sdk/file-lock` | Yeniden girişli dosya kilidi yardımcıları | - | `plugin-sdk/persistent-dedupe` | Disk destekli dedupe önbellek yardımcıları | - | `plugin-sdk/acp-runtime` | ACP çalışma zamanı/oturum ve reply-dispatch yardımcıları | - | `plugin-sdk/agent-config-primitives` | Dar agent çalışma zamanı yapılandırma şeması primitive'leri | - | `plugin-sdk/boolean-param` | Gevşek boolean param okuru | + | `plugin-sdk/persistent-dedupe` | Disk destekli yinelenenleri kaldırma önbelleği yardımcıları | + | `plugin-sdk/acp-runtime` | ACP çalışma zamanı/oturum ve yanıt dağıtımı yardımcıları | + | `plugin-sdk/agent-config-primitives` | Dar agent çalışma zamanı yapılandırma-şeması ilkelleri | + | `plugin-sdk/boolean-param` | Gevşek boolean parametre okuyucusu | | `plugin-sdk/dangerous-name-runtime` | Tehlikeli ad eşleme çözümleme yardımcıları | - | `plugin-sdk/device-bootstrap` | Cihaz bootstrap ve pairing token yardımcıları | - | `plugin-sdk/extension-shared` | Paylaşılan passive-channel, durum ve ambient proxy yardımcı primitive'leri | + | `plugin-sdk/device-bootstrap` | Cihaz bootstrap ve eşleştirme token yardımcıları | + | `plugin-sdk/extension-shared` | Paylaşılan pasif kanal, durum ve ambient proxy yardımcı ilkelleri | | `plugin-sdk/models-provider-runtime` | `/models` komutu/sağlayıcı yanıt yardımcıları | - | `plugin-sdk/skill-commands-runtime` | Skill komutu listeleme yardımcıları | - | `plugin-sdk/native-command-registry` | Native komut kayıt/oluşturma/serileştirme yardımcıları | - | `plugin-sdk/provider-zai-endpoint` | Z.A.I uç nokta algılama yardımcıları | + | `plugin-sdk/skill-commands-runtime` | Skills komut listeleme yardımcıları | + | `plugin-sdk/native-command-registry` | Yerel komut kaydı/oluşturma/serileştirme yardımcıları | + | `plugin-sdk/provider-zai-endpoint` | Z.AI uç nokta algılama yardımcıları | | `plugin-sdk/infra-runtime` | Sistem olayı/heartbeat yardımcıları | | `plugin-sdk/collection-runtime` | Küçük sınırlı önbellek yardımcıları | | `plugin-sdk/diagnostic-runtime` | Tanılama bayrağı ve olay yardımcıları | | `plugin-sdk/error-runtime` | Hata grafiği, biçimlendirme, paylaşılan hata sınıflandırma yardımcıları, `isApprovalNotFoundError` | - | `plugin-sdk/fetch-runtime` | Sarmalanmış fetch, proxy ve pinned lookup yardımcıları | - | `plugin-sdk/host-runtime` | Hostname ve SCP host normalleştirme yardımcıları | - | `plugin-sdk/retry-runtime` | Retry yapılandırması ve retry çalıştırıcı yardımcıları | - | `plugin-sdk/agent-runtime` | Agent dizini/kimlik/çalışma alanı yardımcıları | - | `plugin-sdk/directory-runtime` | Yapılandırma destekli dizin sorgusu/dedupe | + | `plugin-sdk/fetch-runtime` | Sarılmış fetch, proxy ve sabitlenmiş arama yardımcıları | + | `plugin-sdk/host-runtime` | Ana makine adı ve SCP ana makinesi normalizasyon yardımcıları | + | `plugin-sdk/retry-runtime` | Yeniden deneme yapılandırması ve yeniden deneme çalıştırıcı yardımcıları | + | `plugin-sdk/agent-runtime` | Agent dizini/kimliği/çalışma alanı yardımcıları | + | `plugin-sdk/directory-runtime` | Yapılandırma destekli dizin sorgusu/yinelenen kaldırma | | `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` | - | Subpath | Temel dışa aktarımlar | + | Alt yol | Temel dışa aktarımlar | | --- | --- | - | `plugin-sdk/media-runtime` | Paylaşılan medya fetch/dönüştürme/depolama yardımcıları ve medya payload oluşturucuları | + | `plugin-sdk/media-runtime` | Medya payload oluşturucularına ek olarak paylaşılan medya getirme/dönüştürme/depolama yardımcıları | | `plugin-sdk/media-generation-runtime` | Paylaşılan medya üretimi failover yardımcıları, aday seçimi ve eksik model mesajları | | `plugin-sdk/media-understanding` | Medya anlama sağlayıcı türleri ve sağlayıcıya dönük görsel/ses yardımcı dışa aktarımları | - | `plugin-sdk/text-runtime` | Asistana görünür metin ayıklama, markdown render/parçalara ayırma/tablo yardımcıları, redaction yardımcıları, directive-tag yardımcıları ve güvenli metin yardımcıları gibi paylaşılan metin/markdown/günlükleme yardımcıları | - | `plugin-sdk/text-chunking` | Outbound metin parçalara ayırma yardımcısı | - | `plugin-sdk/speech` | Speech sağlayıcı türleri ve sağlayıcıya dönük directive, registry ve doğrulama yardımcıları | - | `plugin-sdk/speech-core` | Paylaşılan speech sağlayıcı türleri, registry, directive ve normalleştirme yardımcıları | - | `plugin-sdk/realtime-transcription` | Realtime transcription sağlayıcı türleri ve registry yardımcıları | - | `plugin-sdk/realtime-voice` | Realtime voice sağlayıcı türleri ve registry yardımcıları | - | `plugin-sdk/image-generation` | Image generation sağlayıcı türleri | - | `plugin-sdk/image-generation-core` | Paylaşılan image-generation türleri, failover, auth ve registry yardımcıları | - | `plugin-sdk/music-generation` | Music generation sağlayıcı/istek/sonuç türleri | - | `plugin-sdk/music-generation-core` | Paylaşılan music-generation türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma | - | `plugin-sdk/video-generation` | Video generation sağlayıcı/istek/sonuç türleri | - | `plugin-sdk/video-generation-core` | Paylaşılan video-generation türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma | - | `plugin-sdk/webhook-targets` | Webhook hedef kayıt defteri ve route-install yardımcıları | - | `plugin-sdk/webhook-path` | Webhook yol normalleştirme yardımcıları | + | `plugin-sdk/text-runtime` | Yardımcıya görünür metin temizleme, markdown işleme/parçalama/tablo yardımcıları, redaksiyon yardımcıları, directive-tag yardımcıları ve güvenli metin araçları gibi paylaşılan metin/markdown/günlükleme yardımcıları | + | `plugin-sdk/text-chunking` | Giden metin parçalama yardımcısı | + | `plugin-sdk/speech` | Konuşma sağlayıcı türleri ile sağlayıcıya dönük directive, kayıt ve doğrulama yardımcıları | + | `plugin-sdk/speech-core` | Paylaşılan konuşma sağlayıcı türleri, kayıt, directive ve normalizasyon yardımcıları | + | `plugin-sdk/realtime-transcription` | Gerçek zamanlı transcription sağlayıcı türleri ve kayıt yardımcıları | + | `plugin-sdk/realtime-voice` | Gerçek zamanlı ses sağlayıcı türleri ve kayıt yardımcıları | + | `plugin-sdk/image-generation` | Görsel üretimi sağlayıcı türleri | + | `plugin-sdk/image-generation-core` | Paylaşılan görsel üretimi türleri, failover, kimlik doğrulama ve kayıt yardımcıları | + | `plugin-sdk/music-generation` | Müzik üretimi sağlayıcı/istek/sonuç türleri | + | `plugin-sdk/music-generation-core` | Paylaşılan müzik üretimi türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma | + | `plugin-sdk/video-generation` | Video üretimi sağlayıcı/istek/sonuç türleri | + | `plugin-sdk/video-generation-core` | Paylaşılan video üretimi türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma | + | `plugin-sdk/webhook-targets` | Webhook hedef kaydı ve rota kurulum yardımcıları | + | `plugin-sdk/webhook-path` | Webhook yolu normalizasyon yardımcıları | | `plugin-sdk/web-media` | Paylaşılan uzak/yerel medya yükleme yardımcıları | - | `plugin-sdk/zod` | Plugin SDK kullanıcıları için yeniden dışa aktarılan `zod` | + | `plugin-sdk/zod` | Plugin SDK tüketicileri için yeniden dışa aktarılan `zod` | | `plugin-sdk/testing` | `installCommonResolveTargetErrorCases`, `shouldAckReaction` | - - | Subpath | Temel dışa aktarımlar | + + | Alt yol | Temel dışa aktarımlar | | --- | --- | - | `plugin-sdk/memory-core` | Manager/config/file/CLI yardımcıları için paketlenmiş memory-core yardımcı yüzeyi | - | `plugin-sdk/memory-core-engine-runtime` | Bellek indeksleme/arama çalışma zamanı cephesi | - | `plugin-sdk/memory-core-host-engine-foundation` | Bellek host foundation engine dışa aktarımları | - | `plugin-sdk/memory-core-host-engine-embeddings` | Bellek host embedding engine dışa aktarımları | - | `plugin-sdk/memory-core-host-engine-qmd` | Bellek host QMD engine dışa aktarımları | - | `plugin-sdk/memory-core-host-engine-storage` | Bellek host storage engine dışa aktarımları | - | `plugin-sdk/memory-core-host-multimodal` | Bellek host multimodal yardımcıları | - | `plugin-sdk/memory-core-host-query` | Bellek host sorgu yardımcıları | - | `plugin-sdk/memory-core-host-secret` | Bellek host secret yardımcıları | - | `plugin-sdk/memory-core-host-events` | Bellek host olay günlüğü yardımcıları | - | `plugin-sdk/memory-core-host-status` | Bellek host durum yardımcıları | - | `plugin-sdk/memory-core-host-runtime-cli` | Bellek host CLI çalışma zamanı yardımcıları | - | `plugin-sdk/memory-core-host-runtime-core` | Bellek host çekirdek çalışma zamanı yardımcıları | - | `plugin-sdk/memory-core-host-runtime-files` | Bellek host dosya/çalışma zamanı yardımcıları | - | `plugin-sdk/memory-host-core` | Bellek host çekirdek çalışma zamanı yardımcıları için satıcıdan bağımsız takma ad | - | `plugin-sdk/memory-host-events` | Bellek host olay günlüğü yardımcıları için satıcıdan bağımsız takma ad | - | `plugin-sdk/memory-host-files` | Bellek host dosya/çalışma zamanı yardımcıları için satıcıdan bağımsız takma ad | - | `plugin-sdk/memory-host-markdown` | Belleğe bitişik plugin'ler için paylaşılan yönetilen markdown yardımcıları | - | `plugin-sdk/memory-host-search` | Search-manager erişimi için etkin bellek çalışma zamanı cephesi | - | `plugin-sdk/memory-host-status` | Bellek host durum yardımcıları için satıcıdan bağımsız takma ad | + | `plugin-sdk/memory-core` | Yönetici/yapılandırma/dosya/CLI yardımcıları için paketlenmiş memory-core yardımcı yüzeyi | + | `plugin-sdk/memory-core-engine-runtime` | Memory dizin/arama çalışma zamanı cephesi | + | `plugin-sdk/memory-core-host-engine-foundation` | Memory host foundation engine dışa aktarımları | + | `plugin-sdk/memory-core-host-engine-embeddings` | Memory host embedding engine dışa aktarımları | + | `plugin-sdk/memory-core-host-engine-qmd` | Memory host QMD engine dışa aktarımları | + | `plugin-sdk/memory-core-host-engine-storage` | Memory host storage engine dışa aktarımları | + | `plugin-sdk/memory-core-host-multimodal` | Memory host multimodal yardımcıları | + | `plugin-sdk/memory-core-host-query` | Memory host sorgu yardımcıları | + | `plugin-sdk/memory-core-host-secret` | Memory host secret yardımcıları | + | `plugin-sdk/memory-core-host-events` | Memory host olay günlüğü yardımcıları | + | `plugin-sdk/memory-core-host-status` | Memory host durum yardımcıları | + | `plugin-sdk/memory-core-host-runtime-cli` | Memory host CLI çalışma zamanı yardımcıları | + | `plugin-sdk/memory-core-host-runtime-core` | Memory host çekirdek çalışma zamanı yardımcıları | + | `plugin-sdk/memory-core-host-runtime-files` | Memory host dosya/çalışma zamanı yardımcıları | + | `plugin-sdk/memory-host-core` | Memory host çekirdek çalışma zamanı yardımcıları için satıcıdan bağımsız takma ad | + | `plugin-sdk/memory-host-events` | Memory host olay günlüğü yardımcıları için satıcıdan bağımsız takma ad | + | `plugin-sdk/memory-host-files` | Memory host dosya/çalışma zamanı yardımcıları için satıcıdan bağımsız takma ad | + | `plugin-sdk/memory-host-markdown` | Memory'e bitişik plugin'ler için paylaşılan yönetilen-markdown yardımcıları | + | `plugin-sdk/memory-host-search` | Search-manager erişimi için etkin memory çalışma zamanı cephesi | + | `plugin-sdk/memory-host-status` | Memory host durum yardımcıları için satıcıdan bağımsız takma ad | | `plugin-sdk/memory-lancedb` | Paketlenmiş memory-lancedb yardımcı yüzeyi | - - | Family | Mevcut alt yollar | Amaçlanan kullanım | + + | Aile | Mevcut alt yollar | Amaçlanan kullanım | | --- | --- | --- | | Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Paketlenmiş browser plugin destek yardımcıları (`browser-support` uyumluluk barrel'i olarak kalır) | | Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Paketlenmiş Matrix yardımcı/çalışma zamanı yüzeyi | | Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Paketlenmiş LINE yardımcı/çalışma zamanı yüzeyi | | IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Paketlenmiş IRC yardımcı yüzeyi | - | Kanala özgü yardımcılar | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Paketlenmiş kanal uyumluluk/yardımcı yüzeyleri | - | Auth/plugin'e özgü yardımcılar | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Paketlenmiş özellik/plugin yardımcı yüzeyleri; `plugin-sdk/github-copilot-token` şu anda `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` ve `resolveCopilotApiToken` dışa aktarır | + | Kanala özel yardımcılar | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Paketlenmiş kanal uyumluluk/yardımcı yüzeyleri | + | Kimlik doğrulama/plugin'e özel yardımcılar | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Paketlenmiş özellik/plugin yardımcı yüzeyleri; `plugin-sdk/github-copilot-token` şu anda `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` ve `resolveCopilotApiToken` dışa aktarır | ## Kayıt API'si -`register(api)` callback'i şu yöntemlere sahip bir `OpenClawPluginApi` nesnesi alır: +`register(api)` callback'i şu yöntemlere sahip bir `OpenClawPluginApi` nesnesi +alır: ### Yetenek kaydı -| Method | Ne kaydeder | -| ------------------------------------------------ | ------------------------------ | -| `api.registerProvider(...)` | Metin çıkarımı (LLM) | -| `api.registerCliBackend(...)` | Yerel CLI çıkarım backend'i | -| `api.registerChannel(...)` | Mesajlaşma kanalı | -| `api.registerSpeechProvider(...)` | Metinden konuşmaya / STT sentezi | -| `api.registerRealtimeTranscriptionProvider(...)` | Akış tabanlı realtime transcription | -| `api.registerRealtimeVoiceProvider(...)` | Çift yönlü realtime voice oturumları | -| `api.registerMediaUnderstandingProvider(...)` | Görsel/ses/video analizi | -| `api.registerImageGenerationProvider(...)` | Görsel üretimi | -| `api.registerMusicGenerationProvider(...)` | Müzik üretimi | -| `api.registerVideoGenerationProvider(...)` | Video üretimi | -| `api.registerWebFetchProvider(...)` | Web fetch / scrape sağlayıcısı | -| `api.registerWebSearchProvider(...)` | Web araması | +| Yöntem | Kaydettiği şey | +| ------------------------------------------------ | -------------------------------- | +| `api.registerProvider(...)` | Metin çıkarımı (LLM) | +| `api.registerCliBackend(...)` | Yerel CLI çıkarım arka ucu | +| `api.registerChannel(...)` | Mesajlaşma kanalı | +| `api.registerSpeechProvider(...)` | Metinden sese / STT sentezi | +| `api.registerRealtimeTranscriptionProvider(...)` | Akışlı gerçek zamanlı transcription | +| `api.registerRealtimeVoiceProvider(...)` | İki yönlü gerçek zamanlı ses oturumları | +| `api.registerMediaUnderstandingProvider(...)` | Görsel/ses/video analizi | +| `api.registerImageGenerationProvider(...)` | Görsel üretimi | +| `api.registerMusicGenerationProvider(...)` | Müzik üretimi | +| `api.registerVideoGenerationProvider(...)` | Video üretimi | +| `api.registerWebFetchProvider(...)` | Web fetch / scrape sağlayıcısı | +| `api.registerWebSearchProvider(...)` | Web arama | ### Araçlar ve komutlar -| Method | Ne kaydeder | -| ------------------------------- | --------------------------------------------- | +| Yöntem | Kaydettiği şey | +| ------------------------------- | ----------------------------------------------- | | `api.registerTool(tool, opts?)` | Agent aracı (zorunlu veya `{ optional: true }`) | -| `api.registerCommand(def)` | Özel komut (LLM'yi atlar) | +| `api.registerCommand(def)` | Özel komut (LLM'yi atlar) | ### Altyapı -| Method | Ne kaydeder | -| ---------------------------------------------- | ------------------------------------- | -| `api.registerHook(events, handler, opts?)` | Olay hook'u | -| `api.registerHttpRoute(params)` | Gateway HTTP uç noktası | -| `api.registerGatewayMethod(name, handler)` | Gateway RPC yöntemi | -| `api.registerCli(registrar, opts?)` | CLI alt komutu | -| `api.registerService(service)` | Arka plan hizmeti | -| `api.registerInteractiveHandler(registration)` | Etkileşimli işleyici | -| `api.registerMemoryPromptSupplement(builder)` | Toplamsal bellek bitişiği istem bölümü | -| `api.registerMemoryCorpusSupplement(adapter)` | Toplamsal bellek arama/okuma corpus'u | +| Yöntem | Kaydettiği şey | +| ---------------------------------------------- | ----------------------------------- | +| `api.registerHook(events, handler, opts?)` | Olay hook'u | +| `api.registerHttpRoute(params)` | Gateway HTTP uç noktası | +| `api.registerGatewayMethod(name, handler)` | Gateway RPC yöntemi | +| `api.registerCli(registrar, opts?)` | CLI alt komutu | +| `api.registerService(service)` | Arka plan hizmeti | +| `api.registerInteractiveHandler(registration)` | Etkileşimli işleyici | +| `api.registerMemoryPromptSupplement(builder)` | Ekleyici memory'e bitişik prompt bölümü | +| `api.registerMemoryCorpusSupplement(adapter)` | Ekleyici memory arama/okuma derlemi | -Ayrılmış çekirdek yönetici ad alanları (`config.*`, `exec.approvals.*`, `wizard.*`, -`update.*`), bir plugin daha dar bir gateway method scope atamaya çalışsa bile her zaman `operator.admin` olarak kalır. Plugin'e ait yöntemler için plugin'e özgü önekleri tercih edin. +Ayrılmış çekirdek yönetici ad alanları (`config.*`, `exec.approvals.*`, +`wizard.*`, `update.*`), bir plugin daha dar bir gateway yöntem kapsamı +atamaya çalışsa bile her zaman `operator.admin` olarak kalır. Plugin'e ait +yöntemler için plugin'e özgü önekleri tercih edin. -### CLI kayıt metadata'sı +### CLI kayıt meta verisi -`api.registerCli(registrar, opts?)` iki tür üst düzey metadata kabul eder: +`api.registerCli(registrar, opts?)` iki tür üst düzey meta veri kabul eder: -- `commands`: registrar'a ait açık komut kökleri -- `descriptors`: kök CLI yardımı, - yönlendirme ve tembel plugin CLI kaydı için ayrıştırma zamanında kullanılan komut açıklayıcıları +- `commands`: registrar'ın sahip olduğu açık komut kökleri +- `descriptors`: kök CLI yardımı, yönlendirme ve tembel plugin CLI kaydı için + ayrıştırma zamanı komut tanımlayıcıları -Bir plugin komutunun normal kök CLI yolunda tembel yüklenmesini istiyorsanız, -o registrar tarafından sunulan her üst düzey komut kökünü kapsayan `descriptors` sağlayın. +Bir plugin komutunun normal kök CLI yolunda tembel yüklenmiş kalmasını +istiyorsanız, bu registrar tarafından açığa çıkarılan her üst düzey komut +kökünü kapsayan `descriptors` sağlayın. ```typescript api.registerCli( @@ -362,125 +381,141 @@ api.registerCli( ); ``` -Kök CLI için tembel kayıt gerekmiyorsa yalnızca `commands` kullanın. -Bu hevesli uyumluluk yolu desteklenmeye devam eder, ancak ayrıştırma zamanı tembel yükleme için açıklayıcı destekli yer tutucular kurmaz. +Normal kök CLI kaydı için tembel yükleme gerekmiyorsa yalnızca `commands` +kullanın. Bu istekli uyumluluk yolu desteklenmeye devam eder, ancak ayrıştırma +zamanı tembel yükleme için descriptor destekli yer tutucular kurmaz. -### CLI backend kaydı +### CLI arka uç kaydı -`api.registerCliBackend(...)`, bir plugin'in `codex-cli` gibi yerel -AI CLI backend'i için varsayılan yapılandırmaya sahip olmasını sağlar. +`api.registerCliBackend(...)`, bir plugin'in `codex-cli` gibi yerel bir +AI CLI arka ucunun varsayılan yapılandırmasına sahip olmasına izin verir. -- Backend `id`, `codex-cli/gpt-5` gibi model başvurularında sağlayıcı öneki olur. -- Backend `config`, `agents.defaults.cliBackends.` ile aynı şekli kullanır. -- Kullanıcı yapılandırması yine önceliklidir. OpenClaw, CLI'yi çalıştırmadan önce `agents.defaults.cliBackends.` değerini - plugin varsayılanının üzerine birleştirir. -- Backend'in birleştirmeden sonra uyumluluk yeniden yazımları gerektirdiği durumlarda - (örneğin eski flag şekillerini normalleştirme) `normalizeConfig` kullanın. +- Arka uç `id`, `codex-cli/gpt-5` gibi model ref'lerinde sağlayıcı öneki olur. +- Arka uç `config`, `agents.defaults.cliBackends.` ile aynı şekli kullanır. +- Kullanıcı yapılandırması yine önceliklidir. OpenClaw, CLI'yi çalıştırmadan + önce plugin varsayılanı üzerine `agents.defaults.cliBackends.` değerini + birleştirir. +- Bir arka uç birleştirmeden sonra uyumluluk yeniden yazımları gerektiriyorsa + `normalizeConfig` kullanın (örneğin eski bayrak şekillerini normalize etmek + için). -### Özel yuvalar +### Münhasır yuvalar -| Method | Ne kaydeder | -| ------------------------------------------ | ----------------------------------- | -| `api.registerContextEngine(id, factory)` | Bağlam motoru (aynı anda bir etkin) | -| `api.registerMemoryCapability(capability)` | Birleşik bellek yeteneği | -| `api.registerMemoryPromptSection(builder)` | Bellek istem bölümü oluşturucusu | -| `api.registerMemoryFlushPlan(resolver)` | Bellek flush planı çözücüsü | -| `api.registerMemoryRuntime(runtime)` | Bellek çalışma zamanı bağdaştırıcısı | +| Yöntem | Kaydettiği şey | +| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `api.registerContextEngine(id, factory)` | Bağlam motoru (aynı anda yalnızca biri etkin). `assemble()` callback'i, motorun prompt eklemelerini uyarlayabilmesi için `availableTools` ve `citationsMode` alır. | +| `api.registerMemoryCapability(capability)` | Birleşik memory yeteneği | +| `api.registerMemoryPromptSection(builder)` | Memory prompt bölümü oluşturucusu | +| `api.registerMemoryFlushPlan(resolver)` | Memory flush planı çözümleyicisi | +| `api.registerMemoryRuntime(runtime)` | Memory çalışma zamanı bağdaştırıcısı | -### Bellek embedding bağdaştırıcıları +### Memory embedding bağdaştırıcıları -| Method | Ne kaydeder | -| ---------------------------------------------- | ------------------------------------------- | -| `api.registerMemoryEmbeddingProvider(adapter)` | Etkin plugin için bellek embedding bağdaştırıcısı | +| Yöntem | Kaydettiği şey | +| ---------------------------------------------- | ---------------------------------------------- | +| `api.registerMemoryEmbeddingProvider(adapter)` | Etkin plugin için memory embedding bağdaştırıcısı | -- `registerMemoryCapability`, tercih edilen özel bellek-plugin API'sidir. -- `registerMemoryCapability`, eşlik eden plugin'lerin dışa aktarılan bellek artifact'lerini - belirli bir bellek plugin'inin özel düzenine erişmeden `openclaw/plugin-sdk/memory-host-core` üzerinden tüketebilmesi için `publicArtifacts.listArtifacts(...)` - de sunabilir. +- `registerMemoryCapability`, tercih edilen münhasır memory-plugin API'sidir. +- `registerMemoryCapability`, eşlik eden plugin'lerin dışa aktarılan memory + yapılarını belirli bir memory plugin'inin özel düzenine ulaşmadan + `openclaw/plugin-sdk/memory-host-core` üzerinden tüketebilmesi için + `publicArtifacts.listArtifacts(...)` da sunabilir. - `registerMemoryPromptSection`, `registerMemoryFlushPlan` ve - `registerMemoryRuntime`, eskiyle uyumlu özel bellek-plugin API'leridir. -- `registerMemoryEmbeddingProvider`, etkin bellek plugin'inin bir - veya daha fazla embedding bağdaştırıcı kimliği kaydetmesine izin verir (örneğin `openai`, `gemini` veya plugin tarafından tanımlanan özel bir kimlik). + `registerMemoryRuntime`, eskiyle uyumlu münhasır memory-plugin API'leridir. +- `registerMemoryEmbeddingProvider`, etkin memory plugin'inin bir veya daha + fazla embedding bağdaştırıcısı kimliği kaydetmesine izin verir (örneğin + `openai`, `gemini` veya özel plugin tanımlı bir kimlik). - `agents.defaults.memorySearch.provider` ve - `agents.defaults.memorySearch.fallback` gibi kullanıcı yapılandırmaları bu kayıtlı - bağdaştırıcı kimliklerine göre çözülür. + `agents.defaults.memorySearch.fallback` gibi kullanıcı yapılandırmaları, bu + kaydedilmiş bağdaştırıcı kimliklerine göre çözülür. ### Olaylar ve yaşam döngüsü -| Method | Ne yapar | -| -------------------------------------------- | ---------------------------- | -| `api.on(hookName, handler, opts?)` | Türlenmiş yaşam döngüsü hook'u | -| `api.onConversationBindingResolved(handler)` | Konuşma binding callback'i | +| Yöntem | Yaptığı şey | +| -------------------------------------------- | ----------------------------- | +| `api.on(hookName, handler, opts?)` | Tiplenmiş yaşam döngüsü hook'u | +| `api.onConversationBindingResolved(handler)` | Konuşma bağlama callback'i | ### Hook karar semantiği -- `before_tool_call`: `{ block: true }` döndürmek sonlandırıcıdır. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır. -- `before_tool_call`: `{ block: false }` döndürmek karar yok olarak değerlendirilir (`block` alanını vermemekle aynı), geçersiz kılma sayılmaz. -- `before_install`: `{ block: true }` döndürmek sonlandırıcıdır. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır. -- `before_install`: `{ block: false }` döndürmek karar yok olarak değerlendirilir (`block` alanını vermemekle aynı), geçersiz kılma sayılmaz. -- `reply_dispatch`: `{ handled: true, ... }` döndürmek sonlandırıcıdır. Herhangi bir işleyici dispatch'i sahiplendiğinde, daha düşük öncelikli işleyiciler ve varsayılan model dispatch yolu atlanır. -- `message_sending`: `{ cancel: true }` döndürmek sonlandırıcıdır. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır. -- `message_sending`: `{ cancel: false }` döndürmek karar yok olarak değerlendirilir (`cancel` alanını vermemekle aynı), geçersiz kılma sayılmaz. +- `before_tool_call`: `{ block: true }` döndürmek kesindir. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır. +- `before_tool_call`: `{ block: false }` döndürmek karar yok olarak değerlendirilir (`block` alanını hiç vermemekle aynıdır), geçersiz kılma olarak değil. +- `before_install`: `{ block: true }` döndürmek kesindir. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır. +- `before_install`: `{ block: false }` döndürmek karar yok olarak değerlendirilir (`block` alanını hiç vermemekle aynıdır), geçersiz kılma olarak değil. +- `reply_dispatch`: `{ handled: true, ... }` döndürmek kesindir. Herhangi bir işleyici dağıtımı sahiplendiğinde, daha düşük öncelikli işleyiciler ve varsayılan model dağıtım yolu atlanır. +- `message_sending`: `{ cancel: true }` döndürmek kesindir. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır. +- `message_sending`: `{ cancel: false }` döndürmek karar yok olarak değerlendirilir (`cancel` alanını hiç vermemekle aynıdır), geçersiz kılma olarak değil. ### API nesnesi alanları -| Field | Type | Açıklama | -| ------------------------ | ------------------------- | ------------------------------------------------------------------------------------------ | -| `api.id` | `string` | Plugin kimliği | -| `api.name` | `string` | Görünen ad | -| `api.version` | `string?` | Plugin sürümü (isteğe bağlı) | -| `api.description` | `string?` | Plugin açıklaması (isteğe bağlı) | -| `api.source` | `string` | Plugin kaynak yolu | -| `api.rootDir` | `string?` | Plugin kök dizini (isteğe bağlı) | -| `api.config` | `OpenClawConfig` | Geçerli yapılandırma anlık görüntüsü (varsa etkin bellek içi çalışma zamanı anlık görüntüsü) | -| `api.pluginConfig` | `Record` | `plugins.entries..config` altındaki plugin'e özgü yapılandırma | -| `api.runtime` | `PluginRuntime` | [Çalışma zamanı yardımcıları](/tr/plugins/sdk-runtime) | -| `api.logger` | `PluginLogger` | Kapsamlı logger (`debug`, `info`, `warn`, `error`) | -| `api.registrationMode` | `PluginRegistrationMode` | Geçerli yükleme kipi; `"setup-runtime"` tam giriş öncesi hafif başlangıç/kurulum penceresidir | -| `api.resolvePath(input)` | `(string) => string` | Plugin köküne göre yolu çözümle | +| Alan | Tür | Açıklama | +| ----------------------- | ------------------------- | ----------------------------------------------------------------------------------------- | +| `api.id` | `string` | Plugin kimliği | +| `api.name` | `string` | Görünen ad | +| `api.version` | `string?` | Plugin sürümü (isteğe bağlı) | +| `api.description` | `string?` | Plugin açıklaması (isteğe bağlı) | +| `api.source` | `string` | Plugin kaynak yolu | +| `api.rootDir` | `string?` | Plugin kök dizini (isteğe bağlı) | +| `api.config` | `OpenClawConfig` | Geçerli yapılandırma anlık görüntüsü (mevcutsa etkin bellek içi çalışma zamanı anlık görüntüsü) | +| `api.pluginConfig` | `Record` | `plugins.entries..config` içinden plugin'e özgü yapılandırma | +| `api.runtime` | `PluginRuntime` | [Çalışma zamanı yardımcıları](/tr/plugins/sdk-runtime) | +| `api.logger` | `PluginLogger` | Kapsamlı logger (`debug`, `info`, `warn`, `error`) | +| `api.registrationMode` | `PluginRegistrationMode` | Geçerli yükleme modu; `"setup-runtime"` hafif, tam entry öncesi başlatma/kurulum penceresidir | +| `api.resolvePath(input)` | `(string) => string` | Yolu plugin köküne göre çözümleyin | ## Dahili modül kuralı -Plugin'inizde, dahili içe aktarmalar için yerel barrel dosyaları kullanın: +Plugin'iniz içinde, dahili içe aktarmalar için yerel barrel dosyaları kullanın: ``` my-plugin/ - api.ts # Harici tüketiciler için genel dışa aktarımlar + api.ts # Harici tüketiciler için herkese açık dışa aktarımlar runtime-api.ts # Yalnızca dahili çalışma zamanı dışa aktarımları - index.ts # Plugin giriş noktası - setup-entry.ts # Yalnızca hafif kurulum girişi (isteğe bağlı) + index.ts # Plugin entry point + setup-entry.ts # Yalnızca hafif kurulum entry'si (isteğe bağlı) ``` - Üretim kodunda kendi plugin'inizi `openclaw/plugin-sdk/` - üzerinden asla içe aktarmayın. Dahili içe aktarmaları `./api.ts` veya - `./runtime-api.ts` üzerinden yönlendirin. SDK yolu yalnızca harici sözleşmedir. + Üretim kodunda kendi plugin'inizi asla `openclaw/plugin-sdk/` + üzerinden içe aktarmayın. Dahili içe aktarmaları `./api.ts` veya + `./runtime-api.ts` üzerinden yönlendirin. SDK yolu yalnızca harici + sözleşmedir. -Facade ile yüklenen paketlenmiş plugin genel yüzeyleri (`api.ts`, `runtime-api.ts`, -`index.ts`, `setup-entry.ts` ve benzeri genel giriş dosyaları) artık OpenClaw zaten çalışıyorsa etkin çalışma zamanı yapılandırma anlık görüntüsünü tercih eder. Henüz çalışma zamanı anlık görüntüsü yoksa, disk üzerindeki çözülmüş yapılandırma dosyasına geri dönerler. +Cephe üzerinden yüklenen paketlenmiş plugin herkese açık yüzeyleri (`api.ts`, +`runtime-api.ts`, `index.ts`, `setup-entry.ts` ve benzer herkese açık entry +dosyaları), OpenClaw zaten çalışıyorsa artık etkin çalışma zamanı yapılandırma +anlık görüntüsünü tercih eder. Henüz çalışma zamanı anlık görüntüsü yoksa, +diskteki çözülmüş yapılandırma dosyasına geri dönerler. -Sağlayıcı plugin'leri ayrıca, bir yardımcı kasıtlı olarak sağlayıcıya özgüyse ve henüz genel bir SDK alt yoluna ait değilse, dar bir plugin'e yerel sözleşme barrel dosyası da sunabilir. Güncel paketlenmiş örnek: Anthropic sağlayıcısı, Anthropic beta-header ve `service_tier` mantığını genel bir -`plugin-sdk/*` sözleşmesine yükseltmek yerine Claude stream yardımcılarını kendi genel `api.ts` / `contract-api.ts` yüzeyinde tutar. +Sağlayıcı plugin'leri, bir yardımcı bilinçli olarak sağlayıcıya özelse ve henüz +genel bir SDK alt yoluna ait değilse dar bir plugin-yerel sözleşme barrel'i de +sunabilir. Mevcut paketlenmiş örnek: Anthropic sağlayıcısı, Anthropic beta +başlığı ve `service_tier` mantığını genel bir `plugin-sdk/*` sözleşmesine +taşımak yerine Claude akış yardımcılarını kendi herkese açık `api.ts` / +`contract-api.ts` yüzeyinde tutar. -Diğer güncel paketlenmiş örnekler: +Diğer mevcut paketlenmiş örnekler: - `@openclaw/openai-provider`: `api.ts`, sağlayıcı oluşturucularını, - varsayılan model yardımcılarını ve realtime sağlayıcı oluşturucularını dışa aktarır -- `@openclaw/openrouter-provider`: `api.ts`, sağlayıcı oluşturucusunu ve + varsayılan model yardımcılarını ve gerçek zamanlı sağlayıcı oluşturucularını + dışa aktarır +- `@openclaw/openrouter-provider`: `api.ts`, sağlayıcı oluşturucuyu ve onboarding/yapılandırma yardımcılarını dışa aktarır - Extension üretim kodu ayrıca `openclaw/plugin-sdk/` - içe aktarmalarından da kaçınmalıdır. Bir yardımcı gerçekten paylaşılıyorsa, - iki plugin'i birbirine bağlamak yerine bunu `openclaw/plugin-sdk/speech`, `.../provider-model-shared` veya başka bir yetenek odaklı yüzey gibi nötr bir SDK alt yoluna yükseltin. + Extension üretim kodu ayrıca `openclaw/plugin-sdk/` içe + aktarmalarından da kaçınmalıdır. Bir yardımcı gerçekten paylaşılıyorsa, iki + plugin'i birbirine bağlamak yerine onu `openclaw/plugin-sdk/speech`, + `.../provider-model-shared` veya başka bir yetenek odaklı yüzey gibi tarafsız + bir SDK alt yoluna taşıyın. ## İlgili -- [Giriş Noktaları](/tr/plugins/sdk-entrypoints) — `definePluginEntry` ve `defineChannelPluginEntry` seçenekleri +- [Entry Points](/tr/plugins/sdk-entrypoints) — `definePluginEntry` ve `defineChannelPluginEntry` seçenekleri - [Çalışma Zamanı Yardımcıları](/tr/plugins/sdk-runtime) — tam `api.runtime` ad alanı başvurusu -- [Kurulum ve Yapılandırma](/tr/plugins/sdk-setup) — paketleme, manifest'ler, yapılandırma şemaları -- [Test](/tr/plugins/sdk-testing) — test yardımcıları ve lint kuralları +- [Kurulum ve Yapılandırma](/tr/plugins/sdk-setup) — paketleme, manifestler, yapılandırma şemaları +- [Test](/tr/plugins/sdk-testing) — test araçları ve lint kuralları - [SDK Geçişi](/tr/plugins/sdk-migration) — kullanımdan kaldırılmış yüzeylerden geçiş - [Plugin İç Yapısı](/tr/plugins/architecture) — derin mimari ve yetenek modeli diff --git a/docs/tr/providers/google.md b/docs/tr/providers/google.md index d4216880a..89285583a 100644 --- a/docs/tr/providers/google.md +++ b/docs/tr/providers/google.md @@ -2,13 +2,13 @@ read_when: - OpenClaw ile Google Gemini modellerini kullanmak istiyorsunuz - API anahtarı veya OAuth kimlik doğrulama akışına ihtiyacınız var -summary: Google Gemini kurulumu (API anahtarı + OAuth, görüntü oluşturma, medya anlama, web araması) +summary: Google Gemini kurulumu (API anahtarı + OAuth, görsel oluşturma, medya anlama, web arama) title: Google (Gemini) x-i18n: - generated_at: "2026-04-08T02:17:14Z" + generated_at: "2026-04-08T08:43:24Z" model: gpt-5.4 provider: openai - source_hash: e9e558f5ce35c853e0240350be9a1890460c5f7f7fd30b05813a656497dee516 + source_hash: fad2ff68987301bd86145fa6e10de8c7b38d5bd5dbcd13db9c883f7f5b9a4e01 source_path: providers/google.md workflow: 15 --- @@ -16,7 +16,7 @@ x-i18n: # Google (Gemini) Google eklentisi, Google AI Studio üzerinden Gemini modellerine erişim sağlar; ayrıca -Gemini Grounding aracılığıyla görüntü oluşturma, medya anlama (görüntü/ses/video) ve web aramasını da destekler. +Gemini Grounding aracılığıyla görsel oluşturma, medya anlama (görsel/ses/video) ve web aramayı da destekler. - Sağlayıcı: `google` - Kimlik doğrulama: `GEMINI_API_KEY` veya `GOOGLE_API_KEY` @@ -56,11 +56,11 @@ openclaw onboard --non-interactive \ Alternatif bir sağlayıcı olan `google-gemini-cli`, API anahtarı yerine PKCE OAuth kullanır. Bu resmi olmayan bir entegrasyondur; bazı kullanıcılar hesap -kısıtlamaları bildirmektedir. Riski size ait olmak üzere kullanın. +kısıtlamaları bildirmektedir. Riski size ait olacak şekilde kullanın. - Varsayılan model: `google-gemini-cli/gemini-3-flash-preview` - Takma ad: `gemini-cli` -- Kurulum önkoşulu: yerel Gemini CLI `gemini` olarak kullanılabilir olmalıdır +- Kurulum önkoşulu: yerel Gemini CLI'ın `gemini` olarak kullanılabilir olması - Homebrew: `brew install gemini-cli` - npm: `npm install -g @google/gemini-cli` - Giriş: @@ -76,34 +76,37 @@ Ortam değişkenleri: (Veya `GEMINI_CLI_*` varyantları.) -Gemini CLI OAuth istekleri girişten sonra başarısız olursa, +Giriş yaptıktan sonra Gemini CLI OAuth istekleri başarısız olursa, gateway host üzerinde `GOOGLE_CLOUD_PROJECT` veya `GOOGLE_CLOUD_PROJECT_ID` ayarlayın ve yeniden deneyin. -Giriş, tarayıcı akışı başlamadan önce başarısız olursa, yerel `gemini` +Tarayıcı akışı başlamadan önce giriş başarısız olursa, yerel `gemini` komutunun kurulu olduğundan ve `PATH` üzerinde bulunduğundan emin olun. OpenClaw hem Homebrew kurulumlarını -hem de genel npm kurulumlarını, yaygın Windows/npm düzenleri dahil, destekler. +hem de genel npm kurulumlarını destekler; buna yaygın Windows/npm düzenleri de dahildir. Gemini CLI JSON kullanım notları: -- Yanıt metni CLI JSON `response` alanından gelir. -- CLI `usage` alanını boş bıraktığında kullanım `stats` değerine geri döner. -- `stats.cached`, OpenClaw `cacheRead` değerine normalize edilir. -- `stats.input` eksikse OpenClaw giriş tokenlarını +- Yanıt metni, CLI JSON içindeki `response` alanından gelir. +- CLI `usage` alanını boş bıraktığında kullanım, `stats` alanına geri döner. +- `stats.cached`, OpenClaw `cacheRead` içine normalize edilir. +- `stats.input` eksikse OpenClaw, giriş tokenlerini `stats.input_tokens - stats.cached` değerinden türetir. ## Yetenekler -| Yetenek | Destekleniyor | -| --------------------- | ----------------- | -| Sohbet tamamlamaları | Evet | -| Görüntü oluşturma | Evet | -| Müzik oluşturma | Evet | -| Görüntü anlama | Evet | -| Ses transkripsiyonu | Evet | -| Video anlama | Evet | -| Web araması (Grounding) | Evet | -| Thinking/reasoning | Evet (Gemini 3.1+) | +| Yetenek | Destekleniyor | +| ---------------------- | ----------------- | +| Sohbet tamamlamaları | Evet | +| Görsel oluşturma | Evet | +| Müzik oluşturma | Evet | +| Görsel anlama | Evet | +| Ses dökümü | Evet | +| Video anlama | Evet | +| Web arama (Grounding) | Evet | +| Düşünme/muhakeme | Evet (Gemini 3.1+) | +| Gemma 4 modelleri | Evet | + +Gemma 4 modelleri (örneğin `gemma-4-26b-a4b-it`) düşünme modunu destekler. OpenClaw, Gemma 4 için `thinkingBudget` değerini desteklenen bir Google `thinkingLevel` değerine yeniden yazar. Düşünmeyi `off` olarak ayarlamak, bunu `MINIMAL` değerine eşlemek yerine düşünmenin devre dışı kalmasını korur. ## Doğrudan Gemini önbellek yeniden kullanımı @@ -112,10 +115,10 @@ yapılandırılmış bir `cachedContent` tanıtıcısını Gemini isteklerine il - Model başına veya genel parametreleri `cachedContent` ya da eski `cached_content` ile yapılandırın -- Her ikisi de varsa `cachedContent` önceliklidir +- İkisi de varsa `cachedContent` önceliklidir - Örnek değer: `cachedContents/prebuilt-context` -- Gemini önbellek isabeti kullanımı, üst akıştaki `cachedContentTokenCount` değerinden - OpenClaw `cacheRead` alanına normalize edilir +- Gemini önbellek isabeti kullanımı, yukarı akıştaki `cachedContentTokenCount` değerinden + OpenClaw `cacheRead` içine normalize edilir Örnek: @@ -135,21 +138,21 @@ yapılandırılmış bir `cachedContent` tanıtıcısını Gemini isteklerine il } ``` -## Görüntü oluşturma +## Görsel oluşturma -Paketlenmiş `google` görüntü oluşturma sağlayıcısı varsayılan olarak +Paketle gelen `google` görsel oluşturma sağlayıcısı varsayılan olarak `google/gemini-3.1-flash-image-preview` kullanır. -- Ayrıca `google/gemini-3-pro-image-preview` desteklenir -- Oluşturma: istek başına en fazla 4 görüntü -- Düzenleme modu: etkin, en fazla 5 giriş görüntüsü +- Ayrıca `google/gemini-3-pro-image-preview` da desteklenir +- Oluşturma: istek başına en fazla 4 görsel +- Düzenleme modu: etkin, en fazla 5 giriş görseli - Geometri denetimleri: `size`, `aspectRatio` ve `resolution` Yalnızca OAuth kullanan `google-gemini-cli` sağlayıcısı ayrı bir metin çıkarımı -yüzeyidir. Görüntü oluşturma, medya anlama ve Gemini Grounding -`google` sağlayıcı kimliği üzerinde kalır. +yüzeyidir. Görsel oluşturma, medya anlama ve Gemini Grounding +`google` sağlayıcı kimliğinde kalır. -Google'ı varsayılan görüntü sağlayıcısı olarak kullanmak için: +Google'ı varsayılan görsel sağlayıcısı olarak kullanmak için: ```json5 { @@ -164,15 +167,15 @@ Google'ı varsayılan görüntü sağlayıcısı olarak kullanmak için: ``` Paylaşılan araç -parametreleri, sağlayıcı seçimi ve yük devretme davranışı için [Görüntü Oluşturma](/tr/tools/image-generation) bölümüne bakın. +parametreleri, sağlayıcı seçimi ve devralma davranışı için [Görsel Oluşturma](/tr/tools/image-generation) bölümüne bakın. ## Video oluşturma -Paketlenmiş `google` eklentisi ayrıca paylaşılan -`video_generate` aracı üzerinden video oluşturmayı kaydeder. +Paketle gelen `google` eklentisi, paylaşılan +`video_generate` aracı üzerinden video oluşturmayı da kaydeder. - Varsayılan video modeli: `google/veo-3.1-fast-generate-preview` -- Modlar: metinden videoya, görüntüden videoya ve tek videolu referans akışları +- Modlar: metinden videoya, görselden videoya ve tek video referans akışları - `aspectRatio`, `resolution` ve `audio` desteklenir - Mevcut süre sınırı: **4 ila 8 saniye** @@ -191,19 +194,19 @@ Google'ı varsayılan video sağlayıcısı olarak kullanmak için: ``` Paylaşılan araç -parametreleri, sağlayıcı seçimi ve yük devretme davranışı için [Video Oluşturma](/tr/tools/video-generation) bölümüne bakın. +parametreleri, sağlayıcı seçimi ve devralma davranışı için [Video Oluşturma](/tr/tools/video-generation) bölümüne bakın. ## Müzik oluşturma -Paketlenmiş `google` eklentisi ayrıca paylaşılan -`music_generate` aracı üzerinden müzik oluşturmayı kaydeder. +Paketle gelen `google` eklentisi, paylaşılan +`music_generate` aracı üzerinden müzik oluşturmayı da kaydeder. - Varsayılan müzik modeli: `google/lyria-3-clip-preview` -- Ayrıca `google/lyria-3-pro-preview` desteklenir -- Komut denetimleri: `lyrics` ve `instrumental` +- Ayrıca `google/lyria-3-pro-preview` da desteklenir +- İstem denetimleri: `lyrics` ve `instrumental` - Çıkış biçimi: varsayılan olarak `mp3`, ayrıca `google/lyria-3-pro-preview` üzerinde `wav` -- Referans girdileri: en fazla 10 görüntü -- Oturum destekli çalıştırmalar, `action: "status"` dahil olmak üzere paylaşılan görev/durum akışı üzerinden ayrılır +- Referans girdileri: en fazla 10 görsel +- Oturum destekli çalıştırmalar, `action: "status"` dahil olmak üzere paylaşılan görev/durum akışı üzerinden ayrıştırılır Google'ı varsayılan müzik sağlayıcısı olarak kullanmak için: @@ -220,10 +223,10 @@ Google'ı varsayılan müzik sağlayıcısı olarak kullanmak için: ``` Paylaşılan araç -parametreleri, sağlayıcı seçimi ve yük devretme davranışı için [Müzik Oluşturma](/tr/tools/music-generation) bölümüne bakın. +parametreleri, sağlayıcı seçimi ve devralma davranışı için [Müzik Oluşturma](/tr/tools/music-generation) bölümüne bakın. ## Ortam notu Gateway bir daemon olarak çalışıyorsa (launchd/systemd), `GEMINI_API_KEY` -değerinin bu sürece erişilebilir olduğundan emin olun (örneğin `~/.openclaw/.env` içinde veya +değerinin bu süreç için kullanılabilir olduğundan emin olun (örneğin `~/.openclaw/.env` içinde veya `env.shellEnv` aracılığıyla). diff --git a/docs/tr/providers/ollama.md b/docs/tr/providers/ollama.md index d8f3d7435..f3a9ca984 100644 --- a/docs/tr/providers/ollama.md +++ b/docs/tr/providers/ollama.md @@ -1,43 +1,43 @@ --- read_when: - OpenClaw'ı Ollama üzerinden bulut veya yerel modellerle çalıştırmak istiyorsunuz - - Ollama kurulumu ve yapılandırma rehberine ihtiyacınız var + - Ollama kurulumu ve yapılandırması konusunda rehberliğe ihtiyacınız var summary: OpenClaw'ı Ollama ile çalıştırın (bulut ve yerel modeller) title: Ollama x-i18n: - generated_at: "2026-04-08T02:18:18Z" + generated_at: "2026-04-08T08:43:38Z" model: gpt-5.4 provider: openai - source_hash: 222ec68f7d4bb29cc7796559ddef1d5059f5159e7a51e2baa3a271ddb3abb716 + source_hash: d3295a7c879d3636a2ffdec05aea6e670e54a990ef52bd9b0cae253bc24aa3f7 source_path: providers/ollama.md workflow: 15 --- # Ollama -Ollama, makinenizde açık kaynaklı modeller çalıştırmayı kolaylaştıran yerel bir LLM çalışma zamanıdır. OpenClaw, Ollama'nın yerel API'siyle (`/api/chat`) entegre olur, akış ve araç çağırmayı destekler ve `OLLAMA_API_KEY` (veya bir auth profili) ile etkinleştirdiğinizde ve açık bir `models.providers.ollama` girdisi tanımlamadığınızda yerel Ollama modellerini otomatik olarak keşfedebilir. +Ollama, makinenizde açık kaynaklı modelleri çalıştırmayı kolaylaştıran yerel bir LLM çalışma zamanıdır. OpenClaw, Ollama'nın yerel API'si (`/api/chat`) ile entegre olur, akış ve araç çağırmayı destekler ve `OLLAMA_API_KEY` (veya bir kimlik doğrulama profili) ile etkinleştirdiğinizde ve açık bir `models.providers.ollama` girdisi tanımlamadığınızda yerel Ollama modellerini otomatik olarak keşfedebilir. -**Uzak Ollama kullanıcıları**: OpenClaw ile `/v1` OpenAI uyumlu URL'yi (`http://host:11434/v1`) kullanmayın. Bu, araç çağırmayı bozar ve modeller ham araç JSON'unu düz metin olarak çıkarabilir. Bunun yerine yerel Ollama API URL'sini kullanın: `baseUrl: "http://host:11434"` (`/v1` olmadan). +**Uzak Ollama kullanıcıları**: OpenClaw ile `/v1` OpenAI uyumlu URL'yi (`http://host:11434/v1`) kullanmayın. Bu, araç çağırmayı bozar ve modeller ham araç JSON'unu düz metin olarak çıktılayabilir. Bunun yerine yerel Ollama API URL'sini kullanın: `baseUrl: "http://host:11434"` (`/v1` olmadan). ## Hızlı başlangıç -### Onboarding (önerilir) +### İlk kurulum (önerilir) -Ollama kurmanın en hızlı yolu onboarding üzerinden geçer: +Ollama'yı kurmanın en hızlı yolu ilk kurulum sürecini kullanmaktır: ```bash openclaw onboard ``` -Sağlayıcı listesinden **Ollama** seçin. Onboarding şunları yapar: +Sağlayıcı listesinden **Ollama** seçin. İlk kurulum şunları yapacaktır: -1. Ollama örneğinize ulaşılabilen Ollama temel URL'sini sorar (varsayılan `http://127.0.0.1:11434`). -2. **Cloud + Local** (bulut modelleri ve yerel modeller) veya **Local** (yalnızca yerel modeller) seçmenizi sağlar. -3. **Cloud + Local** seçerseniz ve ollama.com üzerinde oturumunuz açık değilse tarayıcı tabanlı bir oturum açma akışı başlatır. -4. Mevcut modelleri keşfeder ve varsayılanlar önerir. -5. Seçilen model yerelde mevcut değilse onu otomatik olarak çeker. +1. Örneğinize erişilebilen Ollama temel URL'sini sorar (varsayılan `http://127.0.0.1:11434`). +2. **Cloud + Local** (bulut modelleri ve yerel modeller) veya **Local** (yalnızca yerel modeller) seçmenize izin verir. +3. **Cloud + Local** seçerseniz ve `ollama.com` üzerinde oturum açmamışsanız tarayıcıda bir oturum açma akışı başlatır. +4. Kullanılabilir modelleri keşfeder ve varsayılanlar önerir. +5. Seçilen model yerel olarak mevcut değilse onu otomatik olarak çeker. Etkileşimsiz mod da desteklenir: @@ -57,11 +57,11 @@ openclaw onboard --non-interactive \ --accept-risk ``` -### Manuel kurulum +### Elle kurulum -1. Ollama'yı kurun: [https://ollama.com/download](https://ollama.com/download) +1. Ollama'yı yükleyin: [https://ollama.com/download](https://ollama.com/download) -2. Yerel çıkarım istiyorsanız yerel bir model çekin: +2. Yerel çıkarım istiyorsanız bir yerel model çekin: ```bash ollama pull gemma4 @@ -71,28 +71,28 @@ ollama pull gpt-oss:20b ollama pull llama3.3 ``` -3. Bulut modellerini de istiyorsanız oturum açın: +3. Bulut modelleri de istiyorsanız oturum açın: ```bash ollama signin ``` -4. Onboarding çalıştırın ve `Ollama` seçin: +4. İlk kurulumu çalıştırın ve `Ollama` seçin: ```bash openclaw onboard ``` - `Local`: yalnızca yerel modeller -- `Cloud + Local`: yerel modeller artı bulut modelleri -- `kimi-k2.5:cloud`, `minimax-m2.7:cloud` ve `glm-5.1:cloud` gibi bulut modelleri yerel `ollama pull` **gerektirmez** +- `Cloud + Local`: yerel modeller ve bulut modelleri +- `kimi-k2.5:cloud`, `minimax-m2.7:cloud` ve `glm-5.1:cloud` gibi bulut modelleri yerel bir `ollama pull` gerektirmez OpenClaw şu anda şunları önerir: - yerel varsayılan: `gemma4` - bulut varsayılanları: `kimi-k2.5:cloud`, `minimax-m2.7:cloud`, `glm-5.1:cloud` -5. Manuel kurulumu tercih ediyorsanız Ollama'yı doğrudan OpenClaw için etkinleştirin (herhangi bir değer çalışır; Ollama gerçek bir anahtar gerektirmez): +5. Elle kurulum tercih ediyorsanız, Ollama'yı doğrudan OpenClaw için etkinleştirin (herhangi bir değer çalışır; Ollama gerçek bir anahtar gerektirmez): ```bash # Ortam değişkeni ayarla @@ -109,7 +109,7 @@ openclaw models list openclaw models set ollama/gemma4 ``` -7. Veya varsayılanı yapılandırmada ayarlayın: +7. Ya da varsayılanı yapılandırmada ayarlayın: ```json5 { @@ -123,32 +123,33 @@ openclaw models set ollama/gemma4 ## Model keşfi (örtük sağlayıcı) -`OLLAMA_API_KEY` (veya bir auth profili) ayarladığınızda ve **`models.providers.ollama` tanımlamadığınızda**, OpenClaw modelleri `http://127.0.0.1:11434` adresindeki yerel Ollama örneğinden keşfeder: +`OLLAMA_API_KEY` (veya bir kimlik doğrulama profili) ayarladığınızda ve `models.providers.ollama` tanımlamadığınızda, OpenClaw yerel Ollama örneğinden `http://127.0.0.1:11434` adresinde modelleri keşfeder: - `/api/tags` sorgulanır -- Mümkün olduğunda `contextWindow` okumak için en iyi çabayla `/api/show` aramaları kullanılır +- Kullanılabildiğinde `contextWindow` değerini okumak ve yetenekleri (görsel dahil) algılamak için en iyi çabayla `/api/show` aramaları kullanılır +- `/api/show` tarafından bildirilen `vision` yeteneğine sahip modeller, görsel destekli (`input: ["text", "image"]`) olarak işaretlenir; böylece OpenClaw bu modeller için isteme görüntüleri otomatik olarak ekler - `reasoning`, model adı sezgisiyle işaretlenir (`r1`, `reasoning`, `think`) -- `maxTokens`, OpenClaw tarafından kullanılan varsayılan Ollama azami token sınırına ayarlanır +- `maxTokens`, OpenClaw tarafından kullanılan varsayılan Ollama maksimum token sınırına ayarlanır - Tüm maliyetler `0` olarak ayarlanır -Bu, kataloğu yerel Ollama örneğiyle uyumlu tutarken manuel model girdilerinden kaçınmanızı sağlar. +Bu, katalogu yerel Ollama örneğiyle uyumlu tutarken elle model girişi yapma gereğini ortadan kaldırır. -Hangi modellerin mevcut olduğunu görmek için: +Hangi modellerin kullanılabilir olduğunu görmek için: ```bash ollama list openclaw models list ``` -Yeni bir model eklemek için onu Ollama ile çekmeniz yeterlidir: +Yeni bir model eklemek için, onu Ollama ile çekmeniz yeterlidir: ```bash ollama pull mistral ``` -Yeni model otomatik olarak keşfedilir ve kullanıma sunulur. +Yeni model otomatik olarak keşfedilir ve kullanıma hazır olur. -`models.providers.ollama` değerini açıkça ayarlarsanız otomatik keşif atlanır ve modelleri manuel olarak tanımlamanız gerekir (aşağıya bakın). +`models.providers.ollama` değerini açıkça ayarlarsanız otomatik keşif atlanır ve modelleri elle tanımlamanız gerekir (aşağıya bakın). ## Yapılandırma @@ -160,13 +161,13 @@ Ollama'yı etkinleştirmenin en basit yolu ortam değişkeni kullanmaktır: export OLLAMA_API_KEY="ollama-local" ``` -### Açık kurulum (manuel modeller) +### Açık kurulum (elle modeller) Şu durumlarda açık yapılandırma kullanın: -- Ollama başka bir host/port üzerinde çalışıyorsa. +- Ollama başka bir ana makine/bağlantı noktasında çalışıyorsa. - Belirli bağlam pencerelerini veya model listelerini zorlamak istiyorsanız. -- Tamamen manuel model tanımları istiyorsanız. +- Tamamen elle model tanımları istiyorsanız. ```json5 { @@ -193,11 +194,11 @@ export OLLAMA_API_KEY="ollama-local" } ``` -`OLLAMA_API_KEY` ayarlıysa sağlayıcı girdisinde `apiKey` değerini atlayabilirsiniz; OpenClaw bunu kullanılabilirlik kontrolleri için doldurur. +`OLLAMA_API_KEY` ayarlıysa, sağlayıcı girdisinde `apiKey` değerini atlayabilirsiniz; OpenClaw bunu kullanılabilirlik denetimleri için doldurur. ### Özel temel URL (açık yapılandırma) -Ollama farklı bir host veya port üzerinde çalışıyorsa (açık yapılandırma otomatik keşfi devre dışı bırakır, bu yüzden modelleri manuel tanımlayın): +Ollama farklı bir ana makinede veya bağlantı noktasında çalışıyorsa (açık yapılandırma otomatik keşfi devre dışı bırakır, bu nedenle modelleri elle tanımlayın): ```json5 { @@ -206,7 +207,7 @@ Ollama farklı bir host veya port üzerinde çalışıyorsa (açık yapılandır ollama: { apiKey: "ollama-local", baseUrl: "http://ollama-host:11434", // /v1 yok - yerel Ollama API URL'sini kullanın - api: "ollama", // yerel araç çağırma davranışını garanti etmek için açıkça ayarlayın + api: "ollama", // Yerel araç çağırma davranışını garanti etmek için açıkça ayarlayın }, }, }, @@ -219,7 +220,7 @@ URL'ye `/v1` eklemeyin. `/v1` yolu, araç çağırmanın güvenilir olmadığı ### Model seçimi -Bir kez yapılandırıldığında tüm Ollama modelleriniz kullanılabilir olur: +Yapılandırıldıktan sonra tüm Ollama modelleriniz kullanılabilir olur: ```json5 { @@ -236,9 +237,9 @@ Bir kez yapılandırıldığında tüm Ollama modelleriniz kullanılabilir olur: ## Bulut modelleri -Bulut modelleri, yerel modellerinizle birlikte bulutta barındırılan modelleri (`kimi-k2.5:cloud`, `minimax-m2.7:cloud`, `glm-5.1:cloud` gibi) çalıştırmanızı sağlar. +Bulut modelleri, bulutta barındırılan modelleri (örneğin `kimi-k2.5:cloud`, `minimax-m2.7:cloud`, `glm-5.1:cloud`) yerel modellerinizle birlikte çalıştırmanıza olanak tanır. -Bulut modellerini kullanmak için kurulum sırasında **Cloud + Local** modunu seçin. Sihirbaz oturumunuzun açık olup olmadığını kontrol eder ve gerektiğinde tarayıcı tabanlı oturum açma akışı başlatır. Kimlik doğrulama doğrulanamazsa sihirbaz yerel model varsayılanlarına geri döner. +Bulut modellerini kullanmak için kurulum sırasında **Cloud + Local** modunu seçin. Sihirbaz, oturum açıp açmadığınızı denetler ve gerektiğinde tarayıcıda bir oturum açma akışı başlatır. Kimlik doğrulama doğrulanamazsa sihirbaz yerel model varsayılanlarına geri döner. Doğrudan [ollama.com/signin](https://ollama.com/signin) adresinden de oturum açabilirsiniz. @@ -247,8 +248,7 @@ Doğrudan [ollama.com/signin](https://ollama.com/signin) adresinden de oturum a OpenClaw ayrıca paketlenmiş bir `web_search` sağlayıcısı olarak **Ollama Web Search** desteği sunar. -- Yapılandırılmış Ollama host'unuzu kullanır (`models.providers.ollama.baseUrl` ayarlıysa onu, - aksi halde `http://127.0.0.1:11434`). +- Yapılandırılmış Ollama ana makinenizi kullanır (`models.providers.ollama.baseUrl` ayarlıysa onu, aksi takdirde `http://127.0.0.1:11434`). - Anahtar gerektirmez. - Ollama'nın çalışıyor olmasını ve `ollama signin` ile oturum açılmış olmasını gerektirir. @@ -267,13 +267,13 @@ sağlayıcısı olarak **Ollama Web Search** desteği sunar. } ``` -Tam kurulum ve davranış ayrıntıları için [Ollama Web Search](/tr/tools/ollama-search) bölümüne bakın. +Tam kurulum ve davranış ayrıntıları için bkz. [Ollama Web Search](/tr/tools/ollama-search). ## Gelişmiş ### Reasoning modelleri -OpenClaw, varsayılan olarak `deepseek-r1`, `reasoning` veya `think` gibi adlara sahip modelleri reasoning destekli kabul eder: +OpenClaw, `deepseek-r1`, `reasoning` veya `think` gibi adlara sahip modelleri varsayılan olarak reasoning destekli kabul eder: ```bash ollama pull deepseek-r1:32b @@ -281,16 +281,16 @@ ollama pull deepseek-r1:32b ### Model maliyetleri -Ollama ücretsizdir ve yerelde çalışır, bu nedenle tüm model maliyetleri $0 olarak ayarlanır. +Ollama ücretsizdir ve yerel olarak çalışır, bu nedenle tüm model maliyetleri $0 olarak ayarlanır. ### Akış yapılandırması -OpenClaw'ın Ollama entegrasyonu varsayılan olarak **yerel Ollama API'sini** (`/api/chat`) kullanır; bu, akış ve araç çağırmayı aynı anda tam olarak destekler. Özel bir yapılandırma gerekmez. +OpenClaw'ın Ollama entegrasyonu varsayılan olarak **yerel Ollama API**'sini (`/api/chat`) kullanır; bu API akış ve araç çağırmayı aynı anda tam olarak destekler. Özel bir yapılandırma gerekmez. #### Eski OpenAI uyumlu mod -**Araç çağırma OpenAI uyumlu modda güvenilir değildir.** Bu modu yalnızca bir proxy için OpenAI biçimine ihtiyacınız varsa ve yerel araç çağırma davranışına bağımlı değilseniz kullanın. +**Araç çağırma, OpenAI uyumlu modda güvenilir değildir.** Bu modu yalnızca bir proxy için OpenAI biçimine ihtiyacınız varsa ve yerel araç çağırma davranışına bağımlı değilseniz kullanın. Bunun yerine OpenAI uyumlu uç noktayı kullanmanız gerekiyorsa (ör. yalnızca OpenAI biçimini destekleyen bir proxy arkasında), `api: "openai-completions"` değerini açıkça ayarlayın: @@ -311,9 +311,9 @@ Bunun yerine OpenAI uyumlu uç noktayı kullanmanız gerekiyorsa (ör. yalnızca } ``` -Bu mod aynı anda akış + araç çağırmayı desteklemeyebilir. Model yapılandırmasında `params: { streaming: false }` ile akışı devre dışı bırakmanız gerekebilir. +Bu mod, akış + araç çağırmayı aynı anda desteklemeyebilir. Model yapılandırmasında `params: { streaming: false }` ile akışı devre dışı bırakmanız gerekebilir. -Ollama ile `api: "openai-completions"` kullanıldığında OpenClaw, Ollama'nın sessizce 4096 bağlam penceresine geri dönmemesi için varsayılan olarak `options.num_ctx` enjekte eder. Proxy'niz/yukarı akışınız bilinmeyen `options` alanlarını reddediyorsa bu davranışı devre dışı bırakın: +`api: "openai-completions"` Ollama ile kullanıldığında, OpenClaw varsayılan olarak `options.num_ctx` ekler; böylece Ollama sessizce 4096 bağlam penceresine geri düşmez. Proxy/yukarı akış bilinmeyen `options` alanlarını reddediyorsa bu davranışı devre dışı bırakın: ```json5 { @@ -333,19 +333,19 @@ Ollama ile `api: "openai-completions"` kullanıldığında OpenClaw, Ollama'nın ### Bağlam pencereleri -Otomatik keşfedilen modeller için OpenClaw, mümkün olduğunda Ollama tarafından bildirilen bağlam penceresini kullanır; aksi halde OpenClaw tarafından kullanılan varsayılan Ollama bağlam penceresine geri döner. Açık sağlayıcı yapılandırmasında `contextWindow` ve `maxTokens` değerlerini geçersiz kılabilirsiniz. +Otomatik olarak keşfedilen modeller için OpenClaw, kullanılabiliyorsa Ollama tarafından bildirilen bağlam penceresini kullanır; aksi takdirde OpenClaw tarafından kullanılan varsayılan Ollama bağlam penceresine geri döner. Açık sağlayıcı yapılandırmasında `contextWindow` ve `maxTokens` değerlerini geçersiz kılabilirsiniz. ## Sorun giderme ### Ollama algılanmadı -Ollama'nın çalıştığından, `OLLAMA_API_KEY` (veya bir auth profili) ayarladığınızdan ve açık bir `models.providers.ollama` girdisi tanımlamadığınızdan emin olun: +Ollama'nın çalıştığından, `OLLAMA_API_KEY` (veya bir kimlik doğrulama profili) ayarladığınızdan ve açık bir `models.providers.ollama` girdisi tanımlamadığınızdan emin olun: ```bash ollama serve ``` -Ayrıca API'nin erişilebilir olduğunu doğrulayın: +Ve API'nin erişilebilir olduğunu doğrulayın: ```bash curl http://localhost:11434/api/tags @@ -353,9 +353,9 @@ curl http://localhost:11434/api/tags ### Kullanılabilir model yok -Modeliniz listelenmiyorsa şunlardan birini yapın: +Modeliniz listelenmiyorsa şu iki durumdan biri söz konusudur: -- Modeli yerelde çekin veya +- Modeli yerel olarak çekin veya - Modeli `models.providers.ollama` içinde açıkça tanımlayın. Model eklemek için: @@ -369,18 +369,18 @@ ollama pull llama3.3 # Veya başka bir model ### Bağlantı reddedildi -Ollama'nın doğru port üzerinde çalıştığını kontrol edin: +Ollama'nın doğru bağlantı noktasında çalıştığını denetleyin: ```bash -# Ollama çalışıyor mu kontrol edin +# Ollama'nın çalışıp çalışmadığını denetleyin ps aux | grep ollama -# Veya Ollama'yı yeniden başlatın +# Ya da Ollama'yı yeniden başlatın ollama serve ``` ## Ayrıca bakın -- [Model Sağlayıcıları](/tr/concepts/model-providers) - Tüm sağlayıcılara genel bakış -- [Model Seçimi](/tr/concepts/models) - Modeller nasıl seçilir -- [Yapılandırma](/tr/gateway/configuration) - Tam yapılandırma referansı +- [Model Providers](/tr/concepts/model-providers) - Tüm sağlayıcılara genel bakış +- [Model Selection](/tr/concepts/models) - Modeller nasıl seçilir +- [Configuration](/tr/gateway/configuration) - Tam yapılandırma başvurusu