diff --git a/docs/tr/channels/slack.md b/docs/tr/channels/slack.md index 33eca8ff1..d1a4331b1 100644 --- a/docs/tr/channels/slack.md +++ b/docs/tr/channels/slack.md @@ -1,20 +1,20 @@ --- read_when: - - Slack kuruluyorsa veya Slack socket/HTTP modunda hata ayıklanıyorsa -summary: Slack kurulumu ve çalışma zamanı davranışı (Socket Mode + HTTP Request URLs) + - Slack kuruluyorsa veya Slack socket/HTTP modu hata ayıklanıyorsa +summary: Slack kurulumu ve çalışma zamanı davranışı (Socket Mode + HTTP Request URL'leri) title: Slack x-i18n: - generated_at: "2026-04-07T08:44:50Z" + generated_at: "2026-04-08T06:02:10Z" model: gpt-5.4 provider: openai - source_hash: 2b8fd2cc6c638ee82069f0af2c2b6f6f49c87da709b941433a0343724a9907ea + source_hash: cad132131ddce688517def7c14703ad314441c67aacc4cc2a2a721e1d1c01942 source_path: channels/slack.md workflow: 15 --- # Slack -Durum: Slack uygulama entegrasyonları üzerinden DM'ler ve kanallar için üretime hazır. Varsayılan mod Socket Mode'dur; HTTP Request URLs de desteklenir. +Durum: Slack uygulama entegrasyonları aracılığıyla DM'ler + kanallar için üretime hazır. Varsayılan mod Socket Mode'dur; HTTP Request URL'leri de desteklenir. @@ -24,7 +24,7 @@ Durum: Slack uygulama entegrasyonları üzerinden DM'ler ve kanallar için üret Yerel komut davranışı ve komut kataloğu. - Kanallar arası tanılama ve onarım kılavuzları. + Kanallar arası tanılama ve onarım playbook'ları. @@ -57,7 +57,7 @@ Durum: Slack uygulama entegrasyonları üzerinden DM'ler ve kanallar için üret } ``` - Ortam değişkeni yedeği (yalnızca varsayılan hesap): + Ortam değişkeni geri dönüşü (yalnızca varsayılan hesap): ```bash SLACK_APP_TOKEN=xapp-... @@ -77,7 +77,7 @@ openclaw gateway - + Slack uygulama ayarlarında **[Create New App](https://api.slack.com/apps/new)** düğmesine basın: @@ -108,7 +108,7 @@ openclaw gateway Çok hesaplı HTTP için benzersiz webhook yolları kullanın - Kayıtların çakışmaması için her hesaba farklı bir `webhookPath` verin (varsayılan `/slack/events`). + Kayıtların çakışmaması için her hesaba ayrı bir `webhookPath` (varsayılan `/slack/events`) verin. @@ -134,7 +134,7 @@ openclaw gateway { "display_information": { "name": "OpenClaw", - "description": "Slack connector for OpenClaw" + "description": "OpenClaw için Slack bağlayıcısı" }, "features": { "bot_user": { @@ -148,7 +148,7 @@ openclaw gateway "slash_commands": [ { "command": "/openclaw", - "description": "Send a message to OpenClaw", + "description": "OpenClaw'a mesaj gönder", "should_escape": false } ] @@ -205,13 +205,13 @@ openclaw gateway - + ```json { "display_information": { "name": "OpenClaw", - "description": "Slack connector for OpenClaw" + "description": "OpenClaw için Slack bağlayıcısı" }, "features": { "bot_user": { @@ -225,7 +225,7 @@ openclaw gateway "slash_commands": [ { "command": "/openclaw", - "description": "Send a message to OpenClaw", + "description": "OpenClaw'a mesaj gönder", "should_escape": false, "url": "https://gateway-host.example.com/slack/events" } @@ -296,7 +296,7 @@ openclaw gateway Bir emoji simgesi kullanıyorsanız Slack `:emoji_name:` sözdizimini bekler. - + `channels.slack.userToken` yapılandırırsanız tipik okuma kapsamları şunlardır: - `channels:history`, `groups:history`, `im:history`, `mpim:history` @@ -305,20 +305,20 @@ openclaw gateway - `reactions:read` - `pins:read` - `emoji:read` - - `search:read` (Slack arama okumalarına bağımlıysanız) + - `search:read` (Slack arama okumalarına bağlıysanız) -## Belirteç modeli +## Token modeli - Socket Mode için `botToken` + `appToken` gereklidir. - HTTP modu `botToken` + `signingSecret` gerektirir. -- `botToken`, `appToken`, `signingSecret` ve `userToken`, düz metin +- `botToken`, `appToken`, `signingSecret` ve `userToken` düz metin dizeleri veya SecretRef nesneleri kabul eder. -- Yapılandırma belirteçleri ortam değişkeni yedeğini geçersiz kılar. -- `SLACK_BOT_TOKEN` / `SLACK_APP_TOKEN` ortam değişkeni yedeği yalnızca varsayılan hesaba uygulanır. -- `userToken` (`xoxp-...`) yalnızca yapılandırmadadır (ortam değişkeni yedeği yoktur) ve varsayılan olarak salt okunur davranış kullanır (`userTokenReadOnly: true`). +- Yapılandırma token'ları ortam değişkeni geri dönüşünü geçersiz kılar. +- `SLACK_BOT_TOKEN` / `SLACK_APP_TOKEN` ortam değişkeni geri dönüşü yalnızca varsayılan hesap için geçerlidir. +- `userToken` (`xoxp-...`) yalnızca yapılandırmadandır (ortam değişkeni geri dönüşü yoktur) ve varsayılan olarak salt okunur davranış kullanır (`userTokenReadOnly: true`). Durum anlık görüntüsü davranışı: @@ -326,20 +326,20 @@ Durum anlık görüntüsü davranışı: alanlarını izler (`botToken`, `appToken`, `signingSecret`, `userToken`). - Durum `available`, `configured_unavailable` veya `missing` olabilir. - `configured_unavailable`, hesabın SecretRef - veya başka bir satır içi olmayan gizli kaynak üzerinden yapılandırıldığı, - ancak mevcut komut/çalışma zamanı yolunun gerçek değeri çözemediği anlamına gelir. + veya satır içi olmayan başka bir gizli kaynak üzerinden yapılandırıldığı, ancak mevcut komut/çalışma zamanı yolunun + gerçek değeri çözemediği anlamına gelir. - HTTP modunda `signingSecretStatus` dahil edilir; Socket Mode'da - gereken ikili `botTokenStatus` + `appTokenStatus` olur. + gerekli çift `botTokenStatus` + `appTokenStatus` olur. -Eylemler/dizin okumaları için, yapılandırılmışsa kullanıcı belirteci tercih edilebilir. Yazmalar için bot belirteci tercih edilmeye devam eder; kullanıcı belirteciyle yazmaya yalnızca `userTokenReadOnly: false` olduğunda ve bot belirteci kullanılamadığında izin verilir. +Eylemler/dizin okumaları için, yapılandırılmışsa user token tercih edilebilir. Yazmalar için bot token tercih edilmeye devam eder; user-token ile yazmalara yalnızca `userTokenReadOnly: false` olduğunda ve bot token kullanılamadığında izin verilir. ## Eylemler ve geçitler -Slack eylemleri `channels.slack.actions.*` ile kontrol edilir. +Slack eylemleri `channels.slack.actions.*` tarafından denetlenir. -Geçerli Slack araçlarında kullanılabilir eylem grupları: +Geçerli Slack araçlarında kullanılabilen eylem grupları: | Grup | Varsayılan | | ---------- | ------- | @@ -349,31 +349,31 @@ Geçerli Slack araçlarında kullanılabilir eylem grupları: | memberInfo | etkin | | emojiList | etkin | -Geçerli Slack mesaj eylemleri arasında `send`, `upload-file`, `download-file`, `read`, `edit`, `delete`, `pin`, `unpin`, `list-pins`, `member-info` ve `emoji-list` bulunur. +Geçerli Slack mesaj eylemleri `send`, `upload-file`, `download-file`, `read`, `edit`, `delete`, `pin`, `unpin`, `list-pins`, `member-info` ve `emoji-list` içerir. -## Erişim kontrolü ve yönlendirme +## Erişim denetimi ve yönlendirme - `channels.slack.dmPolicy`, DM erişimini kontrol eder (eski: `channels.slack.dm.policy`): + `channels.slack.dmPolicy`, DM erişimini denetler (eski: `channels.slack.dm.policy`): - `pairing` (varsayılan) - `allowlist` - - `open` (`channels.slack.allowFrom` içinde `"*"` bulunmasını gerektirir; eski: `channels.slack.dm.allowFrom`) + - `open` (`channels.slack.allowFrom` içine `"*"` eklenmesini gerektirir; eski: `channels.slack.dm.allowFrom`) - `disabled` - DM işaretleri: + DM bayrakları: - `dm.enabled` (varsayılan true) - `channels.slack.allowFrom` (tercih edilen) - `dm.allowFrom` (eski) - - `dm.groupEnabled` (grup DM'leri varsayılan olarak false) + - `dm.groupEnabled` (grup DM'leri varsayılan false) - `dm.groupChannels` (isteğe bağlı MPIM izin listesi) - Çok hesaplı öncelik: + Çok hesaplı öncelik sırası: - `channels.slack.accounts.default.allowFrom` yalnızca `default` hesabına uygulanır. - - Adlandırılmış hesaplar, kendi `allowFrom` değerleri ayarlanmamışsa `channels.slack.allowFrom` değerini devralır. + - Adlandırılmış hesaplar, kendi `allowFrom` değerleri ayarlı değilse `channels.slack.allowFrom` değerini devralır. - Adlandırılmış hesaplar `channels.slack.accounts.default.allowFrom` değerini devralmaz. DM'lerde eşleştirme `openclaw pairing approve slack ` kullanır. @@ -381,7 +381,7 @@ Geçerli Slack mesaj eylemleri arasında `send`, `upload-file`, `download-file`, - `channels.slack.groupPolicy`, kanal işlemeyi kontrol eder: + `channels.slack.groupPolicy`, kanal işlemesini denetler: - `open` - `allowlist` @@ -389,26 +389,26 @@ Geçerli Slack mesaj eylemleri arasında `send`, `upload-file`, `download-file`, Kanal izin listesi `channels.slack.channels` altında bulunur ve kararlı kanal kimlikleri kullanmalıdır. - Çalışma zamanı notu: `channels.slack` tamamen eksikse (yalnızca ortam değişkenli kurulum), çalışma zamanı `groupPolicy="allowlist"` değerine geri döner ve bir uyarı kaydeder (`channels.defaults.groupPolicy` ayarlanmış olsa bile). + Çalışma zamanı notu: `channels.slack` tamamen yoksa (yalnızca ortam değişkeni kurulumu), çalışma zamanı `groupPolicy="allowlist"` değerine geri döner ve bir uyarı günlüğe yazar (`channels.defaults.groupPolicy` ayarlı olsa bile). Ad/kimlik çözümleme: - - kanal izin listesi girişleri ve DM izin listesi girişleri, belirteç erişimi izin verdiğinde başlangıçta çözümlenir - - çözümlenmemiş kanal adı girişleri yapılandırıldığı gibi tutulur ancak varsayılan olarak yönlendirme için yok sayılır + - kanal izin listesi girdileri ve DM izin listesi girdileri, token erişimi izin verdiğinde başlangıçta çözülür + - çözümlenmemiş kanal adı girdileri yapılandırıldığı gibi tutulur ancak varsayılan olarak yönlendirme için yok sayılır - gelen yetkilendirme ve kanal yönlendirme varsayılan olarak önce kimlik kullanır; doğrudan kullanıcı adı/slug eşleştirmesi için `channels.slack.dangerouslyAllowNameMatching: true` gerekir - Kanal mesajları varsayılan olarak bahsetme geçidiyle korunur. + Kanal mesajları varsayılan olarak bahsetme kapılıdır. Bahsetme kaynakları: - açık uygulama bahsetmesi (`<@botId>`) - - bahsetme regex desenleri (`agents.list[].groupChat.mentionPatterns`, yedek olarak `messages.groupChat.mentionPatterns`) - - örtük botta yanıt dizisi davranışı (`thread.requireExplicitMention` `true` olduğunda devre dışıdır) + - bahsetme regex desenleri (`agents.list[].groupChat.mentionPatterns`, geri dönüş `messages.groupChat.mentionPatterns`) + - örtük botta-yanıt iş parçacığı davranışı (`thread.requireExplicitMention` `true` olduğunda devre dışı bırakılır) - Kanal başına kontroller (`channels.slack.channels.`; adlar yalnızca başlangıç çözümlemesi veya `dangerouslyAllowNameMatching` ile): + Kanal başına denetimler (`channels.slack.channels.`; adlar yalnızca başlangıç çözümlemesi veya `dangerouslyAllowNameMatching` ile): - `requireMention` - `users` (izin listesi) @@ -417,35 +417,35 @@ Geçerli Slack mesaj eylemleri arasında `send`, `upload-file`, `download-file`, - `systemPrompt` - `tools`, `toolsBySender` - `toolsBySender` anahtar biçimi: `id:`, `e164:`, `username:`, `name:` veya `"*"` joker karakteri - (eski ön eksiz anahtarlar yine de yalnızca `id:` ile eşlenir) + (eski öneksiz anahtarlar yine de yalnızca `id:` ile eşlenir) -## Diziler, oturumlar ve yanıt etiketleri +## İş parçacıkları, oturumlar ve yanıt etiketleri -- DM'ler `direct` olarak; kanallar `channel` olarak; MPIM'ler `group` olarak yönlendirilir. +- DM'ler `direct`; kanallar `channel`; MPIM'ler `group` olarak yönlendirilir. - Varsayılan `session.dmScope=main` ile Slack DM'leri ajan ana oturumunda birleştirilir. - Kanal oturumları: `agent::slack:channel:`. -- Dizi yanıtları, uygun olduğunda dizi oturumu sonekleri (`:thread:`) oluşturabilir. -- `channels.slack.thread.historyScope` varsayılanı `thread`; `thread.inheritParent` varsayılanı `false` değeridir. -- `channels.slack.thread.initialHistoryLimit`, yeni bir dizi oturumu başladığında kaç mevcut dizi mesajının alınacağını kontrol eder (varsayılan `20`; devre dışı bırakmak için `0` ayarlayın). -- `channels.slack.thread.requireExplicitMention` (varsayılan `false`): `true` olduğunda örtük dizi bahsetmelerini bastırır; böylece bot, diziler içinde yalnızca açık `@bot` bahsetmelerine yanıt verir, bot dizide zaten yer almış olsa bile. Bu olmadan, botun katıldığı bir dizideki yanıtlar `requireMention` geçidini atlar. +- İş parçacığı yanıtları, uygun olduğunda iş parçacığı oturum son ekleri (`:thread:`) oluşturabilir. +- `channels.slack.thread.historyScope` varsayılanı `thread`; `thread.inheritParent` varsayılanı `false`. +- `channels.slack.thread.initialHistoryLimit`, yeni bir iş parçacığı oturumu başladığında kaç mevcut iş parçacığı mesajının getirileceğini denetler (varsayılan `20`; devre dışı bırakmak için `0` ayarlayın). +- `channels.slack.thread.requireExplicitMention` (varsayılan `false`): `true` olduğunda, örtük iş parçacığı bahsetmelerini bastırır; böylece bot, iş parçacığına daha önce katılmış olsa bile yalnızca iş parçacıkları içindeki açık `@bot` bahsetmelerine yanıt verir. Bu ayar olmadan, botun katıldığı bir iş parçacığındaki yanıtlar `requireMention` kapısını atlar. -Yanıt dizileme denetimleri: +Yanıt iş parçacığı denetimleri: - `channels.slack.replyToMode`: `off|first|all|batched` (varsayılan `off`) -- `channels.slack.replyToModeByChatType`: `direct|group|channel` başına -- doğrudan sohbetler için eski yedek: `channels.slack.dm.replyToMode` +- `channels.slack.replyToModeByChatType`: her `direct|group|channel` için +- doğrudan sohbetler için eski geri dönüş: `channels.slack.dm.replyToMode` Elle yanıt etiketleri desteklenir: - `[[reply_to_current]]` - `[[reply_to:]]` -Not: `replyToMode="off"`, açık `[[reply_to_*]]` etiketleri dahil Slack'teki **tüm** yanıt dizilemesini devre dışı bırakır. Bu, açık etiketlerin `"off"` modunda yine de dikkate alındığı Telegram'dan farklıdır. Fark, platformların dizi modellerini yansıtır: Slack dizileri mesajları kanaldan gizlerken Telegram yanıtları ana sohbet akışında görünür kalır. +Not: `replyToMode="off"`, açık `[[reply_to_*]]` etiketleri dahil olmak üzere Slack'teki **tüm** yanıt iş parçacıklarını devre dışı bırakır. Bu, açık etiketlerin `"off"` modunda yine de dikkate alındığı Telegram'dan farklıdır. Bu fark, platform iş parçacığı modellerini yansıtır: Slack iş parçacıkları mesajları kanaldan gizlerken Telegram yanıtları ana sohbet akışında görünür kalır. -## Onay reaksiyonları +## Ack reaksiyonları `ackReaction`, OpenClaw gelen bir mesajı işlerken bir onay emojisi gönderir. @@ -454,27 +454,29 @@ Not: `replyToMode="off"`, açık `[[reply_to_*]]` etiketleri dahil Slack'teki ** - `channels.slack.accounts..ackReaction` - `channels.slack.ackReaction` - `messages.ackReaction` -- ajan kimliği emoji yedeği (`agents.list[].identity.emoji`, yoksa "👀") +- ajan kimliği emoji geri dönüşü (`agents.list[].identity.emoji`, aksi halde "👀") Notlar: - Slack kısa kodlar bekler (örneğin `"eyes"`). -- Slack hesabı veya genel olarak reaksiyonu devre dışı bırakmak için `""` kullanın. +- Slack hesabı için veya genel olarak reaksiyonu devre dışı bırakmak için `""` kullanın. ## Metin akışı -`channels.slack.streaming`, canlı önizleme davranışını kontrol eder: +`channels.slack.streaming`, canlı önizleme davranışını denetler: - `off`: canlı önizleme akışını devre dışı bırakır. -- `partial` (varsayılan): önizleme metnini en son kısmi çıktıyla değiştirir. -- `block`: parçalı önizleme güncellemeleri ekler. -- `progress`: üretim sırasında ilerleme durumu metni gösterir, ardından son metni gönderir. +- `partial` (varsayılan): önizleme metnini en son kısmi çıktı ile değiştirir. +- `block`: parçalı önizleme güncellemelerini ekler. +- `progress`: oluşturma sırasında ilerleme durumu metni gösterir, ardından son metni gönderir. -`channels.slack.nativeStreaming`, `streaming` değeri `partial` olduğunda Slack yerel metin akışını kontrol eder (varsayılan: `true`). +`channels.slack.streaming.nativeTransport`, `channels.slack.streaming.mode` `partial` olduğunda Slack yerel metin akışını denetler (varsayılan: `true`). -- Yerel metin akışının görünmesi için bir yanıt dizisi kullanılabilir olmalıdır. Dizi seçimi yine de `replyToMode` değerini izler. Böyle bir dizi yoksa normal taslak önizleme kullanılır. -- Medya ve metin dışı yükler normal teslimata geri döner. -- Akış yanıt ortasında başarısız olursa OpenClaw kalan yükler için normal teslimata geri döner. +- Yerel metin akışı ve Slack assistant iş parçacığı durumunun görünmesi için bir yanıt iş parçacığı kullanılabilir olmalıdır. İş parçacığı seçimi yine `replyToMode` değerini izler. +- Kanal ve grup sohbeti kökleri, yerel akış kullanılamadığında yine normal taslak önizlemeyi kullanabilir. +- Üst düzey Slack DM'leri varsayılan olarak iş parçacığı dışında kalır; bu nedenle iş parçacığı tarzı önizlemeyi göstermezler; orada görünür ilerleme istiyorsanız iş parçacığı yanıtları veya `typingReaction` kullanın. +- Medya ve metin dışı payload'lar normal teslimata geri döner. +- Akış yanıtın ortasında başarısız olursa OpenClaw kalan payload'lar için normal teslimata geri döner. Slack yerel metin akışı yerine taslak önizleme kullanın: @@ -482,8 +484,10 @@ Slack yerel metin akışı yerine taslak önizleme kullanın: { channels: { slack: { - streaming: "partial", - nativeStreaming: false, + streaming: { + mode: "partial", + nativeTransport: false, + }, }, }, } @@ -491,12 +495,13 @@ Slack yerel metin akışı yerine taslak önizleme kullanın: Eski anahtarlar: -- `channels.slack.streamMode` (`replace | status_final | append`) otomatik olarak `channels.slack.streaming` değerine taşınır. -- boolean `channels.slack.streaming`, otomatik olarak `channels.slack.nativeStreaming` değerine taşınır. +- `channels.slack.streamMode` (`replace | status_final | append`) otomatik olarak `channels.slack.streaming.mode` değerine geçirilir. +- boolean `channels.slack.streaming`, otomatik olarak `channels.slack.streaming.mode` ve `channels.slack.streaming.nativeTransport` değerlerine geçirilir. +- eski `channels.slack.nativeStreaming`, otomatik olarak `channels.slack.streaming.nativeTransport` değerine geçirilir. -## Yazıyor reaksiyonu yedeği +## Yazıyor reaksiyonu geri dönüşü -`typingReaction`, OpenClaw bir yanıtı işlerken gelen Slack mesajına geçici bir reaksiyon ekler, ardından çalıştırma bittiğinde bunu kaldırır. Bu en çok, varsayılan "is typing..." durum göstergesini kullanan dizi yanıtları dışında faydalıdır. +`typingReaction`, OpenClaw bir yanıtı işlerken gelen Slack mesajına geçici bir reaksiyon ekler, ardından çalışma bittiğinde bunu kaldırır. Bu en çok, varsayılan `"is typing..."` durum göstergesini kullanan iş parçacığı yanıtları dışında yararlıdır. Çözümleme sırası: @@ -506,23 +511,23 @@ Eski anahtarlar: Notlar: - Slack kısa kodlar bekler (örneğin `"hourglass_flowing_sand"`). -- Reaksiyon en iyi çabayla uygulanır ve yanıt veya hata yolu tamamlandıktan sonra temizleme otomatik olarak denenir. +- Reaksiyon best-effort olarak uygulanır ve yanıt veya hata yolu tamamlandıktan sonra temizleme otomatik olarak denenir. -## Medya, parçalara ayırma ve teslimat +## Medya, parçalama ve teslimat - Slack dosya ekleri, Slack tarafından barındırılan özel URL'lerden (belirteç kimlik doğrulamalı istek akışı) indirilir ve alma başarılı olduğunda ve boyut sınırları izin verdiğinde medya deposuna yazılır. + Slack dosya ekleri, Slack tarafından barındırılan özel URL'lerden (token ile kimlik doğrulamalı istek akışı) indirilir ve getirme başarılı olduğunda ve boyut sınırları izin verdiğinde medya deposuna yazılır. - Çalışma zamanındaki gelen boyut sınırı, `channels.slack.mediaMaxMb` ile geçersiz kılınmadıkça varsayılan olarak `20MB` değeridir. + Çalışma zamanı gelen boyut üst sınırı, `channels.slack.mediaMaxMb` ile geçersiz kılınmadıkça varsayılan olarak `20MB` olur. - metin parçaları `channels.slack.textChunkLimit` kullanır (varsayılan 4000) - `channels.slack.chunkMode="newline"` paragraf öncelikli bölmeyi etkinleştirir - - dosya gönderimleri Slack yükleme API'lerini kullanır ve dizi yanıtlarını (`thread_ts`) içerebilir - - giden medya sınırı, yapılandırılmışsa `channels.slack.mediaMaxMb` değerini izler; aksi halde kanal gönderimleri medya işlem hattından MIME türü varsayılanlarını kullanır + - dosya gönderimleri Slack yükleme API'lerini kullanır ve iş parçacığı yanıtlarını (`thread_ts`) içerebilir + - giden medya üst sınırı, yapılandırılmışsa `channels.slack.mediaMaxMb` değerini izler; aksi halde kanal gönderimleri medya işlem hattındaki MIME türü varsayılanlarını kullanır @@ -531,26 +536,26 @@ Notlar: - DM'ler için `user:` - kanallar için `channel:` - Slack DM'leri, kullanıcı hedeflerine gönderim yapılırken Slack konuşma API'leri aracılığıyla açılır. + Slack DM'leri, kullanıcı hedeflerine gönderim yaparken Slack konuşma API'leri aracılığıyla açılır. ## Komutlar ve slash davranışı -- Yerel komut otomatik modu Slack için **kapalıdır** (`commands.native: "auto"` Slack yerel komutlarını etkinleştirmez). -- Yerel Slack komut işleyicilerini `channels.slack.commands.native: true` (veya genel `commands.native: true`) ile etkinleştirin. -- Yerel komutlar etkinleştirildiğinde, eşleşen slash komutlarını Slack'te (`/` adlarıyla) kaydedin; tek istisna: - - durum komutu için `/agentstatus` kaydedin (Slack `/status` komutunu ayırır) -- Yerel komutlar etkin değilse, `channels.slack.slashCommand` aracılığıyla tek bir yapılandırılmış slash komutu çalıştırabilirsiniz. -- Yerel argüman menüleri artık işleme stratejilerini uyarlıyor: +- Yerel komut otomatik modu Slack için **kapalıdır** (`commands.native: "auto"`, Slack yerel komutlarını etkinleştirmez). +- `channels.slack.commands.native: true` (veya genel `commands.native: true`) ile yerel Slack komut işleyicilerini etkinleştirin. +- Yerel komutlar etkinleştirildiğinde, eşleşen slash komutlarını Slack'te (`/` adları) kaydedin; bir istisna vardır: + - durum komutu için `/agentstatus` kaydedin (Slack `/status` değerini ayırır) +- Yerel komutlar etkin değilse, tek bir yapılandırılmış slash komutunu `channels.slack.slashCommand` aracılığıyla çalıştırabilirsiniz. +- Yerel arg menüleri artık oluşturma stratejilerini uyarlıyor: - 5 seçeneğe kadar: düğme blokları - 6-100 seçenek: statik seçim menüsü - 100'den fazla seçenek: etkileşim seçenek işleyicileri mevcut olduğunda eşzamansız seçenek filtrelemeli harici seçim - kodlanmış seçenek değerleri Slack sınırlarını aşarsa akış düğmelere geri döner -- Uzun seçenek yükleri için Slash komutu argüman menüleri, seçilen değeri göndermeden önce bir onay iletişim kutusu kullanır. +- Uzun seçenek payload'ları için Slash komutu argüman menüleri, seçilen değeri göndermeden önce bir onay iletişim kutusu kullanır. -Varsayılan slash komutu ayarları: +Varsayılan slash komut ayarları: - `enabled: false` - `name: "openclaw"` @@ -565,7 +570,7 @@ ve yine de komut yürütmesini hedef konuşma oturumuna göre yönlendirir (`Com ## Etkileşimli yanıtlar -Slack, ajan tarafından yazılmış etkileşimli yanıt denetimlerini işleyebilir, ancak bu özellik varsayılan olarak devre dışıdır. +Slack, ajan tarafından yazılmış etkileşimli yanıt denetimlerini oluşturabilir, ancak bu özellik varsayılan olarak devre dışıdır. Bunu genel olarak etkinleştirin: @@ -599,44 +604,44 @@ Veya yalnızca bir Slack hesabı için etkinleştirin: } ``` -Etkinleştirildiğinde, ajanlar yalnızca Slack'e özel yanıt yönergeleri üretebilir: +Etkinleştirildiğinde ajanlar yalnızca Slack'e özgü yanıt yönergeleri üretebilir: - `[[slack_buttons: Approve:approve, Reject:reject]]` - `[[slack_select: Choose a target | Canary:canary, Production:production]]` -Bu yönergeler Slack Block Kit içine derlenir ve tıklamaları veya seçimleri mevcut Slack etkileşim olay yolu üzerinden geri yönlendirir. +Bu yönergeler Slack Block Kit'e derlenir ve tıklamaları veya seçimleri mevcut Slack etkileşim olayı yolu üzerinden geri yönlendirir. Notlar: -- Bu, Slack'e özgü bir kullanıcı arayüzüdür. Diğer kanallar, Slack Block Kit yönergelerini kendi düğme sistemlerine çevirmez. -- Etkileşimli geri çağrı değerleri, ham ajan tarafından yazılmış değerler değil, OpenClaw tarafından oluşturulmuş opak belirteçlerdir. -- Üretilen etkileşimli bloklar Slack Block Kit sınırlarını aşarsa OpenClaw geçersiz bir blocks yükü göndermek yerine özgün metin yanıtına geri döner. +- Bu, Slack'e özgü bir kullanıcı arayüzüdür. Diğer kanallar Slack Block Kit yönergelerini kendi düğme sistemlerine çevirmez. +- Etkileşimli callback değerleri, ajan tarafından yazılmış ham değerler değil, OpenClaw tarafından üretilmiş opak token'lardır. +- Üretilen etkileşimli bloklar Slack Block Kit sınırlarını aşarsa OpenClaw geçersiz bir blocks payload'ı göndermek yerine özgün metin yanıtına geri döner. ## Slack'te exec onayları -Slack, Web UI veya terminale geri dönmek yerine, etkileşimli düğmeler ve etkileşimlerle yerel bir onay istemcisi olarak çalışabilir. +Slack, Web UI veya terminale geri dönmek yerine etkileşimli düğmeler ve etkileşimlerle yerel bir onay istemcisi olarak davranabilir. - Exec onayları, yerel DM/kanal yönlendirmesi için `channels.slack.execApprovals.*` kullanır. -- Eklenti onayları, istek zaten Slack'e ulaşıyorsa ve onay kimliği türü `plugin:` ise aynı Slack yerel düğme yüzeyi üzerinden yine çözülebilir. -- Onaylayıcı yetkilendirmesi yine de uygulanır: yalnızca onaylayıcı olarak tanımlanan kullanıcılar Slack üzerinden istekleri onaylayabilir veya reddedebilir. +- İstek zaten Slack'e geliyorsa ve onay kimliği türü `plugin:` ise, plugin onayları yine aynı Slack yerel düğme yüzeyi üzerinden çözümlenebilir. +- Onaylayıcı yetkilendirmesi yine uygulanır: yalnızca onaylayıcı olarak tanımlanan kullanıcılar Slack üzerinden istekleri onaylayabilir veya reddedebilir. Bu, diğer kanallarla aynı paylaşılan onay düğmesi yüzeyini kullanır. Slack uygulama ayarlarınızda `interactivity` etkinleştirildiğinde, onay istemleri doğrudan konuşma içinde Block Kit düğmeleri olarak işlenir. -Bu düğmeler mevcut olduğunda birincil onay kullanıcı deneyimi bunlar olur; OpenClaw, -araç sonucu sohbet onaylarının kullanılamadığını söylemediği veya tek yol manuel onay olmadığı sürece -yalnızca manuel bir `/approve` komutu eklemelidir. +Bu düğmeler mevcut olduğunda birincil onay kullanıcı deneyimi bunlardır; OpenClaw, +yalnızca araç sonucu sohbet onaylarının kullanılamadığını söylediğinde veya tek yol manuel onaysa +elle bir `/approve` komutu eklemelidir. Yapılandırma yolu: - `channels.slack.execApprovals.enabled` -- `channels.slack.execApprovals.approvers` (isteğe bağlı; mümkün olduğunda `commands.ownerAllowFrom` değerine geri döner) +- `channels.slack.execApprovals.approvers` (isteğe bağlıdır; mümkün olduğunda `commands.ownerAllowFrom` değerine geri döner) - `channels.slack.execApprovals.target` (`dm` | `channel` | `both`, varsayılan: `dm`) - `agentFilter`, `sessionFilter` -Slack, `enabled` ayarlanmamış veya `"auto"` olduğunda ve en az bir -onaylayıcı çözümlendiğinde yerel exec onaylarını otomatik etkinleştirir. Slack'i yerel onay istemcisi olarak açıkça devre dışı bırakmak için `enabled: false` ayarlayın. +`enabled` ayarsız veya `"auto"` olduğunda ve en az bir +onaylayıcı çözümlendiğinde Slack yerel exec onaylarını otomatik olarak etkinleştirir. Slack'i yerel bir onay istemcisi olarak açıkça devre dışı bırakmak için `enabled: false` ayarlayın. Onaylayıcılar çözümlendiğinde yerel onayları zorla açmak için `enabled: true` ayarlayın. -Açık Slack exec onay yapılandırması olmayan varsayılan davranış: +Açık Slack exec onay yapılandırması olmadan varsayılan davranış: ```json5 { @@ -646,8 +651,8 @@ Açık Slack exec onay yapılandırması olmayan varsayılan davranış: } ``` -Açık Slack yerel yapılandırması yalnızca onaylayıcıları geçersiz kılmak, filtre eklemek veya -kaynak sohbet teslimatına katılmak istediğinizde gerekir: +Açık Slack-yerel yapılandırma yalnızca onaylayıcıları geçersiz kılmak, filtre eklemek veya +kaynak sohbet teslimatını etkinleştirmek istediğinizde gerekir: ```json5 { @@ -663,45 +668,44 @@ kaynak sohbet teslimatına katılmak istediğinizde gerekir: } ``` -Paylaşılan `approvals.exec` yönlendirmesi ayrıdır. Bunu yalnızca exec onay istemleri ayrıca -başka sohbetlere veya açık bant dışı hedeflere yönlendirilmeliyse kullanın. Paylaşılan `approvals.plugin` yönlendirmesi de -ayrıdır; Slack yerel düğmeleri bu istekler zaten -Slack'e ulaşmışsa eklenti onaylarını yine çözebilir. +Paylaşılan `approvals.exec` iletimi ayrıdır. Bunu yalnızca exec onay istemlerinin ayrıca +diğer sohbetlere veya açık bant dışı hedeflere yönlendirilmesi gerekiyorsa kullanın. Paylaşılan `approvals.plugin` iletimi de ayrıdır; bu istekler zaten +Slack'e geliyorsa Slack yerel düğmeleri yine plugin onaylarını çözebilir. -Aynı sohbet içi `/approve`, komutları zaten destekleyen Slack kanalları ve DM'lerinde de çalışır. Tüm onay yönlendirme modeli için [Exec approvals](/tr/tools/exec-approvals) bölümüne bakın. +Aynı sohbette `/approve`, komutları zaten destekleyen Slack kanallarında ve DM'lerde de çalışır. Tam onay iletme modeli için bkz. [Exec approvals](/tr/tools/exec-approvals). ## Olaylar ve operasyonel davranış -- Mesaj düzenlemeleri/silmeleri/dizi yayınları sistem olaylarına eşlenir. +- Mesaj düzenlemeleri/silmeleri/iş parçacığı yayınları sistem olaylarına eşlenir. - Reaksiyon ekleme/kaldırma olayları sistem olaylarına eşlenir. - Üye katılma/ayrılma, kanal oluşturma/yeniden adlandırma ve sabitleme ekleme/kaldırma olayları sistem olaylarına eşlenir. - `channel_id_changed`, `configWrites` etkin olduğunda kanal yapılandırma anahtarlarını taşıyabilir. -- Kanal topic/purpose meta verisi güvenilmeyen bağlam olarak değerlendirilir ve yönlendirme bağlamına enjekte edilebilir. -- Dizi başlatıcısı ve ilk dizi geçmişi bağlam tohumlaması, uygun olduğunda yapılandırılmış gönderici izin listelerine göre filtrelenir. -- Blok eylemleri ve modal etkileşimler, zengin yük alanlarıyla yapılandırılmış `Slack interaction: ...` sistem olayları üretir: - - blok eylemleri: seçilen değerler, etiketler, seçici değerleri ve `workflow_*` meta verisi - - yönlendirilmiş kanal meta verisi ve form girdileriyle modal `view_submission` ve `view_closed` olayları +- Kanal konu/amaç meta verileri güvenilmeyen bağlam olarak değerlendirilir ve yönlendirme bağlamına enjekte edilebilir. +- İş parçacığı başlatıcı ve ilk iş parçacığı geçmişi bağlam tohumlama, uygun olduğunda yapılandırılmış gönderici izin listelerine göre filtrelenir. +- Blok eylemleri ve modal etkileşimler, zengin payload alanlarıyla yapılandırılmış `Slack interaction: ...` sistem olayları üretir: + - blok eylemleri: seçilen değerler, etiketler, picker değerleri ve `workflow_*` meta verileri + - yönlendirilmiş kanal meta verileri ve form girdileriyle modal `view_submission` ve `view_closed` olayları -## Yapılandırma başvurusu işaretçileri +## Yapılandırma referansı işaretçileri -Birincil başvuru: +Birincil referans: -- [Configuration reference - Slack](/tr/gateway/configuration-reference#slack) +- [Yapılandırma referansı - Slack](/tr/gateway/configuration-reference#slack) Yüksek sinyalli Slack alanları: - mod/kimlik doğrulama: `mode`, `botToken`, `appToken`, `signingSecret`, `webhookPath`, `accounts.*` - DM erişimi: `dm.enabled`, `dmPolicy`, `allowFrom` (eski: `dm.policy`, `dm.allowFrom`), `dm.groupEnabled`, `dm.groupChannels` - - uyumluluk anahtarı: `dangerouslyAllowNameMatching` (son çare; gerekmedikçe kapalı tutun) + - uyumluluk anahtarı: `dangerouslyAllowNameMatching` (acil durum; gerekmedikçe kapalı tutun) - kanal erişimi: `groupPolicy`, `channels.*`, `channels.*.users`, `channels.*.requireMention` - - dizi/geçmiş: `replyToMode`, `replyToModeByChatType`, `thread.*`, `historyLimit`, `dmHistoryLimit`, `dms.*.historyLimit` - - teslimat: `textChunkLimit`, `chunkMode`, `mediaMaxMb`, `streaming`, `nativeStreaming` + - iş parçacığı/geçmiş: `replyToMode`, `replyToModeByChatType`, `thread.*`, `historyLimit`, `dmHistoryLimit`, `dms.*.historyLimit` + - teslimat: `textChunkLimit`, `chunkMode`, `mediaMaxMb`, `streaming`, `streaming.nativeTransport` - işlemler/özellikler: `configWrites`, `commands.native`, `slashCommand.*`, `actions.*`, `userToken`, `userTokenReadOnly` ## Sorun giderme - Sırayla şunları kontrol edin: + Sırayla kontrol edin: - `groupPolicy` - kanal izin listesi (`channels.slack.channels`) @@ -731,26 +735,26 @@ openclaw pairing list slack - - Slack uygulama ayarlarında bot + uygulama belirteçlerini ve Socket Mode etkinliğini doğrulayın. + + Bot + uygulama token'larını ve Slack uygulama ayarlarındaki Socket Mode etkinliğini doğrulayın. `openclaw channels status --probe --json`, `botTokenStatus` veya - `appTokenStatus: "configured_unavailable"` gösteriyorsa, Slack hesabı + `appTokenStatus: "configured_unavailable"` gösteriyorsa Slack hesabı yapılandırılmıştır ancak mevcut çalışma zamanı SecretRef destekli değeri çözememiştir. - + Şunları doğrulayın: - signing secret - webhook yolu - - Slack Request URLs (Events + Interactivity + Slash Commands) - - HTTP hesap başına benzersiz `webhookPath` + - Slack Request URL'leri (Events + Interactivity + Slash Commands) + - HTTP hesabı başına benzersiz `webhookPath` Hesap anlık görüntülerinde `signingSecretStatus: "configured_unavailable"` - görünüyorsa, HTTP hesabı yapılandırılmıştır ancak mevcut çalışma zamanı + görünüyorsa HTTP hesabı yapılandırılmıştır ancak mevcut çalışma zamanı SecretRef destekli signing secret değerini çözememiştir. @@ -758,10 +762,10 @@ openclaw pairing list slack Neyi amaçladığınızı doğrulayın: - - Slack'te eşleşen slash komutları kaydedilmiş yerel komut modu (`channels.slack.commands.native: true`) + - Slack'te kayıtlı eşleşen slash komutlarıyla yerel komut modu (`channels.slack.commands.native: true`) - veya tek slash komutu modu (`channels.slack.slashCommand.enabled: true`) - Ayrıca `commands.useAccessGroups` ile kanal/kullanıcı izin listelerini de kontrol edin. + Ayrıca `commands.useAccessGroups` ve kanal/kullanıcı izin listelerini kontrol edin. diff --git a/docs/tr/concepts/memory.md b/docs/tr/concepts/memory.md index fe5d93c65..69da60346 100644 --- a/docs/tr/concepts/memory.md +++ b/docs/tr/concepts/memory.md @@ -1,104 +1,164 @@ --- read_when: - Belleğin nasıl çalıştığını anlamak istiyorsunuz - - Hangi bellek dosyalarına yazılması gerektiğini öğrenmek istiyorsunuz -summary: OpenClaw’un oturumlar arasında bir şeyleri nasıl hatırladığı + - Hangi bellek dosyalarını yazmanız gerektiğini öğrenmek istiyorsunuz +summary: OpenClaw'un oturumlar arasında şeyleri nasıl hatırladığı title: Belleğe Genel Bakış x-i18n: - generated_at: "2026-04-06T03:06:37Z" + generated_at: "2026-04-08T06:00:52Z" model: gpt-5.4 provider: openai - source_hash: d19d4fa9c4b3232b7a97f7a382311d2a375b562040de15e9fe4a0b1990b825e7 + source_hash: 3bb8552341b0b651609edaaae826a22fdc535d240aed4fad4af4b069454004af source_path: concepts/memory.md workflow: 15 --- # Belleğe Genel Bakış -OpenClaw, aracınızın çalışma alanında **düz Markdown dosyaları** yazarak bir şeyleri hatırlar. Model yalnızca diske kaydedilenleri "hatırlar" -- gizli durum yoktur. +OpenClaw, aracı workspace'inizde **düz Markdown dosyaları** yazarak şeyleri +hatırlar. Model yalnızca diske kaydedilenleri "hatırlar" -- gizli bir durum +yoktur. ## Nasıl çalışır Aracınızın bellekle ilgili üç dosyası vardır: -- **`MEMORY.md`** -- uzun vadeli bellek. Kalıcı gerçekler, tercihler ve kararlar. Her DM oturumunun başında yüklenir. -- **`memory/YYYY-MM-DD.md`** -- günlük notlar. Akan bağlam ve gözlemler. Bugünün ve dünkü notlar otomatik olarak yüklenir. -- **`DREAMS.md`** (deneysel, isteğe bağlı) -- insan incelemesi için Dream Diary ve dreaming sweep özetleri. +- **`MEMORY.md`** -- uzun vadeli bellek. Kalıcı gerçekler, tercihler ve + kararlar. Her DM oturumunun başında yüklenir. +- **`memory/YYYY-MM-DD.md`** -- günlük notlar. Devam eden bağlam ve gözlemler. + Bugünün ve dünkü notlar otomatik olarak yüklenir. +- **`DREAMS.md`** (deneysel, isteğe bağlı) -- insan incelemesi için Dream Diary + ve dreaming sweep özetleri. -Bu dosyalar araç çalışma alanında bulunur (varsayılan `~/.openclaw/workspace`). +Bu dosyalar aracının workspace'inde bulunur (varsayılan olarak `~/.openclaw/workspace`). -Aracınızın bir şeyi hatırlamasını istiyorsanız, ona söylemeniz yeterlidir: "TypeScript tercih ettiğimi hatırla." Uygun dosyaya yazacaktır. +Aracınızın bir şeyi hatırlamasını istiyorsanız, ona söylemeniz yeterlidir: "Benim +TypeScript'i tercih ettiğimi hatırla." Bunu uygun dosyaya yazar. ## Bellek araçları Aracının bellekle çalışmak için iki aracı vardır: -- **`memory_search`** -- ifade biçimi asılinden farklı olsa bile, anlamsal arama kullanarak ilgili notları bulur. +- **`memory_search`** -- ifade biçimi orijinalden farklı olsa bile, anlamsal + arama kullanarak ilgili notları bulur. - **`memory_get`** -- belirli bir bellek dosyasını veya satır aralığını okur. -Her iki araç da etkin bellek plugin’i tarafından sağlanır (varsayılan: `memory-core`). +Bu araçların ikisi de etkin bellek plugin'i tarafından sağlanır (varsayılan: `memory-core`). + +## Memory Wiki yardımcı plugin'i + +Kalıcı belleğin yalnızca ham notlar gibi değil, bakımı yapılan bir bilgi tabanı +gibi davranmasını istiyorsanız, paketle gelen `memory-wiki` plugin'ini kullanın. + +`memory-wiki`, kalıcı bilgiyi şu özelliklere sahip bir wiki kasasına derler: + +- deterministik sayfa yapısı +- yapılandırılmış iddialar ve kanıtlar +- çelişki ve güncellik takibi +- oluşturulmuş panolar +- agent/runtime tüketicileri için derlenmiş özetler +- `wiki_search`, `wiki_get`, `wiki_apply` ve `wiki_lint` gibi wiki'ye özgü araçlar + +Etkin bellek plugin'inin yerini almaz. Etkin bellek plugin'i hâlâ geri getirme, +yükseltme ve dreaming işlemlerine sahiptir. `memory-wiki`, bunun yanına +kaynak zenginliğine sahip bir bilgi katmanı ekler. + +Bkz. [Memory Wiki](/tr/plugins/memory-wiki). ## Bellek araması -Bir embedding sağlayıcısı yapılandırıldığında, `memory_search` **hibrit arama** kullanır -- vektör benzerliğini (anlamsal anlam) anahtar kelime eşleştirmesiyle (kimlikler ve kod sembolleri gibi tam terimler) birleştirir. Desteklenen herhangi bir sağlayıcı için bir API anahtarınız olduğunda bu özellik kutudan çıktığı gibi çalışır. +Bir embedding sağlayıcısı yapılandırıldığında, `memory_search` **hibrit +arama** kullanır -- vektör benzerliğini (anlamsal anlam) anahtar sözcük +eşleştirmesiyle (kimlikler ve kod sembolleri gibi tam terimler) birleştirir. +Desteklenen herhangi bir sağlayıcı için bir API anahtarınız olduğunda bu kutudan +çıktığı gibi çalışır. -OpenClaw, kullanılabilir API anahtarlarından embedding sağlayıcınızı otomatik algılar. Yapılandırılmış bir OpenAI, Gemini, Voyage veya Mistral anahtarınız varsa, bellek araması otomatik olarak etkinleştirilir. +OpenClaw, kullanılabilir API anahtarlarından embedding sağlayıcınızı otomatik +olarak algılar. Yapılandırılmış bir OpenAI, Gemini, Voyage veya Mistral +anahtarınız varsa, bellek araması otomatik olarak etkinleştirilir. -Aramanın nasıl çalıştığı, ince ayar seçenekleri ve sağlayıcı kurulumu hakkında ayrıntılar için bkz. [Bellek Araması](/tr/concepts/memory-search). +Aramanın nasıl çalıştığı, ayarlama seçenekleri ve sağlayıcı kurulumu hakkında +ayrıntılar için bkz. [Memory Search](/tr/concepts/memory-search). ## Bellek arka uçları -SQLite tabanlıdır. Anahtar kelime araması, vektör benzerliği ve hibrit arama ile kutudan çıktığı gibi çalışır. Ek bağımlılık yoktur. +SQLite tabanlıdır. Anahtar sözcük araması, vektör benzerliği ve hibrit arama ile +kutudan çıktığı gibi çalışır. Ek bağımlılık gerekmez. -Yeniden sıralama, sorgu genişletme ve çalışma alanı dışındaki dizinleri indeksleme yeteneğine sahip local-first yan hizmet. +Yeniden sıralama, sorgu genişletme ve workspace dışındaki dizinleri +indeksleyebilme yeteneğine sahip local-first sidecar. -Kullanıcı modelleme, anlamsal arama ve çok aracılı farkındalık ile AI-native oturumlar arası bellek. Plugin kurulumu gerekir. +Kullanıcı modelleme, anlamsal arama ve çoklu agent farkındalığı ile AI-native +oturumlar arası bellek. Plugin kurulumu. -## Otomatik bellek flush +## Bilgi wiki katmanı -[Compaction](/tr/concepts/compaction) konuşmanızı özetlemeden önce, OpenClaw araca önemli bağlamı bellek dosyalarına kaydetmesini hatırlatan sessiz bir tur çalıştırır. Bu varsayılan olarak açıktır -- herhangi bir şey yapılandırmanız gerekmez. + + +Kalıcı belleği iddialar, panolar, köprü modu ve Obsidian uyumlu iş akışlarıyla +kaynak zenginliğine sahip bir wiki kasasına derler. + + + +## Otomatik bellek boşaltma + +[Compaction](/tr/concepts/compaction) konuşmanızı özetlemeden önce, OpenClaw +aracıya önemli bağlamı bellek dosyalarına kaydetmesini hatırlatan sessiz bir tur +çalıştırır. Bu varsayılan olarak açıktır -- herhangi bir şeyi yapılandırmanız +gerekmez. -Bellek flush, sıkıştırma sırasında bağlam kaybını önler. Konuşmada henüz bir dosyaya yazılmamış önemli gerçekler varsa, özetleme gerçekleşmeden önce otomatik olarak kaydedilirler. +Bellek boşaltma, compaction sırasında bağlam kaybını önler. Aracınızın +konuşmada henüz bir dosyaya yazılmamış önemli gerçekleri varsa, özetleme +gerçekleşmeden önce bunlar otomatik olarak kaydedilir. ## Dreaming (deneysel) -Dreaming, bellek için isteğe bağlı bir arka plan pekiştirme geçişidir. Kısa vadeli sinyalleri toplar, adayları puanlar ve yalnızca uygun öğeleri uzun vadeli belleğe (`MEMORY.md`) yükseltir. +Dreaming, bellek için isteğe bağlı bir arka plan pekiştirme geçişidir. Kısa +vadeli sinyalleri toplar, adayları puanlar ve yalnızca uygun öğeleri uzun +vadeli belleğe (`MEMORY.md`) yükseltir. Uzun vadeli belleği yüksek sinyalli tutmak için tasarlanmıştır: - **İsteğe bağlı**: varsayılan olarak devre dışıdır. -- **Zamanlanmış**: etkinleştirildiğinde `memory-core`, tam bir dreaming sweep için yinelenen bir cron işini otomatik olarak yönetir. -- **Eşikli**: yükseltmelerin puan, hatırlama sıklığı ve sorgu çeşitliliği kapılarını geçmesi gerekir. -- **İncelenebilir**: aşama özetleri ve günlük girdileri insan incelemesi için `DREAMS.md` dosyasına yazılır. +- **Zamanlanmış**: etkinleştirildiğinde, `memory-core` bir tam dreaming sweep'i + için yinelenen bir cron işini otomatik olarak yönetir. +- **Eşikli**: yükseltmelerin puan, geri çağırma sıklığı ve sorgu çeşitliliği + geçitlerini geçmesi gerekir. +- **İncelenebilir**: aşama özetleri ve günlük girdileri insan incelemesi için + `DREAMS.md` dosyasına yazılır. -Aşama davranışı, puanlama sinyalleri ve Dream Diary ayrıntıları için bkz. [Dreaming (deneysel)](/concepts/dreaming). +Aşama davranışı, puanlama sinyalleri ve Dream Diary ayrıntıları için bkz. +[Dreaming (experimental)](/tr/concepts/dreaming). ## CLI ```bash -openclaw memory status # İndeks durumunu ve sağlayıcıyı kontrol et -openclaw memory search "query" # Komut satırından ara -openclaw memory index --force # İndeksi yeniden oluştur +openclaw memory status # Dizin durumunu ve sağlayıcıyı kontrol edin +openclaw memory search "query" # Komut satırından arama yapın +openclaw memory index --force # Dizini yeniden oluşturun ``` -## Daha fazla okuma +## İleri okuma - [Builtin Memory Engine](/tr/concepts/memory-builtin) -- varsayılan SQLite arka ucu -- [QMD Memory Engine](/tr/concepts/memory-qmd) -- gelişmiş local-first yan hizmet +- [QMD Memory Engine](/tr/concepts/memory-qmd) -- gelişmiş local-first sidecar - [Honcho Memory](/tr/concepts/memory-honcho) -- AI-native oturumlar arası bellek -- [Memory Search](/tr/concepts/memory-search) -- arama işlem hattı, sağlayıcılar ve ince ayar -- [Dreaming (experimental)](/concepts/dreaming) -- kısa vadeli hatırlamadan uzun vadeli belleğe arka plan yükseltme -- [Memory configuration reference](/tr/reference/memory-config) -- tüm yapılandırma ayarları -- [Compaction](/tr/concepts/compaction) -- sıkıştırmanın bellekle nasıl etkileşime girdiği +- [Memory Wiki](/tr/plugins/memory-wiki) -- derlenmiş bilgi kasası ve wiki'ye özgü araçlar +- [Memory Search](/tr/concepts/memory-search) -- arama işlem hattı, sağlayıcılar ve + ayarlama +- [Dreaming (experimental)](/tr/concepts/dreaming) -- kısa vadeli geri çağırmadan + uzun vadeli belleğe arka plan yükseltmesi +- [Bellek yapılandırma başvurusu](/tr/reference/memory-config) -- tüm yapılandırma seçenekleri +- [Compaction](/tr/concepts/compaction) -- compaction'ın bellekle nasıl etkileşime girdiği diff --git a/docs/tr/concepts/model-providers.md b/docs/tr/concepts/model-providers.md index e670f32c9..485add388 100644 --- a/docs/tr/concepts/model-providers.md +++ b/docs/tr/concepts/model-providers.md @@ -1,14 +1,14 @@ --- read_when: - - Sağlayıcı bazında model kurulum başvurusu gerektiğinde - - Model sağlayıcıları için örnek yapılandırmalar veya CLI onboarding komutları istediğinizde + - Sağlayıcı bazında model kurulumu için bir başvuruya ihtiyacınız var + - Model sağlayıcıları için örnek yapılandırmalar veya CLI ilk kurulum komutları istiyorsunuz summary: Örnek yapılandırmalar ve CLI akışlarıyla model sağlayıcısı genel bakışı title: Model Sağlayıcıları x-i18n: - generated_at: "2026-04-08T02:15:45Z" + generated_at: "2026-04-08T06:02:33Z" model: gpt-5.4 provider: openai - source_hash: 26b36a2bc19a28a7ef39aa8e81a0050fea1d452ac4969122e5cdf8755e690258 + source_hash: 558ac9e34b67fcc3dd6791a01bebc17e1c34152fa6c5611593d681e8cfa532d9 source_path: concepts/model-providers.md workflow: 15 --- @@ -16,25 +16,24 @@ x-i18n: # Model sağlayıcıları Bu sayfa **LLM/model sağlayıcılarını** kapsar (WhatsApp/Telegram gibi sohbet kanalları değil). -Model seçim kuralları için bkz. [/concepts/models](/tr/concepts/models). +Model seçimi kuralları için bkz. [/concepts/models](/tr/concepts/models). ## Hızlı kurallar - Model başvuruları `provider/model` kullanır (örnek: `opencode/claude-opus-4-6`). -- `agents.defaults.models` ayarlarsanız bu allowlist olur. +- `agents.defaults.models` ayarlarsanız, bu allowlist olur. - CLI yardımcıları: `openclaw onboard`, `openclaw models list`, `openclaw models set `. -- Yedek çalışma zamanı kuralları, cooldown propları ve oturum geçersiz kılma kalıcılığı +- Geri dönüş çalışma zamanı kuralları, cooldown probları ve oturum geçersiz kılma kalıcılığı [/concepts/model-failover](/tr/concepts/model-failover) içinde belgelenmiştir. - `models.providers.*.models[].contextWindow` yerel model meta verisidir; - `models.providers.*.models[].contextTokens` etkin çalışma zamanı sınırıdır. -- Sağlayıcı plugin’leri `registerProvider({ catalog })` aracılığıyla model katalogları ekleyebilir; - OpenClaw bu çıktıyı `models.providers` içine birleştirir ve ardından - `models.json` yazar. -- Sağlayıcı manifest’leri `providerAuthEnvVars` bildirebilir; böylece genel env tabanlı - kimlik doğrulama yoklamalarının plugin çalışma zamanını yüklemesi gerekmez. Kalan çekirdek env-var - eşlemesi artık yalnızca plugin olmayan/çekirdek sağlayıcılar ve Anthropic için API-key-first onboarding gibi + `models.providers.*.models[].contextTokens` ise etkili çalışma zamanı sınırıdır. +- Sağlayıcı eklentileri `registerProvider({ catalog })` aracılığıyla model katalogları ekleyebilir; + OpenClaw, `models.json` yazılmadan önce bu çıktıyı `models.providers` içine birleştirir. +- Sağlayıcı manifest dosyaları `providerAuthEnvVars` bildirebilir; böylece genel env tabanlı + kimlik doğrulama problarının eklenti çalışma zamanını yüklemesi gerekmez. Kalan çekirdek env-var + haritası artık yalnızca eklenti olmayan/çekirdek sağlayıcılar ve Anthropic API-key-first ilk kurulum gibi birkaç genel öncelik durumu içindir. -- Sağlayıcı plugin’leri ayrıca +- Sağlayıcı eklentileri ayrıca sağlayıcı çalışma zamanı davranışını da şu yollarla sahiplenebilir: `normalizeModelId`, `normalizeTransport`, `normalizeConfig`, `applyNativeStreamingUsageCompat`, `resolveConfigApiKey`, `resolveSyntheticAuth`, `shouldDeferSyntheticProfileAuth`, @@ -51,216 +50,209 @@ Model seçim kuralları için bkz. [/concepts/models](/tr/concepts/models). `augmentModelCatalog`, `isBinaryThinking`, `supportsXHighThinking`, `resolveDefaultThinkingLevel`, `applyConfigDefaults`, `isModernModelRef`, `prepareRuntimeAuth`, `resolveUsageAuth`, `fetchUsageSnapshot` ve - `onModelSelected` aracılığıyla sağlayıcı çalışma zamanı davranışını sahiplenebilir. + `onModelSelected`. - Not: sağlayıcı çalışma zamanı `capabilities`, paylaşılan çalıştırıcı meta verisidir (sağlayıcı - ailesi, transkript/araç farklılıkları, taşıma/önbellek ipuçları). Bu, - bir plugin’in ne kaydettiğini açıklayan - [genel capability modeli](/tr/plugins/architecture#public-capability-model) + ailesi, transcript/tooling özellikleri, transport/cache ipuçları). Bu, + bir eklentinin ne kaydettiğini açıklayan [public capability model](/tr/plugins/architecture#public-capability-model) ile aynı şey değildir (metin çıkarımı, konuşma vb.). -## Plugin’e ait sağlayıcı davranışı +## Eklenti sahipliğinde sağlayıcı davranışı -Sağlayıcı plugin’leri artık sağlayıcıya özgü mantığın çoğunu sahiplenebilirken OpenClaw -genel çıkarım döngüsünü korur. +Sağlayıcı eklentileri artık OpenClaw genel çıkarım döngüsünü korurken +sağlayıcıya özgü mantığın çoğunu sahiplenebilir. Tipik ayrım: -- `auth[].run` / `auth[].runNonInteractive`: sağlayıcı, - `openclaw onboard`, `openclaw models auth` ve başsız kurulum için onboarding/login +- `auth[].run` / `auth[].runNonInteractive`: sağlayıcı, `openclaw onboard`, `openclaw models auth` ve başsız kurulum için ilk kurulum/giriş akışlarını sahiplenir - `wizard.setup` / `wizard.modelPicker`: sağlayıcı, auth-choice etiketlerini, - eski takma adları, onboarding allowlist ipuçlarını ve onboarding/model seçimlerinde - kurulum girişlerini sahiplenir + eski takma adları, ilk kurulum allowlist ipuçlarını ve ilk kurulum/model seçicilerindeki kurulum girdilerini sahiplenir - `catalog`: sağlayıcı `models.providers` içinde görünür -- `normalizeModelId`: sağlayıcı, arama veya kanonikleştirme öncesinde eski/önizleme model kimliklerini - normalize eder -- `normalizeTransport`: sağlayıcı, genel model derlemesi öncesinde taşıma ailesi `api` / `baseUrl` değerlerini - normalize eder; OpenClaw önce eşleşen sağlayıcıyı, - sonra gerçekten taşıma üzerinde değişiklik yapana kadar diğer hook destekli sağlayıcı plugin’lerini - denetler +- `normalizeModelId`: sağlayıcı, arama veya kanonikleştirme öncesinde eski/önizleme model kimliklerini normalleştirir +- `normalizeTransport`: sağlayıcı, genel model birleştirmesinden önce transport-family `api` / `baseUrl` + değerlerini normalleştirir; OpenClaw önce eşleşen sağlayıcıyı, + ardından transport'u gerçekten değiştiren bir tane bulunana kadar kanca yetenekli diğer sağlayıcı eklentilerini kontrol eder - `normalizeConfig`: sağlayıcı, çalışma zamanı kullanmadan önce `models.providers.` yapılandırmasını - normalize eder; OpenClaw önce eşleşen sağlayıcıyı, - sonra gerçekten yapılandırmayı değiştirene kadar diğer hook destekli sağlayıcı plugin’lerini - denetler. Hiçbir sağlayıcı hook’u yapılandırmayı yeniden yazmazsa, paketlenmiş Google ailesi yardımcıları - desteklenen Google sağlayıcı girdilerini yine de normalize eder. -- `applyNativeStreamingUsageCompat`: sağlayıcı, yapılandırma sağlayıcıları için uç nokta odaklı yerel akış-kullanım uyumluluk yeniden yazımlarını uygular -- `resolveConfigApiKey`: sağlayıcı, yapılandırma sağlayıcıları için tam çalışma zamanı auth yüklemesini zorlamadan - env-marker auth çözümler. Bedrock çalışma zamanı auth’u - AWS SDK varsayılan zincirini kullansa da `amazon-bedrock` burada ayrıca - yerleşik bir AWS env-marker çözücüsüne sahiptir. -- `resolveSyntheticAuth`: sağlayıcı, düz metin gizli anahtarları kalıcılaştırmadan - local/self-hosted veya diğer yapılandırma destekli auth kullanılabilirliğini ortaya çıkarabilir + normalleştirir; OpenClaw önce eşleşen sağlayıcıyı, ardından + yapılandırmayı gerçekten değiştiren bir tane bulunana kadar kanca yetenekli diğer sağlayıcı eklentilerini kontrol eder. Eğer hiçbir + sağlayıcı kancası yapılandırmayı yeniden yazmazsa, paketlenmiş Google ailesi yardımcıları + desteklenen Google sağlayıcı girdilerini yine de normalleştirir. +- `applyNativeStreamingUsageCompat`: sağlayıcı, yapılandırma sağlayıcıları için endpoint kaynaklı yerel streaming-usage uyumluluk yeniden yazımlarını uygular +- `resolveConfigApiKey`: sağlayıcı, tam çalışma zamanı auth yüklemesini zorlamadan yapılandırma sağlayıcıları için env-marker auth'u çözümler. + `amazon-bedrock` ayrıca burada yerleşik bir AWS env-marker çözücüsüne sahiptir; Bedrock çalışma zamanı auth'u + AWS SDK varsayılan zincirini kullanmasına rağmen. +- `resolveSyntheticAuth`: sağlayıcı, düz metin sırları kalıcı hale getirmeden yerel/self-hosted veya + diğer yapılandırma destekli auth kullanılabilirliğini gösterebilir - `shouldDeferSyntheticProfileAuth`: sağlayıcı, depolanmış sentetik profil - yer tutucularını env/config destekli auth’tan daha düşük öncelikli olarak işaretleyebilir + yer tutucularını env/config destekli auth'tan daha düşük öncelikli olarak işaretleyebilir - `resolveDynamicModel`: sağlayıcı, henüz yerel statik katalogda bulunmayan model kimliklerini kabul eder -- `prepareDynamicModel`: sağlayıcı, dinamik çözümlemeyi yeniden denemeden önce meta veri yenilemesine ihtiyaç duyar -- `normalizeResolvedModel`: sağlayıcı, taşıma veya base URL yeniden yazımlarına ihtiyaç duyar -- `contributeResolvedModelCompat`: sağlayıcı, başka bir uyumlu taşıma üzerinden gelseler bile - kendi satıcı modelleri için uyumluluk bayrakları sağlar -- `capabilities`: sağlayıcı, transkript/araçlama/sağlayıcı ailesi farklılıklarını yayımlar -- `normalizeToolSchemas`: sağlayıcı, gömülü çalıştırıcı onları görmeden önce araç şemalarını temizler -- `inspectToolSchemas`: sağlayıcı, normalleştirme sonrasında taşıma türüne özgü şema uyarılarını yüzeye çıkarır -- `resolveReasoningOutputMode`: sağlayıcı, yerel ve etiketli - reasoning-output sözleşmeleri arasında seçim yapar -- `prepareExtraParams`: sağlayıcı, model başına istek parametreleri için varsayılanları uygular veya normalize eder -- `createStreamFn`: sağlayıcı, normal akış yolunu tamamen - özel bir taşıma ile değiştirir -- `wrapStreamFn`: sağlayıcı, istek üstbilgisi/gövdesi/model uyumluluk sarmalayıcıları uygular -- `resolveTransportTurnState`: sağlayıcı, tur başına yerel taşıma - üstbilgileri veya meta verileri sağlar -- `resolveWebSocketSessionPolicy`: sağlayıcı, yerel WebSocket oturumu - üstbilgileri veya oturum cool-down politikasını sağlar -- `createEmbeddingProvider`: provider plugin’i yerine çekirdek embedding switchboard’a değil, - sağlayıcı plugin’ine ait olduğunda bellek embedding davranışını sağlayıcı sahiplenir -- `formatApiKey`: sağlayıcı, depolanmış auth profillerini taşımanın beklediği - çalışma zamanı `apiKey` dizesine biçimlendirir +- `prepareDynamicModel`: sağlayıcının, dinamik çözümlemeyi yeniden denemeden önce meta veri yenilemesine ihtiyacı vardır +- `normalizeResolvedModel`: sağlayıcının transport veya temel URL yeniden yazımlarına ihtiyacı vardır +- `contributeResolvedModelCompat`: sağlayıcı, sağlayıcıya ait modeller başka bir uyumlu transport üzerinden + gelse bile onlar için compat bayrakları ekler +- `capabilities`: sağlayıcı transcript/tooling/provider-family özelliklerini yayımlar +- `normalizeToolSchemas`: sağlayıcı, gömülü çalıştırıcı bunları görmeden önce araç şemalarını temizler +- `inspectToolSchemas`: sağlayıcı, normalleştirmeden sonra transport'a özgü şema uyarılarını ortaya çıkarır +- `resolveReasoningOutputMode`: sağlayıcı, yerel veya etiketli reasoning-output sözleşmelerini seçer +- `prepareExtraParams`: sağlayıcı, model başına istek parametreleri için varsayılanları ayarlar veya normalleştirir +- `createStreamFn`: sağlayıcı, normal akış yolunu tamamen özel bir transport ile değiştirir +- `wrapStreamFn`: sağlayıcı, istek başlık/gövde/model compat sarmalayıcıları uygular +- `resolveTransportTurnState`: sağlayıcı, tur başına yerel transport + başlıkları veya meta verisi sağlar +- `resolveWebSocketSessionPolicy`: sağlayıcı, yerel WebSocket oturum + başlıkları veya oturum cool-down ilkesi sağlar +- `createEmbeddingProvider`: sağlayıcı, çekirdek embedding anahtarlayıcısı yerine + sağlayıcı eklentisiyle birlikte olması gerektiğinde bellek embedding davranışını sahiplenir +- `formatApiKey`: sağlayıcı, depolanmış auth profillerini transport'un beklediği çalışma zamanı + `apiKey` dizesi biçimine dönüştürür - `refreshOAuth`: sağlayıcı, paylaşılan `pi-ai` yenileyiciler yeterli olmadığında OAuth yenilemeyi sahiplenir - `buildAuthDoctorHint`: sağlayıcı, OAuth yenileme başarısız olduğunda onarım rehberliği ekler - `matchesContextOverflowError`: sağlayıcı, genel sezgilerin kaçıracağı sağlayıcıya özgü context-window taşma hatalarını tanır -- `classifyFailoverReason`: sağlayıcı, sağlayıcıya özgü ham taşıma/API - hatalarını hız sınırı veya aşırı yük gibi failover nedenlerine eşler -- `isCacheTtlEligible`: sağlayıcı, hangi yukarı akış model kimliklerinin prompt-cache TTL desteklediğine karar verir +- `classifyFailoverReason`: sağlayıcı, sağlayıcıya özgü ham transport/API + hatalarını rate limit veya overload gibi geri dönüş nedenlerine eşler +- `isCacheTtlEligible`: sağlayıcı, hangi upstream model kimliklerinin prompt-cache TTL'yi desteklediğine karar verir - `buildMissingAuthMessage`: sağlayıcı, genel auth-store hatasını sağlayıcıya özgü bir kurtarma ipucuyla değiştirir -- `suppressBuiltInModel`: sağlayıcı, eski yukarı akış satırlarını gizler ve doğrudan çözümleme başarısızlıkları için - satıcıya ait bir hata döndürebilir +- `suppressBuiltInModel`: sağlayıcı, eski upstream satırlarını gizler ve doğrudan çözümleme başarısızlıkları için + sağlayıcıya ait bir hata döndürebilir - `augmentModelCatalog`: sağlayıcı, keşif ve yapılandırma birleştirmesinden sonra sentetik/nihai katalog satırları ekler -- `isBinaryThinking`: sağlayıcı, ikili açık/kapalı düşünme UX’ini sahiplenir +- `isBinaryThinking`: sağlayıcı, ikili açık/kapalı düşünme UX'ini sahiplenir - `supportsXHighThinking`: sağlayıcı, seçili modelleri `xhigh` içine alır -- `resolveDefaultThinkingLevel`: sağlayıcı, bir model ailesi için varsayılan `/think` politikasını sahiplenir +- `resolveDefaultThinkingLevel`: sağlayıcı, bir model ailesi için varsayılan `/think` ilkesini sahiplenir - `applyConfigDefaults`: sağlayıcı, auth modu, env veya model ailesine göre - yapılandırma materyalizasyonu sırasında sağlayıcıya özgü genel varsayılanlar uygular + yapılandırma somutlaştırması sırasında sağlayıcıya özgü genel varsayılanları uygular - `isModernModelRef`: sağlayıcı, live/smoke tercih edilen model eşleştirmesini sahiplenir - `prepareRuntimeAuth`: sağlayıcı, yapılandırılmış bir kimlik bilgisini kısa ömürlü bir çalışma zamanı belirtecine dönüştürür - `resolveUsageAuth`: sağlayıcı, `/usage` - ve ilgili durum/raporlama yüzeyleri için kullanım/kota kimlik bilgilerini çözer -- `fetchUsageSnapshot`: sağlayıcı, kullanım uç noktası alma/ayrıştırma işini sahiplenirken - çekirdek yine özet kabuğunu ve biçimlendirmeyi sahiplenir -- `onModelSelected`: sağlayıcı, telemetri veya sağlayıcıya ait oturum kayıt tutma gibi + ve ilgili durum/raporlama yüzeyleri için kullanım/kota kimlik bilgilerini çözümler +- `fetchUsageSnapshot`: sağlayıcı, kullanım endpoint'inin getirilmesini/ayrıştırılmasını sahiplenirken + çekirdek özet kabuğu ve biçimlendirmeyi sahiplenmeye devam eder +- `onModelSelected`: sağlayıcı, telemetri veya sağlayıcıya ait oturum kayıt işlemleri gibi seçim sonrası yan etkileri çalıştırır Mevcut paketlenmiş örnekler: -- `anthropic`: Claude 4.6 ileri uyumluluk geri dönüşü, auth onarım ipuçları, kullanım - uç noktası alma, cache-TTL/sağlayıcı ailesi meta verisi ve auth farkındalıklı genel +- `anthropic`: Claude 4.6 ileriye dönük uyumlu geri dönüş, auth onarım ipuçları, kullanım + endpoint getirme, cache-TTL/provider-family meta verisi ve auth farkındalığına sahip genel yapılandırma varsayılanları -- `amazon-bedrock`: Bedrock’a özgü throttle/not-ready hataları için sağlayıcıya ait context-overflow eşleştirme ve failover - neden sınıflandırması; ayrıca Anthropic trafiğindeki yalnızca-Claude replay-policy +- `amazon-bedrock`: Bedrock'a özgü throttle/not-ready hataları için sağlayıcı sahipliğinde context-overflow eşleştirmesi ve failover + nedeni sınıflandırması, ayrıca Anthropic trafiğinde Claude'a özel replay-policy korumaları için paylaşılan `anthropic-by-model` replay ailesi - `anthropic-vertex`: Anthropic-message - trafiği için yalnızca-Claude replay-policy korumaları + trafiğinde Claude'a özel replay-policy korumaları - `openrouter`: doğrudan model kimlikleri, istek sarmalayıcıları, sağlayıcı capability ipuçları, proxy Gemini trafiğinde Gemini thought-signature temizleme, `openrouter-thinking` akış ailesi üzerinden proxy reasoning ekleme, yönlendirme - meta verisi iletimi ve cache-TTL politikası -- `github-copilot`: onboarding/device login, ileri uyumluluk model geri dönüşü, - Claude-thinking transkript ipuçları, çalışma zamanı token değişimi ve kullanım uç noktası - alma -- `openai`: GPT-5.4 ileri uyumluluk geri dönüşü, doğrudan OpenAI taşıma - normalizasyonu, Codex farkındalıklı eksik auth ipuçları, Spark gizleme, sentetik - OpenAI/Codex katalog satırları, thinking/live-model politikası, kullanım token takma ad + meta verisi iletme ve cache-TTL ilkesi +- `github-copilot`: ilk kurulum/cihaz girişi, ileriye dönük uyumlu model geri dönüşü, + Claude-thinking transcript ipuçları, çalışma zamanı token değişimi ve kullanım endpoint'i + getirme +- `openai`: GPT-5.4 ileriye dönük uyumlu geri dönüş, doğrudan OpenAI transport + normalizasyonu, Codex farkındalığına sahip eksik auth ipuçları, Spark bastırma, sentetik + OpenAI/Codex katalog satırları, thinking/live-model ilkesi, kullanım belirteci takma adı normalizasyonu (`input` / `output` ve `prompt` / `completion` aileleri), yerel OpenAI/Codex - sarmalayıcıları için paylaşılan `openai-responses-defaults` akış ailesi, sağlayıcı ailesi - meta verisi, `gpt-image-1` için paketlenmiş görüntü oluşturma sağlayıcısı + sarmalayıcıları için paylaşılan `openai-responses-defaults` akış ailesi, + provider-family meta verisi, `gpt-image-1` için paketlenmiş görüntü oluşturma sağlayıcısı kaydı ve `sora-2` için paketlenmiş video oluşturma sağlayıcısı kaydı -- `google` ve `google-gemini-cli`: Gemini 3.1 ileri uyumluluk geri dönüşü, - yerel Gemini replay doğrulaması, bootstrap replay temizliği, etiketli - reasoning-output modu, modern model eşleştirmesi, Gemini image-preview modelleri için paketlenmiş görüntü oluşturma +- `google` ve `google-gemini-cli`: Gemini 3.1 ileriye dönük uyumlu geri dönüş, + yerel Gemini replay doğrulaması, bootstrap replay temizleme, etiketli + reasoning-output modu, modern-model eşleştirme, Gemini image-preview modelleri için paketlenmiş görüntü oluşturma sağlayıcısı kaydı ve Veo modelleri için paketlenmiş video oluşturma sağlayıcısı kaydı; Gemini CLI OAuth ayrıca - auth-profile token biçimlendirmesi, usage-token ayrıştırması ve kullanım yüzeyleri için kota uç noktası - alımını da sahiplenir -- `moonshot`: paylaşılan taşıma, plugin’e ait thinking payload normalizasyonu -- `kilocode`: paylaşılan taşıma, plugin’e ait istek üstbilgileri, reasoning payload - normalizasyonu, proxy-Gemini thought-signature temizliği ve cache-TTL - politikası -- `zai`: GLM-5 ileri uyumluluk geri dönüşü, `tool_stream` varsayılanları, cache-TTL - politikası, binary-thinking/live-model politikası ve kullanım auth + kota alımı; - bilinmeyen `glm-5*` kimlikleri, paketlenmiş `glm-4.7` şablonundan sentezlenir -- `xai`: yerel Responses taşıma normalizasyonu, Grok hızlı varyantları için - `/fast` takma ad yeniden yazımları, varsayılan `tool_stream`, xAI’ye özgü tool-schema / + kullanım yüzeyleri için auth-profile token biçimlendirmesi, usage-token ayrıştırması ve kota endpoint'i + getirmeyi de sahiplenir +- `moonshot`: paylaşılan transport, eklenti sahipliğinde thinking payload normalizasyonu +- `kilocode`: paylaşılan transport, eklenti sahipliğinde istek başlıkları, reasoning payload + normalizasyonu, proxy-Gemini thought-signature temizleme ve cache-TTL + ilkesi +- `zai`: GLM-5 ileriye dönük uyumlu geri dönüş, `tool_stream` varsayılanları, cache-TTL + ilkesi, binary-thinking/live-model ilkesi ve kullanım auth + kota getirme; + bilinmeyen `glm-5*` kimlikleri, paketlenmiş `glm-4.7` şablonundan sentetik olarak üretilir +- `xai`: yerel Responses transport normalizasyonu, Grok hızlı varyantları için `/fast` takma ad yeniden yazımları, + varsayılan `tool_stream`, xAI'ye özgü tool-schema / reasoning-payload temizliği ve `grok-imagine-video` için paketlenmiş video oluşturma sağlayıcısı kaydı -- `mistral`: plugin’e ait capability meta verisi -- `opencode` ve `opencode-go`: plugin’e ait capability meta verisi ile birlikte - proxy-Gemini thought-signature temizliği -- `alibaba`: `alibaba/wan2.6-t2v` gibi doğrudan Wan model başvuruları için - plugin’e ait video oluşturma kataloğu -- `byteplus`: plugin’e ait kataloglar ve Seedance text-to-video/image-to-video modelleri için - paketlenmiş video oluşturma sağlayıcısı kaydı -- `fal`: FLUX görüntü modelleri için barındırılan üçüncü taraf görüntü oluşturma sağlayıcısı kaydı ve - barındırılan üçüncü taraf video modelleri için paketlenmiş +- `mistral`: eklenti sahipliğinde capability meta verisi +- `opencode` ve `opencode-go`: eklenti sahipliğinde capability meta verisi ve ayrıca + proxy-Gemini thought-signature temizleme +- `alibaba`: `alibaba/wan2.6-t2v` gibi doğrudan Wan model başvuruları için eklenti sahipliğinde video oluşturma kataloğu +- `byteplus`: eklenti sahipliğinde kataloglar ve ayrıca Seedance text-to-video/image-to-video modelleri için paketlenmiş video oluşturma sağlayıcısı + kaydı +- `fal`: barındırılan üçüncü taraf görüntü oluşturma sağlayıcısı + kaydı ile FLUX görüntü modelleri için birlikte, ayrıca barındırılan üçüncü taraf video modelleri için paketlenmiş video oluşturma sağlayıcısı kaydı - `cloudflare-ai-gateway`, `huggingface`, `kimi`, `nvidia`, `qianfan`, `stepfun`, `synthetic`, `venice`, `vercel-ai-gateway` ve `volcengine`: - yalnızca plugin’e ait kataloglar -- `qwen`: metin modelleri için plugin’e ait kataloglar ile birlikte, - çok modlu yüzeyleri için paylaşılan media-understanding ve video-generation sağlayıcısı kayıtları; - Qwen video oluşturma, `wan2.6-t2v` ve `wan2.7-r2v` gibi paketlenmiş Wan modelleriyle - Standard DashScope video uç noktalarını kullanır + yalnızca eklenti sahipliğinde kataloglar +- `qwen`: metin modelleri için eklenti sahipliğinde kataloglar ve ayrıca + çok modlu yüzeyleri için paylaşılan + media-understanding ve video oluşturma sağlayıcısı kayıtları; Qwen video üretimi, + `wan2.6-t2v` ve `wan2.7-r2v` gibi paketlenmiş Wan modelleriyle Standart DashScope video + endpoint'lerini kullanır - `runway`: `gen4.5` gibi yerel - Runway görev tabanlı modeller için plugin’e ait video oluşturma sağlayıcısı kaydı -- `minimax`: plugin’e ait kataloglar, Hailuo video modelleri için paketlenmiş video oluşturma sağlayıcısı + Runway görev tabanlı modeller için eklenti sahipliğinde video oluşturma sağlayıcısı kaydı +- `minimax`: eklenti sahipliğinde kataloglar, Hailuo video modelleri için paketlenmiş video oluşturma sağlayıcısı kaydı, `image-01` için paketlenmiş görüntü oluşturma sağlayıcısı kaydı, hibrit Anthropic/OpenAI replay-policy seçimi ve kullanım auth/snapshot mantığı -- `together`: plugin’e ait kataloglar ve Wan video modelleri için paketlenmiş video oluşturma sağlayıcısı +- `together`: eklenti sahipliğinde kataloglar ve ayrıca Wan video modelleri için paketlenmiş video oluşturma sağlayıcısı kaydı -- `xiaomi`: plugin’e ait kataloglar ile kullanım auth/snapshot mantığı +- `xiaomi`: eklenti sahipliğinde kataloglar ve ayrıca kullanım auth/snapshot mantığı -Paketlenmiş `openai` plugin’i artık her iki sağlayıcı kimliğini de sahipleniyor: `openai` ve +Paketlenmiş `openai` eklentisi artık her iki sağlayıcı kimliğini de sahipleniyor: `openai` ve `openai-codex`. -Bu, OpenClaw’ın normal taşımalarına hâlâ uyan sağlayıcıları kapsar. Tamamen -özel bir istek yürütücüsüne ihtiyaç duyan sağlayıcılar ayrı, daha derin bir genişletme yüzeyidir. +Bu, hâlâ OpenClaw'ın normal transport'larına uyan sağlayıcıları kapsar. Tamamen +özel bir istek yürütücüsü gerektiren bir sağlayıcı, ayrı ve daha derin bir genişletme +yüzeyidir. ## API anahtarı rotasyonu - Seçili sağlayıcılar için genel sağlayıcı rotasyonunu destekler. - Birden çok anahtarı şu yollarla yapılandırın: - - `OPENCLAW_LIVE__KEY` (tek canlı geçersiz kılma, en yüksek öncelik) - - `_API_KEYS` (virgül veya noktalı virgül ayrımlı liste) + - `OPENCLAW_LIVE__KEY` (tek live override, en yüksek öncelik) + - `_API_KEYS` (virgül veya noktalı virgülle ayrılmış liste) - `_API_KEY` (birincil anahtar) - - `_API_KEY_*` (numaralandırılmış liste, örn. `_API_KEY_1`) -- Google sağlayıcıları için `GOOGLE_API_KEY` de yedek olarak dahil edilir. -- Anahtar seçim sırası önceliği korur ve değerleri tekilleştirir. -- İstekler yalnızca hız sınırı yanıtlarında bir sonraki anahtarla yeniden denenir - (örneğin `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many + - `_API_KEY_*` (numaralı liste, örn. `_API_KEY_1`) +- Google sağlayıcıları için `GOOGLE_API_KEY` de geri dönüş olarak dahildir. +- Anahtar seçimi sırası önceliği korur ve değerlerin yinelenmesini kaldırır. +- İstekler yalnızca rate-limit yanıtlarında bir sonraki anahtarla yeniden denenir (örneğin + `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many concurrent requests`, `ThrottlingException`, `concurrency limit reached`, - `workers_ai ... quota limit exceeded` veya dönemsel kullanım sınırı iletileri). -- Hız sınırı dışındaki hatalar hemen başarısız olur; anahtar rotasyonu denenmez. -- Tüm aday anahtarlar başarısız olduğunda son hata, son denemeden döndürülür. + `workers_ai ... quota limit exceeded` veya dönemsel kullanım sınırı mesajları). +- Rate-limit dışı hatalar hemen başarısız olur; anahtar rotasyonu denenmez. +- Tüm aday anahtarlar başarısız olduğunda, son hata son denemeden döndürülür. -## Yerleşik sağlayıcılar (pi-ai kataloğu) +## Yerleşik sağlayıcılar (pi-ai catalog) -OpenClaw, pi‑ai kataloğuyla gelir. Bu sağlayıcılar için -`models.providers` yapılandırması **gerekmez**; yalnızca auth ayarlayın ve bir model seçin. +OpenClaw, pi‑ai catalog ile birlikte gelir. Bu sağlayıcılar için +`models.providers` yapılandırması gerekmez; yalnızca auth ayarlayın ve bir model seçin. ### OpenAI - Sağlayıcı: `openai` - Auth: `OPENAI_API_KEY` -- İsteğe bağlı rotasyon: `OPENAI_API_KEYS`, `OPENAI_API_KEY_1`, `OPENAI_API_KEY_2`, ayrıca `OPENCLAW_LIVE_OPENAI_KEY` (tek geçersiz kılma) +- İsteğe bağlı rotasyon: `OPENAI_API_KEYS`, `OPENAI_API_KEY_1`, `OPENAI_API_KEY_2` ve ayrıca `OPENCLAW_LIVE_OPENAI_KEY` (tek override) - Örnek modeller: `openai/gpt-5.4`, `openai/gpt-5.4-pro` - CLI: `openclaw onboard --auth-choice openai-api-key` -- Varsayılan taşıma `auto`’dur (önce WebSocket, sonra SSE) -- Model başına geçersiz kılmak için `agents.defaults.models["openai/"].params.transport` kullanın (`"sse"`, `"websocket"` veya `"auto"`) -- OpenAI Responses WebSocket ısınması varsayılan olarak `params.openaiWsWarmup` aracılığıyla etkindir (`true`/`false`) -- OpenAI öncelikli işleme, `agents.defaults.models["openai/"].params.serviceTier` aracılığıyla etkinleştirilebilir +- Varsayılan transport `auto`dur (önce WebSocket, sonra SSE geri dönüşü) +- Model başına geçersiz kılma: `agents.defaults.models["openai/"].params.transport` (`"sse"`, `"websocket"` veya `"auto"`) +- OpenAI Responses WebSocket ısınma varsayılanı `params.openaiWsWarmup` ile etkin gelir (`true`/`false`) +- OpenAI öncelikli işleme `agents.defaults.models["openai/"].params.serviceTier` ile etkinleştirilebilir - `/fast` ve `params.fastMode`, doğrudan `openai/*` Responses isteklerini `api.openai.com` üzerinde `service_tier=priority` olarak eşler -- Paylaşılan `/fast` anahtarı yerine açık bir katman istiyorsanız `params.serviceTier` kullanın -- Gizli OpenClaw atıf üstbilgileri (`originator`, `version`, - `User-Agent`) yalnızca `api.openai.com` üzerindeki yerel OpenAI trafiğinde uygulanır, - genel OpenAI uyumlu proxy’lerde uygulanmaz +- Paylaşılan `/fast` geçişi yerine açık bir katman istediğinizde `params.serviceTier` kullanın +- Gizli OpenClaw ilişkilendirme başlıkları (`originator`, `version`, + `User-Agent`) yalnızca `api.openai.com` adresine giden yerel OpenAI trafiğinde uygulanır, + genel OpenAI uyumlu proxy'lerde uygulanmaz - Yerel OpenAI rotaları ayrıca Responses `store`, prompt-cache ipuçları ve OpenAI reasoning-compat payload şekillendirmesini korur; proxy rotaları korumaz -- `openai/gpt-5.3-codex-spark`, canlı OpenAI API bunu reddettiği için OpenClaw’da kasıtlı olarak gizlenir; Spark yalnızca Codex’e ait kabul edilir +- `openai/gpt-5.3-codex-spark`, canlı OpenAI API bunu reddettiği için OpenClaw'da bilinçli olarak bastırılır; Spark yalnızca Codex'e özel kabul edilir ```json5 { @@ -272,13 +264,12 @@ OpenClaw, pi‑ai kataloğuyla gelir. Bu sağlayıcılar için - Sağlayıcı: `anthropic` - Auth: `ANTHROPIC_API_KEY` -- İsteğe bağlı rotasyon: `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`, `ANTHROPIC_API_KEY_2`, ayrıca `OPENCLAW_LIVE_ANTHROPIC_KEY` (tek geçersiz kılma) +- İsteğe bağlı rotasyon: `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`, `ANTHROPIC_API_KEY_2` ve ayrıca `OPENCLAW_LIVE_ANTHROPIC_KEY` (tek override) - Örnek model: `anthropic/claude-opus-4-6` - CLI: `openclaw onboard --auth-choice apiKey` -- Doğrudan genel Anthropic istekleri, `api.anthropic.com` adresine gönderilen API anahtarı ve OAuth kimlik doğrulamalı trafik dahil, - paylaşılan `/fast` anahtarını ve `params.fastMode` değerini destekler; OpenClaw bunu Anthropic `service_tier` değerine (`auto` ve `standard_only`) eşler -- Anthropic notu: Anthropic çalışanları, OpenClaw tarzı Claude CLI kullanımına yeniden izin verildiğini söyledi; bu yüzden Anthropic yeni bir politika yayımlamadığı sürece OpenClaw, Claude CLI yeniden kullanımını ve `claude -p` kullanımını bu entegrasyon için onaylı kabul eder. -- Anthropic setup-token, desteklenen bir OpenClaw token yolu olarak kullanılmaya devam eder, ancak OpenClaw artık mevcut olduğunda Claude CLI yeniden kullanımını ve `claude -p`’yi tercih eder. +- Doğrudan herkese açık Anthropic istekleri, `api.anthropic.com` adresine gönderilen API anahtarı ve OAuth ile kimliği doğrulanmış trafik dahil olmak üzere paylaşılan `/fast` geçişini ve `params.fastMode` değerini destekler; OpenClaw bunu Anthropic `service_tier` (`auto` vs `standard_only`) olarak eşler +- Anthropic notu: Anthropic çalışanları, OpenClaw tarzı Claude CLI kullanımına yeniden izin verildiğini bize bildirdi; bu nedenle OpenClaw, Anthropic yeni bir ilke yayımlamadıkça Claude CLI yeniden kullanımını ve `claude -p` kullanımını bu entegrasyon için onaylı kabul eder. +- Anthropic setup-token, desteklenen bir OpenClaw token yolu olarak kullanılmaya devam eder, ancak OpenClaw artık mümkün olduğunda Claude CLI yeniden kullanımını ve `claude -p` kullanımını tercih eder. ```json5 { @@ -292,16 +283,16 @@ OpenClaw, pi‑ai kataloğuyla gelir. Bu sağlayıcılar için - Auth: OAuth (ChatGPT) - Örnek model: `openai-codex/gpt-5.4` - CLI: `openclaw onboard --auth-choice openai-codex` veya `openclaw models auth login --provider openai-codex` -- Varsayılan taşıma `auto`’dur (önce WebSocket, sonra SSE) -- Model başına geçersiz kılmak için `agents.defaults.models["openai-codex/"].params.transport` kullanın (`"sse"`, `"websocket"` veya `"auto"`) +- Varsayılan transport `auto`dur (önce WebSocket, sonra SSE geri dönüşü) +- Model başına geçersiz kılma: `agents.defaults.models["openai-codex/"].params.transport` (`"sse"`, `"websocket"` veya `"auto"`) - `params.serviceTier`, yerel Codex Responses isteklerinde (`chatgpt.com/backend-api`) de iletilir -- Gizli OpenClaw atıf üstbilgileri (`originator`, `version`, +- Gizli OpenClaw ilişkilendirme başlıkları (`originator`, `version`, `User-Agent`) yalnızca - `chatgpt.com/backend-api` üzerindeki yerel Codex trafiğine eklenir, genel OpenAI uyumlu proxy’lere eklenmez -- Doğrudan `openai/*` ile aynı `/fast` anahtarını ve `params.fastMode` yapılandırmasını paylaşır; OpenClaw bunu `service_tier=priority` olarak eşler -- `openai-codex/gpt-5.3-codex-spark`, Codex OAuth kataloğu bunu açığa çıkardığında kullanılabilir kalır; yetki durumuna bağlıdır + `chatgpt.com/backend-api` adresine giden yerel Codex trafiğine eklenir, genel OpenAI uyumlu proxy'lere eklenmez +- Doğrudan `openai/*` ile aynı `/fast` geçişini ve `params.fastMode` yapılandırmasını paylaşır; OpenClaw bunu `service_tier=priority` olarak eşler +- `openai-codex/gpt-5.3-codex-spark`, Codex OAuth catalog bunu sunduğunda kullanılabilir kalır; entitlement'e bağlıdır - `openai-codex/gpt-5.4`, yerel `contextWindow = 1050000` ve varsayılan çalışma zamanı `contextTokens = 272000` değerlerini korur; çalışma zamanı sınırını `models.providers.openai-codex.models[].contextTokens` ile geçersiz kılın -- Politika notu: OpenAI Codex OAuth, OpenClaw gibi harici araçlar/iş akışları için açıkça desteklenmektedir. +- İlke notu: OpenAI Codex OAuth, OpenClaw gibi harici araçlar/iş akışları için açıkça desteklenir. ```json5 { @@ -323,9 +314,9 @@ OpenClaw, pi‑ai kataloğuyla gelir. Bu sağlayıcılar için ### Diğer abonelik tarzı barındırılan seçenekler -- [Qwen Cloud](/tr/providers/qwen): Qwen Cloud sağlayıcı yüzeyi ile Alibaba DashScope ve Coding Plan uç nokta eşlemesi +- [Qwen Cloud](/tr/providers/qwen): Qwen Cloud sağlayıcı yüzeyi ve ayrıca Alibaba DashScope ile Coding Plan endpoint eşlemesi - [MiniMax](/tr/providers/minimax): MiniMax Coding Plan OAuth veya API anahtarı erişimi -- [GLM Models](/tr/providers/glm): Z.AI Coding Plan veya genel API uç noktaları +- [GLM Models](/tr/providers/glm): Z.AI Coding Plan veya genel API endpoint'leri ### OpenCode @@ -345,40 +336,40 @@ OpenClaw, pi‑ai kataloğuyla gelir. Bu sağlayıcılar için - Sağlayıcı: `google` - Auth: `GEMINI_API_KEY` -- İsteğe bağlı rotasyon: `GEMINI_API_KEYS`, `GEMINI_API_KEY_1`, `GEMINI_API_KEY_2`, `GOOGLE_API_KEY` yedeği ve `OPENCLAW_LIVE_GEMINI_KEY` (tek geçersiz kılma) +- İsteğe bağlı rotasyon: `GEMINI_API_KEYS`, `GEMINI_API_KEY_1`, `GEMINI_API_KEY_2`, `GOOGLE_API_KEY` geri dönüşü ve `OPENCLAW_LIVE_GEMINI_KEY` (tek override) - Örnek modeller: `google/gemini-3.1-pro-preview`, `google/gemini-3-flash-preview` -- Uyumluluk: `google/gemini-3.1-flash-preview` kullanan eski OpenClaw yapılandırması `google/gemini-3-flash-preview` olarak normalize edilir +- Uyumluluk: `google/gemini-3.1-flash-preview` kullanan eski OpenClaw yapılandırması `google/gemini-3-flash-preview` olarak normalleştirilir - CLI: `openclaw onboard --auth-choice gemini-api-key` - Doğrudan Gemini çalıştırmaları ayrıca `agents.defaults.models["google/"].params.cachedContent` - (veya eski `cached_content`) kabul eder; böylece sağlayıcıya özgü bir - `cachedContents/...` işleyicisini iletir; Gemini önbellek isabetleri OpenClaw `cacheRead` olarak görünür + (veya eski `cached_content`) kabul eder; bu, sağlayıcıya özgü bir + `cachedContents/...` tanıtıcısını iletmek içindir; Gemini önbellek isabetleri OpenClaw `cacheRead` olarak görünür ### Google Vertex ve Gemini CLI - Sağlayıcılar: `google-vertex`, `google-gemini-cli` -- Auth: Vertex gcloud ADC kullanır; Gemini CLI kendi OAuth akışını kullanır -- Dikkat: Gemini CLI OAuth’un OpenClaw içindeki entegrasyonu resmi değildir. Bazı kullanıcılar üçüncü taraf istemcileri kullandıktan sonra Google hesaplarında kısıtlamalar bildiriyor. Devam etmeyi seçerseniz Google şartlarını inceleyin ve kritik olmayan bir hesap kullanın. -- Gemini CLI OAuth, paketlenmiş `google` plugin’inin bir parçası olarak gönderilir. - - Önce Gemini CLI’yi kurun: +- Auth: Vertex, gcloud ADC kullanır; Gemini CLI kendi OAuth akışını kullanır +- Dikkat: OpenClaw içindeki Gemini CLI OAuth resmi olmayan bir entegrasyondur. Bazı kullanıcılar, üçüncü taraf istemciler kullandıktan sonra Google hesaplarında kısıtlamalar bildiriyor. Devam etmeyi seçerseniz Google şartlarını inceleyin ve kritik olmayan bir hesap kullanın. +- Gemini CLI OAuth, paketlenmiş `google` eklentisinin bir parçası olarak gönderilir. + - Önce Gemini CLI'yi yükleyin: - `brew install gemini-cli` - veya `npm install -g @google/gemini-cli` - - Etkinleştirin: `openclaw plugins enable google` - - Giriş yapın: `openclaw models auth login --provider google-gemini-cli --set-default` + - Etkinleştirme: `openclaw plugins enable google` + - Giriş: `openclaw models auth login --provider google-gemini-cli --set-default` - Varsayılan model: `google-gemini-cli/gemini-3-flash-preview` - - Not: istemci kimliğini veya gizli anahtarı `openclaw.json` içine **yapıştırmazsınız**. CLI giriş akışı, - token’ları gateway host üzerindeki auth profillerinde depolar. - - Girişten sonra istekler başarısız olursa gateway host üzerinde `GOOGLE_CLOUD_PROJECT` veya `GOOGLE_CLOUD_PROJECT_ID` ayarlayın. - - Gemini CLI JSON yanıtları `response` alanından ayrıştırılır; kullanım bilgisi - `stats` alanına geri döner ve `stats.cached`, OpenClaw `cacheRead` olarak normalize edilir. + - Not: `openclaw.json` içine bir istemci kimliği veya sır yapıştırmazsınız. CLI giriş akışı + belirteçleri gateway host üzerindeki auth profillerinde saklar. + - Girişten sonra istekler başarısız olursa, gateway host üzerinde `GOOGLE_CLOUD_PROJECT` veya `GOOGLE_CLOUD_PROJECT_ID` ayarlayın. + - Gemini CLI JSON yanıtları `response` içinden ayrıştırılır; kullanım verisi + `stats` üzerinden geri döner ve `stats.cached` OpenClaw `cacheRead` olarak normalleştirilir. ### Z.AI (GLM) - Sağlayıcı: `zai` - Auth: `ZAI_API_KEY` -- Örnek model: `zai/glm-5` +- Örnek model: `zai/glm-5.1` - CLI: `openclaw onboard --auth-choice zai-api-key` - - Takma adlar: `z.ai/*` ve `z-ai/*`, `zai/*` olarak normalize edilir - - `zai-api-key`, eşleşen Z.AI uç noktasını otomatik algılar; `zai-coding-global`, `zai-coding-cn`, `zai-global` ve `zai-cn` belirli bir yüzeyi zorlar + - Takma adlar: `z.ai/*` ve `z-ai/*`, `zai/*` olarak normalleştirilir + - `zai-api-key`, eşleşen Z.AI endpoint'ini otomatik algılar; `zai-coding-global`, `zai-coding-cn`, `zai-global` ve `zai-cn` belirli bir yüzeyi zorlar ### Vercel AI Gateway @@ -393,39 +384,37 @@ OpenClaw, pi‑ai kataloğuyla gelir. Bu sağlayıcılar için - Auth: `KILOCODE_API_KEY` - Örnek model: `kilocode/kilo/auto` - CLI: `openclaw onboard --auth-choice kilocode-api-key` -- Base URL: `https://api.kilo.ai/api/gateway/` -- Statik yedek katalog `kilocode/kilo/auto` ile gelir; canlı +- Temel URL: `https://api.kilo.ai/api/gateway/` +- Statik geri dönüş kataloğu `kilocode/kilo/auto` ile gelir; canlı `https://api.kilo.ai/api/gateway/models` keşfi çalışma zamanı kataloğunu daha da genişletebilir. -- `kilocode/kilo/auto` arkasındaki tam yukarı akış yönlendirmesi Kilo Gateway’e aittir, - OpenClaw içinde sabit kodlanmamıştır. +- `kilocode/kilo/auto` arkasındaki tam upstream yönlendirme Kilo Gateway'e aittir, + OpenClaw içinde sabit kodlanmış değildir. Kurulum ayrıntıları için bkz. [/providers/kilocode](/tr/providers/kilocode). -### Diğer paketlenmiş sağlayıcı plugin’leri +### Diğer paketlenmiş sağlayıcı eklentileri - OpenRouter: `openrouter` (`OPENROUTER_API_KEY`) - Örnek model: `openrouter/auto` -- OpenClaw, OpenRouter’ın belgelenmiş uygulama atıf üstbilgilerini yalnızca - istek gerçekten `openrouter.ai` hedefine gidiyorsa uygular -- OpenRouter’a özgü Anthropic `cache_control` işaretçileri de - rastgele proxy URL’lerine değil, yalnızca doğrulanmış OpenRouter rotalarına uygulanır -- OpenRouter, proxy tarzı OpenAI uyumlu yol üzerinde kalır; dolayısıyla yerel - yalnızca OpenAI’ye özgü istek şekillendirme (`serviceTier`, Responses `store`, - prompt-cache ipuçları, OpenAI reasoning-compat payload’ları) iletilmez -- Gemini destekli OpenRouter başvuruları yalnızca proxy-Gemini thought-signature temizliğini korur; +- OpenClaw, OpenRouter'ın belgelenmiş uygulama ilişkilendirme başlıklarını yalnızca + istek gerçekten `openrouter.ai` adresine gidiyorsa uygular +- OpenRouter'a özgü Anthropic `cache_control` işaretçileri de aynı şekilde + doğrulanmış OpenRouter rotalarıyla sınırlıdır, rastgele proxy URL'leriyle değil +- OpenRouter, proxy tarzı OpenAI uyumlu yol üzerinde kalır; bu nedenle yerel + yalnızca OpenAI istek şekillendirmesi (`serviceTier`, Responses `store`, + prompt-cache ipuçları, OpenAI reasoning-compat payload'ları) iletilmez +- Gemini tabanlı OpenRouter başvuruları yalnızca proxy-Gemini thought-signature temizliğini korur; yerel Gemini replay doğrulaması ve bootstrap yeniden yazımları kapalı kalır - Kilo Gateway: `kilocode` (`KILOCODE_API_KEY`) - Örnek model: `kilocode/kilo/auto` -- Gemini destekli Kilo başvuruları aynı proxy-Gemini thought-signature - temizleme yolunu korur; `kilocode/kilo/auto` ve proxy-reasoning’i desteklemeyen diğer - ipuçları proxy reasoning eklemeyi atlar +- Gemini tabanlı Kilo başvuruları aynı proxy-Gemini thought-signature + temizleme yolunu korur; `kilocode/kilo/auto` ve proxy reasoning'i desteklemeyen diğer ipuçları + proxy reasoning eklemeyi atlar - MiniMax: `minimax` (API anahtarı) ve `minimax-portal` (OAuth) - Auth: `minimax` için `MINIMAX_API_KEY`; `minimax-portal` için `MINIMAX_OAUTH_TOKEN` veya `MINIMAX_API_KEY` - Örnek model: `minimax/MiniMax-M2.7` veya `minimax-portal/MiniMax-M2.7` -- MiniMax onboarding/API anahtarı kurulumu, açık M2.7 model tanımları yazar ve - `input: ["text", "image"]` içerir; paketlenmiş sağlayıcı kataloğu bu sohbet başvurularını - sağlayıcı yapılandırması materyalize edilene kadar yalnızca metin olarak tutar +- MiniMax ilk kurulumu/API anahtarı kurulumu, `input: ["text", "image"]` ile açık M2.7 model tanımları yazar; paketlenmiş sağlayıcı kataloğu, o sağlayıcı yapılandırması somutlaştırılana kadar sohbet başvurularını yalnızca metin olarak tutar - Moonshot: `moonshot` (`MOONSHOT_API_KEY`) - Örnek model: `moonshot/kimi-k2.5` - Kimi Coding: `kimi` (`KIMI_API_KEY` veya `KIMICODE_API_KEY`) @@ -453,34 +442,34 @@ Kurulum ayrıntıları için bkz. [/providers/kilocode](/tr/providers/kilocode). - xAI: `xai` (`XAI_API_KEY`) - Yerel paketlenmiş xAI istekleri xAI Responses yolunu kullanır - `/fast` veya `params.fastMode: true`, `grok-3`, `grok-3-mini`, - `grok-4` ve `grok-4-0709` modellerini `*-fast` varyantlarına yeniden yazar - - `tool_stream` varsayılan olarak açıktır; devre dışı bırakmak için + `grok-4` ve `grok-4-0709` değerlerini `*-fast` varyantlarına yeniden yazar + - `tool_stream` varsayılan olarak açıktır; kapatmak için `agents.defaults.models["xai/"].params.tool_stream` değerini `false` - yapın + olarak ayarlayın - Mistral: `mistral` (`MISTRAL_API_KEY`) - Örnek model: `mistral/mistral-large-latest` - CLI: `openclaw onboard --auth-choice mistral-api-key` - Groq: `groq` (`GROQ_API_KEY`) - Cerebras: `cerebras` (`CEREBRAS_API_KEY`) - Cerebras üzerindeki GLM modelleri `zai-glm-4.7` ve `zai-glm-4.6` kimliklerini kullanır. - - OpenAI uyumlu base URL: `https://api.cerebras.ai/v1`. + - OpenAI uyumlu temel URL: `https://api.cerebras.ai/v1`. - GitHub Copilot: `github-copilot` (`COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN`) - Hugging Face Inference örnek modeli: `huggingface/deepseek-ai/DeepSeek-R1`; CLI: `openclaw onboard --auth-choice huggingface-api-key`. Bkz. [Hugging Face (Inference)](/tr/providers/huggingface). ## `models.providers` üzerinden sağlayıcılar (özel/base URL) **Özel** sağlayıcılar veya -OpenAI/Anthropic uyumlu proxy’ler eklemek için `models.providers` (veya `models.json`) kullanın. +OpenAI/Anthropic uyumlu proxy'ler eklemek için `models.providers` (veya `models.json`) kullanın. -Aşağıdaki paketlenmiş sağlayıcı plugin’lerinin çoğu zaten varsayılan bir katalog yayımlar. -Varsayılan base URL, üstbilgiler veya model listesini geçersiz kılmak -istemediğiniz sürece açık `models.providers.` girdileri kullanmayın. +Aşağıdaki paketlenmiş sağlayıcı eklentilerinin çoğu zaten varsayılan bir katalog yayımlar. +Varsayılan temel URL'yi, başlıkları veya model listesini geçersiz kılmak istediğinizde +yalnızca açık `models.providers.` girdilerini kullanın. ### Moonshot AI (Kimi) -Moonshot, paketlenmiş bir sağlayıcı plugin’i olarak gelir. Varsayılan olarak yerleşik sağlayıcıyı -kullanın; yalnızca base URL veya model meta verisini geçersiz kılmanız gerektiğinde -açık bir `models.providers.moonshot` girdisi ekleyin: +Moonshot paketlenmiş bir sağlayıcı eklentisi olarak gelir. Varsayılan olarak yerleşik sağlayıcıyı +kullanın ve yalnızca temel URL'yi veya model meta verisini geçersiz kılmanız +gerektiğinde açık bir `models.providers.moonshot` girdisi ekleyin: - Sağlayıcı: `moonshot` - Auth: `MOONSHOT_API_KEY` @@ -519,7 +508,7 @@ Kimi K2 model kimlikleri: ### Kimi Coding -Kimi Coding, Moonshot AI’nin Anthropic uyumlu uç noktasını kullanır: +Kimi Coding, Moonshot AI'nin Anthropic uyumlu endpoint'ini kullanır: - Sağlayıcı: `kimi` - Auth: `KIMI_API_KEY` @@ -534,13 +523,13 @@ Kimi Coding, Moonshot AI’nin Anthropic uyumlu uç noktasını kullanır: } ``` -Eski `kimi/k2p5`, uyumluluk modeli kimliği olarak kabul edilmeye devam eder. +Eski `kimi/k2p5`, uyumluluk model kimliği olarak kabul edilmeye devam eder. ### Volcano Engine (Doubao) -Volcano Engine (火山引擎), Çin’de Doubao ve diğer modellere erişim sağlar. +Volcano Engine (火山引擎), Çin'de Doubao ve diğer modellere erişim sağlar. -- Sağlayıcı: `volcengine` (coding: `volcengine-plan`) +- Sağlayıcı: `volcengine` (kodlama: `volcengine-plan`) - Auth: `VOLCANO_ENGINE_API_KEY` - Örnek model: `volcengine-plan/ark-code-latest` - CLI: `openclaw onboard --auth-choice volcengine-api-key` @@ -553,13 +542,12 @@ Volcano Engine (火山引擎), Çin’de Doubao ve diğer modellere erişim sağ } ``` -Onboarding varsayılan olarak coding yüzeyini kullanır, ancak genel `volcengine/*` -kataloğu da aynı anda kaydedilir. +İlk kurulum varsayılan olarak kodlama yüzeyini kullanır, ancak genel `volcengine/*` +catalog aynı anda kaydedilir. -Onboarding/model yapılandırma seçimlerinde Volcengine auth choice, -hem `volcengine/*` hem de `volcengine-plan/*` satırlarını tercih eder. Bu modeller henüz yüklenmemişse -OpenClaw, boş bir sağlayıcı kapsamlı seçim göstermek yerine -filtrelenmemiş kataloğa geri döner. +İlk kurulum/yapılandırma model seçicilerinde, Volcengine auth choice hem +`volcengine/*` hem de `volcengine-plan/*` satırlarını tercih eder. Bu modeller henüz yüklenmemişse, +OpenClaw boş bir sağlayıcı kapsamlı seçici göstermek yerine filtrelenmemiş kataloğa geri döner. Kullanılabilir modeller: @@ -569,7 +557,7 @@ Kullanılabilir modeller: - `volcengine/glm-4-7-251222` (GLM 4.7) - `volcengine/deepseek-v3-2-251201` (DeepSeek V3.2 128K) -Coding modelleri (`volcengine-plan`): +Kodlama modelleri (`volcengine-plan`): - `volcengine-plan/ark-code-latest` - `volcengine-plan/doubao-seed-code` @@ -581,7 +569,7 @@ Coding modelleri (`volcengine-plan`): BytePlus ARK, uluslararası kullanıcılar için Volcano Engine ile aynı modellere erişim sağlar. -- Sağlayıcı: `byteplus` (coding: `byteplus-plan`) +- Sağlayıcı: `byteplus` (kodlama: `byteplus-plan`) - Auth: `BYTEPLUS_API_KEY` - Örnek model: `byteplus-plan/ark-code-latest` - CLI: `openclaw onboard --auth-choice byteplus-api-key` @@ -594,13 +582,12 @@ BytePlus ARK, uluslararası kullanıcılar için Volcano Engine ile aynı modell } ``` -Onboarding varsayılan olarak coding yüzeyini kullanır, ancak genel `byteplus/*` -kataloğu da aynı anda kaydedilir. +İlk kurulum varsayılan olarak kodlama yüzeyini kullanır, ancak genel `byteplus/*` +catalog aynı anda kaydedilir. -Onboarding/model yapılandırma seçimlerinde BytePlus auth choice, -hem `byteplus/*` hem de `byteplus-plan/*` satırlarını tercih eder. Bu modeller henüz yüklenmemişse -OpenClaw, boş bir sağlayıcı kapsamlı seçim göstermek yerine -filtrelenmemiş kataloğa geri döner. +İlk kurulum/yapılandırma model seçicilerinde, BytePlus auth choice hem +`byteplus/*` hem de `byteplus-plan/*` satırlarını tercih eder. Bu modeller henüz yüklenmemişse, +OpenClaw boş bir sağlayıcı kapsamlı seçici göstermek yerine filtrelenmemiş kataloğa geri döner. Kullanılabilir modeller: @@ -608,7 +595,7 @@ Kullanılabilir modeller: - `byteplus/kimi-k2-5-260127` (Kimi K2.5) - `byteplus/glm-4-7-251222` (GLM 4.7) -Coding modelleri (`byteplus-plan`): +Kodlama modelleri (`byteplus-plan`): - `byteplus-plan/ark-code-latest` - `byteplus-plan/doubao-seed-code` @@ -618,7 +605,7 @@ Coding modelleri (`byteplus-plan`): ### Synthetic -Synthetic, `synthetic` sağlayıcısı arkasında Anthropic uyumlu modeller sunar: +Synthetic, `synthetic` sağlayıcısının arkasında Anthropic uyumlu modeller sunar: - Sağlayıcı: `synthetic` - Auth: `SYNTHETIC_API_KEY` @@ -646,31 +633,31 @@ Synthetic, `synthetic` sağlayıcısı arkasında Anthropic uyumlu modeller suna ### MiniMax -MiniMax, özel uç noktalar kullandığı için `models.providers` üzerinden yapılandırılır: +MiniMax, özel endpoint'ler kullandığı için `models.providers` üzerinden yapılandırılır: -- MiniMax OAuth (Genel): `--auth-choice minimax-global-oauth` +- MiniMax OAuth (Global): `--auth-choice minimax-global-oauth` - MiniMax OAuth (CN): `--auth-choice minimax-cn-oauth` -- MiniMax API anahtarı (Genel): `--auth-choice minimax-global-api` +- MiniMax API anahtarı (Global): `--auth-choice minimax-global-api` - MiniMax API anahtarı (CN): `--auth-choice minimax-cn-api` - Auth: `minimax` için `MINIMAX_API_KEY`; `minimax-portal` için `MINIMAX_OAUTH_TOKEN` veya `MINIMAX_API_KEY` Kurulum ayrıntıları, model seçenekleri ve yapılandırma parçacıkları için bkz. [/providers/minimax](/tr/providers/minimax). -MiniMax’in Anthropic uyumlu akış yolunda OpenClaw, -siz açıkça ayarlamadığınız sürece düşünmeyi varsayılan olarak devre dışı bırakır ve `/fast on` -`MiniMax-M2.7` modelini `MiniMax-M2.7-highspeed` olarak yeniden yazar. +MiniMax'ın Anthropic uyumlu akış yolunda OpenClaw, siz açıkça ayarlamadığınız sürece +thinking'i varsayılan olarak devre dışı bırakır ve `/fast on`, +`MiniMax-M2.7` değerini `MiniMax-M2.7-highspeed` olarak yeniden yazar. -Plugin’e ait capability ayrımı: +Eklenti sahipliğinde capability ayrımı: - Metin/sohbet varsayılanları `minimax/MiniMax-M2.7` üzerinde kalır -- Görüntü oluşturma `minimax/image-01` veya `minimax-portal/image-01` kullanır -- Görüntü anlama, her iki MiniMax auth yolunda da plugin’e ait `MiniMax-VL-01` kullanır -- Web araması `minimax` sağlayıcı kimliğinde kalır +- Görüntü oluşturma `minimax/image-01` veya `minimax-portal/image-01` biçimindedir +- Görüntü anlama, her iki MiniMax auth yolunda da eklenti sahipliğinde `MiniMax-VL-01` olur +- Web search sağlayıcı kimliği olarak `minimax` üzerinde kalır ### Ollama -Ollama, paketlenmiş bir sağlayıcı plugin’i olarak gelir ve Ollama’nın yerel API’sini kullanır: +Ollama, paketlenmiş bir sağlayıcı eklentisi olarak gelir ve Ollama'nın yerel API'sini kullanır: - Sağlayıcı: `ollama` - Auth: Gerekmez (yerel sunucu) @@ -678,7 +665,7 @@ Ollama, paketlenmiş bir sağlayıcı plugin’i olarak gelir ve Ollama’nın y - Kurulum: [https://ollama.com/download](https://ollama.com/download) ```bash -# Ollama'yı kurun, ardından bir model çekin: +# Önce Ollama'yı kurun, ardından bir model çekin: ollama pull llama3.3 ``` @@ -690,21 +677,21 @@ ollama pull llama3.3 } ``` -`OLLAMA_API_KEY` ile katılım gösterdiğinizde Ollama yerel olarak `http://127.0.0.1:11434` -adresinde algılanır ve paketlenmiş sağlayıcı plugin’i Ollama’yı doğrudan -`openclaw onboard` ve model seçicisine ekler. Onboarding, cloud/local modu ve özel yapılandırma için +Ollama, `OLLAMA_API_KEY` ile katılım sağladığınızda yerel olarak `http://127.0.0.1:11434` adresinde +algılanır ve paketlenmiş sağlayıcı eklentisi Ollama'yı doğrudan +`openclaw onboard` ve model seçiciye ekler. İlk kurulum, bulut/yerel mod ve özel yapılandırma için bkz. [/providers/ollama](/tr/providers/ollama). ### vLLM -vLLM, local/self-hosted OpenAI uyumlu -sunucular için paketlenmiş bir sağlayıcı plugin’i olarak gelir: +vLLM, yerel/self-hosted OpenAI uyumlu +sunucular için paketlenmiş bir sağlayıcı eklentisi olarak gelir: - Sağlayıcı: `vllm` - Auth: İsteğe bağlıdır (sunucunuza bağlıdır) -- Varsayılan base URL: `http://127.0.0.1:8000/v1` +- Varsayılan temel URL: `http://127.0.0.1:8000/v1` -Yerelde otomatik keşfe katılmak için (sunucunuz auth zorlamıyorsa herhangi bir değer çalışır): +Yerelde otomatik keşfe katılmak için (sunucunuz auth zorlamıyorsa herhangi bir değer işe yarar): ```bash export VLLM_API_KEY="vllm-local" @@ -725,13 +712,14 @@ Ayrıntılar için bkz. [/providers/vllm](/tr/providers/vllm). ### SGLang SGLang, hızlı self-hosted -OpenAI uyumlu sunucular için paketlenmiş bir sağlayıcı plugin’i olarak gelir: +OpenAI uyumlu sunucular için paketlenmiş bir sağlayıcı eklentisi olarak gelir: - Sağlayıcı: `sglang` - Auth: İsteğe bağlıdır (sunucunuza bağlıdır) -- Varsayılan base URL: `http://127.0.0.1:30000/v1` +- Varsayılan temel URL: `http://127.0.0.1:30000/v1` -Yerelde otomatik keşfe katılmak için (sunucunuz auth zorlamıyorsa herhangi bir değer çalışır): +Yerelde otomatik keşfe katılmak için (sunucunuz auth'u +zorlamıyorsa herhangi bir değer işe yarar): ```bash export SGLANG_API_KEY="sglang-local" @@ -749,7 +737,7 @@ Ardından bir model ayarlayın (`/v1/models` tarafından döndürülen kimlikler Ayrıntılar için bkz. [/providers/sglang](/tr/providers/sglang). -### Yerel proxy’ler (LM Studio, vLLM, LiteLLM vb.) +### Yerel proxy'ler (LM Studio, vLLM, LiteLLM vb.) Örnek (OpenAI uyumlu): @@ -787,20 +775,20 @@ Ayrıntılar için bkz. [/providers/sglang](/tr/providers/sglang). Notlar: - Özel sağlayıcılar için `reasoning`, `input`, `cost`, `contextWindow` ve `maxTokens` isteğe bağlıdır. - Atlandıklarında OpenClaw şu varsayılanları kullanır: + Atlandıklarında OpenClaw varsayılan olarak şunları kullanır: - `reasoning: false` - `input: ["text"]` - `cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }` - `contextWindow: 200000` - `maxTokens: 8192` - Önerilir: proxy/model sınırlarınızla eşleşen açık değerler ayarlayın. -- Yerel olmayan uç noktalarda `api: "openai-completions"` için (ana makinesi `api.openai.com` olmayan boş olmayan herhangi bir `baseUrl`), OpenClaw sağlayıcının desteklemediği `developer` rolleri nedeniyle 400 hatalarından kaçınmak için `compat.supportsDeveloperRole: false` değerini zorunlu kılar. -- Proxy tarzı OpenAI uyumlu rotalar ayrıca yerel yalnızca OpenAI’ye özgü istek - şekillendirmesini de atlar: `service_tier` yok, Responses `store` yok, prompt-cache ipuçları yok, - OpenAI reasoning-compat payload şekillendirmesi yok ve gizli OpenClaw atıf - üstbilgileri yok. -- `baseUrl` boşsa/atlanmışsa OpenClaw varsayılan OpenAI davranışını korur (`api.openai.com` adresine çözülür). -- Güvenlik için, açık bir `compat.supportsDeveloperRole: true` değeri bile yerel olmayan `openai-completions` uç noktalarında yine geçersiz kılınır. +- Yerel olmayan endpoint'lerde `api: "openai-completions"` için (`baseUrl` boş olmayan ve ana bilgisayarı `api.openai.com` olmayan her değer), OpenClaw desteklenmeyen `developer` rolleri için sağlayıcı 400 hatalarını önlemek amacıyla `compat.supportsDeveloperRole: false` değerini zorlar. +- Proxy tarzı OpenAI uyumlu rotalar ayrıca yalnızca yerel OpenAI istek + şekillendirmesini atlar: `service_tier` yok, Responses `store` yok, prompt-cache ipuçları yok, + OpenAI reasoning-compat payload şekillendirmesi yok ve gizli OpenClaw ilişkilendirme + başlıkları yok. +- `baseUrl` boşsa/atlanmışsa, OpenClaw varsayılan OpenAI davranışını korur (`api.openai.com` adresine çözümlenir). +- Güvenlik için, yerel olmayan `openai-completions` endpoint'lerinde açık `compat.supportsDeveloperRole: true` ayarı bile yine geçersiz kılınır. ## CLI örnekleri @@ -815,6 +803,6 @@ Ayrıca bkz.: tam yapılandırma örnekleri için [/gateway/configuration](/tr/g ## İlgili - [Models](/tr/concepts/models) — model yapılandırması ve takma adlar -- [Model Failover](/tr/concepts/model-failover) — fallback zincirleri ve yeniden deneme davranışı +- [Model Failover](/tr/concepts/model-failover) — geri dönüş zincirleri ve yeniden deneme davranışı - [Configuration Reference](/tr/gateway/configuration-reference#agent-defaults) — model yapılandırma anahtarları -- [Providers](/tr/providers) — sağlayıcı bazında kurulum kılavuzları +- [Providers](/tr/providers) — sağlayıcı başına kurulum kılavuzları diff --git a/docs/tr/concepts/qa-e2e-automation.md b/docs/tr/concepts/qa-e2e-automation.md index b53c7d733..1dbad84b4 100644 --- a/docs/tr/concepts/qa-e2e-automation.md +++ b/docs/tr/concepts/qa-e2e-automation.md @@ -2,14 +2,14 @@ read_when: - qa-lab veya qa-channel genişletilirken - repo destekli QA senaryoları eklerken - - Gateway kontrol paneli etrafında daha yüksek gerçekçiliğe sahip QA otomasyonu oluştururken + - Gateway panosu etrafında daha gerçekçi QA otomasyonu oluştururken summary: qa-lab, qa-channel, tohumlanmış senaryolar ve protokol raporları için özel QA otomasyon yapısı title: QA E2E Otomasyonu x-i18n: - generated_at: "2026-04-08T02:13:58Z" + generated_at: "2026-04-08T06:00:43Z" model: gpt-5.4 provider: openai - source_hash: 3b4aa5acc8e77303f4045d4f04372494cae21b89d2fdaba856dbb4855ced9d27 + source_hash: 57da147dc06abf9620290104e01a83b42182db1806514114fd9e8467492cda99 source_path: concepts/qa-e2e-automation.md workflow: 15 --- @@ -21,30 +21,31 @@ kanal biçimli bir şekilde çalıştırmak için tasarlanmıştır. Mevcut parçalar: -- `extensions/qa-channel`: DM, kanal, konu, tepki, - düzenleme ve silme yüzeylerine sahip sentetik mesaj kanalı. +- `extensions/qa-channel`: DM, kanal, iş parçacığı, + tepki, düzenleme ve silme yüzeylerine sahip sentetik mesaj kanalı. - `extensions/qa-lab`: transkripti gözlemlemek, - gelen mesajları enjekte etmek ve bir Markdown raporu dışa aktarmak için hata ayıklayıcı UI'ı ve QA veri yolu. + gelen mesajları enjekte etmek ve bir Markdown raporu dışa aktarmak için hata ayıklayıcı UI ve QA veri yolu. - `qa/`: başlangıç görevi ve temel QA senaryoları için repo destekli tohum varlıkları. -Geçerli QA operatörü akışı iki panelli bir QA sitesidir: +Geçerli QA operatör akışı, iki bölmeli bir QA sitesidir: -- Sol: Aracının bulunduğu Gateway kontrol paneli (Control UI). -- Sağ: Slack benzeri transkript ve senaryo planını gösteren QA Lab. +- Sol: ajan ile Gateway panosu (Control UI). +- Sağ: Slack benzeri transkripti ve senaryo planını gösteren QA Lab. -Bunu şu komutla çalıştırın: +Şununla çalıştırın: ```bash pnpm qa:lab:up ``` -Bu, QA sitesini derler, Docker destekli gateway hattını başlatır ve bir operatörün veya otomasyon döngüsünün aracıya bir QA +Bu, QA sitesini derler, Docker destekli gateway hattını başlatır ve +bir operatörün veya otomasyon döngüsünün ajana bir QA görevi verebildiği, gerçek kanal davranışını gözlemleyebildiği ve neyin işe yaradığını, neyin başarısız olduğunu veya neyin engelli kaldığını kaydedebildiği QA Lab sayfasını açığa çıkarır. -Docker imajını her seferinde yeniden derlemeden daha hızlı QA Lab UI yinelemesi için, -yığını bind-mount edilmiş bir QA Lab paketiyle başlatın: +Docker imajını her seferinde yeniden derlemeden daha hızlı QA Lab UI yinelemesi için +yığını, bağlama ile monte edilmiş bir QA Lab paketiyle başlatın: ```bash pnpm openclaw qa docker-build-image @@ -53,41 +54,43 @@ pnpm qa:lab:up:fast pnpm qa:lab:watch ``` -`qa:lab:up:fast`, Docker hizmetlerini önceden derlenmiş bir imajda tutar ve -`extensions/qa-lab/web/dist` dizinini `qa-lab` kapsayıcısına bind-mount eder. `qa:lab:watch` -bu paketi değişikliklerde yeniden derler ve QA Lab varlık karması değiştiğinde tarayıcı otomatik olarak yeniden yüklenir. +`qa:lab:up:fast`, Docker servislerini önceden derlenmiş bir imaj üzerinde tutar ve +`extensions/qa-lab/web/dist` dizinini `qa-lab` container'ına bağlama ile monte eder. `qa:lab:watch` +değişiklik olduğunda bu paketi yeniden derler ve QA Lab +varlık karması değiştiğinde tarayıcı otomatik olarak yeniden yüklenir. ## Repo destekli tohumlar Tohum varlıkları `qa/` içinde bulunur: -- `qa/scenarios.md` +- `qa/scenarios/index.md` +- `qa/scenarios/*.md` -Bunlar, QA planı hem insanlar hem de -aracı için görünür olsun diye kasıtlı olarak git içinde tutulur. Temel liste, şunları kapsayacak kadar geniş kalmalıdır: +Bunlar bilerek git içinde tutulur; böylece QA planı hem insanlar hem de +ajan tarafından görülebilir. Temel liste, şu konuları kapsayacak kadar geniş kalmalıdır: - DM ve kanal sohbeti -- konu davranışı +- iş parçacığı davranışı - mesaj eylemi yaşam döngüsü - cron geri çağrıları - bellekten geri çağırma - model değiştirme -- alt aracı devri +- alt ajan devri - repo okuma ve doküman okuma - Lobster Invaders gibi küçük bir derleme görevi ## Raporlama `qa-lab`, gözlemlenen veri yolu zaman çizelgesinden bir Markdown protokol raporu dışa aktarır. -Rapor şu sorulara yanıt vermelidir: +Rapor şu soruları yanıtlamalıdır: -- Ne işe yaradı -- Ne başarısız oldu -- Ne engelli kaldı +- Neler işe yaradı +- Neler başarısız oldu +- Neler engelli kaldı - Hangi takip senaryolarını eklemeye değer ## İlgili dokümanlar -- [Testler](/tr/help/testing) -- [QA Kanalı](/tr/channels/qa-channel) -- [Kontrol Paneli](/web/dashboard) +- [Test etme](/tr/help/testing) +- [QA Channel](/tr/channels/qa-channel) +- [Pano](/web/dashboard) diff --git a/docs/tr/concepts/streaming.md b/docs/tr/concepts/streaming.md index 10b609834..0c25db9c4 100644 --- a/docs/tr/concepts/streaming.md +++ b/docs/tr/concepts/streaming.md @@ -1,15 +1,15 @@ --- read_when: - - Kanallarda akışın veya parçalamanın nasıl çalıştığını açıklıyorsanız - - Blok akışını veya kanal parçalama davranışını değiştiriyorsanız - - Yinelenen/erken blok yanıtlarında veya kanal önizleme akışında hata ayıklıyorsanız -summary: Akış + parçalama davranışı (blok yanıtları, kanal önizleme akışı, kip eşleme) + - Kanallarda akışın veya parçalamanın nasıl çalıştığını açıklama + - Blok akışını veya kanal parçalama davranışını değiştirme + - Yinelenen/erken blok yanıtlarını veya kanal önizleme akışını hata ayıklama +summary: Akış + parçalama davranışı (blok yanıtları, kanal önizleme akışı, mod eşleme) title: Akış ve Parçalama x-i18n: - generated_at: "2026-04-05T13:52:01Z" + generated_at: "2026-04-08T06:01:00Z" model: gpt-5.4 provider: openai - source_hash: 44b0d08c7eafcb32030ef7c8d5719c2ea2d34e4bac5fdad8cc8b3f4e9e9fad97 + source_hash: a8e847bb7da890818cd79dec7777f6ae488e6d6c0468e948e56b6b6c598e0000 source_path: concepts/streaming.md workflow: 15 --- @@ -18,14 +18,14 @@ x-i18n: OpenClaw iki ayrı akış katmanına sahiptir: -- **Blok akışı (kanallar):** assistant yazarken tamamlanmış **blokları** yayar. Bunlar normal kanal mesajlarıdır (token deltaları değildir). +- **Blok akışı (kanallar):** asistan yazarken tamamlanan **blokları** yayar. Bunlar normal kanal mesajlarıdır (token deltaları değil). - **Önizleme akışı (Telegram/Discord/Slack):** oluşturma sırasında geçici bir **önizleme mesajını** günceller. -Bugün kanal mesajlarına **gerçek token-delta akışı yoktur**. Önizleme akışı mesaj tabanlıdır (gönderme + düzenleme/ekleme). +Bugün kanal mesajlarına **gerçek token-delta akışı** yoktur. Önizleme akışı mesaj tabanlıdır (gönderme + düzenlemeler/eklemeler). ## Blok akışı (kanal mesajları) -Blok akışı, kullanılabilir oldukça assistant çıktısını kaba parçalar halinde gönderir. +Blok akışı, asistan çıktısını kullanılabilir oldukça büyük parçalar halinde gönderir. ``` Model output @@ -37,132 +37,133 @@ Model output └─ channel send (block replies) ``` -Açıklama: +Gösterge: -- `text_delta/events`: model akış olaylarıdır (akışsız modeller için seyrek olabilir). -- `chunker`: min/maks sınırlar + kırma tercihi uygulayan `EmbeddedBlockChunker`. +- `text_delta/events`: model akış olayları (akışsız modeller için seyrek olabilir). +- `chunker`: min/max sınırları + kırma tercihi uygulayan `EmbeddedBlockChunker`. - `channel send`: gerçek giden mesajlar (blok yanıtları). **Denetimler:** - `agents.defaults.blockStreamingDefault`: `"on"`/`"off"` (varsayılan kapalı). -- Kanal geçersiz kılmaları: kanal başına `"on"`/`"off"` zorlamak için `*.blockStreaming` (ve hesap başına varyantlar). +- Kanal geçersiz kılmaları: kanal başına `"on"`/`"off"` zorlamak için `*.blockStreaming` (ve hesap başına varyantları). - `agents.defaults.blockStreamingBreak`: `"text_end"` veya `"message_end"`. - `agents.defaults.blockStreamingChunk`: `{ minChars, maxChars, breakPreference? }`. - `agents.defaults.blockStreamingCoalesce`: `{ minChars?, maxChars?, idleMs? }` (göndermeden önce akış bloklarını birleştirir). -- Kanal katı üst sınırı: `*.textChunkLimit` (ör. `channels.whatsapp.textChunkLimit`). -- Kanal parçalama kipi: `*.chunkMode` (`length` varsayılan, `newline` uzunluğa göre parçalamadan önce boş satırlarda bölünür (paragraf sınırları)). -- Discord yumuşak üst sınırı: `channels.discord.maxLinesPerMessage` (varsayılan 17), arayüz kırpmasını önlemek için uzun yanıtları böler. +- Kanal kesin üst sınırı: `*.textChunkLimit` (ör. `channels.whatsapp.textChunkLimit`). +- Kanal parça modu: `*.chunkMode` (`length` varsayılan, `newline` uzunluğa göre parçalamadan önce boş satırlarda (paragraf sınırları) böler). +- Discord yumuşak üst sınırı: `channels.discord.maxLinesPerMessage` (varsayılan 17), kullanıcı arayüzü kırpmasını önlemek için uzun yanıtları böler. -**Sınır semantiği:** +**Sınır anlamları:** -- `text_end`: chunker üretir üretmez blokları akıt; her `text_end` üzerinde flush yap. -- `message_end`: assistant mesajı bitene kadar bekle, sonra tamponlanan çıktıyı flush et. +- `text_end`: `chunker` blok yayar yaymaz akış bloklarını gönderir; her `text_end` için boşaltır. +- `message_end`: asistan mesajı bitene kadar bekler, sonra arabelleğe alınmış çıktıyı boşaltır. -Tamponlanan metin `maxChars` değerini aşarsa `message_end` yine chunker kullanır; bu nedenle sonda birden fazla parça yayabilir. +`message_end`, arabelleğe alınmış metin `maxChars` değerini aşarsa yine `chunker` kullanır; bu nedenle sonda birden çok parça yayabilir. ## Parçalama algoritması (alt/üst sınırlar) Blok parçalama `EmbeddedBlockChunker` tarafından uygulanır: -- **Alt sınır:** tampon >= `minChars` olana kadar yayma (zorlanmadıkça). -- **Üst sınır:** bölmeleri `maxChars` öncesinde tercih et; zorlanırsa `maxChars` değerinde böl. +- **Alt sınır:** arabellek >= `minChars` olana kadar yayma (zorlanmadıkça). +- **Üst sınır:** `maxChars` öncesinde bölmeyi tercih eder; zorlanırsa `maxChars` konumunda böler. - **Kırma tercihi:** `paragraph` → `newline` → `sentence` → `whitespace` → sert kırma. -- **Kod çitleri:** çitlerin içinde asla bölme; `maxChars` değerinde zorlandığında Markdown geçerliliğini korumak için çiti kapat + yeniden aç. +- **Kod çitleri:** çitlerin içinde asla bölmez; `maxChars` konumunda zorlandığında Markdown geçerliliğini korumak için çiti kapatıp yeniden açar. -`maxChars`, kanal `textChunkLimit` değerine sıkıştırılır; böylece kanal başına sınırları aşamazsınız. +`maxChars`, kanal `textChunkLimit` değerine sabitlenir; bu yüzden kanal başına sınırları aşamazsınız. ## Birleştirme (akış bloklarını birleştirme) -Blok akışı etkin olduğunda, OpenClaw **ardışık blok parçalarını** -göndermeden önce birleştirebilir. Bu, ilerlemeli çıktı sağlamaya devam ederken +Blok akışı etkin olduğunda, OpenClaw art arda gelen blok parçalarını +göndermeden önce **birleştirebilir**. Bu, ilerlemeli çıktı sağlamaya devam ederken “tek satırlık spam”i azaltır. -- Birleştirme, flush yapmadan önce **boşta kalma aralıklarını** (`idleMs`) bekler. -- Tamponlar `maxChars` ile sınırlandırılır ve bu sınırı aşarlarsa flush edilir. -- `minChars`, yeterli metin birikene kadar küçük parçaların gönderilmesini önler - (son flush her zaman kalan metni gönderir). -- Birleştirici, `blockStreamingChunk.breakPreference` - değerinden türetilir (`paragraph` → `\n\n`, `newline` → `\n`, `sentence` → boşluk). -- Kanal geçersiz kılmaları `*.blockStreamingCoalesce` aracılığıyla kullanılabilir (hesap başına config'ler dahil). +- Birleştirme, boşaltmadan önce **boşta kalma aralıklarını** (`idleMs`) bekler. +- Arabellekler `maxChars` ile sınırlandırılır ve aşılırsa boşaltılır. +- `minChars`, yeterli metin birikene kadar çok küçük parçaların gönderilmesini engeller + (son boşaltma her zaman kalan metni gönderir). +- Birleştirici, `blockStreamingChunk.breakPreference` değerinden türetilir + (`paragraph` → `\n\n`, `newline` → `\n`, `sentence` → boşluk). +- Kanal geçersiz kılmaları `*.blockStreamingCoalesce` üzerinden kullanılabilir (hesap başına yapılandırmalar dahil). - Varsayılan birleştirme `minChars`, geçersiz kılınmadıkça Signal/Slack/Discord için 1500'e yükseltilir. ## Bloklar arasında insan benzeri tempo -Blok akışı etkin olduğunda, blok yanıtları arasında -(ilk bloktan sonra) **rastgeleleştirilmiş bir duraklama** ekleyebilirsiniz. Bu, çoklu baloncuk yanıtlarının +Blok akışı etkin olduğunda, blok yanıtları arasında **rastgele bir duraklama** +ekleyebilirsiniz (ilk bloktan sonra). Bu, çok baloncuklu yanıtların daha doğal hissettirmesini sağlar. -- Config: `agents.defaults.humanDelay` (ajan başına `agents.list[].humanDelay` ile geçersiz kılınabilir). -- Kipler: `off` (varsayılan), `natural` (800–2500ms), `custom` (`minMs`/`maxMs`). -- Yalnızca **blok yanıtlarına** uygulanır, son yanıtlara veya araç özetlerine uygulanmaz. +- Yapılandırma: `agents.defaults.humanDelay` (ajan başına `agents.list[].humanDelay` ile geçersiz kılınır). +- Modlar: `off` (varsayılan), `natural` (800–2500ms), `custom` (`minMs`/`maxMs`). +- Yalnızca **blok yanıtlarına** uygulanır; son yanıtlara veya araç özetlerine uygulanmaz. ## "Parçaları akıt veya her şeyi" -Bu, şu anlama gelir: +Bu, şuna karşılık gelir: - **Parçaları akıt:** `blockStreamingDefault: "on"` + `blockStreamingBreak: "text_end"` (ilerledikçe yay). Telegram dışındaki kanallarda ayrıca `*.blockStreaming: true` gerekir. -- **Her şeyi sonda akıt:** `blockStreamingBreak: "message_end"` (bir kez flush yapar, çok uzunsa yine birden fazla parça olabilir). +- **Her şeyi sonda akıt:** `blockStreamingBreak: "message_end"` (bir kez boşaltır; çok uzunsa muhtemelen birden çok parça halinde). - **Blok akışı yok:** `blockStreamingDefault: "off"` (yalnızca son yanıt). -**Kanal notu:** `*.blockStreaming` açıkça `true` -olarak ayarlanmadıkça blok akışı **kapalıdır**. Kanallar blok yanıtları olmadan da canlı önizleme -(`channels..streaming`) akıtabilir. +**Kanal notu:** `*.blockStreaming` açıkça `true` olarak +ayarlanmadıkça blok akışı **kapalıdır**. Kanallar, blok yanıtları olmadan +canlı bir önizleme akıtabilir (`channels..streaming`). -Config konumu hatırlatması: `blockStreaming*` varsayılanları kök config altında değil, +Yapılandırma konumu hatırlatması: `blockStreaming*` varsayılanları kök yapılandırmada değil, `agents.defaults` altında bulunur. -## Önizleme akışı kipleri +## Önizleme akışı modları -Kurallı anahtar: `channels..streaming` +Kanoni̇k anahtar: `channels..streaming` -Kipler: +Modlar: -- `off`: önizleme akışını devre dışı bırak. +- `off`: önizleme akışını devre dışı bırakır. - `partial`: en son metinle değiştirilen tek bir önizleme. - `block`: parçalanmış/eklenmiş adımlarla önizleme güncellemeleri. - `progress`: oluşturma sırasında ilerleme/durum önizlemesi, tamamlandığında son yanıt. ### Kanal eşleme -| Kanal | `off` | `partial` | `block` | `progress` | -| -------- | ----- | --------- | ------- | ------------------- | +| Kanal | `off` | `partial` | `block` | `progress` | +| -------- | ----- | --------- | ------- | ---------------------- | | Telegram | ✅ | ✅ | ✅ | `partial` olarak eşlenir | | Discord | ✅ | ✅ | ✅ | `partial` olarak eşlenir | -| Slack | ✅ | ✅ | ✅ | ✅ | +| Slack | ✅ | ✅ | ✅ | ✅ | Yalnızca Slack: -- `streaming=partial` olduğunda `channels.slack.nativeStreaming`, Slack yerel akış API çağrılarını açıp kapatır (varsayılan: `true`). +- `channels.slack.streaming.nativeTransport`, `channels.slack.streaming.mode="partial"` olduğunda Slack yerel akış API çağrılarını açıp kapatır (varsayılan: `true`). +- Slack yerel akışı ve Slack asistan ileti dizisi durumu, bir yanıt ileti dizisi hedefi gerektirir; üst düzey DM'ler bu ileti dizisi tarzı önizlemeyi göstermez. Eski anahtar geçişi: -- Telegram: `streamMode` + boolean `streaming`, otomatik olarak `streaming` enum'una geçirilir. -- Discord: `streamMode` + boolean `streaming`, otomatik olarak `streaming` enum'una geçirilir. -- Slack: `streamMode`, otomatik olarak `streaming` enum'una geçirilir; boolean `streaming`, otomatik olarak `nativeStreaming` değerine geçirilir. +- Telegram: `streamMode` + boolean `streaming`, `streaming` enum'una otomatik geçirilir. +- Discord: `streamMode` + boolean `streaming`, `streaming` enum'una otomatik geçirilir. +- Slack: `streamMode`, `streaming.mode` alanına otomatik geçirilir; boolean `streaming`, `streaming.mode` + `streaming.nativeTransport` alanlarına otomatik geçirilir; eski `nativeStreaming`, `streaming.nativeTransport` alanına otomatik geçirilir. ### Çalışma zamanı davranışı Telegram: -- DM'ler ve grup/konular genelinde `sendMessage` + `editMessageText` önizleme güncellemelerini kullanır. +- DM'lerde ve grup/konularda önizleme güncellemeleri için `sendMessage` + `editMessageText` kullanır. - Telegram blok akışı açıkça etkinleştirildiğinde önizleme akışı atlanır (çift akışı önlemek için). -- `/reasoning stream`, önizlemeye akıl yürütme yazabilir. +- `/reasoning stream`, gerekçelendirmeyi önizlemeye yazabilir. Discord: -- gönder + düzenle önizleme mesajları kullanır. -- `block` kipi taslak parçalama (`draftChunk`) kullanır. +- Gönderme + düzenleme önizleme mesajları kullanır. +- `block` modu `draftChunk` taslak parçalamayı kullanır. - Discord blok akışı açıkça etkinleştirildiğinde önizleme akışı atlanır. Slack: - `partial`, mevcut olduğunda Slack yerel akışını (`chat.startStream`/`append`/`stop`) kullanabilir. - `block`, ekleme tarzı taslak önizlemeleri kullanır. -- `progress`, durum önizleme metni kullanır, ardından son yanıtı gönderir. +- `progress`, durum önizleme metni kullanır, ardından son yanıtı verir. ## İlgili -- [Mesajlar](/concepts/messages) — mesaj yaşam döngüsü ve teslimat -- [Yeniden deneme](/concepts/retry) — teslimat başarısızlığında yeniden deneme davranışı +- [Mesajlar](/tr/concepts/messages) — mesaj yaşam döngüsü ve teslimat +- [Yeniden deneme](/tr/concepts/retry) — teslimat hatasında yeniden deneme davranışı - [Kanallar](/tr/channels) — kanal başına akış desteği diff --git a/docs/tr/gateway/configuration-reference.md b/docs/tr/gateway/configuration-reference.md index 5758cc3e2..1b0c26a1f 100644 --- a/docs/tr/gateway/configuration-reference.md +++ b/docs/tr/gateway/configuration-reference.md @@ -1,29 +1,43 @@ --- read_when: - - Tam alan düzeyi yapılandırma anlamlarını veya varsayılanları öğrenmeniz gerekiyor - - Kanal, model, ağ geçidi veya araç yapılandırma bloklarını doğruluyorsunuz -summary: Her OpenClaw yapılandırma anahtarı, varsayılanlar ve kanal ayarları için eksiksiz başvuru + - Tam alan düzeyinde yapılandırma semantiğine 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 title: Yapılandırma Başvurusu x-i18n: - generated_at: "2026-04-08T02:19:23Z" + generated_at: "2026-04-08T06:06:05Z" model: gpt-5.4 provider: openai - source_hash: 2c7991b948cbbb7954a3e26280089ab00088e7f4878ec0b0540c3c9acf222ebb + source_hash: 2f9ab34fb56897a77cb038d95bea21e8530d8f0402b66d1ee97c73822a1e8fd4 source_path: gateway/configuration-reference.md workflow: 15 --- # Yapılandırma Başvurusu -`~/.openclaw/openclaw.json` içinde kullanılabilen her alan. Görev odaklı bir genel bakış için bkz. [Configuration](/tr/gateway/configuration). +`~/.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. -Yapılandırma biçimi **JSON5**'tir (**yorumlar + sondaki virgüller** desteklenir). Tüm alanlar isteğe bağlıdır — OpenClaw belirtilmediklerinde güvenli varsayılanları kullanır. +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. + +Kod gerçekliğ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 + +Özel derin 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ı + +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. --- ## Kanallar -Her kanal, yapılandırma bölümü mevcut olduğunda otomatik olarak başlar (`enabled: false` olmadığı sürece). +Her kanal, yapılandırma bölümü mevcut olduğunda otomatik başlar (`enabled: false` olmadığı sürece). ### DM ve grup erişimi @@ -31,21 +45,21 @@ Tüm kanallar DM ilkelerini ve grup ilkelerini destekler: | DM ilkesi | Davranış | | ------------------- | ------------------------------------------------------------- | -| `pairing` (varsayılan) | Bilinmeyen göndericiler tek kullanımlık bir eşleştirme kodu alır; sahibi onaylamalıdır | -| `allowlist` | Yalnızca `allowFrom` içindeki göndericiler (veya eşleştirilmiş izin deposu) | -| `open` | Tüm gelen DM'lere izin ver (gerektirir: `allowFrom: ["*"]`) | -| `disabled` | Tüm gelen DM'leri yok say | +| `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 | | Grup ilkesi | Davranış | | --------------------- | ---------------------------------------------------- | | `allowlist` (varsayılan) | Yalnızca yapılandırılmış izin listesiyle eşleşen gruplar | -| `open` | Grup izin listelerini atla (bahsetme geçidi yine uygulanır) | +| `open` | Grup izin listelerini atla (mention-gating yine de 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ılmıştır. -Bir sağlayıcı bloğu tamamen eksikse (`channels.` yoksa), çalışma zamanındaki grup ilkesi başlangıçta bir uyarıyla birlikte `allowlist` olarak geri döner (kapalı-varsayılan). +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. ### Kanal model geçersiz kılmaları @@ -91,15 +105,15 @@ Sağlayıcılar arasında paylaşılan grup ilkesi ve heartbeat davranışı iç } ``` -- `channels.defaults.groupPolicy`: sağlayıcı düzeyindeki `groupPolicy` ayarlanmamışsa kullanılan yedek grup ilkesi. -- `channels.defaults.contextVisibility`: tüm kanallar için varsayılan ek bağlam görünürlüğü modu. Değerler: `all` (varsayılan, tüm alıntı/konu/geçmiş bağlamını dahil eder), `allowlist` (yalnızca izin verilen göndericilerden gelen bağlamı dahil eder), `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`: heartbeat çıktısına sağlıklı kanal durumlarını dahil et. -- `channels.defaults.heartbeat.showAlerts`: heartbeat çıktısına bozulmuş/hatalı durumları dahil et. +- `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.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.useIndicator`: kompakt gösterge tarzı heartbeat çıktısı oluştur. ### WhatsApp -WhatsApp, ağ geçidinin web kanalı (Baileys Web) üzerinden çalışır. Bağlı bir oturum mevcut olduğunda otomatik olarak başlar. +WhatsApp, gateway’nin web kanalı (Baileys Web) üzerinden çalışır. Bağlı bir oturum olduğunda otomatik başlar. ```json5 { @@ -110,7 +124,7 @@ WhatsApp, ağ geçidinin web kanalı (Baileys Web) üzerinden çalışır. Bağl textChunkLimit: 4000, chunkMode: "length", // length | newline mediaMaxMb: 50, - sendReadReceipts: true, // blue ticks (false in self-chat mode) + sendReadReceipts: true, // mavi tikler (self-chat modunda false) groups: { "*": { requireMention: true }, }, @@ -150,9 +164,9 @@ WhatsApp, ağ geçidinin web kanalı (Baileys Web) üzerinden çalışır. Bağl } ``` -- Giden komutlar, varsa varsayılan olarak `default` hesabını kullanır; yoksa ilk yapılandırılmış hesap kimliğini (sıralanmış) kullanır. +- 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` içine taşınır. +- Eski tek hesaplı Baileys kimlik doğrulama dizini, `openclaw doctor` tarafından `whatsapp/default` altına taşınır. - Hesap başına geçersiz kılmalar: `channels.whatsapp.accounts..sendReadReceipts`, `channels.whatsapp.accounts..dmPolicy`, `channels.whatsapp.accounts..allowFrom`. @@ -171,24 +185,24 @@ WhatsApp, ağ geçidinin web kanalı (Baileys Web) üzerinden çalışır. Bağl "*": { requireMention: true }, "-1001234567890": { allowFrom: ["@admin"], - systemPrompt: "Keep answers brief.", + systemPrompt: "Yanıtları kısa tut.", topics: { "99": { requireMention: false, skills: ["search"], - systemPrompt: "Stay on topic.", + systemPrompt: "Konudan sapma.", }, }, }, }, customCommands: [ - { command: "backup", description: "Git backup" }, - { command: "generate", description: "Create an image" }, + { command: "backup", description: "Git yedeği" }, + { command: "generate", description: "Bir görsel oluştur" }, ], historyLimit: 50, replyToMode: "first", // off | first | all | batched linkPreview: true, - streaming: "partial", // off | partial | block | progress (default: off; opt in explicitly to avoid preview-edit rate limits) + 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) actions: { reactions: true, sendMessage: true }, reactionNotifications: "own", // off | own | all mediaMaxMb: 100, @@ -211,11 +225,11 @@ WhatsApp, ağ geçidinin web kanalı (Baileys Web) üzerinden çalışır. Bağl } ``` -- Bot token: `channels.telegram.botToken` veya `channels.telegram.tokenFile` (yalnızca normal dosya; sembolik bağlantılar reddedilir), varsayılan hesap için yedek olarak `TELEGRAM_BOT_TOKEN`. +- 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`. - İ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çersizse `openclaw doctor` uyarır. -- `configWrites: false`, Telegram tarafından başlatılan yapılandırma yazmalarını engeller (süper grup kimliği geçişleri, `/config set|unset`). -- `type: "acp"` içeren üst düzey `bindings[]` girişleri, forum konuları için kalıcı ACP bağlamaları yapılandırır (`match.peer.id` içinde kurallı `chatId:topic:topicId` kullanın). Alan anlamları [ACP Agents](/tr/tools/acp-agents#channel-specific-settings) içinde ortaktır. +- Ç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. - Telegram akış önizlemeleri `sendMessage` + `editMessageText` kullanır (doğrudan ve grup sohbetlerinde çalışır). - Yeniden deneme ilkesi: bkz. [Retry policy](/tr/concepts/retry). @@ -264,7 +278,7 @@ WhatsApp, ağ geçidinin web kanalı (Baileys Web) üzerinden çalışır. Bağl requireMention: true, users: ["987654321098765432"], skills: ["docs"], - systemPrompt: "Short answers only.", + systemPrompt: "Yalnızca kısa yanıtlar.", }, }, }, @@ -272,7 +286,7 @@ WhatsApp, ağ geçidinin web kanalı (Baileys Web) üzerinden çalışır. Bağl historyLimit: 20, textChunkLimit: 2000, chunkMode: "length", // length | newline - streaming: "off", // off | partial | block | progress (progress maps to partial on Discord) + streaming: "off", // off | partial | block | progress (progress, Discord’da partial’a eşlenir) maxLinesPerMessage: 17, ui: { components: { @@ -283,7 +297,7 @@ WhatsApp, ağ geçidinin web kanalı (Baileys Web) üzerinden çalışır. Bağl enabled: true, idleHours: 24, maxAgeHours: 0, - spawnSubagentSessions: false, // opt-in for sessions_spawn({ thread: true }) + spawnSubagentSessions: false, // sessions_spawn({ thread: true }) için isteğe bağlı etkinleştirme }, voice: { enabled: true, @@ -319,36 +333,36 @@ WhatsApp, ağ geçidinin web kanalı (Baileys Web) üzerinden çalışır. Bağl } ``` -- Token: `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 tokeni kullanır; hesap yeniden deneme/ilke ayarları yine etkin çalışma zamanı anlık görüntüsünde seçilen hesaptan gelir. +- 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. - İ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; düz sayısal kimlikler reddedilir. -- Guild slug'ları küçük harflidir 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 bottan bahseden bot mesajlarını kabul etmek için `allowBots: "mentions"` kullanın (botun kendi mesajları yine filtrelenir). -- `channels.discord.guilds..ignoreOtherMentions` (ve kanal geçersiz kılmaları), bottan bahsetmeyen ama başka bir kullanıcı veya rolden bahseden mesajları düşürür (@everyone/@here hariç). -- `maxLinesPerMessage` (varsayılan 17), mesaj 2000 karakterin altında olsa bile uzun mesajları böler. -- `channels.discord.threadBindings`, Discord iş parçacığına bağlı yönlendirmeyi kontrol eder: - - `enabled`: iş parçacığına 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 nedeniyle otomatik odak kaldırma için Discord geçersiz kılması (`0` devre dışı bırakır) - - `maxAgeHours`: saat cinsinden kesin azami yaş için Discord geçersiz kılması (`0` devre dışı bırakır) - - `spawnSubagentSessions`: `sessions_spawn({ thread: true })` için otomatik iş parçacığı oluşturma/bağlama açma anahtarı -- `type: "acp"` içeren üst düzey `bindings[]` girişleri, kanallar ve iş parçacıkları için kalıcı ACP bağlamaları yapılandırır (`match.peer.id` içinde kanal/iş parçacığı kimliğini kullanın). Alan anlamları [ACP Agents](/tr/tools/acp-agents#channel-specific-settings) içinde ortaktır. +- 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) + - `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. - `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, yinelenen şifre çözme hatalarından sonra bir ses oturumundan çıkıp yeniden katılarak ses alma kurtarması yapmayı dener. -- `channels.discord.streaming`, kurallı akış modu anahtarıdır. Eski `streamMode` ve boolean `streaming` değerleri otomatik olarak taşınır. -- `channels.discord.autoPresence`, çalışma zamanı kullanılabilirliğini bot durumuna eşler (healthy => online, degraded => idle, exhausted => dnd) ve isteğe bağlı durum metni geçersiz kılmalarına izin verir. -- `channels.discord.dangerouslyAllowNameMatching`, değiştirilebilir ad/etiket eşlemesini yeniden etkinleştirir (acil durum uyumluluk modu). -- `channels.discord.execApprovals`: Discord'a özgü exec onay teslimi ve onaylayıcı yetkilendirmesi. - - `enabled`: `true`, `false` veya `"auto"` (varsayılan). Otomatik modda, exec onayları `approvers` veya `commands.ownerAllowFrom` içinden onaylayıcılar çözümlenebildiğinde etkinleşir. - - `approvers`: exec isteklerini onaylamasına izin verilen Discord kullanıcı kimlikleri. Belirtilmezse `commands.ownerAllowFrom` değerine geri döner. - - `agentFilter`: isteğe bağlı agent ID izin listesi. Tüm agent'lar için onayları iletmek için boş bırakın. +- 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.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. + - `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. - `sessionFilter`: isteğe bağlı oturum anahtarı desenleri (alt dize veya regex). - - `target`: onay istemlerinin nereye gönderileceği. `"dm"` (varsayılan) onaylayıcıların DM'lerine gönderir, `"channel"` kaynak kanala gönderir, `"both"` ikisine de gönderir. Hedef `"channel"` içerdiğinde, düğmeler yalnızca çözümlenen onaylayıcılar tarafından kullanılabilir. - - `cleanupAfterResolve`: `true` olduğunda, onay, red 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 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. -**Tepki bildirim modları:** `off` (yok), `own` (botun mesajları, varsayılan), `all` (tüm mesajlar), `allowlist` (`guilds..users` içinden tüm mesajlarda). +**Tepki bildirimi modları:** `off` (yok), `own` (botun mesajları, varsayılan), `all` (tüm mesajlar), `allowlist` (`guilds..users` içindekilerden tüm mesajlar). ### Google Chat @@ -379,11 +393,11 @@ WhatsApp, ağ geçidinin web kanalı (Baileys Web) üzerinden çalışır. Bağl } ``` -- Service account JSON: satır içi (`serviceAccount`) veya dosya tabanlı (`serviceAccountFile`). -- Service account SecretRef de desteklenir (`serviceAccountRef`). +- 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`. - Teslim hedefleri için `spaces/` veya `users/` kullanın. -- `channels.googlechat.dangerouslyAllowNameMatching`, değiştirilebilir e-posta asıl eşlemesini yeniden etkinleştirir (acil durum uyumluluk modu). +- `channels.googlechat.dangerouslyAllowNameMatching`, değişebilir e-posta principal eşleştirmesini yeniden etkinleştirir (acil durum uyumluluk modu). ### Slack @@ -405,7 +419,7 @@ WhatsApp, ağ geçidinin web kanalı (Baileys Web) üzerinden çalışır. Bağl allowBots: false, users: ["U123"], skills: ["docs"], - systemPrompt: "Short answers only.", + systemPrompt: "Yalnızca kısa yanıtlar.", }, }, historyLimit: 50, @@ -433,8 +447,10 @@ WhatsApp, ağ geçidinin web kanalı (Baileys Web) üzerinden çalışır. Bağl typingReaction: "hourglass_flowing_sand", textChunkLimit: 4000, chunkMode: "length", - streaming: "partial", // off | partial | block | progress (preview mode) - nativeStreaming: true, // use Slack native streaming API when streaming=partial + streaming: { + mode: "partial", // off | partial | block | progress + nativeTransport: true, // mode=partial olduğunda Slack yerel akış API’sini kullan + }, mediaMaxMb: 20, execApprovals: { enabled: "auto", // true | false | "auto" @@ -448,34 +464,34 @@ WhatsApp, ağ geçidinin web kanalı (Baileys Web) üzerinden çalışır. Bağl } ``` -- **Socket mode** hem `botToken` hem `appToken` gerektirir (varsayılan hesap ortam yedeği olarak `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 başına kaynak/durum alanlarını gösterir. `configured_unavailable`, hesabın SecretRef ile yapılandırıldığı ancak mevcut komut/çalışma zamanı yolunun gizli değeri çözemediği anlamına gelir. -- `configWrites: false`, Slack tarafından başlatılan yapılandırma yazmalarını engeller. +- **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. +- `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`, kurallı akış modu anahtarıdır. Eski `streamMode` ve boolean `streaming` 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ış taşımasını kontrol eder. Eski `streamMode`, mantıksal `streaming` ve `nativeStreaming` değerleri otomatik olarak taşınır. - Teslim hedefleri için `user:` (DM) veya `channel:` kullanın. -**Tepki bildirim modları:** `off`, `own` (varsayılan), `all`, `allowlist` (`reactionAllowlist` içinden). +**Tepki bildirimi 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. -- `typingReaction`, bir yanıt çalışırken gelen Slack mesajına geçici bir tepki ekler, ardından tamamlanınca kaldırır. `"hourglass_flowing_sand"` gibi bir Slack emoji kısa kodu kullanın. -- `channels.slack.execApprovals`: Slack'e özgü 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 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"`). -| 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/sabitlemeyi kaldır/listele | -| memberInfo | etkin | Üye bilgisi | -| emojiList | etkin | Özel emoji listesi | +| messages | etkin | Oku/gönder/düzenle/sil | +| pins | etkin | Sabitle/kaldır/listele | +| memberInfo | etkin | Üye bilgisi | +| emojiList | etkin | Özel emoji listesi | ### Mattermost -Mattermost bir plugin olarak sunulur: `openclaw plugins install @openclaw/mattermost`. +Mattermost bir eklenti olarak gelir: `openclaw plugins install @openclaw/mattermost`. ```json5 { @@ -492,10 +508,10 @@ Mattermost bir plugin olarak sunulur: `openclaw plugins install @openclaw/matter "team-channel-id": { requireMention: false }, }, commands: { - native: true, // opt-in + native: true, // isteğe bağlı etkinleştirme nativeSkills: true, callbackPath: "/api/channels/mattermost/command", - // Optional explicit URL for reverse-proxy/public deployments + // Ters proxy/genel dağıtımlar için isteğe bağlı açık URL callbackUrl: "https://gateway.example.com/api/channels/mattermost/command", }, textChunkLimit: 4000, @@ -505,18 +521,19 @@ Mattermost bir plugin olarak sunulur: `openclaw plugins install @openclaw/matter } ``` -Sohbet modları: `oncall` (@-bahsinde yanıt verir, varsayılan), `onmessage` (her mesaj), `onchar` (tetikleyici önek ile başlayan mesajlar). +Sohbet modları: `oncall` (@-mention olduğunda yanıt ver, varsayılan), `onmessage` (her mesaj), `onchar` (tetikleyici önekle başlayan mesajlar). Mattermost yerel komutları etkinleştirildiğinde: -- `commands.callbackPath` tam URL değil, bir yol olmalıdır (örneğin `/api/channels/mattermost/command`). -- `commands.callbackUrl` OpenClaw ağ geçidi uç noktasına çözülmeli ve Mattermost sunucusundan erişilebilir olmalıdır. -- Yerel slash geri çağrıları, Mattermost'un slash komut kaydı sırasında döndürdüğü komut başına tokenlarla doğrulanır. Kayıt başarısız olursa veya hiçbir komut etkinleştirilmezse, OpenClaw geri çağrıları `Unauthorized: invalid command token.` ile reddeder. -- Özel/tailnet/dahili geri çağrı ana makineleri için Mattermost, `ServiceSettings.AllowedUntrustedInternalConnections` içine geri çağrı ana makinesini/alan adını eklemenizi gerektirebilir. - Tam URL değil, ana makine/alan adı değerleri kullanın. -- `channels.mattermost.configWrites`: Mattermost tarafından başlatılan yapılandırma yazmalarına izin ver veya engelle. +- `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: + `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. - `channels.mattermost.requireMention`: kanallarda yanıt vermeden önce `@mention` gerektir. -- `channels.mattermost.groups..requireMention`: kanal başına bahsetme geçidi geçersiz kılması (varsayılan için `"*"`). +- `channels.mattermost.groups..requireMention`: kanal başına mention-gating 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 @@ -526,7 +543,7 @@ Mattermost yerel komutları etkinleştirildiğinde: channels: { signal: { enabled: true, - account: "+15555550123", // optional account binding + account: "+15555550123", // isteğe bağlı hesap bağlama dmPolicy: "pairing", allowFrom: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"], configWrites: true, @@ -538,15 +555,15 @@ Mattermost yerel komutları etkinleştirildiğinde: } ``` -**Tepki bildirim modları:** `off`, `own` (varsayılan), `all`, `allowlist` (`reactionAllowlist` içinden). +**Tepki bildirimi modları:** `off`, `own` (varsayılan), `all`, `allowlist` (`reactionAllowlist` içinden). -- `channels.signal.account`: kanal başlangıcını belirli bir Signal hesap kimliğine sabitler. -- `channels.signal.configWrites`: Signal tarafından başlatılan yapılandırma yazmalarına izin ver veya engelle. +- `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. - İ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 (plugin desteklidir, `channels.bluebubbles` altında yapılandırılır). +BlueBubbles, önerilen iMessage yoludur (eklenti destekli, `channels.bluebubbles` altında yapılandırılır). ```json5 { @@ -554,8 +571,8 @@ BlueBubbles önerilen iMessage yoludur (plugin desteklidir, `channels.bluebubble bluebubbles: { enabled: true, dmPolicy: "pairing", - // serverUrl, password, webhookPath, group controls, and advanced actions: - // see /channels/bluebubbles + // serverUrl, password, webhookPath, group controls ve gelişmiş eylemler: + // bkz. /channels/bluebubbles }, }, } @@ -563,12 +580,12 @@ BlueBubbles önerilen iMessage yoludur (plugin desteklidir, `channels.bluebubble - Burada kapsanan çekirdek 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. -- `type: "acp"` içeren üst düzey `bindings[]` girişleri, BlueBubbles konuşmalarını kalıcı ACP oturumlarına bağlayabilir. `match.peer.id` içinde bir BlueBubbles handle veya hedef dizesi (`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. +- Ü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. ### iMessage -OpenClaw, `imsg rpc` işlemini başlatır (stdio üzerinden JSON-RPC). Arka plan hizmeti veya port gerekmez. +OpenClaw `imsg rpc` (stdio üzerinden JSON-RPC) başlatır. Daemon veya port gerekmez. ```json5 { @@ -594,15 +611,15 @@ OpenClaw, `imsg rpc` işlemini başlatır (stdio üzerinden JSON-RPC). Arka plan - İsteğe bağlı `channels.imessage.defaultAccount`, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar. -- Messages veritabanı için Tam Disk Erişimi gerekir. +- 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ını gösterebilir; SCP ek dosya çekimi için `remoteHost` (`host` veya `user@host`) ayarlayı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ı host-key denetimi kullanır, bu nedenle röle ana makinesi 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 yazmalarına izin ver veya engelle. -- `type: "acp"` içeren üst düzey `bindings[]` girişleri, iMessage konuşmalarını kalıcı ACP oturumlarına bağlayabilir. `match.peer.id` içinde normalleştirilmiş 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). +- 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). - + ```bash #!/usr/bin/env bash @@ -628,7 +645,7 @@ Matrix uzantı desteklidir ve `channels.matrix` altında yapılandırılır. defaultAccount: "ops", accounts: { ops: { - name: "Ops", + name: "Operasyonlar", userId: "@ops:example.org", accessToken: "syt_ops_xxx", }, @@ -643,21 +660,21 @@ Matrix uzantı desteklidir ve `channels.matrix` altında yapılandırılır. } ``` -- Token kimlik doğrulaması `accessToken` kullanır; parola kimlik doğrulaması `userId` + `password` kullanır. +- Belirteç kimlik doğrulaması `accessToken` kullanır; parola kimlik doğrulaması `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/dahili homeserver'lara izin verir. `proxy` ve bu ağ açma ayarı birbirinden bağımsız kontrollerdir. +- `channels.matrix.network.dangerouslyAllowPrivateNetwork`, özel/iç homeserver’lara izin verir. `proxy` ve bu ağ etkinleştirmesi 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, `autoJoin: "allowlist"` ile `autoJoinAllowlist` veya `autoJoin: "always"` ayarlayana kadar davet edilen odalar ve yeni DM tarzı davetler yok sayılır. -- `channels.matrix.execApprovals`: Matrix'e özgü exec onay teslimi ve onaylayıcı yetkilendirmesi. - - `enabled`: `true`, `false` veya `"auto"` (varsayılan). Otomatik modda, exec onayları `approvers` veya `commands.ownerAllowFrom` içinden onaylayıcılar çözümlenebildiğinde etkinleşir. +- `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. + - `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ı agent ID izin listesi. Tüm agent'lar için onayları iletmek için boş bırakın. + - `agentFilter`: isteğe bağlı ajan kimliği izin listesi. Tüm ajanlar 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 oturumlara nasıl gruplandığını kontrol eder: `per-user` (varsayılan) yönlendirilen 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. +- `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. ### Microsoft Teams @@ -669,15 +686,15 @@ Microsoft Teams uzantı desteklidir ve `channels.msteams` altında yapılandır msteams: { enabled: true, configWrites: true, - // appId, appPassword, tenantId, webhook, team/channel policies: - // see /channels/msteams + // appId, appPassword, tenantId, webhook, takım/kanal ilkeleri: + // 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) içinde belgelenmiştir. +- 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. ### IRC @@ -704,11 +721,11 @@ 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.*`. - İ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/bahsetme geçidi) [IRC](/tr/channels/irc) içinde belgelenmiştir. +- Tam IRC kanal yapılandırması (host/port/TLS/kanallar/izin listeleri/mention gating) [IRC](/tr/channels/irc) sayfasında belgelenmiştir. ### Çok hesaplı (tüm kanallar) -Kanal başına birden çok hesap çalıştırın (her biri kendi `accountId` değeriyle): +Kanal başına birden çok hesap çalıştırın (her birinin kendi `accountId` değeri vardır): ```json5 { @@ -716,11 +733,11 @@ Kanal başına birden çok hesap çalıştırın (her biri kendi `accountId` de telegram: { accounts: { default: { - name: "Primary bot", + name: "Birincil bot", botToken: "123456:ABC...", }, alerts: { - name: "Alerts bot", + name: "Uyarı botu", botToken: "987654:XYZ...", }, }, @@ -729,28 +746,28 @@ Kanal başına birden çok hesap çalıştırın (her biri kendi `accountId` de } ``` -- `accountId` atlandığında `default` kullanılır (CLI + yönlendirme). -- Ortam tokenleri 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` içine taşır; Matrix ise bunun yerine mevcut eşleşen adlandırılmış/varsayılan hedefi koruyabilir. -- Mevcut yalnızca kanal bağlamaları (`accountId` olmadan) varsayılan hesapla eşleşmeye devam eder; hesap kapsamlı bağlamalar isteğe bağlı kalır. -- `openclaw doctor --fix` de karışık biçimleri 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. +- `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. ### Diğer uzantı kanalları -Birçok uzantı kanalı `channels.` olarak yapılandırılır ve kendi kanal sayfalarında belgelenir (örneğin Feishu, Matrix, LINE, Nostr, Zalo, Nextcloud Talk, Synology Chat ve Twitch). +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). -### Grup sohbeti bahsetme geçidi +### Grup sohbeti mention gating -Grup mesajlarında varsayılan davranış **bahsetme gerektir** (meta veri bahsetmeleri veya güvenli regex desenleri). WhatsApp, Telegram, Discord, Google Chat ve iMessage grup sohbetlerine uygulanır. +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. -**Bahsetme türleri:** +**Mention türleri:** -- **Meta veri bahsetmeleri**: Yerel platform @-bahsetmeleri. 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 yinelemeler yok sayılır. -- Bahsetme geçidi yalnızca algılama mümkün olduğunda uygulanır (yerel bahsetmeler veya en az bir desen). +- **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). ```json5 { @@ -780,13 +797,13 @@ Grup mesajlarında varsayılan davranış **bahsetme gerektir** (meta veri bahse } ``` -Çözümleme sırası: DM başına geçersiz kılma → sağlayıcı varsayılanı → sınır yok (hepsi tutulur). +Çözümleme: DM başına geçersiz kılma → sağlayıcı varsayılanı → sınır yok (tümü 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 dahil edin (yerel @-bahsetmeleri 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 { @@ -807,18 +824,24 @@ Self-chat modunu etkinleştirmek için kendi numaranızı `allowFrom` içine dah } ``` -### Komutlar (sohbet komutu işleme) +### Commands (sohbet komutu işleme) ```json5 { commands: { - native: "auto", // register native commands when supported - text: true, // parse /commands in chat messages - bash: false, // allow ! (alias: /bash) + 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) bashForegroundMs: 2000, - config: false, // allow /config - debug: false, // allow /debug - restart: false, // allow /restart + gateway restart tool + 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 + ownerAllowFrom: ["discord:123456789012345678"], + ownerDisplay: "raw", // raw | hash + ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}", allowFrom: { "*": ["user1"], discord: ["user:123"], @@ -830,22 +853,38 @@ Self-chat modunu etkinleştirmek için kendi numaranızı `allowFrom` içine dah -- Metin komutları başında `/` bulunan **bağımsız** mesajlar olmalıdır. -- `native: "auto"` Discord/Telegram için yerel komutları açar, Slack'i kapalı bırakır. -- Kanal başına geçersiz kılma: `channels.discord.commands.native` (bool veya `"auto"`). `false`, daha önce kaydedilmiş komutları temizler. +- 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. +- 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 makine kabuğu için `! ` kullanımını etkinleştirir (`/bash` takma adı). `tools.elevated.enabled` gerektirir ve gönderen `tools.elevated.allowFrom.` içinde olmalıdır. -- `config: true`, `/config` komutunu etkinleştirir (`openclaw.json` okur/yazar). Ağ geçidi `chat.send` istemcileri için kalıcı `/config set|unset` yazmaları ayrıca `operator.admin` gerektirir; salt okunur `/config show` normal yazma kapsamlı operatör istemcileri için kullanılabilir kalır. -- `channels..configWrites`, kanal başına yapılandırma mutasyonlarını kapatır/açar (varsayılan: true). -- Çok hesaplı kanallar için `channels..accounts..configWrites`, o hesabı hedefleyen yazmaları da kapatır/açar (örneğin `/allowlist --config --account ` veya `/config set channels..accounts....`). -- `allowFrom`, sağlayıcı başınadır. Ayarlandığında, **tek** yetkilendirme kaynağı odur (kanal izin listeleri/eşleştirme ve `useAccessGroups` yok sayılır). -- `useAccessGroups: false`, `allowFrom` ayarlı değilken komutların erişim grubu ilkelerini atlamasına izin verir. +- `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. +- `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) + - QQ Bot komutları: [QQ Bot](/tr/channels/qqbot) + - eşleştirme komutları: [Pairing](/tr/channels/pairing) + - LINE kart komutu: [LINE](/tr/channels/line) + - memory dreaming: [Dreaming](/tr/concepts/dreaming) --- -## Agent varsayılanları +## Ajan varsayılanları ### `agents.defaults.workspace` @@ -859,7 +898,7 @@ Varsayılan: `~/.openclaw/workspace`. ### `agents.defaults.repoRoot` -Sistem istemindeki Runtime satırında gösterilen isteğe bağlı depo kökü. Ayarlanmamışsa OpenClaw bunu çalışma alanından yukarı doğru yürüyerek otomatik algılar. +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. ```json5 { @@ -869,29 +908,29 @@ Sistem istemindeki Runtime satırında gösterilen isteğe bağlı depo kökü. ### `agents.defaults.skills` -`agents.list[].skills` ayarlamayan agent'lar için isteğe bağlı varsayılan skill izin listesi. +`agents.list[].skills` ayarlamayan ajanlar için isteğe bağlı varsayılan skill izin listesi. ```json5 { agents: { defaults: { skills: ["github", "weather"] }, list: [ - { id: "writer" }, // inherits github, weather - { id: "docs", skills: ["docs-search"] }, // replaces defaults - { id: "locked-down", skills: [] }, // no skills + { id: "writer" }, // github, weather devralır + { id: "docs", skills: ["docs-search"] }, // varsayılanların yerine geçer + { id: "locked-down", skills: [] }, // skill yok ], }, } ``` -- Varsayılan olarak kısıtlanmamış skill'ler için `agents.defaults.skills` alanını atlayın. -- Varsayılanları devralmak için `agents.list[].skills` alanını atlayın. -- Hiç skill 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. +- 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. ### `agents.defaults.skipBootstrap` -Çalışma alanı bootstrap dosyalarının (`AGENTS.md`, `SOUL.md`, `TOOLS.md`, `IDENTITY.md`, `USER.md`, `HEARTBEAT.md`, `BOOTSTRAP.md`) otomatik oluşturulmasını devre dışı bırakır. +Workspace bootstrap dosyalarının (`AGENTS.md`, `SOUL.md`, `TOOLS.md`, `IDENTITY.md`, `USER.md`, `HEARTBEAT.md`, `BOOTSTRAP.md`) otomatik oluşturulmasını devre dışı bırakır. ```json5 { @@ -901,9 +940,9 @@ Sistem istemindeki Runtime satırında gösterilen isteğe bağlı depo kökü. ### `agents.defaults.contextInjection` -Çalışma alanı bootstrap dosyalarının sistem istemine ne zaman ekleneceğini kontrol eder. Varsayılan: `"always"`. +Workspace bootstrap dosyalarının sistem istemine ne zaman enjekte edileceğini kontrol eder. Varsayılan: `"always"`. -- `"continuation-skip"`: güvenli devam dönüşleri (tamamlanmış bir asistan yanıtından sonra) çalışma alanı bootstrap yeniden eklemesini atlar ve istem boyutunu azaltır. Heartbeat çalıştırmaları 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 istem boyutunu azaltır. Heartbeat çalışmaları ve sıkıştırma sonrası yeniden denemeler yine bağlamı yeniden oluşturur. ```json5 { @@ -913,7 +952,7 @@ Sistem istemindeki Runtime satırında gösterilen isteğe bağlı depo kökü. ### `agents.defaults.bootstrapMaxChars` -Kesilmeden önce çalışma alanı bootstrap dosyası başına azami karakter. Varsayılan: `20000`. +Kırpma öncesi workspace bootstrap dosyası başına en fazla karakter. Varsayılan: `20000`. ```json5 { @@ -923,7 +962,7 @@ Kesilmeden önce çalışma alanı bootstrap dosyası başına azami karakter. V ### `agents.defaults.bootstrapTotalMaxChars` -Tüm çalışma alanı bootstrap dosyaları arasında eklenen toplam azami karakter. Varsayılan: `150000`. +Tüm workspace bootstrap dosyalarından enjekte edilen toplam en fazla karakter. Varsayılan: `150000`. ```json5 { @@ -933,12 +972,12 @@ Tüm çalışma alanı bootstrap dosyaları arasında eklenen toplam azami karak ### `agents.defaults.bootstrapPromptTruncationWarning` -Bootstrap bağlamı kesildiğinde agente görünen uyarı metnini kontrol eder. +Bootstrap bağlamı kırpıldığında ajana görünen uyarı metnini kontrol eder. Varsayılan: `"once"`. -- `"off"`: sistem istemine hiçbir zaman uyarı metni ekleme. -- `"once"`: her benzersiz kesilme imzası için bir kez uyarı ekle (önerilir). -- `"always"`: kesilme olduğu sürece her çalıştırmada uyarı ekle. +- `"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. ```json5 { @@ -948,11 +987,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 azami piksel boyutu. +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. Varsayılan: `1200`. -Daha düşük değerler genellikle ekran görüntüsü ağırlıklı ç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. +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. ```json5 { @@ -962,7 +1001,7 @@ Daha yüksek değerler daha fazla görsel ayrıntıyı korur. ### `agents.defaults.userTimezone` -Sistem istemi bağlamı için saat dilimi (mesaj zaman damgaları için değil). Ana makine saat dilimine geri döner. +Sistem istemi bağlamı için saat dilimi (mesaj zaman damgaları değil). Ana bilgisayar saat dilimine geri döner. ```json5 { @@ -972,7 +1011,7 @@ Sistem istemi bağlamı için saat dilimi (mesaj zaman damgaları için değil). ### `agents.defaults.timeFormat` -Sistem istemindeki saat biçimi. Varsayılan: `auto` (OS tercihi). +Sistem istemindeki zaman biçimi. Varsayılan: `auto` (OS tercihi). ```json5 { @@ -1010,7 +1049,7 @@ Sistem istemindeki saat biçimi. Varsayılan: `auto` (OS tercihi). primary: "anthropic/claude-opus-4-6", fallbacks: ["openai/gpt-5.4-mini"], }, - params: { cacheRetention: "long" }, // global default provider params + params: { cacheRetention: "long" }, // küresel varsayılan sağlayıcı parametreleri pdfMaxBytesMb: 10, pdfMaxPages: 20, thinkingDefault: "low", @@ -1025,64 +1064,64 @@ Sistem istemindeki saat biçimi. Varsayılan: `auto` (OS tercihi). } ``` -- `model`: bir dize (`"provider/model"`) veya nesne (`{ primary, fallbacks }`) kabul eder. +- `model`: bir dize (`"provider/model"`) veya bir nesne (`{ primary, fallbacks }`) kabul eder. - Dize biçimi yalnızca birincil modeli ayarlar. - - Nesne biçimi birincil modeli ve sıralı yedek geçiş modellerini ayarlar. -- `imageModel`: bir dize (`"provider/model"`) veya nesne (`{ primary, fallbacks }`) kabul eder. - - `image` araç yolunda vision model yapılandırması olarak kullanılır. - - Ayrıca seçilen/varsayılan model görsel girdiyi kabul edemediğinde yedek yönlendirme için kullanılır. -- `imageGenerationModel`: bir dize (`"provider/model"`) veya nesne (`{ primary, fallbacks }`) kabul eder. - - Paylaşılan görsel üretimi yeteneği ve gelecekte görsel üreten herhangi bir araç/plugin yüzeyi tarafından kullanılır. + - 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ı/model 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ğrulamalı bir sağlayıcı varsayılanı çıkarabilir. Önce mevcut varsayılan sağlayıcıyı, sonra kalan kayıtlı görsel üretim sağlayıcılarını sağlayıcı kimliği sırasıyla dener. -- `musicGenerationModel`: bir dize (`"provider/model"`) veya nesne (`{ primary, fallbacks }`) kabul eder. - - Paylaşılan müzik üretimi yeteneği ve yerleşik `music_generate` aracı tarafından kullanılır. + - 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. - 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ğrulamalı bir sağlayıcı varsayılanı çıkarabilir. Önce mevcut varsayılan sağlayıcıyı, sonra kalan kayıtlı müzik üretim sağlayıcılarını sağlayıcı kimliği sırasıyla dener. - - Bir sağlayıcı/model 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 nesne (`{ primary, fallbacks }`) kabul eder. - - Paylaşılan video üretimi yeteneği ve yerleşik `video_generate` aracı tarafından kullanılır. + - 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. - 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ğrulamalı bir sağlayıcı varsayılanı çıkarabilir. Önce mevcut varsayılan sağlayıcıyı, sonra kalan kayıtlı video üretim sağlayıcılarını sağlayıcı kimliği sırasıyla dener. - - Bir sağlayıcı/model 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 giriş görseli, 4 giriş 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 nesne (`{ primary, fallbacks }`) kabul eder. - - `pdf` aracı için model yönlendirmesinde kullanılır. - - Atlanırsa PDF aracı önce `imageModel`, ardından çözümlenen oturum/varsayılan modele geri döner. + - 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 değerlendirilen 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`: `provider/model` biçiminde olmalıdır (örn. `openai/gpt-5.4`). Sağlayıcıyı atlarsanız OpenClaw önce bir takma adı, sonra tam bu model kimliği için benzersiz yapılandırılmış sağlayıcı eşleşmesini dener ve ancak sonra yapılandırılmış varsayılan sağlayıcıya geri döner (kullanımdan kaldırılmış 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ı yüzeye çıkarmak yerine ilk yapılandırılmış sağlayıcı/modele 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 sağlayıcı parametreleri. `agents.defaults.params` altında ayarlayın (örn. `{ cacheRetention: "long" }`). -- `params` birleştirme önceliği (yapılandırma): `agents.defaults.params` (genel 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 agent ID) anahtar bazında geçersiz kılar. Ayrıntılar için bkz. [Prompt Caching](/tr/reference/prompt-caching). -- Bu alanları mutasyona uğratan yapılandırma yazıcıları (örneğin `/models set`, `/models set-image` ve yedek ekle/kaldır komutları), mümkün olduğunda kurallı nesne biçimini kaydeder ve mevcut yedek listelerini korur. -- `maxConcurrent`: oturumlar arasında azami paralel agent çalıştırması (her oturum yine sıralanır). Varsayılan: 4. +- `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. -**Yerleşik takma ad kısayolları** (`agents.defaults.models` içinde model bulunduğunda geçerlidir): +**Yerleşik takma ad kısaltmaları** (yalnızca model `agents.defaults.models` içinde olduğ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` | +| 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` | | `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. -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, araç çağrısı akışı için varsayılan olarak `tool_stream` etkinleştirir. Bunu kapatmak için `agents.defaults.models["zai/"].params.tool_stream` değerini `false` yapın. -Anthropic Claude 4.6 modelleri, açık bir düşünme seviyesi ayarlanmamışsa varsayılan olarak `adaptive` thinking kullanır. +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. ### `agents.defaults.cliBackends` -Metin odaklı 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 faydalıdır. +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. ```json5 { @@ -1110,9 +1149,9 @@ Metin odaklı yedek çalıştırmalar için isteğe bağlı CLI arka uçları (a } ``` -- CLI arka uçları metin önceliklidir; araçlar her zaman devre dışıdır. -- `sessionArg` ayarlandığında oturumlar desteklenir. -- `imageArg` dosya yollarını kabul ediyorsa görsel passthrough desteklenir. +- 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. ### `agents.defaults.heartbeat` @@ -1123,16 +1162,16 @@ Periyodik heartbeat çalıştırmaları. agents: { defaults: { heartbeat: { - every: "30m", // 0m disables + every: "30m", // 0m devre dışı bırakır model: "openai/gpt-5.4-mini", includeReasoning: false, - lightContext: false, // default: false; true keeps only HEARTBEAT.md from workspace bootstrap files - isolatedSession: false, // default: false; true runs each heartbeat in a fresh session (no conversation history) + 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) session: "main", to: "+15555550123", - directPolicy: "allow", // allow (default) | block - target: "none", // default: none | options: last | whatsapp | telegram | discord | ... - prompt: "Read HEARTBEAT.md if it exists...", + directPolicy: "allow", // allow (varsayılan) | block + target: "none", // varsayılan: none | seçenekler: last | whatsapp | telegram | discord | ... + prompt: "Varsa HEARTBEAT.md dosyasını oku...", ackMaxChars: 300, suppressToolErrorWarnings: false, }, @@ -1141,13 +1180,13 @@ Periyodik heartbeat çalıştırmaları. } ``` -- `every`: süre dizesi (ms/s/m/h). Varsayılan: `30m` (API anahtarı kimlik doğrulaması) veya `1h` (OAuth kimlik doğrulaması). Devre dışı bırakmak için `0m` ayarlayın. -- `suppressToolErrorWarnings`: `true` olduğunda heartbeat çalıştırmaları sırasında araç 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ıştırmaları hafif bootstrap bağlamı kullanır ve çalışma alanı bootstrap dosyalarından yalnızca `HEARTBEAT.md` dosyasını tutar. -- `isolatedSession`: `true` olduğunda her heartbeat yeni bir oturumda, önceki konuşma geçmişi olmadan çalışır. Cron `sessionTarget: "isolated"` ile aynı yalıtım düzeni. Heartbeat başına token maliyetini yaklaşık 100K'dan yaklaşık 2-5K tokena düşürür. -- Agent başına: `agents.list[].heartbeat` ayarlayın. Herhangi bir agent `heartbeat` tanımlarsa, heartbeat'leri **yalnızca o agent'lar** çalıştırır. -- Heartbeat'ler tam agent dönüşleri çalıştırır — daha kısa aralıklar daha fazla token tüketir. +- `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. +- `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. ### `agents.defaults.compaction` @@ -1157,19 +1196,19 @@ Periyodik heartbeat çalıştırmaları. defaults: { compaction: { mode: "safeguard", // default | safeguard - provider: "my-provider", // id of a registered compaction provider plugin (optional) + provider: "my-provider", // kayıtlı bir compaction sağlayıcı eklentisinin kimliği (isteğe bağlı) timeoutSeconds: 900, reserveTokensFloor: 24000, identifierPolicy: "strict", // strict | off | custom - identifierInstructions: "Preserve deployment IDs, ticket IDs, and host:port pairs exactly.", // used when identifierPolicy=custom - postCompactionSections: ["Session Startup", "Red Lines"], // [] disables reinjection - model: "openrouter/anthropic/claude-sonnet-4-6", // optional compaction-only model override - notifyUser: true, // send a brief notice when compaction starts (default: false) + identifierInstructions: "Dağıtım kimliklerini, bilet kimliklerini ve host:port çiftlerini tam olarak koru.", // 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) memoryFlush: { enabled: true, softThresholdTokens: 6000, - 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.", + 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.", }, }, }, @@ -1178,18 +1217,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ı plugin'inin kimliği. Ayarlandığında, yerleşik LLM özetlemesi yerine sağlayıcının `summarize()` işlevi çağrılır. Başarısızlıkta yerleşik sürüme geri döner. Bir sağlayıcı ayarlamak `mode: "safeguard"` kullanımını zorlar. Bkz. [Compaction](/tr/concepts/compaction). -- `timeoutSeconds`: OpenClaw'ın tek bir compaction işlemini iptal etmeden önce izin verdiği azami saniye. Varsayılan: `900`. -- `identifierPolicy`: `strict` (varsayılan), `off` veya `custom`. `strict`, compaction özetlemesi sırasında yerleşik opak tanımlayıcı koruma yönergesini öne ekler. -- `identifierInstructions`: `identifierPolicy=custom` kullanıldığında kullanılan isteğe bağlı özel tanımlayıcı koruma metni. -- `postCompactionSections`: compaction sonrası yeniden eklenecek isteğe bağlı AGENTS.md H2/H3 bölüm adları. Varsayılan `["Session Startup", "Red Lines"]`; yeniden eklemeyi devre dışı bırakmak için `[]` ayarlayın. Ayarlanmamışsa veya açıkça bu varsayılan çift olarak ayarlanmışsa, eski `Every Session`/`Safety` başlıkları da eski sürüm yedeği olarak kabul edilir. -- `model`: yalnızca compaction özetlemesi için isteğe bağlı `provider/model-id` geçersiz kılması. Ana oturum bir modeli kullanmaya devam ederken compaction özetlerinin başka bir modelle çalışmasını istiyorsanız bunu kullanın; ayarlanmamışsa 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..."). Varsayılan olarak devre dışıdır; amaç compaction'ı sessiz tutmaktır. -- `memoryFlush`: otomatik compaction öncesi kalıcı anıları saklamak için sessiz agentic dönüş. Çalışma alanı salt okunursa atlanır. +- `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. +- `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. ### `agents.defaults.contextPruning` -LLM'ye göndermeden önce bellek içi bağlamdan **eski araç sonuçlarını** budar. Diskteki oturum geçmişini **değiştirmez**. +LLM’ye göndermeden önce bellekteki bağlamdan **eski araç sonuçlarını** budar. Diskteki oturum geçmişini **değiştirmez**. ```json5 { @@ -1197,13 +1236,13 @@ LLM'ye göndermeden önce bellek içi bağlamdan **eski araç sonuçlarını** b defaults: { contextPruning: { mode: "cache-ttl", // off | cache-ttl - ttl: "1h", // duration (ms/s/m/h), default unit: minutes + ttl: "1h", // süre (ms/s/m/h), varsayılan birim: dakika keepLastAssistants: 3, softTrimRatio: 0.3, hardClearRatio: 0.5, minPrunableToolChars: 50000, softTrim: { maxChars: 4000, headChars: 1500, tailChars: 1500 }, - hardClear: { enabled: true, placeholder: "[Old tool result content cleared]" }, + hardClear: { enabled: true, placeholder: "[Eski araç sonuç içeriği temizlendi]" }, tools: { deny: ["browser", "canvas"] }, }, }, @@ -1211,25 +1250,25 @@ LLM'ye göndermeden önce bellek içi bağlamdan **eski araç sonuçlarını** b } ``` - + -- `mode: "cache-ttl"` budama geçişlerini etkinleştirir. -- `ttl`, budamanın yeniden ne kadar sıklıkla çalışabileceğini kontrol eder (son önbellek dokunuşundan sonra). -- Budama, önce aşırı büyük araç sonuçlarını yumuşak şekilde kısaltır, sonra gerekirse eski araç sonuçlarını tamamen temizler. +- `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. -**Yumuşak kısaltma**, başı + sonu tutar ve ortaya `...` ekler. +**Yumuşak kırpma**, başı + sonu tutar ve ortaya `...` ekler. -**Tam temizleme**, tüm araç sonucunu yer tutucuyla değiştirir. +**Sert temizleme**, tüm araç sonucunu yer tutucuyla değiştirir. Notlar: -- Görsel bloklar hiçbir zaman kısaltılmaz/temizlenmez. -- Oranlar karakter tabanlıdır (yaklaşık), tam token sayıları değildir. +- 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. -Davranış ayrıntıları için bkz. [Session Pruning](/tr/concepts/session-pruning). +Davranış ayrıntıları için [Session Pruning](/tr/concepts/session-pruning) sayfasına bakın. ### Blok akışı @@ -1241,19 +1280,19 @@ Davranış ayrıntıları için bkz. [Session Pruning](/tr/concepts/session-prun blockStreamingBreak: "text_end", // text_end | message_end blockStreamingChunk: { minChars: 800, maxChars: 1200 }, blockStreamingCoalesce: { idleMs: 1000 }, - humanDelay: { mode: "natural" }, // off | natural | custom (use minMs/maxMs) + humanDelay: { mode: "natural" }, // off | natural | custom (minMs/maxMs kullanın) }, }, } ``` -- 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 için varsayılan `minChars: 1500`. -- `humanDelay`: blok yanıtlar arasında rastgele duraklama. `natural` = 800–2500ms. Agent başına geçersiz kılma: `agents.list[].humanDelay`. +- 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`. -Davranış + parçalara ayırma ayrıntıları için bkz. [Streaming](/tr/concepts/streaming). +Davranış + parçalama ayrıntıları için [Streaming](/tr/concepts/streaming) sayfasına bakın. -### Yazıyor göstergeleri +### Yazma göstergeleri ```json5 { @@ -1266,7 +1305,7 @@ Davranış + parçalara ayırma ayrıntıları için bkz. [Streaming](/tr/concep } ``` -- Varsayılanlar: doğrudan sohbetler/bahsetmeler için `instant`, bahsedilmemiş grup sohbetleri için `message`. +- Varsayılanlar: doğrudan sohbetler/mention’lar için `instant`, mention içermeyen grup sohbetleri için `message`. - Oturum başına geçersiz kılmalar: `session.typingMode`, `session.typingIntervalSeconds`. Bkz. [Typing Indicators](/tr/concepts/typing-indicators). @@ -1275,7 +1314,7 @@ Bkz. [Typing Indicators](/tr/concepts/typing-indicators). ### `agents.defaults.sandbox` -Gömülü agent için isteğe bağlı sandboxing. Tam kılavuz için bkz. [Sandboxing](/tr/gateway/sandboxing). +Gömülü ajan için isteğe bağlı sandboxing. Tam kılavuz için [Sandboxing](/tr/gateway/sandboxing) sayfasına bakın. ```json5 { @@ -1321,7 +1360,7 @@ Gömülü agent için isteğe bağlı sandboxing. Tam kılavuz için bkz. [Sandb identityFile: "~/.ssh/id_ed25519", certificateFile: "~/.ssh/id_ed25519-cert.pub", knownHostsFile: "~/.ssh/known_hosts", - // SecretRefs / inline contents also supported: + // SecretRef / satır içi içerik 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" }, @@ -1385,39 +1424,39 @@ Gömülü agent için isteğe bağlı sandboxing. Tam kılavuz için bkz. [Sandb - `target`: `user@host[:port]` biçiminde SSH hedefi - `command`: SSH istemci komutu (varsayılan: `ssh`) -- `workspaceRoot`: kapsam başına çalışma alanları 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 zamanı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 kimlik doğrulama önceliği:** +**SSH auth önceliği:** -- `identityData`, `identityFile` üzerinde kazanır -- `certificateData`, `certificateFile` üzerinde kazanır -- `knownHostsData`, `knownHostsFile` üzerinde kazanır -- SecretRef destekli `*Data` değerleri, sandbox oturumu başlamadan önce etkin gizli anahtar çalışma zamanı anlık görüntüsünden çözümlenir +- `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 **SSH arka uç davranışı:** -- oluşturma veya yeniden oluşturma sonrası uzak çalışma alanını bir kez tohumlar -- ardından uzak SSH çalışma alanını kurallı tutar +- 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 makineye geri senkronize etmez +- uzak değişiklikleri otomatik olarak ana bilgisayara geri senkronize etmez - sandbox tarayıcı kapsayıcılarını desteklemez -**Çalışma alanı erişimi:** +**Workspace erişimi:** -- `none`: `~/.openclaw/sandboxes` altında kapsam başına sandbox çalışma alanı -- `ro`: `/workspace` altında sandbox çalışma alanı, `/agent` altında salt okunur agent çalışma alanı -- `rw`: `/workspace` altında okuma/yazma olarak bağlanan agent çalışma alanı +- `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 **Kapsam:** -- `session`: oturum başına kapsayıcı + çalışma alanı -- `agent`: agent başına tek kapsayıcı + çalışma alanı (varsayılan) -- `shared`: paylaşılan kapsayıcı ve çalışma alanı (oturumlar arası yalıtım yok) +- `session`: oturum başına kapsayıcı + workspace +- `agent`: ajan başına bir kapsayıcı + workspace (varsayılan) +- `shared`: paylaşılan kapsayıcı ve workspace (oturumlar arası yalıtım yok) -**OpenShell plugin yapılandırması:** +**OpenShell eklenti yapılandırması:** ```json5 { @@ -1430,10 +1469,10 @@ Gömülü agent için isteğe bağlı sandboxing. Tam kılavuz için bkz. [Sandb from: "openclaw", remoteWorkspaceDir: "/sandbox", remoteAgentWorkspaceDir: "/agent", - gateway: "lab", // optional - gatewayEndpoint: "https://lab.example", // optional - policy: "strict", // optional OpenShell policy id - providers: ["openai"], // optional + gateway: "lab", // isteğe bağlı + gatewayEndpoint: "https://lab.example", // isteğe bağlı + policy: "strict", // isteğe bağlı OpenShell ilke kimliği + providers: ["openai"], // isteğe bağlı autoProviders: true, timeoutSeconds: 120, }, @@ -1445,32 +1484,32 @@ Gömülü agent için isteğe bağlı sandboxing. Tam kılavuz için bkz. [Sandb **OpenShell modu:** -- `mirror`: exec öncesi uzaktakini yerelden tohumla, exec sonrası geri senkronize et; yerel çalışma alanı kurallı kalır -- `remote`: uzaktakini sandbox oluşturulurken bir kez tohumla, ardından uzak çalışma alanını kurallı tut +- `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 -`remote` modunda, OpenClaw dışından yapılan ana makine yerel düzenlemeleri tohum adımından sonra otomatik olarak sandbox içine senkronize edilmez. -Taşıma, OpenShell sandbox içine SSH ile yapılır, ancak sandbox yaşam döngüsüne ve isteğe bağlı mirror sync'e plugin sahiptir. +`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. -**`setupCommand`**, kapsayıcı oluşturulduktan sonra bir kez çalışır (`sh -lc` ile). Ağ çıkışı, yazılabilir kök, root kullanıcı gerekir. +**`setupCommand`**, kapsayıcı oluşturulduktan sonra bir kez çalışır (`sh -lc` ile). Ağ çıkışı, yazılabilir kök ve root kullanıcı gerektirir. -**Kapsayıcıların varsayılanı `network: "none"` şeklindedir** — agent dışa erişime ihtiyaç duyuyorsa `"bridge"` (veya özel bir bridge ağı) olarak ayarlayın. -`"host"` engellenir. Varsayılan olarak `"container:"` de engellenir; bunu yalnızca açıkça -`sandbox.docker.dangerouslyAllowContainerNamespaceJoin: true` ayarlarsanız açabilirsiniz (acil durum). +**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). -**Gelen ek dosyalar**, etkin çalışma alanında `media/inbound/*` içine hazırlanır. +**Gelen ek dosyalar**, etkin workspace içindeki `media/inbound/*` içine hazırlanır. -**`docker.binds`**, ek ana makine dizinlerini bağlar; genel ve agent başına bind değerleri birleştirilir. +**`docker.binds`**, ek ana bilgisayar dizinlerini bağlar; genel ve ajan başına binds birleştirilir. -**Sandboxed browser** (`sandbox.browser.enabled`): bir kapsayıcı içinde Chromium + CDP. noVNC URL'si sistem istemine eklenir. `openclaw.json` içinde `browser.enabled` gerektirmez. -noVNC gözlemci erişimi varsayılan olarak VNC kimlik doğrulaması kullanır ve OpenClaw kısa ömürlü token URL üretir (paylaşılan URL içinde parolayı açığa çıkarmak yerine). +**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. -- `allowHostControl: false` (varsayılan), sandboxed oturumların ana makine tarayıcısını hedeflemesini engeller. -- `network` varsayılan olarak `openclaw-sandbox-browser` (ayrılmış bridge ağı) kullanır. Küresel bridge bağlantısı özellikle istendiğinde yalnızca `bridge` ayarlayın. +- `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 makine 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ımlanmıştır ve kapsayıcı ana makineleri için ayarlanmıştır: +- `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: - `--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` @@ -1487,29 +1526,29 @@ noVNC gözlemci erişimi varsayılan olarak VNC kimlik doğrulaması kullanır v - `--metrics-recording-only` - `--disable-extensions` (varsayılan olarak etkin) - `--disable-3d-apis`, `--disable-software-rasterizer` ve `--disable-gpu` - varsayılan olarak etkindir; WebGL/3D kullanımı gerekiyorsa + varsayılan olarak etkindir ve WebGL/3D kullanımı gerektiriyorsa `OPENCLAW_BROWSER_DISABLE_GRAPHICS_FLAGS=0` ile devre dışı bırakılabilir. - - İş akışınız buna bağlıysa `OPENCLAW_BROWSER_DISABLE_EXTENSIONS=0` + - `OPENCLAW_BROWSER_DISABLE_EXTENSIONS=0`, iş akışınız buna bağlıysa uzantıları yeniden etkinleştirir. - - `--renderer-process-limit=2`, - `OPENCLAW_BROWSER_RENDERER_PROCESS_LIMIT=` ile değiştirilebilir; Chromium'un + - `--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. - - ayrıca `noSandbox` etkin olduğunda `--no-sandbox` ve `--disable-setuid-sandbox`. - - Varsayılanlar kapsayıcı görseli taban çizgisidir; kapsayıcı varsayılanlarını değiştirmek için - özel giriş noktası olan özel bir tarayıcı görseli kullanı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. -Tarayıcı sandboxing ve `sandbox.docker.binds` şu anda yalnızca Docker içindir. +Tarayıcı sandboxing ve `sandbox.docker.binds` şu anda yalnızca Docker’da desteklenir. Görselleri oluşturun: ```bash -scripts/sandbox-setup.sh # main sandbox image -scripts/sandbox-browser-setup.sh # optional browser image +scripts/sandbox-setup.sh # ana sandbox görseli +scripts/sandbox-browser-setup.sh # isteğe bağlı tarayıcı görseli ``` -### `agents.list` (agent başına geçersiz kılmalar) +### `agents.list` (ajan başına geçersiz kılmalar) ```json5 { @@ -1518,18 +1557,18 @@ scripts/sandbox-browser-setup.sh # optional browser image { id: "main", default: true, - name: "Main Agent", + name: "Ana Ajan", workspace: "~/.openclaw/workspace", agentDir: "~/.openclaw/agents/main/agent", - model: "anthropic/claude-opus-4-6", // or { primary, fallbacks } - thinkingDefault: "high", // per-agent thinking level override - reasoningDefault: "on", // per-agent reasoning visibility override - fastModeDefault: false, // per-agent fast mode override - params: { cacheRetention: "none" }, // overrides matching defaults.models params by key - skills: ["docs-search"], // replaces agents.defaults.skills when set + 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ı + 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 identity: { name: "Samantha", - theme: "helpful sloth", + theme: "yardımsever tembel hayvan", emoji: "🦥", avatar: "avatars/samantha.png", }, @@ -1557,26 +1596,26 @@ scripts/sandbox-browser-setup.sh # optional browser image } ``` -- `id`: kararlı agent kimliği (gerekli). -- `default`: birden çok ayarlanırsa ilk olan kazanır (uyarı kaydedilir). Hiçbiri ayarlanmazsa ilk liste girdisi varsayılan olur. -- `model`: dize biçimi yalnızca `primary` değerini geçersiz kılar; nesne biçimi `{ primary, fallbacks }` ikisini de geçersiz kılar (`[]`, genel yedekleri devre dışı bırakır). Yalnızca `primary` geçersiz kılan cron işleri, `fallbacks: []` ayarlamadığınız sürece varsayılan yedekleri devralmaya devam eder. -- `params`: seçilen model girişinde `agents.defaults.models` üzerine birleştirilen agent başına akış parametreleri. Tüm model kataloğunu çoğaltmadan `cacheRetention`, `temperature` veya `maxTokens` gibi agent'e özgü geçersiz kılmalar için bunu kullanın. -- `skills`: isteğe bağlı agent başına skill izin listesi. Atlanırsa agent, ayarlıysa `agents.defaults.skills` değerini devralır; açık bir liste varsayılanlarla birleşmek yerine onların yerine geçer ve `[]` hiç skill olmadığı anlamına gelir. -- `thinkingDefault`: isteğe bağlı agent başına varsayılan thinking düzeyi (`off | minimal | low | medium | high | xhigh | adaptive`). Mesaj veya oturum başına geçersiz kılma ayarlı değilse bu agent için `agents.defaults.thinkingDefault` değerinin önüne geçer. -- `reasoningDefault`: isteğe bağlı agent başına varsayılan reasoning görünürlüğü (`on | off | stream`). Mesaj veya oturum başına reasoning geçersiz kılması yoksa uygulanır. -- `fastModeDefault`: isteğe bağlı agent başına fast mode varsayılanı (`true | false`). Mesaj veya oturum başına fast-mode geçersiz kılması yoksa 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`: çalışma alanı göreli yolu, `http(s)` URL'si veya `data:` URI'si. -- `identity`, varsayılanları türetir: `emoji` içinden `ackReaction`, `name`/`emoji` içinden `mentionPatterns`. -- `subagents.allowAgents`: `sessions_spawn` için agent kimliği izin listesi (`["*"]` = herhangi biri; varsayılan: yalnızca aynı agent). -- Sandbox devralma koruması: istekte bulunan oturum sandboxed ise `sessions_spawn`, sandbox olmadan ç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ı 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). --- -## Çok agent'lı yönlendirme +## Çok ajanlı yönlendirme -Tek bir Gateway içinde birden fazla yalıtılmış agent çalıştırın. Bkz. [Multi-Agent](/tr/concepts/multi-agent). +Tek bir Gateway içinde birden çok yalıtılmış ajan çalıştırın. Bkz. [Multi-Agent](/tr/concepts/multi-agent). ```json5 { @@ -1593,10 +1632,10 @@ Tek bir Gateway içinde birden fazla yalıtılmış agent çalıştırın. Bkz. } ``` -### Bağlama eşleşme alanları +### Bağ eşleştirme alanları -- `type` (isteğe bağlı): normal yönlendirme için `route` (tip eksikse varsayılan route olur), kalıcı ACP konuşma bağlamaları için `acp`. -- `match.channel` (gerekli) +- `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) - `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ü) @@ -1609,13 +1648,13 @@ Tek bir Gateway içinde birden fazla yalıtılmış agent çalıştırın. Bkz. 3. `match.teamId` 4. `match.accountId` (tam eşleşme, peer/guild/team olmadan) 5. `match.accountId: "*"` (kanal genelinde) -6. Varsayılan agent +6. Varsayılan ajan -Her katman içinde, eşleşen ilk `bindings` girişi kazanır. +Her katmanda ilk eşleşen `bindings` girdisi kazanır. -`type: "acp"` girişleri için OpenClaw tam konuşma kimliğine göre çözümler (`match.channel` + hesap + `match.peer.id`) ve yukarıdaki route bağlama katman sırasını kullanmaz. +`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. -### Agent başına erişim profilleri +### Ajan başına erişim profilleri @@ -1635,7 +1674,7 @@ Her katman içinde, eşleşen ilk `bindings` girişi kazanır. - + ```json5 { @@ -1710,11 +1749,11 @@ Her katman içinde, eşleşen ilk `bindings` girişi kazanır. -Öncelik ayrıntıları için bkz. [Multi-Agent Sandbox & Tools](/tr/tools/multi-agent-sandbox-tools). +Öncelik ayrıntıları için [Multi-Agent Sandbox & Tools](/tr/tools/multi-agent-sandbox-tools) sayfasına bakın. --- -## Oturum +## Session ```json5 { @@ -1736,22 +1775,22 @@ Her katman içinde, eşleşen ilk `bindings` girişi kazanır. }, resetTriggers: ["/new", "/reset"], store: "~/.openclaw/agents/{agentId}/sessions/sessions.json", - parentForkMaxTokens: 100000, // skip parent-thread fork above this token count (0 disables) + parentForkMaxTokens: 100000, // üst iş parçacığı fork’u bu belirteç sayısının üzerinde atlanır (0 devre dışı bırakır) maintenance: { mode: "warn", // warn | enforce pruneAfter: "30d", maxEntries: 500, rotateBytes: "10mb", - resetArchiveRetention: "30d", // duration or false - maxDiskBytes: "500mb", // optional hard budget - highWaterBytes: "400mb", // optional cleanup target + resetArchiveRetention: "30d", // süre veya false + maxDiskBytes: "500mb", // isteğe bağlı katı bütçe + highWaterBytes: "400mb", // isteğe bağlı temizleme hedefi }, threadBindings: { enabled: true, - idleHours: 24, // default inactivity auto-unfocus in hours (`0` disables) - maxAgeHours: 0, // default hard max age in hours (`0` disables) + 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) }, - mainKey: "main", // legacy (runtime always uses "main") + mainKey: "main", // eski (çalışma zamanı her zaman "main" kullanır) agentToAgent: { maxPingPongTurns: 5 }, sendPolicy: { rules: [{ action: "deny", match: { channel: "discord", chatType: "group" } }], @@ -1764,45 +1803,45 @@ Her katman içinde, eşleşen ilk `bindings` girişi kazanır. - **`scope`**: grup sohbeti bağlamları için temel oturum gruplama stratejisi. - - `per-sender` (varsayılan): bir kanal bağlamı içinde her gönderici 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ır. - - `per-channel-peer`: kanal + gönderici başına yalıtır (çok kullanıcılı gelen kutuları için önerilir). - - `per-account-channel-peer`: hesap + kanal + gönderici başına yalıtır (çok hesaplı kullanım için önerilir). -- **`identityLinks`**: kanallar arası oturum paylaşımı için kurallı kimlikleri sağlayıcı önekli eşlere eşler. -- **`reset`**: birincil sıfırlama ilkesi. `daily`, yerel saatle `atHour` zamanında sıfırlar; `idle`, `idleMinutes` süresinden sonra sıfırlar. İkisi de yapılandırılmışsa, hangisi önce dolarsa o uygulanır. + - `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. - **`resetByType`**: tür başına geçersiz kılmalar (`direct`, `group`, `thread`). Eski `dm`, `direct` için takma ad olarak kabul edilir. -- **`parentForkMaxTokens`**: çatallanmış bir iş parçacığı oturumu oluşturulurken üst oturumun izin verilen azami `totalTokens` değeri (varsayılan `100000`). - - Üst oturum `totalTokens` bu değerin ü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 üst çatallamaya her zaman izin vermek için `0` ayarlayın. +- **`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`**: agent'dan agent'a alışverişlerinde azami geri yanıtlama dönüşü (tam sayı, aralık: `0`–`5`). `0`, ping-pong zincirlemeyi devre dışı bırakır. -- **`sendPolicy`**: `channel`, `chatType` (`direct|group|channel`, eski `dm` takma adıyla), `keyPrefix` veya `rawKeyPrefix` ile eşleşir. İlk deny kazanır. -- **`maintenance`**: oturum deposu temizliği + saklama kontrolleri. - - `mode`: `warn` yalnızca uyarı üretir; `enforce` temizliği uygular. - - `pruneAfter`: bayat girişler için yaş sınırı (varsayılan `30d`). - - `maxEntries`: `sessions.json` içindeki azami giriş sayısı (varsayılan `500`). - - `rotateBytes`: `sessions.json` bu boyutu aşarsa dosyayı döndür (varsayılan `10mb`). +- **`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. +- **`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`: oturumlar dizini için isteğe bağlı disk bütçesi. `warn` modunda uyarı kaydeder; `enforce` modunda en eski artifact/oturumlar önce kaldırılır. - - `highWaterBytes`: bütçe temizliği sonrası isteğe bağlı hedef. Varsayılan olarak `maxDiskBytes` değerinin `%80`'i kullanılır. -- **`threadBindings`**: iş parçacığına bağlı oturum özellikleri için genel varsayılanlar. + - `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. - `enabled`: ana varsayılan anahtar (sağlayıcılar geçersiz kılabilir; Discord `channels.discord.threadBindings.enabled` kullanır) - - `idleHours`: saat cinsinden etkinliksizlik nedeniyle otomatik odak kaldırma için genel varsayılan (`0` devre dışı bırakır; sağlayıcılar geçersiz kılabilir) - - `maxAgeHours`: saat cinsinden kesin azami yaş için genel varsayılan (`0` devre dışı bırakır; sağlayıcılar geçersiz kılabilir) + - `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) --- -## Mesajlar +## Messages ```json5 { messages: { - responsePrefix: "🦞", // or "auto" + responsePrefix: "🦞", // veya "auto" ackReaction: "👀", ackReactionScope: "group-mentions", // group-mentions | group-all | direct | all removeAckAfterReply: false, @@ -1817,7 +1856,7 @@ Her katman içinde, eşleşen ilk `bindings` girişi kazanır. }, }, inbound: { - debounceMs: 2000, // 0 disables + debounceMs: 2000, // 0 devre dışı bırakır byChannel: { whatsapp: 5000, slack: 1500, @@ -1831,36 +1870,36 @@ Her katman içinde, eşleşen ilk `bindings` girişi kazanır. Kanal/hesap başına geçersiz kılmalar: `channels..responsePrefix`, `channels..accounts..responsePrefix`. -Çözümleme (en özeli kazanır): hesap → kanal → genel. `""` bunu devre dışı bırakır ve zinciri durdurur. `"auto"` değeri `[{identity.name}]` türetir. +Çözümleme (en özeli 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}` | Agent kimlik adı | (`"auto"` ile aynı) | +| `{provider}` | Sağlayıcı adı | `anthropic` | +| `{thinkingLevel}` | Geçerli thinking düzeyi | `high`, `low`, `off` | +| `{identity.name}` | Ajan kimlik adı | (`"auto"` ile aynı) | -Değişkenler büyük/küçük harfe duyarsızdır. `{think}`, `{thinkingLevel}` için bir takma addır. +Değişkenler büyük/küçük harfe duyarsızdır. `{think}`, `{thinkingLevel}` için takma addır. -### Ack reaksiyonu +### Ack tepkisi -- Varsayılan olarak etkin agent'ın `identity.emoji` değerini, yoksa `"👀"` kullanır. Devre dışı bırakmak için `""` ayarlayın. +- Varsayılan olarak etkin ajanın `identity.emoji` değeri, yoksa `"👀"` kullanılır. 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` → identity yedeği. +- Çözümleme sırası: hesap → kanal → `messages.ackReaction` → kimlik yedeği. - Kapsam: `group-mentions` (varsayılan), `group-all`, `direct`, `all`. -- `removeAckAfterReply`: Slack, Discord ve Telegram'da yanıttan sonra 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 ayarsız bırakmak, ack reaksiyonları etkin olduğunda durum tepkilerini etkin tutar. - Telegram'da yaşam döngüsü durum tepkilerini etkinleştirmek için bunu açıkça `true` yapın. +- `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. ### Gelen debounce -Aynı göndericiden hızla gelen yalnızca metin içeren mesajları tek bir agent dönüşünde toplar. Medya/ek dosyalar hemen flush edilir. Kontrol komutları debounce'u atlar. +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. -### TTS (metinden sese) +### TTS (metinden konuşmaya) ```json5 { @@ -1901,12 +1940,12 @@ Aynı göndericiden hızla gelen yalnızca metin içeren mesajları tek bir agen } ``` -- `auto`, otomatik TTS'yi kontrol eder. `/tts off|always|inbound|tagged` komutu bunu oturum başına geçersiz kılar. +- `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ı açma). +- `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ç noktayı gösterdiğinde, OpenClaw bunu OpenAI uyumlu bir TTS sunucusu olarak ele alır ve model/ses doğrulamasını gevşetir. +- `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. --- @@ -1936,13 +1975,13 @@ Talk modu için varsayılanlar (macOS/iOS/Android). } ``` -- Birden fazla Talk sağlayıcısı yapılandırıldığında `talk.provider`, `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, yedek olarak `ELEVENLABS_VOICE_ID` veya `SAG_VOICE_ID` kullanır. +- `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 bir Talk API anahtarı yapılandırılmadığında uygulanır. +- `ELEVENLABS_API_KEY` yedeği, 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 dökümü göndermeden önce kullanıcı sessizliğinden sonra ne kadar bekleyeceğini kontrol eder. Ayarlanmamışsa platform varsayılan duraklama penceresi kullanılır (`macOS ve Android'de 700 ms, iOS'ta 900 ms`). +- `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`). --- @@ -1952,20 +1991,20 @@ Talk modu için varsayılanlar (macOS/iOS/Android). `tools.profile`, `tools.allow`/`tools.deny` öncesinde temel bir izin listesi ayarlar: -Yerel onboarding, ayarsız yeni yerel yapılandırmaları varsayılan olarak `tools.profile: "coding"` ile başlatır (mevcut açık profiller korunur). +Yerel onboarding, ayarlanmamış yeni yerel yapılandırmalar için varsayılan olarak `tools.profile: "coding"` kullanır (mevcut açık profiller korunur). | 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ış olanla aynı) | +| `full` | Kısıtlama yok (ayarlanmamış ile aynı) | ### Araç grupları -| Grup | Araçlar | -| ------------------ | ------------------------------------------------------------------------------------------------------------------------ | -| `group:runtime` | `exec`, `process`, `code_execution` (`bash`, `exec` için bir takma ad olarak kabul edilir) | +| 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` | | `group:sessions` | `sessions_list`, `sessions_history`, `sessions_send`, `sessions_spawn`, `sessions_yield`, `subagents`, `session_status` | | `group:memory` | `memory_search`, `memory_get` | @@ -1976,11 +2015,11 @@ Yerel onboarding, ayarsız yeni yerel yapılandırmaları varsayılan olarak `to | `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ı plugin'leri hariç) | +| `group:openclaw` | Tüm yerleşik araçlar (sağlayıcı eklentileri hariç) | ### `tools.allow` / `tools.deny` -Genel araç izin/engelleme ilkesi (deny kazanır). Büyük/küçük harfe duyarsızdır, `*` joker karakterlerini destekler. Docker sandbox kapalı olsa bile uygulanır. +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. ```json5 { @@ -2022,9 +2061,9 @@ Sandbox dışındaki elevated exec erişimini kontrol eder: } ``` -- 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 kaydeder; satır içi yönergeler tek mesaja uygulanır. -- Elevated `exec`, sandboxing'i atlar ve yapılandırılmış çıkış yolunu kullanır (varsayılan olarak `gateway`, exec hedefi `node` ise `node`). +- 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`). ### `tools.exec` @@ -2048,8 +2087,8 @@ Sandbox dışındaki elevated exec erişimini kontrol eder: ### `tools.loopDetection` -Araç 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` içinde tanımlanabilir ve agent başına `agents.list[].tools.loopDetection` altında geçersiz kılınabilir. +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. ```json5 { @@ -2070,13 +2109,13 @@ Ayarlar genel olarak `tools.loopDetection` içinde tanımlanabilir ve agent baş } ``` -- `historySize`: döngü analizi için tutulan azami araç çağrısı geçmişi. -- `warningThreshold`: uyarılar için yinelenen ilerleme yok deseni eşiği. -- `criticalThreshold`: kritik döngüleri engellemek için daha yüksek yinelenme eşiği. -- `globalCircuitBreakerThreshold`: herhangi bir ilerleme yok çalıştırması için kesin durdurma eşiği. -- `detectors.genericRepeat`: aynı araç/aynı argüman çağrılarının yinelenmesi konusunda uyarır. -- `detectors.knownPollNoProgress`: bilinen poll araçlarında (`process.poll`, `command_status` vb.) ilerleme yoksa uyarır/engeller. -- `detectors.pingPong`: dönüşümlü ilerleme yok ikili desenler konusunda uyarır/engeller. +- `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. +- `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. +- `detectors.pingPong`: dönüşümlü ilerleme olmayan çift desenlerinde uyar/engelle. - `warningThreshold >= criticalThreshold` veya `criticalThreshold >= globalCircuitBreakerThreshold` ise doğrulama başarısız olur. ### `tools.web` @@ -2087,14 +2126,14 @@ Ayarlar genel olarak `tools.loopDetection` içinde tanımlanabilir ve agent baş web: { search: { enabled: true, - apiKey: "brave_api_key", // or BRAVE_API_KEY env + apiKey: "brave_api_key", // veya BRAVE_API_KEY ortam değişkeni maxResults: 5, timeoutSeconds: 30, cacheTtlMinutes: 15, }, fetch: { enabled: true, - provider: "firecrawl", // optional; omit for auto-detect + provider: "firecrawl", // isteğe bağlı; otomatik algılama için atlayın maxChars: 50000, maxCharsCap: 50000, maxResponseBytes: 2000000, @@ -2111,7 +2150,7 @@ Ayarlar genel olarak `tools.loopDetection` içinde tanımlanabilir ve agent baş ### `tools.media` -Gelen medya anlama (görsel/ses/video) yapılandırması: +Gelen medya anlama yapılandırması (görsel/ses/video): ```json5 { @@ -2119,7 +2158,7 @@ Gelen medya anlama (görsel/ses/video) yapılandırması: media: { concurrency: 2, asyncCompletion: { - directSend: false, // opt-in: send finished async music/video directly to the channel + directSend: false, // isteğe bağlı etkinleştirme: tamamlanan eşzamansız müzik/video işlerini doğrudan kanala gönder }, audio: { enabled: true, @@ -2143,15 +2182,15 @@ Gelen medya anlama (görsel/ses/video) yapılandırması: } ``` - + -**Sağlayıcı girişi** (`type: "provider"` veya atlanmış): +**Sağlayıcı 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ı - `profile` / `preferredProfile`: `auth-profiles.json` profil seçimi -**CLI girişi** (`type: "cli"`): +**CLI girdisi** (`type: "cli"`): - `command`: çalıştırılacak yürütülebilir dosya - `args`: şablonlu argümanlar (`{{MediaPath}}`, `{{Prompt}}`, `{{MaxChars}}` vb. desteklenir) @@ -2159,14 +2198,14 @@ Gelen medya anlama (görsel/ses/video) yapılandırması: **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`: giriş başına geçersiz kılmalar. -- Hatalar sonraki girişe geri düşer. +- `prompt`, `maxChars`, `maxBytes`, `timeoutSeconds`, `language`: girdi başına geçersiz kılmalar. +- Hatalarda sonraki girdiye geri düşülür. -Sağlayıcı kimlik doğrulaması standart sırayı izler: `auth-profiles.json` → ortam değişkenleri → `models.providers.*.apiKey`. +Sağlayıcı auth standart sırayı izler: `auth-profiles.json` → ortam değişkenleri → `models.providers.*.apiKey`. -**Async completion alanları:** +**Eşzamansız tamamlama alanları:** -- `asyncCompletion.directSend`: `true` olduğunda, tamamlanan asenkron `music_generate` +- `asyncCompletion.directSend`: `true` olduğunda tamamlanan eşzamansız `music_generate` ve `video_generate` görevleri önce doğrudan kanal teslimini dener. Varsayılan: `false` (eski requester-session wake/model-delivery yolu). @@ -2187,9 +2226,9 @@ Sağlayıcı kimlik doğrulaması standart sırayı izler: `auth-profiles.json` ### `tools.sessions` -Oturum araçlarının (`sessions_list`, `sessions_history`, `sessions_send`) hangi oturumları hedefleyebileceğini kontrol eder. +Oturum araçları (`sessions_list`, `sessions_history`, `sessions_send`) tarafından hangi oturumların hedeflenebileceğini kontrol eder. -Varsayılan: `tree` (geçerli oturum + onun oluşturduğu oturumlar, örneğin subagent'lar). +Varsayılan: `tree` (mevcut oturum + onun tarafından oluşturulan oturumlar, örneğin subagent’lar). ```json5 { @@ -2204,11 +2243,11 @@ Varsayılan: `tree` (geçerli oturum + onun oluşturduğu oturumlar, örneğin s Notlar: -- `self`: yalnızca geçerli oturum anahtarı. -- `tree`: geçerli oturum + geçerli oturumun oluşturduğu oturumlar (subagent'lar). -- `agent`: geçerli agent kimliğine ait herhangi bir oturum (aynı agent kimliği altında gönderici başına oturumlar çalıştırıyorsanız başka kullanıcıları da içerebilir). -- `all`: herhangi bir oturum. Agent'lar arası hedefleme yine de `tools.agentToAgent` gerektirir. -- Sandbox kıskacı: geçerli oturum sandboxed olduğunda ve `agents.defaults.sandbox.sessionToolsVisibility="spawned"` ise, `tools.sessions.visibility="all"` olsa bile görünürlük `tree` olarak zorlanır. +- `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. ### `tools.sessions_spawn` @@ -2219,11 +2258,11 @@ Notlar: tools: { sessions_spawn: { attachments: { - enabled: false, // opt-in: set true to allow inline file attachments - maxTotalBytes: 5242880, // 5 MB total across all files + 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 maxFiles: 50, - maxFileBytes: 1048576, // 1 MB per file - retainOnSessionKeep: false, // keep attachments when cleanup="keep" + maxFileBytes: 1048576, // dosya başına 1 MB + retainOnSessionKeep: false, // cleanup="keep" olduğunda ekleri koru }, }, }, @@ -2233,21 +2272,21 @@ Notlar: Notlar: - Ek dosyalar yalnızca `runtime: "subagent"` için desteklenir. ACP çalışma zamanı bunları reddeder. -- Dosyalar, alt çalışma alanında `.openclaw/attachments//` içine `.manifest.json` ile materyalize edilir. -- Ek dosya içeriği döküm kalıcılığından otomatik olarak sansürlenir. -- Base64 girdileri katı alfabe/padding kontrolleri ve çözümleme öncesi boyut korumasıyla doğrulanır. +- 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. - Dosya izinleri dizinler için `0700`, dosyalar için `0600` olur. -- Temizlik `cleanup` ilkesini izler: `delete` ek dosyaları her zaman kaldırır; `keep` bunları yalnızca `retainOnSessionKeep: true` olduğunda tutar. +- Temizleme, `cleanup` ilkesini izler: `delete` ekleri her zaman kaldırır; `keep`, yalnızca `retainOnSessionKeep: true` olduğunda ekleri korur. ### `tools.experimental` -Deneysel yerleşik araç bayrakları. Çalışma zamanına özgü otomatik etkinleştirme kuralı uygulanmadıkça varsayılan olarak kapalıdır. +Deneysel yerleşik araç bayrakları. Çalışma zamanına özgü otomatik etkinleştirme kuralı uygulanmadığı sürece varsayılan olarak kapalıdır. ```json5 { tools: { experimental: { - planTool: true, // enable experimental update_plan + planTool: true, // deneysel update_plan etkinleştir }, }, } @@ -2256,8 +2295,8 @@ 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ı bunu otomatik etkinleştirir. -- Etkin olduğunda sistem istemi ayrıca 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` olarak tutar. +- 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. ### `agents.defaults.subagents` @@ -2277,21 +2316,21 @@ Notlar: } ``` -- `model`: oluşturulan alt-agent'lar için varsayılan model. Atlanırsa alt-agent'lar çağıranın modelini devralır. -- `allowAgents`: istekte bulunan agent kendi `subagents.allowAgents` değerini ayarlamadığında `sessions_spawn` için hedef agent kimliklerinin varsayılan izin listesi (`["*"]` = herhangi biri; varsayılan: yalnızca aynı agent). +- `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-agent başına araç ilkesi: `tools.subagents.tools.allow` / `tools.subagents.tools.deny`. +- Alt ajan başına araç ilkesi: `tools.subagents.tools.allow` / `tools.subagents.tools.deny`. --- -## Özel sağlayıcılar ve temel URL'ler +## Özel sağlayıcı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` yoluyla ekleyin. +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. ```json5 { models: { - mode: "merge", // merge (default) | replace + mode: "merge", // merge (varsayılan) | replace providers: { "custom-proxy": { baseUrl: "http://localhost:4000/v1", @@ -2315,47 +2354,47 @@ OpenClaw yerleşik model kataloğunu kullanır. Özel sağlayıcıları yapılan } ``` -- Özel kimlik doğrulama ihtiyaçları için `authHeader: true` + `headers` kullanın. -- Agent yapılandırma kökünü `OPENCLAW_AGENT_DIR` ile geçersiz kılın (veya eski ortam değişkeni takma adı olan `PI_CODING_AGENT_DIR`). +- Ö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 agent `models.json` `baseUrl` değerleri kazanır. - - Boş olmayan agent `apiKey` değerleri yalnızca bu 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ümlenen gizli anahtarları kalıcı hale getirmek yerine kaynak işaretleyicilerden (`ENV_VAR_NAME` ortam başvuruları için, `secretref-managed` dosya/exec başvuruları için) yenilenir. - - SecretRef tarafından yönetilen sağlayıcı başlık değerleri, kaynak işaretleyicilerden yenilenir (`secretref-env:ENV_VAR_NAME` ortam başvuruları için, `secretref-managed` dosya/exec başvuruları için). - - Boş veya eksik agent `apiKey`/`baseUrl` değerleri yapılandırmadaki `models.providers` değerlerine geri döner. - - Eşleşen model `contextWindow`/`maxTokens` değerleri, açık yapılandırma ve örtük katalog değerleri arasından daha yüksek olanı kullanır. - - Eşleşen model `contextTokens`, varsa açık çalışma zamanı sınırını korur; yerel model meta verisini değiştirmeden etkili bağlamı sınırlamak için kullanın. + - 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. - - İşaretleyici kalıcılığı kaynak açısından yetkilidir: işaretleyiciler, çözümlenen ç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. + - 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. ### Sağlayıcı alanı ayrıntıları - `models.mode`: sağlayıcı katalog davranışı (`merge` veya `replace`). -- `models.providers`: sağlayıcı kimliğiyle anahtarlanmış özel sağlayıcı eşlemesi. +- `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/ortam değişkeni yer değiştirmesini tercih edin). -- `models.providers.*.auth`: kimlik doğrulama stratejisi (`api-key`, `token`, `oauth`, `aws-sdk`). -- `models.providers.*.injectNumCtxForOpenAICompat`: Ollama + `openai-completions` için isteklere `options.num_ctx` ekler (varsayılan: `true`). -- `models.providers.*.authHeader`: gerektiğinde kimlik bilgisini `Authorization` başlığında taşımayı zorlar. -- `models.providers.*.baseUrl`: yukarı akış API temel URL'si. -- `models.providers.*.headers`: proxy/kiracı yönlendirme için ek statik başlıklar. -- `models.providers.*.request`: model-sağlayıcı HTTP istekleri için taşıma geçersiz kılmaları. - - `request.headers`: ek başlıklar (sağlayıcı varsayılanlarıyla birleştirilir). Değerler SecretRef kabul eder. - - `request.auth`: kimlik doğrulama stratejisi geçersiz kılması. Modlar: `"provider-default"` (sağlayıcının yerleşik kimlik doğrulamasını 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 nesnesini kabul eder. - - `request.tls`: doğrudan bağlantılar için TLS geçersiz kılması. Alanlar: `ca`, `cert`, `key`, `passphrase` (hepsi SecretRef kabul eder), `serverName`, `insecureSkipVerify`. -- `models.providers.*.models`: açık sağlayıcı model katalog girişleri. -- `models.providers.*.models.*.contextWindow`: yerel model bağlam penceresi meta verisi. -- `models.providers.*.models.*.contextTokens`: isteğe bağlı çalışma zamanı bağlam sınırı. Modelin yerel `contextWindow` değerinden daha küçük etkili bağlam bütçesi istiyorsanız bunu kullanın. -- `models.providers.*.models.*.compat.supportsDeveloperRole`: isteğe bağlı uyumluluk ipucu. Yerel olmayan boş olmayan `baseUrl` değerine sahip `api: "openai-completions"` için (ana makine `api.openai.com` değilse), OpenClaw bunu çalışma zamanında zorla `false` yapar. 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 dizeye indirger. +- `models.providers.*.apiKey`: sağlayıcı kimlik bilgisi (SecretRef/env substitution tercih edilir). +- `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. + - `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.*.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ü. - `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.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 azami çıktı tokenı. +- `plugins.entries.amazon-bedrock.config.discovery.defaultMaxTokens`: keşfedilen modeller için yedek en büyük çıktı belirteci. ### Sağlayıcı örnekleri @@ -2393,7 +2432,7 @@ OpenClaw yerleşik model kataloğunu kullanır. Özel sağlayıcıları yapılan } ``` -Cerebras için `cerebras/zai-glm-4.7`; doğrudan Z.AI için `zai/glm-4.7` kullanın. +Cerebras için `cerebras/zai-glm-4.7`; Z.AI doğrudan için `zai/glm-4.7` kullanın. @@ -2431,7 +2470,7 @@ Cerebras için `cerebras/zai-glm-4.7`; doğrudan Z.AI 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, base URL geçersiz kılmalı özel sağlayıcı tanımlayın. +- Genel uç nokta için, temel URL geçersiz kılmalı özel bir sağlayıcı tanımlayın. @@ -2473,7 +2512,8 @@ Cerebras için `cerebras/zai-glm-4.7`; doğrudan Z.AI 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ı üzerinde akış kullanımı uyumluluğu bildirir ve OpenClaw artık bunu yalnızca yerleşik sağlayıcı kimliğine göre değil, uç nokta +`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. @@ -2496,7 +2536,7 @@ Anthropic uyumlu, yerleşik sağlayıcı. Kısayol: `openclaw onboard --auth-cho - + ```json5 { @@ -2575,8 +2615,8 @@ Temel URL `/v1` içermemelidir (Anthropic istemcisi bunu ekler). Kısayol: `open `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 OpenClaw, MiniMax thinking özelliğini -açıkça kendiniz `thinking` ayarlamadıkça varsayılan olarak devre dışı bırakır. `/fast on` veya +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. @@ -2584,7 +2624,7 @@ açıkça kendiniz `thinking` ayarlamadıkça varsayılan olarak devre dışı b -Bkz. [Local Models](/tr/gateway/local-models). Kısacası: güçlü 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. [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. @@ -2605,7 +2645,7 @@ Bkz. [Local Models](/tr/gateway/local-models). Kısacası: güçlü donanım üz }, entries: { "image-lab": { - apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // or plaintext string + apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // veya düz metin dize env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" }, }, peekaboo: { enabled: true }, @@ -2615,16 +2655,16 @@ Bkz. [Local Models](/tr/gateway/local-models). Kısacası: güçlü donanım üz } ``` -- `allowBundled`: yalnızca paketlenmiş skill'ler için isteğe bağlı izin listesi (yönetilen/çalışma alanı skill'leri etkilenmez). +- `allowBundled`: yalnızca paketlenmiş skill’ler için isteğe bağlı izin listesi (yönetilen/workspace skill’leri 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` özellikleri için node yükleyici tercihi (`npm` | `pnpm` | `yarn` | `bun`). -- `entries..enabled: false`, skill paketlenmiş/yüklü olsa bile onu devre dışı bırakır. -- `entries..apiKey`: birincil ortam değişkeni bildiren skill'ler için kolaylık alanı (düz metin dize veya SecretRef nesnesi). +- `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). --- -## Plugins +## Eklentiler ```json5 { @@ -2648,78 +2688,10 @@ Bkz. [Local Models](/tr/gateway/local-models). Kısacası: güçlü donanım üz } ``` -- `~/.openclaw/extensions`, `/.openclaw/extensions` ve `plugins.load.paths` içinden yüklenir. -- Keşif; yerel OpenClaw plugin'lerini, uyumlu Codex paketlerini ve Claude paketlerini, manifest'siz Claude varsayılan düzen paketleri dahil kabul eder. -- **Yapılandırma değişiklikleri için ağ geçidi yeniden başlatılması gerekir.** -- `allow`: isteğe bağlı izin listesi (yalnızca listelenen plugin'ler yüklenir). `deny` kazanır. -- `plugins.entries..apiKey`: plugin düzeyinde API anahtarı kolaylık alanı (plugin destekliyorsa). -- `plugins.entries..env`: plugin kapsamlı ortam değişkeni eşlemesi. -- `plugins.entries..hooks.allowPromptInjection`: `false` olduğunda çekirdek `before_prompt_build` işlemini engeller ve eski `before_agent_start` içindeki istem değiştiren alanları yok sayar; eski `modelOverride` ve `providerOverride` alanlarını korur. Yerel plugin hook'larına ve desteklenen paket kaynaklı hook dizinlerine uygulanır. -- `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ı isteme konusunda açık güven verir. -- `plugins.entries..subagent.allowedModels`: güvenilen subagent geçersiz kılmaları için isteğe bağlı kurallı `provider/model` hedef izin listesi. Yalnızca gerçekten herhangi bir modele izin vermek istediğinizde `"*"` kullanın. -- `plugins.entries..config`: plugin tarafından tanımlanan yapılandırma nesnesi (varsa yerel OpenClaw plugin şemasıyla doğrulanır). -- `plugins.entries.firecrawl.config.webFetch`: Firecrawl web fetch sağlayıcı ayarları. - - `apiKey`: Firecrawl API anahtarı (SecretRef kabul eder). `plugins.entries.firecrawl.config.webSearch.apiKey`, eski `tools.web.fetch.firecrawl.apiKey` veya `FIRECRAWL_API_KEY` ortam değişkenine geri düşer. - - `baseUrl`: Firecrawl API temel URL'si (varsayılan: `https://api.firecrawl.dev`). - - `onlyMainContent`: sayfalardan yalnızca ana içeriği çıkar (varsayılan: `true`). - - `maxAgeMs`: azami önbellek yaşı, milisaniye cinsinden (varsayılan: `172800000` / 2 gün). - - `timeoutSeconds`: scrape isteği zaman aşımı, saniye cinsinden (varsayılan: `60`). -- `plugins.entries.xai.config.xSearch`: xAI X Search (Grok web search) ayarları. - - `enabled`: X Search sağlayıcısını etkinleştirir. - - `model`: arama için kullanılacak Grok modeli (örneğin `"grok-4-1-fast"`). -- `plugins.entries.memory-core.config.dreaming`: bellek dreaming (deneysel) ayarları. Aşamalar ve eşikler için bkz. [Dreaming](/tr/concepts/dreaming). - - `enabled`: ana dreaming anahtarı (varsayılan `false`). - - `frequency`: her tam dreaming taraması için cron sıklığı (varsayılan `"0 3 * * *"`). - - aşama ilkesi ve eşikler uygulama ayrıntılarıdır (kullanıcıya açık yapılandırma anahtarları değildir). -- Etkin Claude paket plugin'leri, `settings.json` içinden gömülü Pi varsayılanları da sağlayabilir; OpenClaw bunları ham OpenClaw yapılandırma yamaları olarak değil, temizlenmiş agent ayarları olarak uygular. -- `plugins.slots.memory`: etkin bellek plugin kimliğini seçin veya bellek plugin'lerini devre dışı bırakmak için `"none"` kullanın. -- `plugins.slots.contextEngine`: etkin bağlam motoru plugin kimliğini seçin; başka bir motor yükleyip seçmediğiniz sürece varsayılan `"legacy"` olur. -- `plugins.installs`: `openclaw plugins update` tarafından kullanılan CLI yönetimli kurulum meta verisi. - - `source`, `spec`, `sourcePath`, `installPath`, `version`, `resolvedName`, `resolvedVersion`, `resolvedSpec`, `integrity`, `shasum`, `resolvedAt`, `installedAt` içerir. - - `plugins.installs.*` alanlarını yönetilen durum olarak değerlendirin; elle düzenlemek yerine CLI komutlarını tercih edin. - -Bkz. [Plugins](/tr/tools/plugin). - ---- - -## Tarayıcı - -```json5 -{ - browser: { - enabled: true, - evaluateEnabled: true, - defaultProfile: "user", - ssrfPolicy: { - dangerouslyAllowPrivateNetwork: true, // default trusted-network mode - // allowPrivateNetwork: true, // legacy alias - // hostnameAllowlist: ["*.example.com", "example.com"], - // allowedHostnames: ["localhost"], - }, - profiles: { - openclaw: { cdpPort: 18800, color: "#FF4500" }, - work: { cdpPort: 18801, color: "#0066CC" }, - user: { driver: "existing-session", attachOnly: true, color: "#00AA00" }, - brave: { - driver: "existing-session", - attachOnly: true, - userDataDir: "~/Library/Application Support/BraveSoftware/Brave-Browser", - color: "#FB542B", - }, - remote: { cdpUrl: "http://10.0.0.42:9222", color: "#00AA00" }, - }, - color: "#FF4500", - // headless: false, - // noSandbox: false, - // extraArgs: [], - // executablePath: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser", - // attachOnly: false, - }, -} -``` - -- `evaluateEnabled: false`, `act:evaluate` ve `wait --fn` komutlarını devre dışı bırakır. -- `ssrfPolicy.dangerouslyAllowPrivateNetwork`, ayarlanmadığında varsayılan olarak `true` olur (güvenilen ağ modeli). -- Katı yalnızca herkese açık tarayıcı gezinmesi için `ssrfPolicy.dangerouslyAllowPrivateNetwork: false` ayarlayın. -- Katı modda, uzak CDP profil uç noktaları (`profiles.*.cdpUrl`) erişilebilirlik/keşif kontrolleri sırasında aynı özel ağ engellemesine tabidir. -- `ssrfPolicy.allowPrivateNetwork`, eski takma ad olarak desteklenmeye devam eder. \ No newline at end of file +- `~/.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 diff --git a/docs/tr/gateway/configuration.md b/docs/tr/gateway/configuration.md index 1ab8ad06b..6dda3741d 100644 --- a/docs/tr/gateway/configuration.md +++ b/docs/tr/gateway/configuration.md @@ -1,36 +1,36 @@ --- read_when: - - OpenClaw'ı ilk kez kuruyorsunuz - - Yaygın yapılandırma kalıplarını arıyorsunuz - - Belirli yapılandırma bölümlerine gitmek istiyorsunuz -summary: 'Yapılandırma genel bakışı: yaygın görevler, hızlı kurulum ve tam başvuru bağlantıları' -title: Configuration + - OpenClaw ilk kez kurulurken + - Yaygın yapılandırma kalıplarını ararken + - Belirli yapılandırma bölümlerine giderken +summary: 'Yapılandırmaya genel bakış: yaygın görevler, hızlı kurulum ve tam başvuru bağlantıları' +title: Yapılandırma x-i18n: - generated_at: "2026-04-05T13:53:51Z" + generated_at: "2026-04-08T06:01:58Z" model: gpt-5.4 provider: openai - source_hash: a39a7de09c5f9540785ec67f37d435a7a86201f0f5f640dae663054f35976712 + source_hash: 199a1e515bd4003319e71593a2659bb883299a76ff67e273d92583df03c96604 source_path: gateway/configuration.md workflow: 15 --- -# Configuration +# Yapılandırma -OpenClaw, `~/.openclaw/openclaw.json` içinden isteğe bağlı bir **JSON5** yapılandırması okur. +OpenClaw, `~/.openclaw/openclaw.json` dosyasından isteğe bağlı bir **JSON5** yapılandırması okur. -Dosya yoksa OpenClaw güvenli varsayılanları kullanır. Yapılandırma eklemek için yaygın nedenler: +Dosya yoksa, OpenClaw güvenli varsayılanları kullanır. Yapılandırma eklemek için yaygın nedenler: -- Kanalları bağlamak ve bot'a kimlerin mesaj gönderebileceğini kontrol etmek -- Modelleri, araçları, sandbox kullanımını veya otomasyonu ayarlamak (cron, hook'lar) -- Oturumları, medyayı, ağı veya kullanıcı arayüzünü ince ayarlamak +- Kanalları bağlamak ve botla kimlerin mesajlaşabileceğini denetlemek +- Modelleri, araçları, sandbox kullanımını veya otomasyonu (cron, hook'lar) ayarlamak +- Oturumları, medyayı, ağ iletişimini veya kullanıcı arayüzünü ince ayarlamak -Kullanılabilir tüm alanlar için [tam başvuruya](/gateway/configuration-reference) bakın. +Kullanılabilir tüm alanlar için [tam başvuruya](/tr/gateway/configuration-reference) bakın. -**Yapılandırma konusunda yeni misiniz?** Etkileşimli kurulum için `openclaw onboard` ile başlayın veya tam kopyala-yapıştır yapılandırmaları için [Configuration Examples](/gateway/configuration-examples) kılavuzuna göz atın. +**Yapılandırma konusunda yeni misiniz?** Etkileşimli kurulum için `openclaw onboard` ile başlayın veya eksiksiz kopyala-yapıştır yapılandırmaları için [Yapılandırma Örnekleri](/tr/gateway/configuration-examples) kılavuzuna göz atın. -## Minimal yapılandırma +## En küçük yapılandırma ```json5 // ~/.openclaw/openclaw.json @@ -45,7 +45,7 @@ Kullanılabilir tüm alanlar için [tam başvuruya](/gateway/configuration-refer ```bash - openclaw onboard # tam başlangıç kurulumu akışı + openclaw onboard # tam ilk kurulum akışı openclaw configure # yapılandırma sihirbazı ``` @@ -58,49 +58,56 @@ Kullanılabilir tüm alanlar için [tam başvuruya](/gateway/configuration-refer [http://127.0.0.1:18789](http://127.0.0.1:18789) adresini açın ve **Config** sekmesini kullanın. - Kontrol UI, mevcut yapılandırma şemasından bir form oluşturur; buna alan - `title` / `description` belge meta verileri ile kullanılabilir olduğunda eklenti ve kanal şemaları da dahildir. Ayrıca kaçış noktası olarak bir **Raw JSON** düzenleyici sunar. Ayrıntılı inceleme - arayüzleri ve diğer araçlar için gateway ayrıca - yol kapsamlı tek bir şema düğümü ve hemen altındaki çocuk özetlerini almak üzere - `config.schema.lookup` yöntemini de açığa çıkarır. + Kontrol UI, canlı yapılandırma şemasından bir form oluşturur; buna mevcut + olduğunda alan `title` / `description` belge meta verileri ile plugin ve kanal şemaları da dahildir + ve kaçış kapağı olarak bir **Raw JSON** düzenleyicisi sunar. Ayrıntılı inceleme + kullanıcı arayüzleri ve diğer araçlar için gateway ayrıca + tek bir yol kapsamlı şema düğümünü ve doğrudan alt özetleri getirmek üzere `config.schema.lookup` + sunar. - `~/.openclaw/openclaw.json` dosyasını doğrudan düzenleyin. Gateway dosyayı izler ve değişiklikleri otomatik olarak uygular (bkz. [anında yeniden yükleme](#config-hot-reload)). + `~/.openclaw/openclaw.json` dosyasını doğrudan düzenleyin. Gateway dosyayı izler ve değişiklikleri otomatik olarak uygular ([anında yeniden yükleme](#config-hot-reload) bölümüne bakın). -## Sıkı doğrulama +## Katı doğrulama -OpenClaw yalnızca şemayla tamamen eşleşen yapılandırmaları kabul eder. Bilinmeyen anahtarlar, hatalı türler veya geçersiz değerler Gateway'in **başlatılmayı reddetmesine** neden olur. Tek kök düzey istisna `$schema`dır (string); böylece düzenleyiciler JSON Schema meta verisini ekleyebilir. +OpenClaw yalnızca şemayla tamamen eşleşen yapılandırmaları kabul eder. Bilinmeyen anahtarlar, hatalı türler veya geçersiz değerler Gateway'nin **başlatılmayı reddetmesine** neden olur. Kök düzeyindeki tek istisna `$schema` (string) alanıdır; böylece düzenleyiciler JSON Schema meta verisi ekleyebilir. -Şema araç notları: +Şema aracı notları: -- `openclaw config schema`, Kontrol UI ve yapılandırma doğrulaması tarafından kullanılan aynı JSON Schema ailesini yazdırır. +- `openclaw config schema`, Kontrol UI tarafından kullanılan aynı JSON Schema ailesini + ve yapılandırma doğrulamasını yazdırır. +- Bu şema çıktısını, `openclaw.json` için kanonik makine tarafından okunabilir sözleşme olarak + değerlendirin; bu genel bakış ve yapılandırma başvurusu bunu özetler. - Alan `title` ve `description` değerleri, düzenleyici ve form araçları için şema çıktısına taşınır. -- İç içe nesne, joker (`*`) ve dizi öğesi (`[]`) girişleri, eşleşen alan belgeleri bulunduğunda aynı - belge meta verisini devralır. -- `anyOf` / `oneOf` / `allOf` birleşim dalları da aynı belge +- İç içe nesne, joker (`*`) ve dizi öğesi (`[]`) girdileri, eşleşen alan belgeleri mevcut olduğunda + aynı belge meta verisini devralır. +- `anyOf` / `oneOf` / `allOf` bileşim dalları da aynı belge meta verisini devralır; böylece union/intersection varyantları aynı alan yardımını korur. -- `config.schema.lookup`, bir normalize edilmiş yapılandırma yolunu; sığ bir - şema düğümüyle (`title`, `description`, `type`, `enum`, `const`, yaygın sınırlar - ve benzer doğrulama alanları), eşleşen UI ipucu meta verisiyle ve ayrıntılı araçlar için hemen alt çocuk - özetleriyle döndürür. -- Gateway mevcut manifest kaydını yükleyebildiğinde çalışma zamanı eklenti/kanal şemaları buna birleştirilir. +- `config.schema.lookup`, tek bir normalize edilmiş yapılandırma yolunu; sığ bir + şema düğümü (`title`, `description`, `type`, `enum`, `const`, yaygın sınırlar + ve benzer doğrulama alanları), eşleşen UI ipucu meta verisi ve ayrıntılı inceleme araçları için doğrudan alt + özetlerle birlikte döndürür. +- Çalışma zamanı plugin/kanal şemaları, gateway mevcut manifest kayıt defterini yükleyebildiğinde + birleştirilir. +- `pnpm config:docs:check`, dokümantasyona yönelik yapılandırma temel + yapıları ile mevcut şema yüzeyi arasındaki sapmayı tespit eder. Doğrulama başarısız olduğunda: - Gateway açılmaz - Yalnızca tanılama komutları çalışır (`openclaw doctor`, `openclaw logs`, `openclaw health`, `openclaw status`) -- Tam sorunları görmek için `openclaw doctor` çalıştırın +- Kesin sorunları görmek için `openclaw doctor` çalıştırın - Onarımları uygulamak için `openclaw doctor --fix` (veya `--yes`) çalıştırın ## Yaygın görevler - + Her kanalın `channels.` altında kendi yapılandırma bölümü vardır. Kurulum adımları için ilgili kanal sayfasına bakın: - [WhatsApp](/tr/channels/whatsapp) — `channels.whatsapp` @@ -114,7 +121,7 @@ Doğrulama başarısız olduğunda: - [iMessage](/tr/channels/imessage) — `channels.imessage` - [Mattermost](/tr/channels/mattermost) — `channels.mattermost` - Tüm kanallar aynı DM ilkesi kalıbını paylaşır: + Tüm kanallar aynı DM ilke düzenini paylaşır: ```json5 { @@ -123,7 +130,7 @@ Doğrulama başarısız olduğunda: enabled: true, botToken: "123:abc", dmPolicy: "pairing", // pairing | allowlist | open | disabled - allowFrom: ["tg:123"], // yalnızca allowlist/open için + allowFrom: ["tg:123"], // only for allowlist/open }, }, } @@ -132,7 +139,7 @@ Doğrulama başarısız olduğunda: - Birincil modeli ve isteğe bağlı geri dönüşleri ayarlayın: + Birincil modeli ve isteğe bağlı yedekleri ayarlayın: ```json5 { @@ -151,30 +158,30 @@ Doğrulama başarısız olduğunda: } ``` - - `agents.defaults.models`, model kataloğunu tanımlar ve `/model` için izin listesi görevi görür. + - `agents.defaults.models`, model kataloğunu tanımlar ve `/model` için allowlist görevi görür. - Model başvuruları `provider/model` biçimini kullanır (ör. `anthropic/claude-opus-4-6`). - - `agents.defaults.imageMaxDimensionPx`, transkript/araç görüntüsü küçültmeyi denetler (varsayılan `1200`); daha düşük değerler genellikle ekran görüntüsü ağırlıklı çalıştırmalarda vision token kullanımını azaltır. - - Sohbet içinde model değiştirme için [Models CLI](/concepts/models), kimlik doğrulama rotasyonu ve geri dönüş davranışı için [Model Failover](/concepts/model-failover) bölümüne bakın. - - Özel/self-hosted sağlayıcılar için başvurudaki [Custom providers](/gateway/configuration-reference#custom-providers-and-base-urls) bölümüne bakın. + - `agents.defaults.imageMaxDimensionPx`, transkript/araç görüntüsü küçültmeyi denetler (varsayılan `1200`); daha düşük değerler genellikle ekran görüntüsü yoğun çalıştırmalarda vision token kullanımını azaltır. + - Sohbette model değiştirme için [Models CLI](/tr/concepts/models), kimlik doğrulama rotasyonu ve yedek davranışı için [Model Failover](/tr/concepts/model-failover) bölümüne bakın. + - Özel/kendi barındırdığınız sağlayıcılar için başvurudaki [Custom providers](/tr/gateway/configuration-reference#custom-providers-and-base-urls) bölümüne bakın. - - DM erişimi kanal başına `dmPolicy` ile denetlenir: + + DM erişimi, kanal başına `dmPolicy` ile denetlenir: - - `"pairing"` (varsayılan): bilinmeyen göndericiler onay için tek kullanımlık bir eşleme kodu alır - - `"allowlist"`: yalnızca `allowFrom` içindeki göndericiler (veya eşlenmiş izin deposu) - - `"open"`: tüm gelen DM'lere izin verilir (`allowFrom: ["*"]` gerektirir) + - `"pairing"` (varsayılan): bilinmeyen göndericiler, onay için tek kullanımlık eşleştirme kodu alır + - `"allowlist"`: yalnızca `allowFrom` içindeki göndericiler (veya eşleştirilmiş izin deposu) + - `"open"`: tüm gelen DM'lere izin verir (`allowFrom: ["*"]` gerektirir) - `"disabled"`: tüm DM'leri yok sayar - Gruplar için `groupPolicy` + `groupAllowFrom` veya kanala özgü izin listelerini kullanın. + Gruplar için `groupPolicy` + `groupAllowFrom` veya kanala özgü allowlist'leri kullanın. - Kanal başına ayrıntılar için [tam başvuruya](/gateway/configuration-reference#dm-and-group-access) bakın. + Kanal başına ayrıntılar için [tam başvuruya](/tr/gateway/configuration-reference#dm-and-group-access) bakın. - - Grup mesajları varsayılan olarak **mention gerektirir**. Ajan başına kalıpları yapılandırın: + + Grup mesajları varsayılan olarak **mention gerektirir**. Desenleri agent başına yapılandırın: ```json5 { @@ -197,14 +204,14 @@ Doğrulama başarısız olduğunda: ``` - **Meta veri mention'ları**: yerel @-mention'lar (WhatsApp dokunarak mention, Telegram @bot vb.) - - **Metin kalıpları**: `mentionPatterns` içindeki güvenli regex kalıpları - - Kanal başına geçersiz kılmalar ve self-chat modu için [tam başvuruya](/gateway/configuration-reference#group-chat-mention-gating) bakın. + - **Metin desenleri**: `mentionPatterns` içindeki güvenli regex desenleri + - Kanal başına geçersiz kılmalar ve self-chat modu için [tam başvuruya](/tr/gateway/configuration-reference#group-chat-mention-gating) bakın. - - Paylaşılan bir temel için `agents.defaults.skills` kullanın, ardından belirli - ajanları `agents.list[].skills` ile geçersiz kılın: + + Paylaşılan bir temel için `agents.defaults.skills` kullanın, sonra belirli + agent'ları `agents.list[].skills` ile geçersiz kılın: ```json5 { @@ -214,23 +221,23 @@ Doğrulama başarısız olduğunda: }, list: [ { id: "writer" }, // github, weather devralır - { id: "docs", skills: ["docs-search"] }, // varsayılanların yerini alır - { id: "locked-down", skills: [] }, // skill yok + { id: "docs", skills: ["docs-search"] }, // varsayılanların yerine geçer + { id: "locked-down", skills: [] }, // Skills yok ], }, } ``` - - Varsayılan olarak kısıtlanmamış Skills 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. - - [Skills](/tools/skills), [Skills config](/tools/skills-config) ve - [Configuration Reference](/gateway/configuration-reference#agentsdefaultsskills) bölümüne bakın. + - Varsayılan olarak kısıtlanmamış Skills için `agents.defaults.skills` alanını atlayın. + - Varsayılanları devralmak için `agents.list[].skills` alanını atlayın. + - Hiç Skills olmaması için `agents.list[].skills: []` ayarlayın. + - [Skills](/tr/tools/skills), [Skills config](/tr/tools/skills-config) ve + [Configuration Reference](/tr/gateway/configuration-reference#agentsdefaultsskills) bölümlerine bakın. - - Gateway'in eski görünümlü kanalları ne kadar agresif biçimde yeniden başlatacağını denetleyin: + + Gateway'nin bayat görünen kanalları ne kadar agresif biçimde yeniden başlatacağını denetleyin: ```json5 { @@ -254,13 +261,13 @@ Doğrulama başarısız olduğunda: - Sağlık izleme yeniden başlatmalarını küresel olarak devre dışı bırakmak için `gateway.channelHealthCheckMinutes: 0` ayarlayın. - `channelStaleEventThresholdMinutes`, denetim aralığından büyük veya ona eşit olmalıdır. - - Küresel izleyiciyi kapatmadan tek bir kanal veya hesap için otomatik yeniden başlatmaları kapatmak amacıyla `channels..healthMonitor.enabled` veya `channels..accounts..healthMonitor.enabled` kullanın. - - Operasyonel hata ayıklama için [Health Checks](/gateway/health) ve tüm alanlar için [tam başvuruya](/gateway/configuration-reference#gateway) bakın. + - Küresel izleyiciyi devre dışı bırakmadan tek bir kanal veya hesap için otomatik yeniden başlatmaları kapatmak üzere `channels..healthMonitor.enabled` veya `channels..accounts..healthMonitor.enabled` kullanın. + - İşlemsel hata ayıklama için [Health Checks](/tr/gateway/health), tüm alanlar için ise [tam başvuruya](/tr/gateway/configuration-reference#gateway) bakın. - Oturumlar, konuşmanın sürekliliğini ve yalıtımını denetler: + Oturumlar, konuşma sürekliliğini ve yalıtımı denetler: ```json5 { @@ -281,14 +288,14 @@ Doğrulama başarısız olduğunda: ``` - `dmScope`: `main` (paylaşılan) | `per-peer` | `per-channel-peer` | `per-account-channel-peer` - - `threadBindings`: iş parçacığına bağlı oturum yönlendirmesi için küresel varsayılanlar (Discord `/focus`, `/unfocus`, `/agents`, `/session idle` ve `/session max-age` destekler). - - Kapsamlama, kimlik bağlantıları ve gönderme ilkesi için [Session Management](/concepts/session) bölümüne bakın. - - Tüm alanlar için [tam başvuruya](/gateway/configuration-reference#session) bakın. + - `threadBindings`: thread'e bağlı oturum yönlendirmesi için küresel varsayılanlar (Discord `/focus`, `/unfocus`, `/agents`, `/session idle` ve `/session max-age` destekler). + - Kapsam, kimlik bağlantıları ve gönderim ilkesi için [Session Management](/tr/concepts/session) bölümüne bakın. + - Tüm alanlar için [tam başvuruya](/tr/gateway/configuration-reference#session) bakın. - Ajan oturumlarını yalıtılmış Docker kapsayıcılarında çalıştırın: + Agent oturumlarını yalıtılmış Docker konteynerlerinde çalıştırın: ```json5 { @@ -305,11 +312,11 @@ Doğrulama başarısız olduğunda: Önce imajı oluşturun: `scripts/sandbox-setup.sh` - Tam kılavuz için [Sandboxing](/gateway/sandboxing), tüm seçenekler için [tam başvuruya](/gateway/configuration-reference#agentsdefaultssandbox) bakın. + Tam kılavuz için [Sandboxing](/tr/gateway/sandboxing), tüm seçenekler için ise [tam başvuruya](/tr/gateway/configuration-reference#agentsdefaultssandbox) bakın. - + Relay destekli push, `openclaw.json` içinde yapılandırılır. Bunu gateway yapılandırmasında ayarlayın: @@ -330,7 +337,7 @@ Doğrulama başarısız olduğunda: } ``` - CLI eşdeğeri: + Eşdeğer CLI komutu: ```bash openclaw config set gateway.push.apns.relay.baseUrl https://relay.example.com @@ -338,35 +345,35 @@ Doğrulama başarısız olduğunda: Bunun yaptığı şey: - - Gateway'in `push.test`, uyandırma dürtmeleri ve yeniden bağlanma uyandırmalarını harici relay üzerinden göndermesine izin verir. - - Eşlenmiş iOS uygulaması tarafından iletilen, kayıt kapsamlı bir gönderme izni kullanır. Gateway'in dağıtım genelinde bir relay belirtecine ihtiyacı yoktur. - - Her relay destekli kaydı, iOS uygulamasının eşlendiği gateway kimliğine bağlar; böylece başka bir gateway saklanan kaydı yeniden kullanamaz. - - Yerel/elle oluşturulmuş iOS sürümlerini doğrudan APNs üzerinde tutar. Relay destekli gönderimler yalnızca relay üzerinden kaydolmuş resmi dağıtılmış sürümlere uygulanır. - - Resmi/TestFlight iOS sürümüne gömülü relay temel URL'siyle eşleşmelidir; böylece kayıt ve gönderim trafiği aynı relay dağıtımına ulaşır. + - Gateway'nin `push.test`, uyandırma dürtmeleri ve yeniden bağlanma uyandırmalarını harici relay üzerinden göndermesine izin verir. + - Eşleştirilmiş iOS uygulaması tarafından iletilen kayıt kapsamlı bir gönderim yetkisi kullanır. Gateway'nin dağıtım geneli bir relay token'ına ihtiyacı yoktur. + - Her relay destekli kaydı, iOS uygulamasının eşleştirildiği gateway kimliğine bağlar; böylece başka bir gateway saklanan kaydı yeniden kullanamaz. + - Yerel/el ile oluşturulmuş iOS derlemelerini doğrudan APNs üzerinde tutar. Relay destekli gönderimler yalnızca relay üzerinden kayıt olan resmi dağıtılmış derlemelere uygulanır. + - Kayıt ve gönderim trafiğinin aynı relay dağıtımına ulaşması için resmi/TestFlight iOS derlemesine gömülü relay temel URL'si ile eşleşmelidir. Uçtan uca akış: - 1. Aynı relay temel URL'siyle derlenmiş resmi/TestFlight iOS sürümünü yükleyin. + 1. Aynı relay temel URL'si ile derlenmiş resmi/TestFlight bir iOS derlemesi yükleyin. 2. Gateway üzerinde `gateway.push.apns.relay.baseUrl` ayarlayın. - 3. iOS uygulamasını gateway ile eşleyin ve hem düğüm hem operatör oturumlarının bağlanmasına izin verin. - 4. iOS uygulaması gateway kimliğini alır, App Attest ile uygulama makbuzunu kullanarak relay'e kaydolur ve ardından relay destekli `push.apns.register` yükünü eşlenmiş gateway'e yayımlar. - 5. Gateway relay tanıtıcısını ve gönderme iznini saklar, ardından bunları `push.test`, uyandırma dürtmeleri ve yeniden bağlanma uyandırmaları için kullanır. + 3. iOS uygulamasını gateway ile eşleştirin ve hem node hem operatör oturumlarının bağlanmasına izin verin. + 4. iOS uygulaması gateway kimliğini alır, App Attest ve uygulama makbuzunu kullanarak relay'e kayıt olur, ardından relay destekli `push.apns.register` yükünü eşleştirilmiş gateway'e yayınlar. + 5. Gateway relay tanıtıcısını ve gönderim yetkisini saklar, ardından bunları `push.test`, uyandırma dürtmeleri ve yeniden bağlanma uyandırmaları için kullanır. - Operasyonel notlar: + İşletim notları: - - iOS uygulamasını farklı bir gateway'e geçirirseniz, uygulamayı yeniden bağlayın ki bu gateway'e bağlı yeni bir relay kaydı yayımlayabilsin. - - Farklı bir relay dağıtımını işaret eden yeni bir iOS sürümü yayımlarsanız, uygulama eski relay kaynağını yeniden kullanmak yerine önbelleğe alınmış relay kaydını yeniler. + - iOS uygulamasını farklı bir gateway'e geçirirseniz, uygulamanın o gateway'e bağlanmış yeni bir relay kaydı yayımlayabilmesi için yeniden bağlayın. + - Farklı bir relay dağıtımını işaret eden yeni bir iOS derlemesi yayımlarsanız, uygulama eski relay kaynağını yeniden kullanmak yerine önbelleğe alınmış relay kaydını yeniler. Uyumluluk notu: - - `OPENCLAW_APNS_RELAY_BASE_URL` ve `OPENCLAW_APNS_RELAY_TIMEOUT_MS` hâlâ geçici ortam değişkeni geçersiz kılmaları olarak çalışır. - - `OPENCLAW_APNS_RELAY_ALLOW_HTTP=true` yalnızca loopback geliştirmesi için bir kaçış noktası olmaya devam eder; HTTP relay URL'lerini yapılandırmada kalıcı hale getirmeyin. + - `OPENCLAW_APNS_RELAY_BASE_URL` ve `OPENCLAW_APNS_RELAY_TIMEOUT_MS` geçici env geçersiz kılmaları olarak hâlâ çalışır. + - `OPENCLAW_APNS_RELAY_ALLOW_HTTP=true` yalnızca loopback için bir geliştirme kaçış kapağı olarak kalır; HTTP relay URL'lerini yapılandırmada kalıcı olarak tutmayın. - Uçtan uca akış için [iOS App](/platforms/ios#relay-backed-push-for-official-builds), relay güvenlik modeli için [Authentication and trust flow](/platforms/ios#authentication-and-trust-flow) bölümüne bakın. + Uçtan uca akış için [iOS App](/tr/platforms/ios#relay-backed-push-for-official-builds), relay güvenlik modeli için ise [Authentication and trust flow](/tr/platforms/ios#authentication-and-trust-flow) bölümlerine bakın. - + ```json5 { agents: { @@ -380,14 +387,14 @@ Doğrulama başarısız olduğunda: } ``` - - `every`: süre dizgesi (`30m`, `2h`). Devre dışı bırakmak için `0m` ayarlayın. + - `every`: süre string'i (`30m`, `2h`). Devre dışı bırakmak için `0m` ayarlayın. - `target`: `last` | `none` | `` (örneğin `discord`, `matrix`, `telegram` veya `whatsapp`) - `directPolicy`: DM tarzı heartbeat hedefleri için `allow` (varsayılan) veya `block` - - Tam kılavuz için [Heartbeat](/gateway/heartbeat) bölümüne bakın. + - Tam kılavuz için [Heartbeat](/tr/gateway/heartbeat) bölümüne bakın. - + ```json5 { cron: { @@ -402,13 +409,13 @@ Doğrulama başarısız olduğunda: } ``` - - `sessionRetention`: tamamlanmış yalıtılmış çalıştırma oturumlarını `sessions.json` içinden budar (varsayılan `24h`; devre dışı bırakmak için `false` ayarlayın). - - `runLog`: `cron/runs/.jsonl` dosyasını boyut ve korunacak satır sayısına göre budar. - - Özellik genel görünümü ve CLI örnekleri için [Cron jobs](/tr/automation/cron-jobs) bölümüne bakın. + - `sessionRetention`: tamamlanan yalıtılmış çalıştırma oturumlarını `sessions.json` içinden budar (varsayılan `24h`; devre dışı bırakmak için `false` ayarlayın). + - `runLog`: `cron/runs/.jsonl` dosyasını boyut ve tutulan satır sayısına göre budar. + - Özellik genel bakışı ve CLI örnekleri için [Cron jobs](/tr/automation/cron-jobs) bölümüne bakın. - + Gateway üzerinde HTTP webhook uç noktalarını etkinleştirin: ```json5 @@ -433,20 +440,20 @@ Doğrulama başarısız olduğunda: ``` Güvenlik notu: - - Tüm hook/webhook yük içeriğini güvenilmez girdi olarak değerlendirin. - - Özel bir `hooks.token` kullanın; paylaşılan Gateway belirtecini yeniden kullanmayın. - - Hook kimlik doğrulaması yalnızca başlık temellidir (`Authorization: Bearer ...` veya `x-openclaw-token`); sorgu dizgesi belirteçleri reddedilir. - - `hooks.path`, `/` olamaz; webhook girişini `/hooks` gibi özel bir alt yolda tutun. - - Sıkı kapsamlı hata ayıklama yapmıyorsanız güvensiz içerik atlama bayraklarını (`hooks.gmail.allowUnsafeExternalContent`, `hooks.mappings[].allowUnsafeExternalContent`) devre dışı bırakılmış halde tutun. - - `hooks.allowRequestSessionKey` etkinse, çağıranın seçtiği oturum anahtarlarını sınırlamak için `hooks.allowedSessionKeyPrefixes` de ayarlayın. - - Hook tarafından sürülen ajanlar için güçlü modern model katmanlarını ve sıkı araç ilkesini tercih edin (örneğin mümkün olduğunda yalnızca mesajlaşma + sandbox). + - Tüm hook/webhook yük içeriklerini güvenilmeyen girdi olarak değerlendirin. + - Ayrı bir `hooks.token` kullanın; paylaşılan Gateway token'ını yeniden kullanmayın. + - Hook kimlik doğrulaması yalnızca üstbilgi tabanlıdır (`Authorization: Bearer ...` veya `x-openclaw-token`); sorgu dizesi token'ları reddedilir. + - `hooks.path` `/` olamaz; webhook girişini `/hooks` gibi ayrılmış bir alt yolda tutun. + - Sıkı kapsamlı hata ayıklama yapmıyorsanız güvenli olmayan içerik atlama bayraklarını (`hooks.gmail.allowUnsafeExternalContent`, `hooks.mappings[].allowUnsafeExternalContent`) devre dışı bırakılmış bırakın. + - `hooks.allowRequestSessionKey` etkinleştirirseniz, çağıran tarafından seçilen oturum anahtarlarını sınırlamak için ayrıca `hooks.allowedSessionKeyPrefixes` ayarlayın. + - Hook tarafından sürülen agent'lar için mümkün olduğunda güçlü modern model katmanlarını ve sıkı araç ilkesini tercih edin (örneğin yalnızca mesajlaşma artı sandbox kullanımı). - Tüm eşleme seçenekleri ve Gmail entegrasyonu için [tam başvuruya](/gateway/configuration-reference#hooks) bakın. + Tüm eşleme seçenekleri ve Gmail entegrasyonu için [tam başvuruya](/tr/gateway/configuration-reference#hooks) bakın. - - Ayrı çalışma alanları ve oturumlarla birden fazla yalıtılmış ajan çalıştırın: + + Ayrı çalışma alanları ve oturumlarla birden çok yalıtılmış agent çalıştırın: ```json5 { @@ -463,11 +470,11 @@ Doğrulama başarısız olduğunda: } ``` - Bağlama kuralları ve ajan başına erişim profilleri için [Multi-Agent](/concepts/multi-agent) ve [tam başvuruya](/gateway/configuration-reference#multi-agent-routing) bakın. + Bağlama kuralları ve agent başına erişim profilleri için [Multi-Agent](/tr/concepts/multi-agent) ve [tam başvuruya](/tr/gateway/configuration-reference#multi-agent-routing) bakın. - + Büyük yapılandırmaları düzenlemek için `$include` kullanın: ```json5 @@ -481,11 +488,11 @@ Doğrulama başarısız olduğunda: } ``` - - **Tek dosya**: kapsayan nesnenin yerini alır - - **Dosya dizisi**: sırayla derin birleştirilir (sonraki kazanır) - - **Kardeş anahtarlar**: include'lardan sonra birleştirilir (dahil edilen değerleri geçersiz kılar) - - **İç içe include'lar**: 10 düzeye kadar desteklenir - - **Göreli yollar**: include eden dosyaya göre çözülür + - **Tek dosya**: içeren nesnenin yerine geçer + - **Dosya dizisi**: sırayla derinlemesine birleştirilir (sonraki kazanır) + - **Kardeş anahtarlar**: include'ların ardından birleştirilir (dahil edilen değerleri geçersiz kılar) + - **İç içe include'lar**: 10 düzey derinliğe kadar desteklenir + - **Göreli yollar**: dahil eden dosyaya göre çözülür - **Hata işleme**: eksik dosyalar, ayrıştırma hataları ve döngüsel include'lar için açık hatalar @@ -497,12 +504,12 @@ Gateway, `~/.openclaw/openclaw.json` dosyasını izler ve değişiklikleri otoma ### Yeniden yükleme modları -| Mod | Davranış | +| Mod | Davranış | | ---------------------- | --------------------------------------------------------------------------------------- | -| **`hybrid`** (varsayılan) | Güvenli değişiklikleri anında uygular. Kritik olanlar için otomatik olarak yeniden başlatır. | -| **`hot`** | Yalnızca güvenli değişiklikleri anında uygular. Yeniden başlatma gerektiğinde bir uyarı kaydeder — bunu siz yaparsınız. | -| **`restart`** | Güvenli olsun olmasın her yapılandırma değişikliğinde Gateway'i yeniden başlatır. | -| **`off`** | Dosya izlemeyi devre dışı bırakır. Değişiklikler bir sonraki elle yeniden başlatmada etkili olur. | +| **`hybrid`** (varsayılan) | Güvenli değişiklikleri anında uygular. Kritik olanlar için otomatik olarak yeniden başlatır. | +| **`hot`** | Yalnızca güvenli değişiklikleri anında uygular. Yeniden başlatma gerektiğinde bir uyarı kaydeder — bunu siz yönetirsiniz. | +| **`restart`** | Güvenli olsun olmasın her yapılandırma değişikliğinde Gateway'yi yeniden başlatır. | +| **`off`** | Dosya izlemeyi devre dışı bırakır. Değişiklikler bir sonraki el ile yeniden başlatmada etkili olur. | ```json5 { @@ -512,63 +519,63 @@ Gateway, `~/.openclaw/openclaw.json` dosyasını izler ve değişiklikleri otoma } ``` -### Neler anında uygulanır, neler yeniden başlatma ister +### Neler anında uygulanır, neler yeniden başlatma gerektirir -Çoğu alan kesinti olmadan anında uygulanır. `hybrid` modunda, yeniden başlatma gerektiren değişiklikler otomatik olarak ele alınır. +Çoğu alan, kesinti olmadan anında uygulanır. `hybrid` modunda, yeniden başlatma gerektiren değişiklikler otomatik olarak ele alınır. -| Kategori | Alanlar | Yeniden başlatma gerekir mi? | -| ------------------- | -------------------------------------------------------------------- | ---------------------------- | -| Kanallar | `channels.*`, `web` (WhatsApp) — tüm yerleşik ve uzantı kanalları | Hayır | -| Ajan ve modeller | `agent`, `agents`, `models`, `routing` | Hayır | -| Otomasyon | `hooks`, `cron`, `agent.heartbeat` | Hayır | -| Oturumlar ve mesajlar | `session`, `messages` | Hayır | -| Araçlar ve medya | `tools`, `browser`, `skills`, `audio`, `talk` | Hayır | -| UI ve diğerleri | `ui`, `logging`, `identity`, `bindings` | Hayır | -| Gateway sunucusu | `gateway.*` (port, bind, auth, tailscale, TLS, HTTP) | **Evet** | -| Altyapı | `discovery`, `canvasHost`, `plugins` | **Evet** | +| Kategori | Alanlar | Yeniden başlatma gerekiyor mu? | +| ------------------- | -------------------------------------------------------------------- | --------------- | +| Kanallar | `channels.*`, `web` (WhatsApp) — tüm yerleşik ve uzantı kanalları | Hayır | +| Agent ve modeller | `agent`, `agents`, `models`, `routing` | Hayır | +| Otomasyon | `hooks`, `cron`, `agent.heartbeat` | Hayır | +| Oturumlar ve mesajlar | `session`, `messages` | Hayır | +| Araçlar ve medya | `tools`, `browser`, `skills`, `audio`, `talk` | Hayır | +| UI ve çeşitli | `ui`, `logging`, `identity`, `bindings` | Hayır | +| Gateway sunucusu | `gateway.*` (port, bind, auth, tailscale, TLS, HTTP) | **Evet** | +| Altyapı | `discovery`, `canvasHost`, `plugins` | **Evet** | -`gateway.reload` ve `gateway.remote` istisnadır — bunları değiştirmek **yeniden başlatmayı** tetiklemez. +`gateway.reload` ve `gateway.remote` istisnadır — bunları değiştirmek yeniden başlatmayı **tetiklemez**. ## Config RPC (programlı güncellemeler) -Kontrol düzlemi yazma RPC'leri (`config.apply`, `config.patch`, `update.run`) `deviceId+clientIp` başına **60 saniyede 3 istek** ile hız sınırlıdır. Sınır uygulandığında, RPC `retryAfterMs` ile birlikte `UNAVAILABLE` döndürür. +Kontrol düzlemi yazma RPC'leri (`config.apply`, `config.patch`, `update.run`) her `deviceId+clientIp` için **60 saniyede 3 istek** ile oran sınırlıdır. Sınır uygulandığında RPC, `retryAfterMs` ile birlikte `UNAVAILABLE` döndürür. Güvenli/varsayılan akış: - `config.schema.lookup`: sığ bir - şema düğümü, eşleşen ipucu meta verisi ve hemen alt çocuk özetleriyle tek bir yol kapsamlı yapılandırma alt ağacını inceleyin -- `config.get`: mevcut anlık görüntüyü + hash'i alın + şema düğümü, eşleşen ipucu meta verisi ve doğrudan alt özetlerle tek bir yol kapsamlı yapılandırma alt ağacını inceleyin +- `config.get`: geçerli anlık görüntüyü + hash'i alın - `config.patch`: tercih edilen kısmi güncelleme yolu -- `config.apply`: yalnızca tam yapılandırma değiştirme için -- `update.run`: açık self-update + yeniden başlatma +- `config.apply`: yalnızca tam yapılandırma değiştirme +- `update.run`: açık kendi kendini güncelleme + yeniden başlatma -Tüm yapılandırmanın yerini değiştirmiyorsanız `config.schema.lookup` +Tüm yapılandırmayı değiştirmiyorsanız, `config.schema.lookup` ardından `config.patch` tercih edin. - Tam yapılandırmayı tek adımda doğrular + yazar ve Gateway'i yeniden başlatır. + Tam yapılandırmayı doğrular + yazar ve Gateway'yi tek adımda yeniden başlatır. - `config.apply`, **tüm yapılandırmanın** yerini değiştirir. Kısmi güncellemeler için `config.patch`, tek anahtarlar için `openclaw config set` kullanın. + `config.apply`, **tüm yapılandırmanın** yerine geçer. Kısmi güncellemeler için `config.patch`, tek anahtarlar için ise `openclaw config set` kullanın. Parametreler: - `raw` (string) — tüm yapılandırma için JSON5 yükü - - `baseHash` (isteğe bağlı) — `config.get` içinden gelen yapılandırma hash'i (yapılandırma varsa gereklidir) + - `baseHash` (isteğe bağlı) — `config.get` içinden yapılandırma hash'i (yapılandırma varsa zorunlu) - `sessionKey` (isteğe bağlı) — yeniden başlatma sonrası uyandırma ping'i için oturum anahtarı - - `note` (isteğe bağlı) — yeniden başlatma sentinel'i için not - - `restartDelayMs` (isteğe bağlı) — yeniden başlatma öncesi gecikme (varsayılan 2000) + - `note` (isteğe bağlı) — yeniden başlatma sentinel notu + - `restartDelayMs` (isteğe bağlı) — yeniden başlatmadan önce gecikme (varsayılan 2000) - Yeniden başlatma istekleri, zaten bekleyen/devam eden bir istek varken birleştirilir ve yeniden başlatma döngüleri arasında 30 saniyelik bir soğuma süresi uygulanır. + Yeniden başlatma istekleri, biri zaten beklemede/işlemdeyken birleştirilir ve yeniden başlatma döngüleri arasında 30 saniyelik bekleme süresi uygulanır. ```bash - openclaw gateway call config.get --params '{}' # payload.hash değerini alın + openclaw gateway call config.get --params '{}' # payload.hash değerini yakalayın openclaw gateway call config.apply --params '{ "raw": "{ agents: { defaults: { workspace: \"~/.openclaw/workspace\" } } }", "baseHash": "", @@ -579,19 +586,19 @@ ardından `config.patch` tercih edin. - Kısmi bir güncellemeyi mevcut yapılandırmayla birleştirir (JSON merge patch semantiği): + Kısmi bir güncellemeyi mevcut yapılandırma ile birleştirir (JSON merge patch semantiği): - - Nesneler özyineli olarak birleştirilir + - Nesneler özyineli olarak birleşir - `null` bir anahtarı siler - Diziler yer değiştirir Parametreler: - `raw` (string) — yalnızca değişecek anahtarları içeren JSON5 - - `baseHash` (zorunlu) — `config.get` içinden gelen yapılandırma hash'i + - `baseHash` (zorunlu) — `config.get` içinden yapılandırma hash'i - `sessionKey`, `note`, `restartDelayMs` — `config.apply` ile aynı - Yeniden başlatma davranışı `config.apply` ile aynıdır: bekleyen yeniden başlatmalar birleştirilir ve yeniden başlatma döngüleri arasında 30 saniyelik bir soğuma süresi vardır. + Yeniden başlatma davranışı `config.apply` ile eşleşir: bekleyen yeniden başlatmalar birleştirilir ve yeniden başlatma döngüleri arasında 30 saniyelik bekleme süresi vardır. ```bash openclaw gateway call config.patch --params '{ @@ -605,12 +612,12 @@ ardından `config.patch` tercih edin. ## Ortam değişkenleri -OpenClaw, üst süreçten gelen ortam değişkenlerini ve ayrıca şunları okur: +OpenClaw, üst süreçten gelen env değişkenlerini ve ayrıca şunları okur: -- geçerli çalışma dizinindeki `.env` dosyası (varsa) -- `~/.openclaw/.env` (küresel geri dönüş) +- geçerli çalışma dizinindeki `.env` (varsa) +- `~/.openclaw/.env` (küresel yedek) -Hiçbir dosya mevcut ortam değişkenlerini geçersiz kılmaz. Yapılandırmada satır içi ortam değişkenleri de ayarlayabilirsiniz: +Bu dosyaların hiçbiri mevcut env değişkenlerinin yerine geçmez. Yapılandırmada satır içi env değişkenleri de ayarlayabilirsiniz: ```json5 { @@ -621,8 +628,8 @@ Hiçbir dosya mevcut ortam değişkenlerini geçersiz kılmaz. Yapılandırmada } ``` - - Etkinleştirilirse ve beklenen anahtarlar ayarlı değilse, OpenClaw oturum açma kabuğunuzu çalıştırır ve yalnızca eksik anahtarları içe aktarır: + + Etkinleştirilirse ve beklenen anahtarlar ayarlı değilse, OpenClaw giriş shell'inizi çalıştırır ve yalnızca eksik anahtarları içe aktarır: ```json5 { @@ -632,11 +639,11 @@ Hiçbir dosya mevcut ortam değişkenlerini geçersiz kılmaz. Yapılandırmada } ``` -Ortam değişkeni eşdeğeri: `OPENCLAW_LOAD_SHELL_ENV=1` +Env değişkeni eşdeğeri: `OPENCLAW_LOAD_SHELL_ENV=1` - - Herhangi bir yapılandırma string değerinde `${VAR_NAME}` ile ortam değişkenlerine başvurun: + + Herhangi bir yapılandırma string değerinde `${VAR_NAME}` ile env değişkenlerine başvurun: ```json5 { @@ -647,15 +654,15 @@ Ortam değişkeni eşdeğeri: `OPENCLAW_LOAD_SHELL_ENV=1` Kurallar: -- Yalnızca şu biçimle eşleşen büyük harf adları eşleştirilir: `[A-Z_][A-Z0-9_]*` -- Eksik/boş değişkenler yükleme sırasında hata verir +- Yalnızca şu kalıpla eşleşen büyük harfli adlar eşleştirilir: `[A-Z_][A-Z0-9_]*` +- Eksik/boş değişkenler yükleme sırasında hata fırlatır - Değişmez çıktı için `$${VAR}` ile kaçırın -- `$include` dosyaları içinde de çalışır -- Satır içi yerine koyma: `"${BASE}/v1"` → `"https://api.example.com/v1"` +- `$include` dosyaları içinde çalışır +- Satır içi ikame: `"${BASE}/v1"` → `"https://api.example.com/v1"` - + SecretRef nesnelerini destekleyen alanlar için şunları kullanabilirsiniz: ```json5 @@ -688,16 +695,16 @@ Kurallar: } ``` -`env`/`file`/`exec` için `secrets.providers` dahil SecretRef ayrıntıları [Secrets Management](/gateway/secrets) bölümündedir. -Desteklenen kimlik bilgisi yolları [SecretRef Credential Surface](/reference/secretref-credential-surface) bölümünde listelenmiştir. +SecretRef ayrıntıları (`env`/`file`/`exec` için `secrets.providers` dahil) [Secrets Management](/tr/gateway/secrets) bölümündedir. +Desteklenen kimlik bilgisi yolları [SecretRef Credential Surface](/tr/reference/secretref-credential-surface) bölümünde listelenmiştir. -Tam öncelik sırası ve kaynaklar için [Environment](/help/environment) bölümüne bakın. +Tam öncelik sırası ve kaynaklar için [Environment](/tr/help/environment) bölümüne bakın. ## Tam başvuru -Alan alan tam başvuru için **[Configuration Reference](/gateway/configuration-reference)** bölümüne bakın. +Eksiksiz alan alan başvuru için **[Configuration Reference](/tr/gateway/configuration-reference)** bölümüne bakın. --- -_İlgili: [Configuration Examples](/gateway/configuration-examples) · [Configuration Reference](/gateway/configuration-reference) · [Doctor](/gateway/doctor)_ +_İlgili: [Configuration Examples](/tr/gateway/configuration-examples) · [Configuration Reference](/tr/gateway/configuration-reference) · [Doctor](/tr/gateway/doctor)_ diff --git a/docs/tr/plugins/memory-wiki.md b/docs/tr/plugins/memory-wiki.md new file mode 100644 index 000000000..974038efe --- /dev/null +++ b/docs/tr/plugins/memory-wiki.md @@ -0,0 +1,343 @@ +--- +read_when: + - Düz MEMORY.md notlarının ötesinde kalıcı bilgi istiyorsanız + - Paketlenmiş memory-wiki plugin'ini yapılandırıyorsanız + - wiki_search, wiki_get veya bridge modunu anlamak istiyorsanız +summary: 'memory-wiki: kaynak, iddialar, panolar ve bridge modu içeren derlenmiş bilgi kasası' +title: Memory Wiki +x-i18n: + generated_at: "2026-04-08T06:01:17Z" + model: gpt-5.4 + provider: openai + source_hash: b78dd6a4ef4451dae6b53197bf0c7c2a2ba846b08e4a3a93c1026366b1598d82 + source_path: plugins/memory-wiki.md + workflow: 15 +--- + +# Memory Wiki + +`memory-wiki`, dayanıklı belleği derlenmiş bir bilgi kasasına dönüştüren paketlenmiş bir plugin'dir. + +Etkin bellek plugin'inin yerini **almaz**. Etkin bellek plugin'i geri çağırma, yükseltme, indeksleme ve düşleme işlerinin sahibi olmaya devam eder. `memory-wiki` onun yanında yer alır ve dayanıklı bilgiyi gezilebilir bir wikiye; deterministik sayfalar, yapılandırılmış iddialar, kaynak bilgisi, panolar ve makine tarafından okunabilir özetlerle derler. + +Belleğin, bir Markdown dosyaları yığını gibi değil de daha çok bakımı yapılan bir bilgi katmanı gibi davranmasını istediğinizde bunu kullanın. + +## Ne ekler + +- Deterministik sayfa düzenine sahip özel bir wiki kasası +- Yalnızca düzyazı değil, yapılandırılmış iddia ve kanıt meta verileri +- Sayfa düzeyinde kaynak bilgisi, güven, çelişkiler ve açık sorular +- Aracı/çalışma zamanı tüketicileri için derlenmiş özetler +- Wiki'ye özgü search/get/apply/lint araçları +- Etkin bellek plugin'inden herkese açık yapıtları içe aktaran isteğe bağlı bridge modu +- İsteğe bağlı Obsidian uyumlu render modu ve CLI entegrasyonu + +## Bellekle nasıl uyum sağlar + +Ayrımı şöyle düşünün: + +| Katman | Sahibi olduğu şeyler | +| ------------------------------------------------------- | ------------------------------------------------------------------------------------------ | +| Etkin bellek plugin'i (`memory-core`, QMD, Honcho vb.) | Geri çağırma, anlamsal arama, yükseltme, düşleme, bellek çalışma zamanı | +| `memory-wiki` | Derlenmiş wiki sayfaları, kaynak açısından zengin sentezler, panolar, wiki'ye özgü search/get/apply | + +Etkin bellek plugin'i paylaşılan geri çağırma yapıtlarını sunuyorsa, OpenClaw `memory_search corpus=all` ile her iki katmanı da tek geçişte arayabilir. + +Wiki'ye özgü sıralama, kaynak bilgisi veya doğrudan sayfa erişimi gerektiğinde bunun yerine wiki'ye özgü araçları kullanın. + +## Kasa modları + +`memory-wiki` üç kasa modunu destekler: + +### `isolated` + +Kendi kasası, kendi kaynakları, `memory-core` bağımlılığı yok. + +Wiki'nin kendi küratörlüğü yapılmış bilgi deposu olmasını istiyorsanız bunu kullanın. + +### `bridge` + +Etkin bellek plugin'inden, herkese açık plugin SDK sınırları üzerinden herkese açık bellek yapıtlarını ve bellek olaylarını okur. + +Wiki'nin, özel plugin iç yapılarına erişmeden bellek plugin'inin dışa aktardığı yapıtları derleyip düzenlemesini istiyorsanız bunu kullanın. + +Bridge modu şunları indeksleyebilir: + +- dışa aktarılan bellek yapıtları +- düş raporları +- günlük notlar +- bellek kök dosyaları +- bellek olay günlükleri + +### `unsafe-local` + +Yerel özel yollar için açık aynı-makine kaçış kapağı. + +Bu mod kasıtlı olarak deneyseldir ve taşınabilir değildir. Bunu yalnızca güven sınırını anladığınızda ve özellikle bridge modunun sağlayamadığı yerel dosya sistemi erişimine ihtiyaç duyduğunuzda kullanın. + +## Kasa düzeni + +Plugin, şöyle bir kasa başlatır: + +```text +/ + AGENTS.md + WIKI.md + index.md + inbox.md + entities/ + concepts/ + syntheses/ + sources/ + reports/ + _attachments/ + _views/ + .openclaw-wiki/ +``` + +Yönetilen içerik, oluşturulan blokların içinde kalır. İnsan not blokları korunur. + +Ana sayfa grupları şunlardır: + +- içe aktarılan ham materyal ve bridge destekli sayfalar için `sources/` +- kalıcı şeyler, kişiler, sistemler, projeler ve nesneler için `entities/` +- fikirler, soyutlamalar, örüntüler ve ilkeler için `concepts/` +- derlenmiş özetler ve bakımı yapılan toplulaştırmalar için `syntheses/` +- oluşturulan panolar için `reports/` + +## Yapılandırılmış iddialar ve kanıtlar + +Sayfalar yalnızca serbest biçimli metin değil, yapılandırılmış `claims` frontmatter da taşıyabilir. + +Her iddia şunları içerebilir: + +- `id` +- `text` +- `status` +- `confidence` +- `evidence[]` +- `updatedAt` + +Kanıt girdileri şunları içerebilir: + +- `sourceId` +- `path` +- `lines` +- `weight` +- `note` +- `updatedAt` + +Wiki'nin pasif bir not dökümü yerine daha çok bir inanç katmanı gibi davranmasını sağlayan şey budur. İddialar izlenebilir, puanlanabilir, itiraz edilebilir ve tekrar kaynaklara bağlanarak çözülebilir. + +## Derleme işlem hattı + +Derleme adımı wiki sayfalarını okur, özetleri normalize eder ve şu konumların altında kararlı, makineye dönük yapıtlar üretir: + +- `.openclaw-wiki/cache/agent-digest.json` +- `.openclaw-wiki/cache/claims.jsonl` + +Bu özetler, aracıların ve çalışma zamanı kodunun Markdown sayfalarını kazımasına gerek kalmaması için vardır. + +Derlenmiş çıktı ayrıca şunlara güç sağlar: + +- search/get akışları için ilk geçiş wiki indeksleme +- sahip sayfalara geri iddia kimliği araması +- kompakt prompt ekleri +- rapor/pano üretimi + +## Panolar ve sağlık raporları + +`render.createDashboards` etkinleştirildiğinde derleme, `reports/` altında panoları korur. + +Yerleşik raporlar şunları içerir: + +- `reports/open-questions.md` +- `reports/contradictions.md` +- `reports/low-confidence.md` +- `reports/claim-health.md` +- `reports/stale-pages.md` + +Bu raporlar şunları izler: + +- çelişki not kümleri +- yarışan iddia kümeleri +- yapılandırılmış kanıtı olmayan iddialar +- düşük güvene sahip sayfalar ve iddialar +- bayat veya bilinmeyen tazelik +- çözülmemiş sorular içeren sayfalar + +## Arama ve getirme + +`memory-wiki` iki arama arka ucunu destekler: + +- `shared`: varsa paylaşılan bellek arama akışını kullan +- `local`: wiki'yi yerelde ara + +Ayrıca üç corpus'u destekler: + +- `wiki` +- `memory` +- `all` + +Önemli davranış: + +- `wiki_search` ve `wiki_get`, mümkün olduğunda ilk geçiş olarak derlenmiş özetleri kullanır +- iddia kimlikleri sahip sayfaya geri çözümlenebilir +- itiraz edilmiş/bayat/taze iddialar sıralamayı etkiler +- kaynak etiketleri sonuçlara taşınabilir + +Pratik kural: + +- tek geniş geri çağırma geçişi için `memory_search corpus=all` kullanın +- wiki'ye özgü sıralama, kaynak bilgisi veya sayfa düzeyinde inanç yapısı sizin için önemliyse `wiki_search` + `wiki_get` kullanın + +## Aracı araçları + +Plugin şu araçları kaydeder: + +- `wiki_status` +- `wiki_search` +- `wiki_get` +- `wiki_apply` +- `wiki_lint` + +Yaptıkları işler: + +- `wiki_status`: geçerli kasa modu, sağlık durumu, Obsidian CLI kullanılabilirliği +- `wiki_search`: wiki sayfalarını ve yapılandırılmışsa paylaşılan bellek corpus'larını arar +- `wiki_get`: bir wiki sayfasını id/path ile okur veya paylaşılan bellek corpus'una geri döner +- `wiki_apply`: serbest biçimli sayfa cerrahisi olmadan dar sentez/meta veri mutasyonları +- `wiki_lint`: yapısal denetimler, kaynak boşlukları, çelişkiler, açık sorular + +Plugin ayrıca özel olmayan bir bellek corpus eki de kaydeder; böylece etkin bellek plugin'i corpus seçimini desteklediğinde paylaşılan `memory_search` ve `memory_get` wiki'ye erişebilir. + +## Prompt ve bağlam davranışı + +`context.includeCompiledDigestPrompt` etkinleştirildiğinde, bellek prompt bölümleri `agent-digest.json` içinden kompakt bir derlenmiş anlık görüntü ekler. + +Bu anlık görüntü kasıtlı olarak küçük ve yüksek sinyallidir: + +- yalnızca en üst sayfalar +- yalnızca en üst iddialar +- çelişki sayısı +- soru sayısı +- güven/tazelik niteleyicileri + +Bu isteğe bağlıdır çünkü prompt şeklini değiştirir ve çoğunlukla bağlam motorları veya bellek eklerini açıkça tüketen eski prompt derleme yapıları için faydalıdır. + +## Yapılandırma + +Yapılandırmayı `plugins.entries.memory-wiki.config` altında koyun: + +```json5 +{ + plugins: { + entries: { + "memory-wiki": { + enabled: true, + config: { + vaultMode: "isolated", + vault: { + path: "~/.openclaw/wiki/main", + renderMode: "obsidian", + }, + obsidian: { + enabled: true, + useOfficialCli: true, + vaultName: "OpenClaw Wiki", + openAfterWrites: false, + }, + bridge: { + enabled: false, + readMemoryArtifacts: true, + indexDreamReports: true, + indexDailyNotes: true, + indexMemoryRoot: true, + followMemoryEvents: true, + }, + ingest: { + autoCompile: true, + maxConcurrentJobs: 1, + allowUrlIngest: true, + }, + search: { + backend: "shared", + corpus: "wiki", + }, + context: { + includeCompiledDigestPrompt: false, + }, + render: { + preserveHumanBlocks: true, + createBacklinks: true, + createDashboards: true, + }, + }, + }, + }, + }, +} +``` + +Temel anahtarlar: + +- `vaultMode`: `isolated`, `bridge`, `unsafe-local` +- `vault.renderMode`: `native` veya `obsidian` +- `bridge.readMemoryArtifacts`: etkin bellek plugin'inin herkese açık yapıtlarını içe aktar +- `bridge.followMemoryEvents`: bridge modunda olay günlüklerini dahil et +- `search.backend`: `shared` veya `local` +- `search.corpus`: `wiki`, `memory` veya `all` +- `context.includeCompiledDigestPrompt`: bellek prompt bölümlerine kompakt özet anlık görüntüsünü ekle +- `render.createBacklinks`: deterministik ilgili bloklar oluştur +- `render.createDashboards`: pano sayfaları oluştur + +## CLI + +`memory-wiki` ayrıca üst düzey bir CLI yüzeyi sunar: + +```bash +openclaw wiki status +openclaw wiki doctor +openclaw wiki init +openclaw wiki ingest ./notes/alpha.md +openclaw wiki compile +openclaw wiki lint +openclaw wiki search "alpha" +openclaw wiki get entity.alpha +openclaw wiki apply synthesis "Alpha Summary" --body "..." --source-id source.alpha +openclaw wiki bridge import +openclaw wiki obsidian status +``` + +Tam komut başvurusu için [CLI: wiki](/cli/wiki) bölümüne bakın. + +## Obsidian desteği + +`vault.renderMode` `obsidian` olduğunda plugin, Obsidian dostu Markdown yazar ve isteğe bağlı olarak resmî `obsidian` CLI'ını kullanabilir. + +Desteklenen iş akışları şunları içerir: + +- durum yoklaması +- kasa araması +- bir sayfayı açma +- bir Obsidian komutunu çağırma +- günlük nota atlama + +Bu isteğe bağlıdır. Wiki, Obsidian olmadan yerel modda da çalışır. + +## Önerilen iş akışı + +1. Geri çağırma/yükseltme/düşleme için etkin bellek plugin'inizi koruyun. +2. `memory-wiki` etkinleştirin. +3. Özellikle bridge modu istemiyorsanız `isolated` moduyla başlayın. +4. Kaynak bilgisi önemliyse `wiki_search` / `wiki_get` kullanın. +5. Dar sentezler veya meta veri güncellemeleri için `wiki_apply` kullanın. +6. Anlamlı değişikliklerden sonra `wiki_lint` çalıştırın. +7. Bayatlık/çelişki görünürlüğü istiyorsanız panoları açın. + +## İlgili belgeler + +- [Belleğe Genel Bakış](/tr/concepts/memory) +- [CLI: memory](/cli/memory) +- [CLI: wiki](/cli/wiki) +- [Plugin SDK genel bakış](/tr/plugins/sdk-overview) diff --git a/docs/tr/providers/glm.md b/docs/tr/providers/glm.md index fbdd91ac2..414c9693d 100644 --- a/docs/tr/providers/glm.md +++ b/docs/tr/providers/glm.md @@ -1,14 +1,14 @@ --- read_when: - - OpenClaw içinde GLM modelleri istiyorsunuz - - Model adlandırma kuralına ve kuruluma ihtiyacınız var + - OpenClaw içinde GLM modelleri istiyorsanız + - Model adlandırma kuralına ve kuruluma ihtiyacınız varsa summary: GLM model ailesine genel bakış + OpenClaw içinde nasıl kullanılacağı title: GLM Modelleri x-i18n: - generated_at: "2026-04-05T14:03:50Z" + generated_at: "2026-04-08T06:00:51Z" model: gpt-5.4 provider: openai - source_hash: 59622edab5094d991987f9788fbf08b33325e737e7ff88632b0c3ac89412d4c7 + source_hash: 79a55acfa139847b4b85dbc09f1068cbd2febb1e49f984a23ea9e3b43bc910eb source_path: providers/glm.md workflow: 15 --- @@ -21,7 +21,7 @@ modellerine `zai` sağlayıcısı ve `zai/glm-5` gibi model kimlikleri üzerinde ## CLI kurulumu ```bash -# Endpoint otomatik algılamalı genel API anahtarı kurulumu +# Uç nokta otomatik algılamalı genel API anahtarı kurulumu openclaw onboard --auth-choice zai-api-key # Coding Plan Global, Coding Plan kullanıcıları için önerilir @@ -33,26 +33,26 @@ openclaw onboard --auth-choice zai-coding-cn # Genel API openclaw onboard --auth-choice zai-global -# Genel API CN (Çin bölgesi) +# General API CN (Çin bölgesi) openclaw onboard --auth-choice zai-cn ``` -## Config parçacığı +## Yapılandırma parçacığı ```json5 { env: { ZAI_API_KEY: "sk-..." }, - agents: { defaults: { model: { primary: "zai/glm-5" } } }, + agents: { defaults: { model: { primary: "zai/glm-5.1" } } }, } ``` -`zai-api-key`, OpenClaw'ın anahtardan eşleşen Z.AI endpoint'ini algılamasına ve -doğru base URL'yi otomatik olarak uygulamasına izin verir. Belirli bir Coding Plan veya genel API yüzeyini zorlamak istediğinizde +`zai-api-key`, OpenClaw'ın anahtardan eşleşen Z.AI uç noktasını algılamasına ve +doğru temel URL'yi otomatik olarak uygulamasına olanak tanır. Belirli bir Coding Plan veya genel API yüzeyini zorlamak istediğinizde açık bölgesel seçenekleri kullanın. -## Mevcut paketli GLM modelleri +## Mevcut paketlenmiş GLM modelleri -OpenClaw şu anda paketli `zai` sağlayıcısını şu GLM referanslarıyla başlatır: +OpenClaw şu anda paketlenmiş `zai` sağlayıcısını şu GLM başvurularıyla tohumlar: - `glm-5.1` - `glm-5` @@ -70,6 +70,6 @@ OpenClaw şu anda paketli `zai` sağlayıcısını şu GLM referanslarıyla baş ## Notlar -- GLM sürümleri ve kullanılabilirliği değişebilir; en güncel bilgiler için Z.AI belgelerini kontrol edin. -- Varsayılan paketli model ref'i `zai/glm-5` değeridir. -- Sağlayıcı ayrıntıları için bkz. [/providers/zai](/providers/zai). +- GLM sürümleri ve kullanılabilirliği değişebilir; en güncel bilgiler için Z.AI belgelerine bakın. +- Varsayılan paketlenmiş model başvurusu `zai/glm-5.1` şeklindedir. +- Sağlayıcı ayrıntıları için bkz. [/providers/zai](/tr/providers/zai). diff --git a/docs/tr/providers/zai.md b/docs/tr/providers/zai.md index 3421888f4..184f31937 100644 --- a/docs/tr/providers/zai.md +++ b/docs/tr/providers/zai.md @@ -1,21 +1,23 @@ --- read_when: - - OpenClaw içinde Z.AI / GLM modellerini istiyorsunuz - - Basit bir ZAI_API_KEY kurulumuna ihtiyacınız var + - OpenClaw içinde Z.AI / GLM modelleri istiyorsanız + - Basit bir ZAI_API_KEY kurulumuna ihtiyacınız varsa summary: OpenClaw ile Z.AI (GLM modelleri) kullanın title: Z.AI x-i18n: - generated_at: "2026-04-05T14:05:34Z" + generated_at: "2026-04-08T06:01:00Z" model: gpt-5.4 provider: openai - source_hash: 48006cdd580484f0c62e2877b27a6a68d7bc44795b3e97a28213d95182d9acf9 + source_hash: 66cbd9813ee28d202dcae34debab1b0cf9927793acb00743c1c62b48d9e381f9 source_path: providers/zai.md workflow: 15 --- # Z.AI -Z.AI, **GLM** modelleri için API platformudur. GLM için REST API'leri sağlar ve kimlik doğrulama için API anahtarları kullanır. API anahtarınızı Z.AI konsolunda oluşturun. OpenClaw, bir Z.AI API anahtarıyla `zai` sağlayıcısını kullanır. +Z.AI, **GLM** modelleri için API platformudur. GLM için REST API'leri sağlar ve +kimlik doğrulama için API anahtarları kullanır. API anahtarınızı Z.AI konsolunda oluşturun. OpenClaw, `zai` sağlayıcısını +bir Z.AI API anahtarıyla kullanır. ## CLI kurulumu @@ -32,24 +34,26 @@ openclaw onboard --auth-choice zai-coding-cn # Genel API openclaw onboard --auth-choice zai-global -# General API CN (China region) +# General API CN (Çin bölgesi) openclaw onboard --auth-choice zai-cn ``` -## Yapılandırma kod parçacığı +## Yapılandırma parçacığı ```json5 { env: { ZAI_API_KEY: "sk-..." }, - agents: { defaults: { model: { primary: "zai/glm-5" } } }, + agents: { defaults: { model: { primary: "zai/glm-5.1" } } }, } ``` -`zai-api-key`, OpenClaw'ın anahtardan eşleşen Z.AI uç noktasını algılamasına ve doğru temel URL'yi otomatik olarak uygulamasına olanak tanır. Belirli bir Coding Plan veya genel API yüzeyini zorlamak istediğinizde açık bölgesel seçenekleri kullanın. +`zai-api-key`, OpenClaw'ın anahtardan eşleşen Z.AI uç noktasını algılamasına ve +doğru temel URL'yi otomatik olarak uygulamasına olanak tanır. Belirli bir Coding Plan veya genel API yüzeyini zorlamak istediğinizde +açık bölgesel seçenekleri kullanın. -## Birlikte gelen GLM kataloğu +## Paketlenmiş GLM kataloğu -OpenClaw şu anda birlikte gelen `zai` sağlayıcısını şunlarla başlatır: +OpenClaw şu anda paketlenmiş `zai` sağlayıcısını şunlarla tohumlar: - `glm-5.1` - `glm-5` @@ -67,9 +71,11 @@ OpenClaw şu anda birlikte gelen `zai` sağlayıcısını şunlarla başlatır: ## Notlar -- GLM modelleri `zai/` olarak kullanılabilir (örnek: `zai/glm-5`). -- Varsayılan birlikte gelen model ref'i: `zai/glm-5` -- Bilinmeyen `glm-5*` kimlikleri, kimlik mevcut GLM-5 ailesi biçimiyle eşleştiğinde `glm-4.7` şablonundan sağlayıcıya ait meta verileri sentezleyerek birlikte gelen sağlayıcı yolunda yine de ileri çözümlenir. -- Z.AI araç çağrısı akışı için `tool_stream` varsayılan olarak etkindir. Devre dışı bırakmak için `agents.defaults.models["zai/"].params.tool_stream` değerini `false` olarak ayarlayın. -- Model ailesi genel görünümü için [/providers/glm](/tr/providers/glm) bölümüne bakın. -- Z.AI, API anahtarınızla birlikte Bearer kimlik doğrulaması kullanır. +- GLM modelleri `zai/` olarak kullanılabilir (`zai/glm-5` örneği). +- Varsayılan paketlenmiş model başvurusu: `zai/glm-5.1` +- Bilinmeyen `glm-5*` kimlikleri, kimlik + geçerli GLM-5 ailesi şekliyle eşleştiğinde `glm-4.7` şablonundan sağlayıcıya ait meta veriler sentezlenerek paketlenmiş sağlayıcı yolunda yine de ileri çözülür. +- Z.AI araç çağrısı akışı için `tool_stream` varsayılan olarak etkindir. Devre dışı bırakmak için + `agents.defaults.models["zai/"].params.tool_stream` değerini `false` olarak ayarlayın. +- Model ailesi genel görünümü için bkz. [/providers/glm](/tr/providers/glm). +- Z.AI, API anahtarınızla Bearer kimlik doğrulaması kullanır. diff --git a/docs/tr/refactor/qa.md b/docs/tr/refactor/qa.md index e65d51766..9c00b29c3 100644 --- a/docs/tr/refactor/qa.md +++ b/docs/tr/refactor/qa.md @@ -1,18 +1,18 @@ --- x-i18n: - generated_at: "2026-04-08T02:18:25Z" + generated_at: "2026-04-08T06:01:31Z" model: gpt-5.4 provider: openai - source_hash: 0e156cc8e2fe946a0423862f937754a7caa1fe7e6863b50a80bff49a1c86e1e8 + source_hash: 4a9066b2a939c5a9ba69141d75405f0e8097997b523164340e2f0e9a0d5060dd source_path: refactor/qa.md workflow: 15 --- -# QA Yeniden Düzenleme +# QA Yeniden Düzenlemesi Durum: temel geçiş tamamlandı. -## Amaç +## Hedef OpenClaw QA'yı bölünmüş tanım modelinden tek bir doğruluk kaynağına taşımak: @@ -21,41 +21,45 @@ OpenClaw QA'yı bölünmüş tanım modelinden tek bir doğruluk kaynağına ta - kurulum ve temizleme - harness mantığı - doğrulamalar ve başarı ölçütleri -- artifact'ler ve rapor ipuçları +- artefaktlar ve rapor ipuçları -İstenen son durum, davranışın çoğunu TypeScript içinde sabit kodlamak yerine güçlü senaryo tanım dosyaları yükleyen genel bir QA harness'idir. +İstenen son durum, davranışın büyük bölümünü TypeScript içinde sabit kodlamak yerine güçlü senaryo tanım dosyalarını yükleyen genel bir QA harness'idir. ## Mevcut Durum -Birincil doğruluk kaynağı artık `qa/scenarios.md` içinde bulunuyor. +Birincil doğruluk kaynağı artık `qa/scenarios/index.md` ile `qa/scenarios/*.md` +altındaki her senaryo için bir dosyada bulunuyor. Uygulananlar: -- `qa/scenarios.md` - - kanonik QA paketi +- `qa/scenarios/index.md` + - kanonik QA paketi meta verileri - operatör kimliği - başlangıç görevi +- `qa/scenarios/*.md` + - senaryo başına bir markdown dosyası - senaryo meta verileri - - işleyici bağlamaları + - handler bağlamaları + - senaryoya özgü yürütme yapılandırması - `extensions/qa-lab/src/scenario-catalog.ts` - - markdown paket ayrıştırıcısı + zod doğrulaması + - markdown paketi ayrıştırıcısı + zod doğrulaması - `extensions/qa-lab/src/qa-agent-bootstrap.ts` - markdown paketinden plan oluşturma - `extensions/qa-lab/src/qa-agent-workspace.ts` - - oluşturulmuş uyumluluk dosyalarını ve `QA_SCENARIOS.md` dosyasını tohumlar + - oluşturulan uyumluluk dosyaları ile `QA_SCENARIOS.md` üretimi - `extensions/qa-lab/src/suite.ts` - - çalıştırılabilir senaryoları markdown tanımlı işleyici bağlamaları üzerinden seçer -- QA veri yolu protokolü + UI - - resim/video/ses/dosya işleme için genel satır içi ekler + - çalıştırılabilir senaryoları markdown ile tanımlanmış handler bağlamaları üzerinden seçer +- QA bus protokolü + UI + - görüntü/video/ses/dosya işleme için genel satır içi ekler Kalan bölünmüş yüzeyler: - `extensions/qa-lab/src/suite.ts` - - yürütülebilir özel işleyici mantığının çoğuna hâlâ sahip + - hâlâ çalıştırılabilir özel handler mantığının çoğunu barındırıyor - `extensions/qa-lab/src/report.ts` - - rapor yapısını hâlâ çalışma zamanı çıktılarından türetiyor + - hâlâ rapor yapısını çalışma zamanı çıktılarından türetiyor -Dolayısıyla doğruluk kaynağı bölünmesi düzeltildi, ancak yürütme hâlâ tam bildirime dayalı olmaktan çok çoğunlukla işleyici destekli. +Yani doğruluk kaynağı bölünmesi düzeltildi, ancak yürütme hâlâ çoğunlukla tam bildirimsel olmaktan ziyade handler destekli. ## Gerçek Senaryo Yüzeyi Nasıl Görünüyor @@ -65,9 +69,9 @@ Mevcut suite okunduğunda birkaç farklı senaryo sınıfı görülüyor. - kanal taban çizgisi - DM taban çizgisi -- iş parçacıklı takip +- ileti dizili takip - model değiştirme -- onay tamamlama +- onay takibi - tepki/düzenleme/silme ### Yapılandırma ve çalışma zamanı mutasyonu @@ -75,62 +79,63 @@ Mevcut suite okunduğunda birkaç farklı senaryo sınıfı görülüyor. - config patch skill devre dışı bırakma - config apply yeniden başlatma uyandırması - config yeniden başlatma yetenek çevirme -- çalışma zamanı envanter kayması denetimi +- çalışma zamanı envanter sapması denetimi ### Dosya sistemi ve repo doğrulamaları -- kaynak/docs keşif raporu -- Lobster Invaders oluşturma -- oluşturulmuş görsel artifact arama +- source/docs keşif raporu +- Lobster Invaders derleme +- oluşturulmuş görüntü artefaktı araması ### Bellek orkestrasyonu - bellek geri çağırma - kanal bağlamında bellek araçları -- bellek başarısızlığı fallback'i +- bellek hata geri dönüşü - oturum belleği sıralaması -- iş parçacığı bellek yalıtımı -- bellek rüya görme taraması +- ileti dizisi belleği yalıtımı +- bellek dreaming sweep -### Araç ve eklenti entegrasyonu +### Araç ve plugin entegrasyonu - MCP plugin-tools çağrısı - skill görünürlüğü -- skill anında yükleme -- yerel görsel oluşturma -- görsel gidiş-dönüş -- ekten görsel anlama +- skill canlı kurulum +- yerel görüntü üretimi +- görüntü gidiş-dönüşü +- ekten görüntü anlama ### Çok turlu ve çok aktörlü -- alt ajan devri -- alt ajan fanout sentezi +- subagent devri +- subagent fanout sentezi - yeniden başlatma kurtarma tarzı akışlar -Bu kategoriler önemlidir çünkü DSL gereksinimlerini yönlendirir. Düz bir istem + beklenen metin listesi yeterli değildir. +Bu kategoriler önemlidir çünkü DSL gereksinimlerini yönlendirirler. Düz bir istem + beklenen metin listesi yeterli değildir. ## Yön ### Tek doğruluk kaynağı -Yazılan doğruluk kaynağı olarak `qa/scenarios.md` kullanın. +Yazılmış doğruluk kaynağı olarak `qa/scenarios/index.md` ile `qa/scenarios/*.md` +kullanılsın. -Paket şu özellikleri korumalıdır: +Paket şu özellikleri korumalı: - incelemede insan tarafından okunabilir - makine tarafından ayrıştırılabilir -- şunları yönetecek kadar zengin: +- şunları yönlendirecek kadar zengin: - suite yürütmesi - - QA çalışma alanı bootstrap'i + - QA workspace bootstrap - QA Lab UI meta verileri - - docs/keşif istemleri - - rapor oluşturma + - docs/discovery istemleri + - rapor üretimi ### Tercih edilen yazım biçimi -Üst düzey biçim olarak markdown kullanın; içinde yapılandırılmış YAML olsun. +Üst düzey biçim olarak markdown kullanın, içinde yapılandırılmış YAML olsun. -Önerilen biçim: +Önerilen şekil: - YAML frontmatter - id @@ -139,27 +144,27 @@ Paket şu özellikleri korumalıdır: - tags - docs refs - code refs - - model/provider override'ları - - ön koşullar + - model/provider overrides + - prerequisites - düz yazı bölümleri - - amaç - - notlar - - hata ayıklama ipuçları -- fenced YAML blokları + - objective + - notes + - debugging hints +- çitlenmiş YAML blokları - setup - steps - assertions - cleanup -Bu şu avantajları sağlar: +Bu şunları sağlar: - dev JSON'a göre daha iyi PR okunabilirliği -- saf YAML'a göre daha zengin bağlam -- katı ayrıştırma ve zod doğrulaması +- yalnızca YAML'dan daha zengin bağlam +- sıkı ayrıştırma ve zod doğrulaması Ham JSON yalnızca ara oluşturulmuş biçim olarak kabul edilebilir. -## Önerilen Senaryo Dosyası Biçimi +## Önerilen Senaryo Dosyası Şekli Örnek: @@ -182,11 +187,11 @@ codeRefs: - src/gateway/chat-attachments.ts --- -# Objective +# Amaç -Verify generated media is reattached on the follow-up turn. +Üretilen medyanın takip turunda yeniden eklenerek gönderildiğini doğrulayın. -# Setup +# Kurulum ```yaml scenario.setup - action: config.patch @@ -199,13 +204,13 @@ Verify generated media is reattached on the follow-up turn. key: agent:qa:image-roundtrip ``` -# Steps +# Adımlar ```yaml scenario.steps - action: agent.send session: agent:qa:image-roundtrip message: | - Image generation check: generate a QA lighthouse image and summarize it in one short sentence. + Görüntü üretimi denetimi: bir QA deniz feneri görüntüsü üret ve bunu tek kısa cümlede özetle. - action: artifact.capture kind: generated-image promptSnippet: Image generation check @@ -213,12 +218,12 @@ Verify generated media is reattached on the follow-up turn. - action: agent.send session: agent:qa:image-roundtrip message: | - Roundtrip image inspection check: describe the generated lighthouse attachment in one short sentence. + Gidiş-dönüş görüntü inceleme denetimi: üretilen deniz feneri ekini tek kısa cümlede açıkla. attachments: - fromArtifact: lighthouseImage ``` -# Expect +# Beklenen ```yaml scenario.expect - assert: outbound.textIncludes @@ -232,9 +237,9 @@ Verify generated media is reattached on the follow-up turn. ``` ```` -## DSL'nin Kapsaması Gereken Çalıştırıcı Yetenekleri +## DSL'nin Kapsaması Gereken Runner Yetenekleri -Mevcut suite'e göre, genel çalıştırıcı istem yürütmeden daha fazlasına ihtiyaç duyar. +Mevcut suite'e göre, genel runner yalnızca istem yürütmeden fazlasına ihtiyaç duyuyor. ### Ortam ve kurulum eylemleri @@ -245,7 +250,7 @@ Mevcut suite'e göre, genel çalıştırıcı istem yürütmeden daha fazlasına - `thread.create` - `workspace.writeSkill` -### Ajan turu eylemleri +### Agent turu eylemleri - `agent.send` - `agent.wait` @@ -261,7 +266,7 @@ Mevcut suite'e göre, genel çalıştırıcı istem yürütmeden daha fazlasına - `tools.effective` - `skills.status` -### Dosya ve artifact eylemleri +### Dosya ve artefakt eylemleri - `file.write` - `file.read` @@ -300,66 +305,66 @@ Mevcut suite'e göre, genel çalıştırıcı istem yürütmeden daha fazlasına - `cron.managedPresent` - `artifact.exists` -## Değişkenler ve Artifact Referansları +## Değişkenler ve Artefakt Başvuruları -DSL kaydedilmiş çıktıları ve daha sonra yapılan referansları desteklemelidir. +DSL, kaydedilmiş çıktıları ve daha sonra yapılacak başvuruları desteklemelidir. Mevcut suite'ten örnekler: -- bir iş parçacığı oluştur, sonra `threadId` değerini yeniden kullan -- bir oturum oluştur, sonra `sessionKey` değerini yeniden kullan -- bir görsel oluştur, sonra dosyayı sonraki turda ek olarak iliştir -- bir uyandırma işaretçisi dizesi oluştur, sonra bunun daha sonra göründüğünü doğrula +- bir ileti dizisi oluşturup sonra `threadId` yeniden kullanmak +- bir oturum oluşturup sonra `sessionKey` yeniden kullanmak +- bir görüntü üretip sonraki turda dosyayı eklemek +- bir uyandırma işaretçisi dizesi üretip bunun daha sonra göründüğünü doğrulamak Gerekli yetenekler: - `saveAs` - `${vars.name}` - `${artifacts.name}` -- yollar, oturum anahtarları, iş parçacığı kimlikleri, işaretçiler, araç çıktıları için türlendirilmiş referanslar +- yollar, oturum anahtarları, ileti dizisi kimlikleri, işaretçiler, araç çıktıları için türlenmiş başvurular -Değişken desteği olmadan harness, senaryo mantığını TypeScript'e geri sızdırmaya devam eder. +Değişken desteği olmadan harness, senaryo mantığını tekrar TypeScript'e sızdırmaya devam edecektir. -## Kaçış Kapısı Olarak Nelerin Kalması Gerekir +## Kaçış Kapıları Olarak Neler Kalmalı -Tamamen saf bildirimsel bir çalıştırıcı 1. aşamada gerçekçi değildir. +Tamamen saf bildirimsel bir runner 1. aşamada gerçekçi değil. -Bazı senaryolar doğası gereği yoğun orkestrasyon gerektirir: +Bazı senaryolar doğası gereği ağır orkestrasyon gerektirir: -- bellek rüya görme taraması +- bellek dreaming sweep - config apply yeniden başlatma uyandırması - config yeniden başlatma yetenek çevirme -- zaman damgası/yola göre oluşturulmuş görsel artifact çözümleme +- zaman damgası/yol ile oluşturulmuş görüntü artefaktı çözümlemesi - discovery-report değerlendirmesi -Bunlar şimdilik açık özel işleyiciler kullanmalıdır. +Bunlar şimdilik açık özel handler'lar kullanmalıdır. Önerilen kural: -- %85-%90 bildirime dayalı -- geri kalan zor kısım için açık `customHandler` adımları -- yalnızca adlandırılmış ve belgelenmiş özel işleyiciler +- %85-90 bildirimsel +- zor kalan bölüm için açık `customHandler` adımları +- yalnızca adlandırılmış ve belgelenmiş özel handler'lar - senaryo dosyasında anonim satır içi kod yok -Bu, ilerlemeye izin verirken genel motoru temiz tutar. +Bu, yine de ilerlemeye izin verirken genel motoru temiz tutar. ## Mimari Değişiklik -### Mevcut +### Mevcut Durum Senaryo markdown'u zaten şu alanlar için doğruluk kaynağıdır: - suite yürütmesi -- çalışma alanı bootstrap dosyaları +- workspace bootstrap dosyaları - QA Lab UI senaryo kataloğu - rapor meta verileri -- keşif istemleri +- discovery istemleri -Oluşturulan uyumluluk: +Üretilmiş uyumluluk: -- tohumlanmış çalışma alanı hâlâ `QA_KICKOFF_TASK.md` içeriyor -- tohumlanmış çalışma alanı hâlâ `QA_SCENARIO_PLAN.md` içeriyor -- tohumlanmış çalışma alanı artık ayrıca `QA_SCENARIOS.md` içeriyor +- seed edilmiş workspace hâlâ `QA_KICKOFF_TASK.md` içeriyor +- seed edilmiş workspace hâlâ `QA_SCENARIO_PLAN.md` içeriyor +- seed edilmiş workspace artık ayrıca `QA_SCENARIOS.md` de içeriyor ## Yeniden Düzenleme Planı @@ -367,69 +372,70 @@ Oluşturulan uyumluluk: Tamamlandı. -- `qa/scenarios.md` eklendi +- `qa/scenarios/index.md` eklendi +- senaryolar `qa/scenarios/*.md` içine bölündü - adlandırılmış markdown YAML paket içeriği için ayrıştırıcı eklendi - zod ile doğrulandı - tüketiciler ayrıştırılmış pakete geçirildi -- repo düzeyi `qa/seed-scenarios.json` ve `qa/QA_KICKOFF_TASK.md` kaldırıldı +- repo düzeyindeki `qa/seed-scenarios.json` ve `qa/QA_KICKOFF_TASK.md` kaldırıldı ### Aşama 2: genel motor -- `extensions/qa-lab/src/suite.ts` dosyasını şunlara ayır: - - yükleyici - - motor - - eylem kayıt defteri - - doğrulama kayıt defteri - - özel işleyiciler -- mevcut yardımcı işlevleri motor işlemleri olarak tut +- `extensions/qa-lab/src/suite.ts` şu parçalara bölünecek: + - loader + - engine + - action registry + - assertion registry + - custom handlers +- mevcut yardımcı işlevler motor işlemleri olarak korunacak -Teslim edilecek çıktı: +Teslimat: -- motor, basit bildirimsel senaryoları yürütür +- motor basit bildirimsel senaryoları yürütür Çoğunlukla istem + bekleme + doğrulamadan oluşan senaryolarla başlayın: -- iş parçacıklı takip -- ekten görsel anlama -- skill görünürlüğü ve çağrılması +- ileti dizili takip +- ekten görüntü anlama +- skill görünürlüğü ve çağrımı - kanal taban çizgisi -Teslim edilecek çıktı: +Teslimat: -- ilk gerçek markdown tanımlı senaryolar genel motor üzerinden yayımlanıyor +- ilk gerçek markdown tanımlı senaryoların genel motor üzerinden gönderimi -### Aşama 4: orta düzey senaryoları taşı +### Aşama 4: orta zorluktaki senaryoları taşıma -- görsel oluşturma gidiş-dönüş +- görüntü üretimi gidiş-dönüşü - kanal bağlamında bellek araçları - oturum belleği sıralaması -- alt ajan devri -- alt ajan fanout sentezi +- subagent devri +- subagent fanout sentezi -Teslim edilecek çıktı: +Teslimat: -- değişkenler, artifact'ler, araç doğrulamaları, request-log doğrulamaları kanıtlanmış olur +- değişkenler, artefaktlar, araç doğrulamaları, request-log doğrulamalarının kanıtlanması -### Aşama 5: zor senaryoları özel işleyicilerde tut +### Aşama 5: zor senaryoları özel handler'larda tutma -- bellek rüya görme taraması +- bellek dreaming sweep - config apply yeniden başlatma uyandırması - config yeniden başlatma yetenek çevirme -- çalışma zamanı envanter kayması +- çalışma zamanı envanter sapması -Teslim edilecek çıktı: +Teslimat: -- aynı yazım biçimi, ancak gerektiğinde açık özel adım bloklarıyla +- aynı yazım biçimi, ancak gerektiğinde açık custom-step bloklarıyla -### Aşama 6: sabit kodlanmış senaryo haritasını sil +### Aşama 6: sabit kodlu senaryo eşlemesini silme Paket kapsamı yeterince iyi olduğunda: -- `extensions/qa-lab/src/suite.ts` içindeki senaryoya özgü TypeScript dallanmasının çoğunu kaldır +- `extensions/qa-lab/src/suite.ts` içindeki senaryoya özgü TypeScript dallanmasının büyük bölümünü kaldırın ## Sahte Slack / Zengin Medya Desteği -Mevcut QA veri yolu önce metne odaklıdır. +Mevcut QA bus öncelikle metin odaklıdır. İlgili dosyalar: @@ -439,17 +445,17 @@ Mevcut QA veri yolu önce metne odaklıdır. - `extensions/qa-lab/src/bus-server.ts` - `extensions/qa-lab/web/src/ui-render.ts` -Bugün QA veri yolu şunları destekler: +Bugün QA bus şunları destekler: - metin - tepkiler -- iş parçacıkları +- ileti dizileri Henüz satır içi medya eklerini modellemiyor. ### Gerekli taşıma sözleşmesi -Genel bir QA veri yolu ek modeli ekleyin: +Genel bir QA bus eki modeli ekleyin: ```ts type QaBusAttachment = { @@ -468,67 +474,67 @@ type QaBusAttachment = { }; ``` -Sonra `attachments?: QaBusAttachment[]` alanını şunlara ekleyin: +Ardından `attachments?: QaBusAttachment[]` ekleyin: - `QaBusMessage` - `QaBusInboundMessageInput` - `QaBusOutboundMessageInput` -### Neden önce genel +### Neden önce genel model -Yalnızca Slack'e özgü bir medya modeli oluşturmayın. +Yalnızca Slack'e özel bir medya modeli oluşturmayın. Bunun yerine: - tek bir genel QA taşıma modeli -- bunun üzerinde birden çok işleyici +- bunun üzerinde birden çok renderer - mevcut QA Lab sohbeti - - gelecekteki sahte Slack web - - diğer olası sahte taşıma görünümleri + - gelecekteki sahte Slack web arayüzü + - diğer sahte taşıma görünümleri -Bu yaklaşım yinelenen mantığı önler ve medya senaryolarının taşıma bağımsız kalmasını sağlar. +Bu, yinelenen mantığı önler ve medya senaryolarının taşımadan bağımsız kalmasını sağlar. -### Gereken UI çalışması +### Gerekli UI çalışması -QA UI'ı şunları işleyebilecek şekilde güncelleyin: +QA UI'yi şu öğeleri işleyecek şekilde güncelleyin: -- satır içi görsel önizlemesi +- satır içi görüntü önizlemesi - satır içi ses oynatıcı - satır içi video oynatıcı -- dosya eki çipi +- dosya eki chip'i -Mevcut UI zaten iş parçacıklarını ve tepkileri işleyebiliyor, bu nedenle ek işleme aynı mesaj kartı modeli üzerine katman olarak eklenmelidir. +Mevcut UI zaten ileti dizilerini ve tepkileri işleyebiliyor, bu yüzden ek işleme aynı mesaj kartı modeli üzerine katmanlanabilmelidir. ### Medya taşımasıyla etkinleşen senaryo çalışması -Ekler QA veri yolundan akmaya başladığında daha zengin sahte sohbet senaryoları ekleyebiliriz: +Ekler QA bus üzerinden akmaya başladığında, daha zengin sahte sohbet senaryoları ekleyebiliriz: -- sahte Slack'te satır içi görsel yanıtı +- sahte Slack'te satır içi görüntü yanıtı - ses eki anlama - video eki anlama - karışık ek sıralaması -- medyayı koruyan iş parçacığı yanıtı +- medyası korunmuş ileti dizisi yanıtı ## Öneri -Sonraki uygulama parçası şu olmalıdır: +Bir sonraki uygulama parçası şu olmalı: 1. markdown senaryo yükleyicisi + zod şeması ekle -2. mevcut kataloğu markdown'dan oluştur +2. mevcut kataloğu markdown'dan üret 3. önce birkaç basit senaryoyu taşı -4. genel QA veri yolu ek desteği ekle -5. QA UI'da satır içi görseli işle -6. sonra ses ve videoya genişlet +4. genel QA bus ek desteği ekle +5. QA UI içinde satır içi görüntüyü işle +6. ardından ses ve videoya genişlet Bu, her iki hedefi de kanıtlayan en küçük yoldur: -- genel markdown tanımlı QA +- genel markdown ile tanımlanmış QA - daha zengin sahte mesajlaşma yüzeyleri ## Açık Sorular -- senaryo dosyalarının değişken enterpolasyonu ile gömülü markdown istem şablonlarına izin verip vermemesi gerektiği -- setup/cleanup bölümlerinin adlandırılmış bölümler mi yoksa yalnızca sıralı eylem listeleri mi olması gerektiği -- artifact referanslarının şemada güçlü biçimde türlendirilmiş mi yoksa dize tabanlı mı olması gerektiği -- özel işleyicilerin tek bir kayıt defterinde mi yoksa yüzey başına kayıt defterlerinde mi yaşaması gerektiği -- oluşturulan JSON uyumluluk dosyasının geçiş sırasında sürüm kontrolünde tutulmaya devam edip etmemesi gerektiği +- senaryo dosyalarının değişken interpolasyonlu gömülü markdown istem şablonlarına izin verip vermemesi +- setup/cleanup'ın adlandırılmış bölümler mi yoksa yalnızca sıralı eylem listeleri mi olması gerektiği +- artefakt başvurularının şemada güçlü türlenmiş mi yoksa dize tabanlı mı olması gerektiği +- özel handler'ların tek bir registry içinde mi yoksa surface başına registry'lerde mi yaşaması gerektiği +- oluşturulmuş JSON uyumluluk dosyasının geçiş sırasında checked in kalıp kalmaması gerektiği diff --git a/docs/tr/tools/slash-commands.md b/docs/tr/tools/slash-commands.md index 2428589f8..8a8a9d08e 100644 --- a/docs/tr/tools/slash-commands.md +++ b/docs/tr/tools/slash-commands.md @@ -1,14 +1,14 @@ --- read_when: - - Sohbet komutlarını kullanıyor veya yapılandırıyorsunuz - - Komut yönlendirmesini veya izinleri hata ayıklıyorsunuz -summary: 'Slash komutları: metin ve yerel, yapılandırma ve desteklenen komutlar' + - Sohbet komutlarını kullanırken veya yapılandırırken + - Komut yönlendirmesi veya izinlerinde hata ayıklarken +summary: 'Slash komutları: metin ile yerel arasındaki fark, yapılandırma ve desteklenen komutlar' title: Slash Komutları x-i18n: - generated_at: "2026-04-06T03:14:45Z" + generated_at: "2026-04-08T06:02:12Z" model: gpt-5.4 provider: openai - source_hash: 417e35b9ddd87f25f6c019111b55b741046ea11039dde89210948185ced5696d + source_hash: 4a7ee7f1a8012058279b9e632889b291d4e659e4ec81209ca8978afbb9ad4b96 source_path: tools/slash-commands.md workflow: 15 --- @@ -16,21 +16,21 @@ x-i18n: # Slash komutları Komutlar Gateway tarafından işlenir. Çoğu komut, `/` ile başlayan **bağımsız** bir mesaj olarak gönderilmelidir. -Yalnızca host üzerinde çalışan bash sohbet komutu `! ` kullanır (`/bash ` bir takma addır). +Yalnızca ana makineye özel bash sohbet komutu `! ` kullanır (`/bash ` ise bunun diğer adıdır). Birbiriyle ilişkili iki sistem vardır: - **Komutlar**: bağımsız `/...` mesajları. - **Yönergeler**: `/think`, `/fast`, `/verbose`, `/reasoning`, `/elevated`, `/exec`, `/model`, `/queue`. - - Yönergeler, model mesajı görmeden önce ondan ayıklanır. - - Normal sohbet mesajlarında (yalnızca yönergelerden oluşmayan), “satır içi ipuçları” olarak değerlendirilir ve oturum ayarlarını **kalıcı hale getirmez**. - - Yalnızca yönerge içeren mesajlarda (mesaj yalnızca yönergeler içeriyorsa), oturuma kalıcı olarak kaydedilir ve bir onay yanıtı döndürür. - - Yönergeler yalnızca **yetkili göndericilere** uygulanır. `commands.allowFrom` ayarlanmışsa, kullanılan tek - izin listesi odur; aksi halde yetkilendirme channel izin listeleri/eşleştirme ile `commands.useAccessGroups` üzerinden gelir. - Yetkisiz göndericiler, yönergelerin düz metin olarak ele alındığını görür. + - Yönergeler, model mesajı görmeden önce mesajdan çıkarılır. + - Normal sohbet mesajlarında (yalnızca yönerge olmayanlarda), “satır içi ipuçları” olarak değerlendirilir ve oturum ayarlarını **kalıcı olarak** değiştirmez. + - Yalnızca yönerge içeren mesajlarda (mesaj yalnızca yönergeler içeriyorsa), oturumda kalıcı olur ve bir onay yanıtı verir. + - Yönergeler yalnızca **yetkili göndericiler** için uygulanır. `commands.allowFrom` ayarlanmışsa, kullanılan tek + izin listesi odur; aksi halde yetkilendirme kanal izin listeleri/eşleştirme ile `commands.useAccessGroups` üzerinden gelir. + Yetkisiz göndericilerde yönergeler düz metin olarak değerlendirilir. -Ayrıca birkaç **satır içi kısayol** da vardır (yalnızca izin listesinde/yetkili göndericiler için): `/help`, `/commands`, `/status`, `/whoami` (`/id`). -Bunlar hemen çalışır, model kalan metni görmeden önce ayıklanır ve kalan metin normal akıştan devam eder. +Buna ek olarak birkaç **satır içi kısayol** da vardır (yalnızca izinli/yetkili göndericiler): `/help`, `/commands`, `/status`, `/whoami` (`/id`). +Bunlar hemen çalışır, model mesajı görmeden önce çıkarılır ve kalan metin normal akıştan devam eder. ## Yapılandırma @@ -46,7 +46,10 @@ Bunlar hemen çalışır, model kalan metni görmeden önce ayıklanır ve kalan mcp: false, plugins: false, debug: false, - restart: false, + restart: true, + ownerAllowFrom: ["discord:123456789012345678"], + ownerDisplay: "raw", + ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}", allowFrom: { "*": ["user1"], discord: ["user:123"], @@ -56,141 +59,179 @@ Bunlar hemen çalışır, model kalan metni görmeden önce ayıklanır ve kalan } ``` -- `commands.text` (varsayılan `true`), sohbet mesajlarında `/...` ayrıştırmasını etkinleştirir. - - Yerel komutları olmayan yüzeylerde (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams), bunu `false` yapsanız bile metin komutları çalışmaya devam eder. -- `commands.native` (varsayılan `"auto"`), yerel komutları kaydeder. - - Otomatik: Discord/Telegram için açık; Slack için kapalıdır (slash komutlarını ekleyene kadar); yerel desteği olmayan sağlayıcılarda yok sayılır. - - Sağlayıcı bazında geçersiz kılmak için `channels.discord.commands.native`, `channels.telegram.commands.native` veya `channels.slack.commands.native` ayarlayın (bool veya `"auto"`). +- `commands.text` (varsayılan `true`) sohbet mesajlarında `/...` ayrıştırmayı etkinleştirir. + - Yerel komutları olmayan yüzeylerde (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams), bunu `false` olarak ayarlasanız bile metin komutları çalışmaya devam eder. +- `commands.native` (varsayılan `"auto"`) yerel komutları kaydeder. + - Otomatik: Discord/Telegram için açık; Slack için kapalıdır (slash komutlarını siz ekleyene kadar); yerel destek olmayan sağlayıcılarda yok sayılır. + - Sağlayıcı bazında geçersiz kılmak için `channels.discord.commands.native`, `channels.telegram.commands.native` veya `channels.slack.commands.native` ayarını kullanın (bool veya `"auto"`). - `false`, başlangıçta Discord/Telegram üzerinde daha önce kaydedilmiş komutları temizler. Slack komutları Slack uygulamasında yönetilir ve otomatik olarak kaldırılmaz. -- `commands.nativeSkills` (varsayılan `"auto"`), desteklendiğinde **skill** komutlarını yerel olarak kaydeder. - - Otomatik: Discord/Telegram için açık; Slack için kapalıdır (Slack, skill başına bir slash komutu oluşturmayı gerektirir). - - Sağlayıcı bazında geçersiz kılmak için `channels.discord.commands.nativeSkills`, `channels.telegram.commands.nativeSkills` veya `channels.slack.commands.nativeSkills` ayarlayın (bool veya `"auto"`). -- `commands.bash` (varsayılan `false`), `! ` ile host shell komutlarının çalıştırılmasını etkinleştirir (`/bash ` bir takma addır; `tools.elevated` izin listeleri gerekir). -- `commands.bashForegroundMs` (varsayılan `2000`), bash’in arka plan kipine geçmeden önce ne kadar bekleyeceğini denetler (`0`, hemen arka plana atar). -- `commands.config` (varsayılan `false`), `/config` komutunu etkinleştirir (`openclaw.json` okur/yazar). -- `commands.mcp` (varsayılan `false`), `/mcp` komutunu etkinleştirir (`mcp.servers` altındaki OpenClaw tarafından yönetilen MCP config’ini okur/yazar). -- `commands.plugins` (varsayılan `false`), `/plugins` komutunu etkinleştirir (plugin keşfi/durumu artı kurulum + etkinleştirme/devre dışı bırakma denetimleri). -- `commands.debug` (varsayılan `false`), `/debug` komutunu etkinleştirir (yalnızca çalışma zamanı geçersiz kılmaları). -- `commands.allowFrom` (isteğe bağlı), komut yetkilendirmesi için sağlayıcı başına bir izin listesi ayarlar. Yapılandırıldığında, komutlar ve yönergeler için - tek yetkilendirme kaynağı bu olur (channel izin listeleri/eşleştirme ve `commands.useAccessGroups` - yok sayılır). Global varsayılan için `"*"` kullanın; sağlayıcıya özgü anahtarlar bunu geçersiz kılar. -- `commands.useAccessGroups` (varsayılan `true`), `commands.allowFrom` ayarlanmamışsa komutlar için izin listelerini/ilkeleri uygular. +- `commands.nativeSkills` (varsayılan `"auto"`) desteklendiğinde **skill** komutlarını yerel olarak kaydeder. + - Otomatik: Discord/Telegram için açık; Slack için kapalıdır (Slack her skill için bir slash komutu oluşturmayı gerektirir). + - Sağlayıcı bazında geçersiz kılmak için `channels.discord.commands.nativeSkills`, `channels.telegram.commands.nativeSkills` veya `channels.slack.commands.nativeSkills` ayarını kullanın (bool veya `"auto"`). +- `commands.bash` (varsayılan `false`) `! ` ile ana makine kabuk komutlarını çalıştırmayı etkinleştirir (`/bash ` bunun diğer adıdır; `tools.elevated` izin listelerini gerektirir). +- `commands.bashForegroundMs` (varsayılan `2000`) bash'in arka plan moduna geçmeden önce ne kadar bekleyeceğini kontrol eder (`0`, hemen arka plana alır). +- `commands.config` (varsayılan `false`) `/config` komutunu etkinleştirir (`openclaw.json` okur/yazar). +- `commands.mcp` (varsayılan `false`) `/mcp` komutunu etkinleştirir (OpenClaw tarafından yönetilen `mcp.servers` altındaki MCP yapılandırmasını okur/yazar). +- `commands.plugins` (varsayılan `false`) `/plugins` komutunu etkinleştirir (plugin keşfi/durumu ile kurulum + etkinleştirme/devre dışı bırakma denetimleri). +- `commands.debug` (varsayılan `false`) `/debug` komutunu etkinleştirir (yalnızca çalışma zamanı geçersiz kılmaları). +- `commands.restart` (varsayılan `true`) `/restart` ile gateway yeniden başlatma araç eylemlerini etkinleştirir. +- `commands.ownerAllowFrom` (isteğe bağlı), yalnızca sahip için olan komut/araç yüzeyleri adına açık sahip izin listesini ayarlar. Bu, `commands.allowFrom` listesinden ayrıdır. +- `commands.ownerDisplay`, sahip kimliklerinin sistem isteminde nasıl görüneceğini kontrol eder: `raw` veya `hash`. +- `commands.ownerDisplaySecret`, `commands.ownerDisplay="hash"` olduğunda kullanılan HMAC gizli anahtarını isteğe bağlı olarak ayarlar. +- `commands.allowFrom` (isteğe bağlı), komut yetkilendirmesi için sağlayıcı bazlı bir izin listesi ayarlar. Yapılandırıldığında, komutlar ve yönergeler için + tek yetkilendirme kaynağı budur (kanal izin listeleri/eşleştirme ve `commands.useAccessGroups` + yok sayılır). Genel varsayılan için `"*"` kullanın; sağlayıcıya özel anahtarlar bunu geçersiz kılar. +- `commands.useAccessGroups` (varsayılan `true`), `commands.allowFrom` ayarlı değilken komutlar için izin listelerini/ilkeleri uygular. ## Komut listesi -Metin + yerel (etkinleştirildiğinde): +Geçerli gerçek kaynaklar: -- `/help` -- `/commands` -- `/tools [compact|verbose]` (geçerli agent’ın şu anda ne kullanabildiğini gösterir; `verbose` açıklamaları ekler) -- `/skill [input]` (bir skill’i adına göre çalıştır) -- `/status` (geçerli durumu gösterir; mevcut model provider için kullanılabiliyorsa provider kullanım/kota bilgilerini içerir) -- `/tasks` (geçerli oturum için arka plan görevlerini listeler; agent-local geri dönüş sayılarıyla etkin ve son görev ayrıntılarını gösterir) -- `/allowlist` (izin listesi girdilerini listele/ekle/kaldır) -- `/approve ` (exec onay istemlerini çözümler; kullanılabilir kararlar için bekleyen onay mesajını kullanın) -- `/context [list|detail|json]` (“bağlam”ı açıklar; `detail`, dosya başına + araç başına + skill başına + sistem komutu boyutunu gösterir) -- `/btw ` (gelecekteki oturum bağlamını değiştirmeden geçerli oturum hakkında geçici bir yan soru sorar; bkz. [/tools/btw](/tr/tools/btw)) -- `/export-session [path]` (takma ad: `/export`) (geçerli oturumu tam sistem komutuyla birlikte HTML olarak dışa aktarır) -- `/whoami` (gönderici kimliğinizi gösterir; takma adı: `/id`) -- `/session idle ` (odaklanmış thread bağları için etkinliksizlik kaynaklı otomatik odak kaldırmayı yönetir) -- `/session max-age ` (odaklanmış thread bağları için kesin max-age kaynaklı otomatik odak kaldırmayı yönetir) -- `/subagents list|kill|log|info|send|steer|spawn` (geçerli oturum için alt agent çalıştırmalarını incele, denetle veya başlat) -- `/acp spawn|cancel|steer|close|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|sessions` (ACP çalışma zamanı oturumlarını incele ve denetle) -- `/agents` (bu oturum için thread’e bağlı agent’ları listeler) -- `/focus ` (Discord: bu thread’i veya yeni bir thread’i bir oturum/alt agent hedefine bağla) -- `/unfocus` (Discord: geçerli thread bağını kaldır) -- `/kill ` (bu oturum için çalışan bir veya tüm alt agent’ları hemen durdurur; onay mesajı yoktur) -- `/steer ` (çalışan bir alt agent’ı hemen yönlendirir: mümkünse çalışma içinde, aksi halde mevcut işi durdurup yönlendirme mesajıyla yeniden başlatır) -- `/tell ` (`/steer` için takma ad) -- `/config show|get|set|unset` (config’i diske kalıcı yazar, yalnızca sahip; `commands.config: true` gerektirir) -- `/mcp show|get|set|unset` (OpenClaw MCP sunucu config’ini yönetir, yalnızca sahip; `commands.mcp: true` gerektirir) -- `/plugins list|show|get|install|enable|disable` (keşfedilen plugin’leri incele, yenilerini kur ve etkinliği değiştir; yazma işlemleri yalnızca sahip içindir; `commands.plugins: true` gerektirir) - - `/plugin`, `/plugins` için bir takma addır. - - `/plugin install `, `openclaw plugins install` ile aynı plugin spec’lerini kabul eder: yerel yol/arşiv, npm paketi veya `clawhub:`. - - Etkinleştirme/devre dışı bırakma yazmaları yine de bir yeniden başlatma ipucuyla yanıt verir. Ön planda izlenen bir gateway’de OpenClaw bu yeniden başlatmayı yazımdan hemen sonra otomatik gerçekleştirebilir. -- `/debug show|set|unset|reset` (yalnızca çalışma zamanı geçersiz kılmaları, yalnızca sahip; `commands.debug: true` gerektirir) -- `/usage off|tokens|full|cost` (yanıt başına kullanım altbilgisi veya yerel maliyet özeti) -- `/tts off|always|inbound|tagged|status|provider|limit|summary|audio` (TTS denetimi; bkz. [/tts](/tr/tools/tts)) - - Discord: yerel komut `/voice`’dur (Discord `/tts` komutunu ayırır); metin `/tts` yine de çalışır. -- `/stop` -- `/restart` -- `/dock-telegram` (takma ad: `/dock_telegram`) (yanıtları Telegram’a geçir) -- `/dock-discord` (takma ad: `/dock_discord`) (yanıtları Discord’a geçir) -- `/dock-slack` (takma ad: `/dock_slack`) (yanıtları Slack’e geçir) -- `/activation mention|always` (yalnızca gruplar) -- `/send on|off|inherit` (yalnızca sahip) -- `/reset` veya `/new [model]` (isteğe bağlı model ipucu; kalan metin aynen iletilir) -- `/think ` (modele/sağlayıcıya göre dinamik seçenekler; takma adlar: `/thinking`, `/t`) -- `/fast status|on|off` (argümanı atlamak, geçerli etkin fast-mode durumunu gösterir) -- `/verbose on|full|off` (takma adı: `/v`) -- `/reasoning on|off|stream` (takma adı: `/reason`; açıkken `Reasoning:` önekli ayrı bir mesaj gönderir; `stream` = yalnızca Telegram taslağı) -- `/elevated on|off|ask|full` (takma adı: `/elev`; `full`, exec onaylarını atlar) -- `/exec host= security= ask= node=` (geçerli durumu görmek için `/exec` gönderin) -- `/model ` (takma adı: `/models`; veya `agents.defaults.models.*.alias` içindeki `/`) -- `/queue ` (artı `debounce:2s cap:25 drop:summarize` gibi seçenekler; mevcut ayarları görmek için `/queue` gönderin) -- `/bash ` (yalnızca host; `! ` için takma ad; `commands.bash: true` + `tools.elevated` izin listeleri gerekir) -- `/dreaming [on|off|status|help]` (global dreaming’i aç/kapat veya durumu göster; bkz. [Dreaming](/concepts/dreaming)) +- çekirdek yerleşik komutlar `src/auto-reply/commands-registry.shared.ts` içinden gelir +- üretilmiş dock komutları `src/auto-reply/commands-registry.data.ts` içinden gelir +- plugin komutları plugin `registerCommand()` çağrılarından gelir +- gateway'inizde fiili kullanılabilirlik yine de yapılandırma bayraklarına, kanal yüzeyine ve kurulu/etkin plugin'lere bağlıdır -Yalnızca metin: +### Çekirdek yerleşik komutlar -- `/compact [instructions]` (bkz. [/concepts/compaction](/tr/concepts/compaction)) -- `! ` (yalnızca host; aynı anda bir tane; uzun işler için `!poll` + `!stop` kullanın) -- `!poll` (çıktıyı / durumu kontrol eder; isteğe bağlı `sessionId` kabul eder; `/bash poll` da çalışır) -- `!stop` (çalışan bash işini durdurur; isteğe bağlı `sessionId` kabul eder; `/bash stop` da çalışır) +Bugün kullanılabilen yerleşik komutlar: + +- `/new [model]` yeni bir oturum başlatır; `/reset` sıfırlama diğer adıdır. +- `/compact [instructions]` oturum bağlamını sıkıştırır. Bkz. [/concepts/compaction](/tr/concepts/compaction). +- `/stop` geçerli çalıştırmayı iptal eder. +- `/session idle ` ve `/session max-age ` iş parçacığına bağlanma süresinin dolmasını yönetir. +- `/think ` düşünme düzeyini ayarlar. Diğer adlar: `/thinking`, `/t`. +- `/verbose on|off|full` ayrıntılı çıktıyı açar/kapatır. Diğer adı: `/v`. +- `/fast [status|on|off]` hızlı modu gösterir veya ayarlar. +- `/reasoning [on|off|stream]` muhakeme görünürlüğünü açar/kapatır. Diğer adı: `/reason`. +- `/elevated [on|off|ask|full]` yükseltilmiş modu açar/kapatır. Diğer adı: `/elev`. +- `/exec host= security= ask= node=` exec varsayılanlarını gösterir veya ayarlar. +- `/model [name|#|status]` modeli gösterir veya ayarlar. +- `/models [provider] [page] [limit=|size=|all]` sağlayıcıları veya bir sağlayıcıya ait modelleri listeler. +- `/queue ` kuyruk davranışını yönetir (`steer`, `interrupt`, `followup`, `collect`, `steer-backlog`) ve `debounce:2s cap:25 drop:summarize` gibi seçenekleri destekler. +- `/help` kısa yardım özetini gösterir. +- `/commands` üretilmiş komut kataloğunu gösterir. +- `/tools [compact|verbose]` geçerli ajanın şu anda neleri kullanabildiğini gösterir. +- `/status` çalışma zamanı durumunu gösterir; varsa sağlayıcı kullanımı/kotası da dahil edilir. +- `/tasks` geçerli oturum için etkin/son arka plan görevlerini listeler. +- `/context [list|detail|json]` bağlamın nasıl oluşturulduğunu açıklar. +- `/export-session [path]` geçerli oturumu HTML olarak dışa aktarır. Diğer adı: `/export`. +- `/whoami` gönderici kimliğinizi gösterir. Diğer adı: `/id`. +- `/skill [input]` adıyla bir skill çalıştırır. +- `/allowlist [list|add|remove] ...` izin listesi girdilerini yönetir. Yalnızca metin. +- `/approve ` exec onay istemlerini çözümler. +- `/btw ` gelecekteki oturum bağlamını değiştirmeden yan bir soru sorar. Bkz. [/tools/btw](/tr/tools/btw). +- `/subagents list|kill|log|info|send|steer|spawn` geçerli oturum için alt ajan çalıştırmalarını yönetir. +- `/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help` ACP oturumlarını ve çalışma zamanı seçeneklerini yönetir. +- `/focus ` geçerli Discord iş parçacığını veya Telegram konusunu/sohbetini bir oturum hedefine bağlar. +- `/unfocus` geçerli bağlamayı kaldırır. +- `/agents` geçerli oturum için iş parçacığına bağlı ajanları listeler. +- `/kill ` çalışan bir veya tüm alt ajanları iptal eder. +- `/steer ` çalışan bir alt ajana yönlendirme gönderir. Diğer adı: `/tell`. +- `/config show|get|set|unset` `openclaw.json` okur veya yazar. Yalnızca sahip. `commands.config: true` gerektirir. +- `/mcp show|get|set|unset` `mcp.servers` altındaki OpenClaw tarafından yönetilen MCP sunucu yapılandırmasını okur veya yazar. Yalnızca sahip. `commands.mcp: true` gerektirir. +- `/plugins list|inspect|show|get|install|enable|disable` plugin durumunu inceler veya değiştirir. `/plugin` bunun diğer adıdır. Yazma işlemleri yalnızca sahip içindir. `commands.plugins: true` gerektirir. +- `/debug show|set|unset|reset` yalnızca çalışma zamanı yapılandırma geçersiz kılmalarını yönetir. Yalnızca sahip. `commands.debug: true` gerektirir. +- `/usage off|tokens|full|cost` yanıt başına kullanım alt bilgisini denetler veya yerel bir maliyet özeti yazdırır. +- `/tts on|off|status|provider|limit|summary|audio|help` TTS'yi denetler. Bkz. [/tools/tts](/tr/tools/tts). +- `/restart` etkinse OpenClaw'ı yeniden başlatır. Varsayılan: etkin; devre dışı bırakmak için `commands.restart: false` ayarlayın. +- `/activation mention|always` grup etkinleştirme modunu ayarlar. +- `/send on|off|inherit` gönderme ilkesini ayarlar. Yalnızca sahip. +- `/bash ` bir ana makine kabuk komutunu çalıştırır. Yalnızca metin. Diğer adı: `! `. `commands.bash: true` ve ayrıca `tools.elevated` izin listelerini gerektirir. +- `!poll [sessionId]` bir arka plan bash işini denetler. +- `!stop [sessionId]` bir arka plan bash işini durdurur. + +### Üretilmiş dock komutları + +Dock komutları, yerel komut desteğine sahip kanal plugin'lerinden üretilir. Geçerli paketlenmiş küme: + +- `/dock-discord` (diğer adı: `/dock_discord`) +- `/dock-mattermost` (diğer adı: `/dock_mattermost`) +- `/dock-slack` (diğer adı: `/dock_slack`) +- `/dock-telegram` (diğer adı: `/dock_telegram`) + +### Paketlenmiş plugin komutları + +Paketlenmiş plugin'ler daha fazla slash komutu ekleyebilir. Bu repodaki geçerli paketlenmiş komutlar: + +- `/dreaming [on|off|status|help]` bellek rüyalaştırmayı açar/kapatır. Bkz. [Dreaming](/tr/concepts/dreaming). +- `/pair [qr|status|pending|approve|cleanup|notify]` cihaz eşleştirme/kurulum akışını yönetir. Bkz. [Pairing](/tr/channels/pairing). +- `/phone status|arm [duration]|disarm` yüksek riskli telefon düğümü komutlarını geçici olarak devreye alır. +- `/voice status|list [limit]|set ` Talk ses yapılandırmasını yönetir. Discord'da yerel komut adı `/talkvoice` olur. +- `/card ...` LINE zengin kart önayarlarını gönderir. Bkz. [LINE](/tr/channels/line). +- Yalnızca QQBot komutları: + - `/bot-ping` + - `/bot-version` + - `/bot-help` + - `/bot-upgrade` + - `/bot-logs` + +### Dinamik skill komutları + +Kullanıcının çağırabildiği skill'ler de slash komutları olarak sunulur: + +- `/skill [input]` her zaman genel giriş noktası olarak çalışır. +- skill'ler, skill/plugin bunları kaydederse `/prose` gibi doğrudan komutlar olarak da görünebilir. +- yerel skill komutu kaydı `commands.nativeSkills` ve `channels..commands.nativeSkills` tarafından denetlenir. Notlar: -- Komutlar, komut ile argümanlar arasında isteğe bağlı `:` kabul eder (ör. `/think: high`, `/send: on`, `/help:`). -- `/new `, bir model takma adı, `provider/model` veya sağlayıcı adı (bulanık eşleşme) kabul eder; eşleşme yoksa metin mesaj gövdesi olarak ele alınır. -- Tam provider kullanım dökümü için `openclaw status --usage` kullanın. -- `/allowlist add|remove`, `commands.config=true` gerektirir ve channel `configWrites` ayarını dikkate alır. -- Çok hesaplı channels içinde, hedef hesap için kullanılan `/allowlist --account ` ve `/config set channels..accounts....` da hedef hesabın `configWrites` ayarını dikkate alır. -- `/usage`, yanıt başına kullanım altbilgisini denetler; `/usage cost`, OpenClaw oturum günlüklerinden yerel bir maliyet özeti yazdırır. +- Komutlar, komut ile argümanlar arasında isteğe bağlı bir `:` kabul eder (ör. `/think: high`, `/send: on`, `/help:`). +- `/new ` bir model diğer adını, `provider/model` biçimini veya bir sağlayıcı adını kabul eder (bulanık eşleşme); eşleşme yoksa metin mesaj gövdesi olarak değerlendirilir. +- Sağlayıcı kullanımının tam dökümü için `openclaw status --usage` kullanın. +- `/allowlist add|remove` için `commands.config=true` gerekir ve kanal `configWrites` ayarlarına uyar. +- Çok hesaplı kanallarda, yapılandırma hedefli `/allowlist --account ` ve `/config set channels..accounts....` işlemleri de hedef hesabın `configWrites` ayarlarına uyar. +- `/usage`, yanıt başına kullanım alt bilgisini denetler; `/usage cost`, OpenClaw oturum günlüklerinden yerel bir maliyet özeti yazdırır. - `/restart` varsayılan olarak etkindir; devre dışı bırakmak için `commands.restart: false` ayarlayın. -- Yalnızca Discord yerel komutu: `/vc join|leave|status`, ses kanallarını denetler (`channels.discord.voice` ve yerel komutlar gerekir; metin olarak yoktur). -- Discord thread-binding komutları (`/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age`), etkin thread bağlarının etkin olmasını gerektirir (`session.threadBindings.enabled` ve/veya `channels.discord.threadBindings.enabled`). +- `/plugins install `, `openclaw plugins install` ile aynı plugin belirtimlerini kabul eder: yerel yol/arşiv, npm paketi veya `clawhub:`. +- `/plugins enable|disable` plugin yapılandırmasını günceller ve yeniden başlatma isteyebilir. +- Yalnızca Discord yerel komutu: `/vc join|leave|status` ses kanallarını denetler (`channels.discord.voice` ve yerel komutlar gerekir; metin olarak kullanılamaz). +- Discord iş parçacığı bağlama komutları (`/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age`) etkili iş parçacığı bağlamalarının etkin olmasını gerektirir (`session.threadBindings.enabled` ve/veya `channels.discord.threadBindings.enabled`). - ACP komut başvurusu ve çalışma zamanı davranışı: [ACP Agents](/tr/tools/acp-agents). -- `/verbose`, hata ayıklama ve ek görünürlük içindir; normal kullanımda **kapalı** tutun. -- `/fast on|off`, oturum geçersiz kılmasını kalıcı hale getirir. Bunu temizleyip config varsayılanlarına dönmek için Sessions UI içindeki `inherit` seçeneğini kullanın. -- `/fast`, sağlayıcıya özgüdür: OpenAI/OpenAI Codex bunu yerel Responses endpoint’lerinde `service_tier=priority` olarak eşlerken, `api.anthropic.com` adresine gönderilen OAuth ile kimlik doğrulanmış trafik dahil doğrudan herkese açık Anthropic istekleri bunu `service_tier=auto` veya `standard_only` olarak eşler. Bkz. [OpenAI](/tr/providers/openai) ve [Anthropic](/tr/providers/anthropic). -- Araç hata özetleri ilgili olduğunda yine gösterilir, ancak ayrıntılı hata metni yalnızca `/verbose` `on` veya `full` iken eklenir. -- `/reasoning` (ve `/verbose`) grup ortamlarında risklidir: açığa çıkarmayı düşünmediğiniz iç reasoning’i veya araç çıktısını ifşa edebilir. Özellikle grup sohbetlerinde bunları kapalı bırakmayı tercih edin. +- `/verbose`, hata ayıklama ve ek görünürlük için tasarlanmıştır; normal kullanımda **kapalı** tutun. +- `/fast on|off`, oturum geçersiz kılmasını kalıcı hale getirir. Bunu temizleyip yapılandırma varsayılanlarına dönmek için Sessions UI içindeki `inherit` seçeneğini kullanın. +- `/fast` sağlayıcıya özeldir: OpenAI/OpenAI Codex bunu yerel Responses uç noktalarında `service_tier=priority` olarak eşler; `api.anthropic.com` adresine gönderilen OAuth kimlik doğrulamalı trafik dahil doğrudan genel Anthropic isteklerinde ise `service_tier=auto` veya `standard_only` olarak eşlenir. Bkz. [OpenAI](/tr/providers/openai) ve [Anthropic](/tr/providers/anthropic). +- Araç hata özetleri ilgili olduğunda yine gösterilir, ancak ayrıntılı hata metni yalnızca `/verbose` `on` veya `full` olduğunda eklenir. +- `/reasoning` (ve `/verbose`) grup ortamlarında risklidir: ortaya çıkarmanız amaçlanmayan iç muhakemeyi veya araç çıktısını açığa çıkarabilirler. Özellikle grup sohbetlerinde bunları kapalı bırakmanız önerilir. - `/model`, yeni oturum modelini hemen kalıcı hale getirir. -- Agent boşta ise bir sonraki çalıştırma bunu hemen kullanır. -- Bir çalıştırma zaten etkinse OpenClaw canlı geçişi beklemede olarak işaretler ve yalnızca temiz bir yeniden deneme noktasında yeni modele yeniden başlar. -- Araç etkinliği veya yanıt çıktısı zaten başladıysa, bekleyen geçiş daha sonraki bir yeniden deneme fırsatına ya da sonraki kullanıcı turuna kadar kuyrukta kalabilir. -- **Hızlı yol:** izin listesindeki göndericilerden gelen yalnızca komut içeren mesajlar hemen işlenir (kuyruk + model atlanır). -- **Grup mention kapılaması:** izin listesindeki göndericilerden gelen yalnızca komut içeren mesajlar mention gereksinimlerini atlar. -- **Satır içi kısayollar (yalnızca izin listesindeki göndericiler):** bazı komutlar normal bir mesajın içine gömülü olduğunda da çalışır ve model kalan metni görmeden önce ayıklanır. - - Örnek: `hey /status`, bir durum yanıtı tetikler ve kalan metin normal akıştan devam eder. +- Ajan boşta ise, bir sonraki çalıştırma bunu hemen kullanır. +- Bir çalıştırma zaten etkinken, OpenClaw canlı geçişi beklemede olarak işaretler ve yalnızca temiz bir yeniden deneme noktasında yeni modele yeniden başlatır. +- Araç etkinliği veya yanıt çıktısı zaten başlamışsa, bekleyen geçiş daha sonraki bir yeniden deneme fırsatına veya bir sonraki kullanıcı turuna kadar kuyrukta kalabilir. +- **Hızlı yol:** izinli göndericilerden gelen yalnızca komut içeren mesajlar hemen işlenir (kuyruk + model atlanır). +- **Grup bahsetme geçidi:** izinli göndericilerden gelen yalnızca komut içeren mesajlar bahsetme gereksinimlerini atlar. +- **Satır içi kısayollar (yalnızca izinli göndericiler):** bazı komutlar normal bir mesaja gömülü olduğunda da çalışır ve model kalan metni görmeden önce çıkarılır. + - Örnek: `hey /status` bir durum yanıtını tetikler ve kalan metin normal akıştan devam eder. - Şu anda: `/help`, `/commands`, `/status`, `/whoami` (`/id`). -- Yetkisiz yalnızca komut mesajları sessizce yok sayılır ve satır içi `/...` belirteçleri düz metin olarak değerlendirilir. -- **Skill komutları:** `user-invocable` skill’ler slash komutları olarak sunulur. Adlar `a-z0-9_` olacak şekilde temizlenir (en fazla 32 karakter); çakışmalar sayısal son ekler alır (ör. `_2`). - - `/skill [input]`, bir skill’i adına göre çalıştırır (yerel komut sınırları skill başına komutları engellediğinde yararlıdır). - - Varsayılan olarak skill komutları modele normal istek olarak iletilir. - - Skill’ler isteğe bağlı olarak komutu doğrudan bir araca yönlendirmek için `command-dispatch: tool` bildirebilir (deterministik, modelsiz). - - Örnek: `/prose` (OpenProse plugin’i) — bkz. [OpenProse](/tr/prose). -- **Yerel komut argümanları:** Discord, dinamik seçenekler için autocomplete kullanır (ve gerekli argümanları atlarsanız düğme menüleri gösterir). Telegram ve Slack, komut seçenekleri destekliyorsa ve argümanı atlarsanız bir düğme menüsü gösterir. +- Yetkisiz yalnızca komut içeren mesajlar sessizce yok sayılır ve satır içi `/...` belirteçleri düz metin olarak değerlendirilir. +- **Skill komutları:** `user-invocable` skill'ler slash komutları olarak sunulur. Adlar `a-z0-9_` biçimine dönüştürülür (en fazla 32 karakter); çakışmalar sayısal son ekler alır (ör. `_2`). + - `/skill [input]` bir skill'i adıyla çalıştırır (yerel komut sınırları her-skill-komutlara izin vermediğinde kullanışlıdır). + - Varsayılan olarak skill komutları modele normal bir istek olarak iletilir. + - Skill'ler isteğe bağlı olarak komutu doğrudan bir araca yönlendirmek için `command-dispatch: tool` bildirebilir (deterministik, modelsiz). + - Örnek: `/prose` (OpenProse plugin'i) — bkz. [OpenProse](/tr/prose). +- **Yerel komut argümanları:** Discord dinamik seçenekler için otomatik tamamlama kullanır (ve gerekli argümanları atladığınızda düğme menüleri gösterir). Telegram ve Slack, bir komut seçenekleri desteklediğinde ve siz argümanı atladığınızda düğme menüsü gösterir. ## `/tools` -`/tools`, bir config sorusunu değil, çalışma zamanı sorusunu yanıtlar: **bu agent’ın şu anda -bu konuşmada ne kullanabildiğini**. +`/tools`, bir yapılandırma sorusunu değil, bir çalışma zamanı sorusunu yanıtlar: **bu ajan şu anda +bu konuşmada neleri kullanabilir**. -- Varsayılan `/tools` kompakttır ve hızlı tarama için optimize edilmiştir. -- `/tools verbose`, kısa açıklamalar ekler. -- Argümanları destekleyen yerel komut yüzeyleri, aynı `compact|verbose` kip değiştiricisini sunar. -- Sonuçlar oturum kapsamındadır; bu nedenle agent, channel, thread, gönderici yetkilendirmesi veya model değişirse çıktı da değişebilir. -- `/tools`, çalışma zamanında gerçekten erişilebilir araçları içerir; buna core araçları, bağlı plugin araçları ve channel’a ait araçlar dahildir. +- Varsayılan `/tools` kompakt yapıdadır ve hızlı tarama için optimize edilmiştir. +- `/tools verbose` kısa açıklamalar ekler. +- Argümanları destekleyen yerel komut yüzeyleri, aynı mod geçişini `compact|verbose` olarak sunar. +- Sonuçlar oturum kapsamlıdır; bu nedenle ajanı, kanalı, iş parçacığını, gönderici yetkilendirmesini veya modeli değiştirmek + çıktıyı değiştirebilir. +- `/tools`; çalışma zamanında gerçekten erişilebilir olan araçları içerir; buna çekirdek araçlar, bağlı + plugin araçları ve kanala ait araçlar dahildir. -Profil ve geçersiz kılma düzenlemeleri için, `/tools`’u statik katalog gibi görmek yerine Control UI Tools panelini veya config/katalog yüzeylerini kullanın. +Profil ve geçersiz kılma düzenlemeleri için `/tools`'u statik bir katalog gibi ele almak yerine +Control UI Tools panelini veya yapılandırma/katalog yüzeylerini kullanın. ## Kullanım yüzeyleri (nerede ne gösterilir) -- **Provider kullanım/kota** (örnek: “Claude %80 kaldı”), kullanım izleme etkin olduğunda `/status` içinde mevcut model provider için görünür. OpenClaw provider pencerelerini `% kaldı` olarak normalize eder; MiniMax için yalnızca kalan yüzde alanları gösterimden önce tersine çevrilir ve `model_remains` yanıtları model etiketi taşıyan plan etiketine ek olarak chat-model girdisini tercih eder. -- `/status` içindeki **Token/cache satırları**, canlı oturum snapshot’ı seyrek olduğunda en son transcript kullanım girdisine geri dönebilir. Mevcut sıfır olmayan canlı değerler yine de kazanır ve transcript geri dönüşü ayrıca etkin çalışma zamanı model etiketini ve depolanmış toplamlar eksik veya daha küçük olduğunda prompt odaklı daha büyük bir toplamı da geri getirebilir. +- **Sağlayıcı kullanımı/kota** (örnek: “Claude %80 kaldı”), kullanım izleme etkin olduğunda geçerli model sağlayıcısı için `/status` içinde görünür. OpenClaw, sağlayıcı pencerelerini `% kaldı` biçimine normalleştirir; MiniMax için yalnızca kalan yüzde alanları gösterimden önce ters çevrilir ve `model_remains` yanıtlarında sohbet modeli girdisi ile modele etiketlenmiş plan etiketi tercih edilir. +- `/status` içindeki **token/cache satırları**, canlı oturum anlık görüntüsü seyrek olduğunda en son transkript kullanım girdisine geri dönebilir. Sıfır olmayan mevcut canlı değerler yine önceliklidir ve transkript geri dönüşü, depolanan toplamlar eksik veya daha küçük olduğunda etkin çalışma zamanı model etiketini ve istem odaklı daha büyük bir toplamı da kurtarabilir. - **Yanıt başına token/maliyet**, `/usage off|tokens|full` ile denetlenir (normal yanıtlara eklenir). -- `/model status`, kullanımla değil, **modeller/auth/endpoint’lerle** ilgilidir. +- `/model status`, kullanımla değil **modeller/auth/uç noktalar** ile ilgilidir. ## Model seçimi (`/model`) @@ -209,14 +250,14 @@ Profil ve geçersiz kılma düzenlemeleri için, `/tools`’u statik katalog gib Notlar: -- `/model` ve `/model list`, kompakt, numaralandırılmış bir seçici gösterir (model ailesi + kullanılabilir sağlayıcılar). -- Discord üzerinde `/model` ve `/models`, sağlayıcı ve model açılır listeleri artı bir Submit adımı içeren etkileşimli bir seçici açar. +- `/model` ve `/model list`, kompakt ve numaralı bir seçici gösterir (model ailesi + kullanılabilir sağlayıcılar). +- Discord'da `/model` ve `/models`, sağlayıcı ve model açılır menülerinin yanı sıra bir Submit adımı içeren etkileşimli bir seçici açar. - `/model <#>`, bu seçiciden seçim yapar (ve mümkün olduğunda geçerli sağlayıcıyı tercih eder). -- `/model status`, kullanılabildiğinde yapılandırılmış sağlayıcı endpoint’i (`baseUrl`) ve API kipini (`api`) de içeren ayrıntılı görünümü gösterir. +- `/model status`, yapılandırılmış sağlayıcı uç noktası (`baseUrl`) ve varsa API modu (`api`) dahil ayrıntılı görünümü gösterir. -## Debug geçersiz kılmaları +## Hata ayıklama geçersiz kılmaları -`/debug`, **yalnızca çalışma zamanı** config geçersiz kılmaları ayarlamanıza olanak tanır (disk değil, bellek). Yalnızca sahip içindir. Varsayılan olarak devre dışıdır; etkinleştirmek için `commands.debug: true` kullanın. +`/debug`, **yalnızca çalışma zamanı** yapılandırma geçersiz kılmalarını ayarlamanıza izin verir (diskte değil, bellekte). Yalnızca sahip. Varsayılan olarak devre dışıdır; etkinleştirmek için `commands.debug: true` kullanın. Örnekler: @@ -230,12 +271,12 @@ Notlar: Notlar: -- Geçersiz kılmalar yeni config okumalarına hemen uygulanır, ancak `openclaw.json` dosyasına yazılmaz. -- Tüm geçersiz kılmaları temizlemek ve disk üzerindeki config’e dönmek için `/debug reset` kullanın. +- Geçersiz kılmalar, yeni yapılandırma okumalarına hemen uygulanır, ancak `openclaw.json` içine yazılmaz. +- Tüm geçersiz kılmaları temizleyip disk üzerindeki yapılandırmaya dönmek için `/debug reset` kullanın. -## Config güncellemeleri +## Yapılandırma güncellemeleri -`/config`, disk üzerindeki config’inize (`openclaw.json`) yazar. Yalnızca sahip içindir. Varsayılan olarak devre dışıdır; etkinleştirmek için `commands.config: true` kullanın. +`/config`, disk üzerindeki yapılandırmanıza (`openclaw.json`) yazar. Yalnızca sahip. Varsayılan olarak devre dışıdır; etkinleştirmek için `commands.config: true` kullanın. Örnekler: @@ -249,12 +290,12 @@ Notlar: Notlar: -- Yazmadan önce config doğrulanır; geçersiz değişiklikler reddedilir. -- `/config` güncellemeleri yeniden başlatmalar arasında kalıcıdır. +- Yazmadan önce yapılandırma doğrulanır; geçersiz değişiklikler reddedilir. +- `/config` güncellemeleri yeniden başlatmalar arasında kalıcı olur. ## MCP güncellemeleri -`/mcp`, `mcp.servers` altındaki OpenClaw tarafından yönetilen MCP sunucu tanımlarını yazar. Yalnızca sahip içindir. Varsayılan olarak devre dışıdır; etkinleştirmek için `commands.mcp: true` kullanın. +`/mcp`, `mcp.servers` altında OpenClaw tarafından yönetilen MCP sunucu tanımlarını yazar. Yalnızca sahip. Varsayılan olarak devre dışıdır; etkinleştirmek için `commands.mcp: true` kullanın. Örnekler: @@ -267,12 +308,12 @@ Notlar: Notlar: -- `/mcp`, config’i Pi’ye ait proje ayarlarında değil OpenClaw config’inde saklar. -- Hangi transport’ların gerçekten yürütülebilir olduğuna çalışma zamanı bağdaştırıcıları karar verir. +- `/mcp`, yapılandırmayı Pi'ye ait proje ayarlarında değil, OpenClaw yapılandırmasında saklar. +- Hangi taşımaların gerçekten çalıştırılabilir olduğuna çalışma zamanı bağdaştırıcıları karar verir. ## Plugin güncellemeleri -`/plugins`, operatörlerin keşfedilen plugin’leri incelemesine ve config içindeki etkinliği değiştirmesine olanak tanır. Salt okunur akışlar takma ad olarak `/plugin` kullanabilir. Varsayılan olarak devre dışıdır; etkinleştirmek için `commands.plugins: true` kullanın. +`/plugins`, operatörlerin keşfedilen plugin'leri incelemesine ve yapılandırmada etkinleştirmeyi açıp kapatmasına olanak tanır. Salt okunur akışlar diğer ad olarak `/plugin` kullanabilir. Varsayılan olarak devre dışıdır; etkinleştirmek için `commands.plugins: true` kullanın. Örnekler: @@ -286,34 +327,35 @@ Notlar: Notlar: -- `/plugins list` ve `/plugins show`, mevcut çalışma alanı ve disk üzerindeki config’e karşı gerçek plugin keşfini kullanır. -- `/plugins enable|disable`, yalnızca plugin config’ini günceller; plugin kurmaz veya kaldırmaz. -- Etkinleştirme/devre dışı bırakma değişikliklerinden sonra bunları uygulamak için gateway’i yeniden başlatın. +- `/plugins list` ve `/plugins show`, geçerli çalışma alanına ve disk üzerindeki yapılandırmaya karşı gerçek plugin keşfini kullanır. +- `/plugins enable|disable` yalnızca plugin yapılandırmasını günceller; plugin kurmaz veya kaldırmaz. +- Etkinleştirme/devre dışı bırakma değişikliklerinden sonra bunları uygulamak için gateway'i yeniden başlatın. ## Yüzey notları -- **Metin komutları**, normal sohbet oturumunda çalışır (DM’ler `main`’i paylaşır, grupların kendi oturumu vardır). -- **Yerel komutlar**, izole oturumlar kullanır: +- **Metin komutları** normal sohbet oturumunda çalışır (DM'ler `main` oturumunu paylaşır, grupların kendi oturumu vardır). +- **Yerel komutlar** yalıtılmış oturumlar kullanır: - Discord: `agent::discord:slash:` - Slack: `agent::slack:slash:` (önek `channels.slack.slashCommand.sessionPrefix` ile yapılandırılabilir) - - Telegram: `telegram:slash:` (oturum hedefi `CommandTargetSessionKey` üzerinden sohbet oturumunu hedefler) -- **`/stop`**, geçerli çalıştırmayı durdurabilmesi için etkin sohbet oturumunu hedefler. -- **Slack:** `channels.slack.slashCommand`, tek bir `/openclaw` tarzı komut için hâlâ desteklenir. `commands.native` etkinleştirirseniz, her yerleşik komut için bir Slack slash komutu oluşturmanız gerekir (`/help` ile aynı adlar). Slack için komut argüman menüleri geçici Block Kit düğmeleri olarak iletilir. - - Slack yerel istisnası: Slack `/status` komutunu ayırdığı için `/status` değil `/agentstatus` kaydedin. Metin `/status`, Slack mesajlarında yine de çalışır. + - Telegram: `telegram:slash:` (sohbet oturumunu `CommandTargetSessionKey` üzerinden hedefler) +- **`/stop`**, geçerli çalıştırmayı iptal edebilmek için etkin sohbet oturumunu hedef alır. +- **Slack:** `channels.slack.slashCommand`, tek bir `/openclaw` tarzı komut için hâlâ desteklenir. `commands.native` etkinleştirirseniz, her yerleşik komut için bir Slack slash komutu oluşturmanız gerekir (`/help` ile aynı adlar). Slack için komut argüman menüleri geçici Block Kit düğmeleri olarak teslim edilir. + - Slack yerel istisnası: Slack `/status` komutunu ayırdığı için `/status` değil `/agentstatus` kaydedin. Metin `/status`, Slack mesajlarında yine çalışır. ## BTW yan soruları -`/btw`, mevcut oturum hakkında hızlı bir **yan soru**dur. +`/btw`, geçerli oturum hakkında hızlı bir **yan soru** sormanın yoludur. Normal sohbetten farklı olarak: -- mevcut oturumu arka plan bağlamı olarak kullanır, -- ayrı, **araçsız** tek seferlik bir çağrı olarak çalışır, +- geçerli oturumu arka plan bağlamı olarak kullanır, +- ayrı bir **araçsız** tek seferlik çağrı olarak çalışır, - gelecekteki oturum bağlamını değiştirmez, -- transcript geçmişine yazılmaz, +- transkript geçmişine yazılmaz, - normal bir asistan mesajı yerine canlı bir yan sonuç olarak iletilir. -Bu, ana görev devam ederken geçici bir netleştirme istediğinizde `/btw` komutunu yararlı kılar. +Bu da `/btw` komutunu, ana +görev sürerken geçici bir açıklama istediğiniz durumlar için kullanışlı kılar. Örnek: @@ -321,4 +363,5 @@ Bu, ana görev devam ederken geçici bir netleştirme istediğinizde `/btw` komu /btw şu anda ne yapıyoruz? ``` -Tam davranış ve istemci UX ayrıntıları için bkz. [BTW Side Questions](/tr/tools/btw). +Tam davranış ve istemci UX +ayrıntıları için bkz. [BTW Yan Soruları](/tr/tools/btw). diff --git a/docs/tr/tools/tts.md b/docs/tr/tools/tts.md index 68350d0ba..bae06553b 100644 --- a/docs/tr/tools/tts.md +++ b/docs/tr/tools/tts.md @@ -6,17 +6,17 @@ read_when: summary: Giden yanıtlar için metinden konuşmaya (TTS) title: Metinden Konuşmaya x-i18n: - generated_at: "2026-04-05T14:14:34Z" + generated_at: "2026-04-08T06:01:50Z" model: gpt-5.4 provider: openai - source_hash: 8487c8acef7585bd4eb5e3b39e2a063ebc6b5f0103524abdcbadd3a7781ffc46 + source_hash: 6e0fbcaf61282733c134f682e05a71f94d2169c03a85131ce9ad233c71a1e533 source_path: tools/tts.md workflow: 15 --- # Metinden konuşmaya (TTS) -OpenClaw, ElevenLabs, Microsoft, MiniMax veya OpenAI kullanarak giden yanıtları sese dönüştürebilir. +OpenClaw, giden yanıtları ElevenLabs, Microsoft, MiniMax veya OpenAI kullanarak sese dönüştürebilir. OpenClaw'ın ses gönderebildiği her yerde çalışır. ## Desteklenen hizmetler @@ -24,20 +24,21 @@ OpenClaw'ın ses gönderebildiği her yerde çalışır. - **ElevenLabs** (birincil veya yedek sağlayıcı) - **Microsoft** (birincil veya yedek sağlayıcı; mevcut paketlenmiş uygulama `node-edge-tts` kullanır) - **MiniMax** (birincil veya yedek sağlayıcı; T2A v2 API'sini kullanır) -- **OpenAI** (birincil veya yedek sağlayıcı; ayrıca özetler için kullanılır) +- **OpenAI** (birincil veya yedek sağlayıcı; özetler için de kullanılır) ### Microsoft konuşma notları Paketlenmiş Microsoft konuşma sağlayıcısı şu anda Microsoft Edge'in çevrimiçi -nöral TTS hizmetini `node-edge-tts` kitaplığı üzerinden kullanır. Barındırılan bir hizmettir (yerel -değil), Microsoft uç noktalarını kullanır ve API anahtarı gerektirmez. -`node-edge-tts`, konuşma yapılandırma seçeneklerini ve çıktı biçimlerini sunar, ancak -tüm seçenekler hizmet tarafından desteklenmez. Eski yapılandırma ve yönerge girdisi -olarak `edge` hâlâ çalışır ve `microsoft` olarak normalize edilir. +nöral TTS hizmetini `node-edge-tts` kitaplığı aracılığıyla kullanır. Barındırılan +bir hizmettir (yerel değil), Microsoft uç noktalarını kullanır ve API anahtarı +gerektirmez. `node-edge-tts`, konuşma yapılandırma seçeneklerini ve çıktı +biçimlerini sunar, ancak tüm seçenekler hizmet tarafından desteklenmez. `edge` +kullanan eski yapılandırma ve yönerge girdileri hâlâ çalışır ve `microsoft` +olarak normalize edilir. -Bu yol, yayımlanmış bir SLA veya kota olmadan herkese açık bir web hizmeti olduğu için, -onu en iyi çaba düzeyinde değerlendirin. Garantili sınırlar ve destek gerekiyorsa OpenAI -veya ElevenLabs kullanın. +Bu yol, yayımlanmış bir SLA veya kotası olmayan herkese açık bir web hizmeti +olduğundan, bunu en iyi çaba düzeyinde değerlendirin. Garantili sınırlar ve +destek gerekiyorsa OpenAI veya ElevenLabs kullanın. ## İsteğe bağlı anahtarlar @@ -50,8 +51,8 @@ OpenAI, ElevenLabs veya MiniMax istiyorsanız: Microsoft konuşma için API anahtarı **gerekmez**. Birden fazla sağlayıcı yapılandırılmışsa önce seçilen sağlayıcı kullanılır, diğerleri yedek seçenekler olur. -Otomatik özetleme, yapılandırılmış `summaryModel` değerini (veya `agents.defaults.model.primary`) kullanır, -bu nedenle özetlemeyi etkinleştirirseniz o sağlayıcının da kimliği doğrulanmış olması gerekir. +Otomatik özetleme, yapılandırılmış `summaryModel` (veya `agents.defaults.model.primary`) kullanır, +bu nedenle özetlemeyi etkinleştirirseniz o sağlayıcı için de kimlik doğrulaması yapılmış olmalıdır. ## Hizmet bağlantıları @@ -65,10 +66,10 @@ bu nedenle özetlemeyi etkinleştirirseniz o sağlayıcının da kimliği doğru ## Varsayılan olarak etkin mi? -Hayır. Otomatik TTS varsayılan olarak **kapalıdır**. Yapılandırmada -`messages.tts.auto` ile veya oturum başına `/tts always` (takma ad: `/tts on`) ile etkinleştirin. +Hayır. Otomatik TTS varsayılan olarak **kapalıdır**. Bunu yapılandırmada +`messages.tts.auto` ile veya yerel olarak `/tts on` ile etkinleştirin. -`messages.tts.provider` ayarlanmamışsa OpenClaw, kayıt defteri otomatik seçim sırasındaki +`messages.tts.provider` ayarlanmamışsa OpenClaw, kayıt otomatik seçim sırasındaki ilk yapılandırılmış konuşma sağlayıcısını seçer. ## Yapılandırma @@ -89,7 +90,7 @@ Tam şema [Gateway configuration](/tr/gateway/configuration) sayfasındadır. } ``` -### Birincil OpenAI, yedek ElevenLabs +### ElevenLabs yedekli OpenAI birincil ```json5 { @@ -130,7 +131,7 @@ Tam şema [Gateway configuration](/tr/gateway/configuration) sayfasındadır. } ``` -### Birincil Microsoft (API anahtarı yok) +### Microsoft birincil (API anahtarı yok) ```json5 { @@ -153,7 +154,7 @@ Tam şema [Gateway configuration](/tr/gateway/configuration) sayfasındadır. } ``` -### Birincil MiniMax +### MiniMax birincil ```json5 { @@ -177,7 +178,7 @@ Tam şema [Gateway configuration](/tr/gateway/configuration) sayfasındadır. } ``` -### Microsoft konuşmayı devre dışı bırakma +### Microsoft konuşmayı devre dışı bırak ```json5 { @@ -208,7 +209,7 @@ Tam şema [Gateway configuration](/tr/gateway/configuration) sayfasındadır. } ``` -### Yalnızca gelen bir sesli mesajdan sonra sesle yanıt ver +### Yalnızca gelen bir sesli mesajdan sonra sesli yanıt ver ```json5 { @@ -220,7 +221,7 @@ Tam şema [Gateway configuration](/tr/gateway/configuration) sayfasındadır. } ``` -### Uzun yanıtlar için otomatik özeti devre dışı bırakma +### Uzun yanıtlar için otomatik özeti devre dışı bırak ```json5 { @@ -241,78 +242,79 @@ Ardından şunu çalıştırın: ### Alanlarla ilgili notlar - `auto`: otomatik TTS modu (`off`, `always`, `inbound`, `tagged`). - - `inbound`, yalnızca gelen bir sesli mesajdan sonra ses gönderir. - - `tagged`, yalnızca yanıt `[[tts]]` etiketleri içerdiğinde ses gönderir. -- `enabled`: eski açma/kapama seçeneği (doctor bunu `auto` değerine taşır). + - `inbound` yalnızca gelen bir sesli mesajdan sonra ses gönderir. + - `tagged` yalnızca yanıtta `[[tts]]` etiketleri bulunduğunda ses gönderir. +- `enabled`: eski geçiş anahtarıdır (`doctor` bunu `auto` değerine geçirir). - `mode`: `"final"` (varsayılan) veya `"all"` (araç/blok yanıtlarını da içerir). -- `provider`: `"elevenlabs"`, `"microsoft"`, `"minimax"` veya `"openai"` gibi konuşma sağlayıcı kimliği (yedek otomatik olarak yapılır). -- `provider` **ayarlanmamışsa**, OpenClaw kayıt defteri otomatik seçim sırasındaki ilk yapılandırılmış konuşma sağlayıcısını kullanır. +- `provider`: `"elevenlabs"`, `"microsoft"`, `"minimax"` veya `"openai"` gibi konuşma sağlayıcısı kimliği (yedek kullanım otomatiktir). +- `provider` **ayarlanmamışsa**, OpenClaw kayıt otomatik seçim sırasındaki ilk yapılandırılmış konuşma sağlayıcısını kullanır. - Eski `provider: "edge"` hâlâ çalışır ve `microsoft` olarak normalize edilir. -- `summaryModel`: otomatik özet için isteğe bağlı düşük maliyetli model; varsayılan olarak `agents.defaults.model.primary` kullanılır. - - `provider/model` veya yapılandırılmış model takma adını kabul eder. +- `summaryModel`: otomatik özet için isteğe bağlı düşük maliyetli modeldir; varsayılanı `agents.defaults.model.primary` değeridir. + - `provider/model` veya yapılandırılmış bir model takma adını kabul eder. - `modelOverrides`: modelin TTS yönergeleri üretmesine izin verir (varsayılan olarak açık). - `allowProvider` varsayılan olarak `false` değerindedir (sağlayıcı değiştirme isteğe bağlıdır). -- `providers.`: konuşma sağlayıcı kimliğine göre anahtarlanan, sağlayıcının sahip olduğu ayarlar. -- Eski doğrudan sağlayıcı blokları (`messages.tts.openai`, `messages.tts.elevenlabs`, `messages.tts.microsoft`, `messages.tts.edge`) yükleme sırasında otomatik olarak `messages.tts.providers.` yapısına taşınır. -- `maxTextLength`: TTS girdisi için katı üst sınır (karakter). Aşılırsa `/tts audio` başarısız olur. +- `providers.`: konuşma sağlayıcısı kimliğine göre anahtarlanmış, sağlayıcıya ait ayarlardır. +- Eski doğrudan sağlayıcı blokları (`messages.tts.openai`, `messages.tts.elevenlabs`, `messages.tts.microsoft`, `messages.tts.edge`) yükleme sırasında otomatik olarak `messages.tts.providers.` yapısına geçirilir. +- `maxTextLength`: TTS girdisi için kesin üst sınırdır (karakter). Aşılırsa `/tts audio` başarısız olur. - `timeoutMs`: istek zaman aşımı (ms). -- `prefsPath`: yerel tercihler JSON yolu için geçersiz kılma (sağlayıcı/sınır/özet). -- `apiKey` değerleri ortam değişkenlerine geri döner (`ELEVENLABS_API_KEY`/`XI_API_KEY`, `MINIMAX_API_KEY`, `OPENAI_API_KEY`). +- `prefsPath`: yerel prefs JSON yolunu geçersiz kılar (sağlayıcı/sınır/özet). +- `apiKey` değerleri env vars değerlerine geri düşer (`ELEVENLABS_API_KEY`/`XI_API_KEY`, `MINIMAX_API_KEY`, `OPENAI_API_KEY`). - `providers.elevenlabs.baseUrl`: ElevenLabs API temel URL'sini geçersiz kılar. - `providers.openai.baseUrl`: OpenAI TTS uç noktasını geçersiz kılar. - Çözümleme sırası: `messages.tts.providers.openai.baseUrl` -> `OPENAI_TTS_BASE_URL` -> `https://api.openai.com/v1` - - Varsayılan dışındaki değerler OpenAI uyumlu TTS uç noktaları olarak değerlendirilir, bu nedenle özel model ve ses adları kabul edilir. + - Varsayılan olmayan değerler OpenAI uyumlu TTS uç noktaları olarak değerlendirilir, bu nedenle özel model ve ses adları kabul edilir. - `providers.elevenlabs.voiceSettings`: - `stability`, `similarityBoost`, `style`: `0..1` - `useSpeakerBoost`: `true|false` - - `speed`: `0.5..2.0` (`1.0 = normal`) + - `speed`: `0.5..2.0` (1.0 = normal) - `providers.elevenlabs.applyTextNormalization`: `auto|on|off` - `providers.elevenlabs.languageCode`: 2 harfli ISO 639-1 (ör. `en`, `de`) -- `providers.elevenlabs.seed`: `0..4294967295` tamsayısı (en iyi çaba ile belirlenim) -- `providers.minimax.baseUrl`: MiniMax API temel URL'sini geçersiz kılar (varsayılan `https://api.minimax.io`, ortam: `MINIMAX_API_HOST`). -- `providers.minimax.model`: TTS modeli (varsayılan `speech-2.8-hd`, ortam: `MINIMAX_TTS_MODEL`). -- `providers.minimax.voiceId`: ses tanımlayıcısı (varsayılan `English_expressive_narrator`, ortam: `MINIMAX_TTS_VOICE_ID`). +- `providers.elevenlabs.seed`: tamsayı `0..4294967295` (en iyi çaba düzeyinde belirlenimlilik) +- `providers.minimax.baseUrl`: MiniMax API temel URL'sini geçersiz kılar (varsayılan `https://api.minimax.io`, env: `MINIMAX_API_HOST`). +- `providers.minimax.model`: TTS modeli (varsayılan `speech-2.8-hd`, env: `MINIMAX_TTS_MODEL`). +- `providers.minimax.voiceId`: ses tanımlayıcısıdır (varsayılan `English_expressive_narrator`, env: `MINIMAX_TTS_VOICE_ID`). - `providers.minimax.speed`: oynatma hızı `0.5..2.0` (varsayılan 1.0). -- `providers.minimax.vol`: ses seviyesi `(0, 10]` (varsayılan 1.0; 0'dan büyük olmalıdır). +- `providers.minimax.vol`: ses düzeyi `(0, 10]` (varsayılan 1.0; 0'dan büyük olmalıdır). - `providers.minimax.pitch`: perde kaydırma `-12..12` (varsayılan 0). - `providers.microsoft.enabled`: Microsoft konuşma kullanımına izin verir (varsayılan `true`; API anahtarı yok). - `providers.microsoft.voice`: Microsoft nöral ses adı (ör. `en-US-MichelleNeural`). - `providers.microsoft.lang`: dil kodu (ör. `en-US`). - `providers.microsoft.outputFormat`: Microsoft çıktı biçimi (ör. `audio-24khz-48kbitrate-mono-mp3`). - - Geçerli değerler için Microsoft Speech çıktı biçimlerine bakın; tüm biçimler paketlenmiş Edge tabanlı taşıma tarafından desteklenmez. -- `providers.microsoft.rate` / `providers.microsoft.pitch` / `providers.microsoft.volume`: yüzde dizeleri (ör. `+10%`, `-5%`). -- `providers.microsoft.saveSubtitles`: ses dosyasının yanına JSON altyazıları yazar. + - Geçerli değerler için Microsoft Speech output formats bölümüne bakın; tüm biçimler paketlenmiş Edge tabanlı aktarım tarafından desteklenmez. +- `providers.microsoft.rate` / `providers.microsoft.pitch` / `providers.microsoft.volume`: yüzde dizgeleri (ör. `+10%`, `-5%`). +- `providers.microsoft.saveSubtitles`: ses dosyasının yanında JSON altyazıları yazar. - `providers.microsoft.proxy`: Microsoft konuşma istekleri için proxy URL'si. - `providers.microsoft.timeoutMs`: istek zaman aşımı geçersiz kılması (ms). -- `edge.*`: aynı Microsoft ayarları için eski takma ad. +- `edge.*`: aynı Microsoft ayarları için eski takma addır. ## Model odaklı geçersiz kılmalar (varsayılan olarak açık) Varsayılan olarak model, tek bir yanıt için TTS yönergeleri üretebilir. -`messages.tts.auto`, `tagged` olduğunda sesi tetiklemek için bu yönergeler gereklidir. +`messages.tts.auto` değeri `tagged` olduğunda, sesi tetiklemek için bu yönergeler gerekir. -Etkin olduğunda model, tek bir yanıt için sesi geçersiz kılmak üzere `[[tts:...]]` yönergeleri ve ayrıca -yalnızca seste görünmesi gereken ifadesel etiketler (kahkaha, şarkı söyleme işaretleri vb.) -sağlamak için isteğe bağlı bir `[[tts:text]]...[[/tts:text]]` bloğu üretebilir. +Etkin olduğunda model, tek bir yanıt için sesi geçersiz kılmak üzere `[[tts:...]]` +yönergeleri ve ayrıca yalnızca seste görünmesi gereken ifade etiketlerini +(kahkaha, şarkı söyleme ipuçları vb.) sağlamak için isteğe bağlı bir +`[[tts:text]]...[[/tts:text]]` bloğu üretebilir. -`provider=...` yönergeleri, `modelOverrides.allowProvider: true` olmadığı sürece yok sayılır. +`provider=...` yönergeleri, `modelOverrides.allowProvider: true` olmadıkça yok sayılır. Örnek yanıt yükü: ``` -İşte burada. +Here you go. [[tts:voiceId=pMsXgVXv3BLzUgSXRplE model=eleven_v3 speed=1.1]] -[[tts:text]](güler) Şarkıyı bir kez daha oku.[[/tts:text]] +[[tts:text]](laughs) Read the song once more.[[/tts:text]] ``` Kullanılabilir yönerge anahtarları (etkin olduğunda): -- `provider` (kayıtlı konuşma sağlayıcısı kimliği, örneğin `openai`, `elevenlabs`, `minimax` veya `microsoft`; `allowProvider: true` gerektirir) +- `provider` (kayıtlı konuşma sağlayıcısı kimliği; örneğin `openai`, `elevenlabs`, `minimax` veya `microsoft`; `allowProvider: true` gerektirir) - `voice` (OpenAI sesi) veya `voiceId` (ElevenLabs / MiniMax) - `model` (OpenAI TTS modeli, ElevenLabs model kimliği veya MiniMax modeli) - `stability`, `similarityBoost`, `style`, `speed`, `useSpeakerBoost` -- `vol` / `volume` (MiniMax ses seviyesi, 0-10) +- `vol` / `volume` (MiniMax ses düzeyi, 0-10) - `pitch` (MiniMax perde, -12 ile 12 arası) - `applyTextNormalization` (`auto|on|off`) - `languageCode` (ISO 639-1) @@ -332,7 +334,7 @@ Tüm model geçersiz kılmalarını devre dışı bırakın: } ``` -İsteğe bağlı izin listesi (diğer ayarlar yapılandırılabilir kalırken sağlayıcı değiştirmeyi etkinleştirme): +İsteğe bağlı izin listesi (sağlayıcı değiştirmeyi etkinleştirirken diğer ayarların yapılandırılabilir kalmasını sağlama): ```json5 { @@ -350,30 +352,30 @@ Tüm model geçersiz kılmalarını devre dışı bırakın: ## Kullanıcı başına tercihler -Slash komutları yerel geçersiz kılmaları `prefsPath` içine yazar (varsayılan: +Slash komutları yerel geçersiz kılmaları `prefsPath` alanına yazar (varsayılan: `~/.openclaw/settings/tts.json`, `OPENCLAW_TTS_PREFS` veya `messages.tts.prefsPath` ile geçersiz kılınabilir). -Saklanan alanlar: +Depolanan alanlar: - `enabled` - `provider` - `maxLength` (özet eşiği; varsayılan 1500 karakter) - `summarize` (varsayılan `true`) -Bunlar, bu ana bilgisayar için `messages.tts.*` değerlerini geçersiz kılar. +Bunlar o ana makine için `messages.tts.*` değerlerini geçersiz kılar. ## Çıktı biçimleri (sabit) -- **Feishu / Matrix / Telegram / WhatsApp**: Opus sesli mesajı (ElevenLabs'ten `opus_48000_64`, OpenAI'dan `opus`). - - 48kHz / 64kbps, sesli mesaj için iyi bir dengedir. -- **Diğer kanallar**: MP3 (ElevenLabs'ten `mp3_44100_128`, OpenAI'dan `mp3`). +- **Feishu / Matrix / Telegram / WhatsApp**: Opus sesli mesajı (`opus_48000_64` ElevenLabs'tan, `opus` OpenAI'dan). + - 48kHz / 64kbps, sesli mesajlar için iyi bir dengedir. +- **Diğer kanallar**: MP3 (`mp3_44100_128` ElevenLabs'tan, `mp3` OpenAI'dan). - 44.1kHz / 128kbps, konuşma netliği için varsayılan dengedir. -- **MiniMax**: MP3 (`speech-2.8-hd` modeli, 32kHz örnekleme hızı). Sesli not biçimi doğal olarak desteklenmez; garantili Opus sesli mesajları için OpenAI veya ElevenLabs kullanın. +- **MiniMax**: MP3 (`speech-2.8-hd` modeli, 32kHz örnekleme hızı). Sesli not biçimi yerel olarak desteklenmez; garantili Opus sesli mesajlar için OpenAI veya ElevenLabs kullanın. - **Microsoft**: `microsoft.outputFormat` kullanır (varsayılan `audio-24khz-48kbitrate-mono-mp3`). - - Paketlenmiş taşıma bir `outputFormat` kabul eder, ancak tüm biçimler hizmetten alınamaz. - - Çıktı biçimi değerleri Microsoft Speech çıktı biçimlerini izler (Ogg/WebM Opus dahil). - - Telegram `sendVoice`, OGG/MP3/M4A kabul eder; garantili Opus sesli mesajları gerekiyorsa OpenAI/ElevenLabs kullanın. + - Paketlenmiş aktarım bir `outputFormat` kabul eder, ancak tüm biçimler hizmetten alınamayabilir. + - Çıktı biçimi değerleri Microsoft Speech output formats biçimlerini izler (Ogg/WebM Opus dahil). + - Telegram `sendVoice`, OGG/MP3/M4A kabul eder; garantili Opus sesli mesajlar gerekiyorsa OpenAI/ElevenLabs kullanın. - Yapılandırılmış Microsoft çıktı biçimi başarısız olursa OpenClaw MP3 ile yeniden dener. OpenAI/ElevenLabs çıktı biçimleri kanal başına sabittir (yukarıya bakın). @@ -382,42 +384,41 @@ OpenAI/ElevenLabs çıktı biçimleri kanal başına sabittir (yukarıya bakın) Etkin olduğunda OpenClaw: -- yanıt zaten medya veya `MEDIA:` yönergesi içeriyorsa TTS'yi atlar. -- çok kısa yanıtları (< 10 karakter) atlar. +- yanıt zaten medya veya bir `MEDIA:` yönergesi içeriyorsa TTS'yi atlar. +- çok kısa yanıtları atlar (< 10 karakter). - etkinse uzun yanıtları `agents.defaults.model.primary` (veya `summaryModel`) kullanarak özetler. - oluşturulan sesi yanıta ekler. -Yanıt `maxLength` değerini aşarsa ve özet kapalıysa (veya özet modeli için API anahtarı yoksa), -ses atlanır ve normal metin yanıtı gönderilir. +Yanıt `maxLength` değerini aşıyorsa ve özetleme kapalıysa (veya özet modeli +için API anahtarı yoksa), ses +atlanır ve normal metin yanıtı gönderilir. ## Akış diyagramı ``` -Yanıt -> TTS etkin mi? - hayır -> metni gönder - evet -> medya / MEDIA: / kısa var mı? - evet -> metni gönder - hayır -> uzunluk > sınır? - hayır -> TTS -> sesi ekle - evet -> özet etkin mi? - hayır -> metni gönder - evet -> özetle (`summaryModel` veya `agents.defaults.model.primary`) - -> TTS -> sesi ekle +Reply -> TTS enabled? + no -> send text + yes -> has media / MEDIA: / short? + yes -> send text + no -> length > limit? + no -> TTS -> attach audio + yes -> summary enabled? + no -> send text + yes -> summarize (summaryModel or agents.defaults.model.primary) + -> TTS -> attach audio ``` ## Slash komutu kullanımı Tek bir komut vardır: `/tts`. -Etkinleştirme ayrıntıları için [Slash commands](/tools/slash-commands) sayfasına bakın. +Etkinleştirme ayrıntıları için [Slash commands](/tr/tools/slash-commands) sayfasına bakın. -Discord notu: `/tts`, yerleşik bir Discord komutudur, bu yüzden OpenClaw -orada yerel komut olarak `/voice` kaydeder. Metin olarak `/tts ...` yine de çalışır. +Discord notu: `/tts`, Discord'un yerleşik bir komutudur, bu yüzden OpenClaw +orada yerel komut olarak `/voice` kaydeder. Metin biçimindeki `/tts ...` yine de çalışır. ``` /tts off -/tts always -/tts inbound -/tts tagged +/tts on /tts status /tts provider openai /tts limit 2000 @@ -429,20 +430,22 @@ Notlar: - Komutlar yetkili bir gönderici gerektirir (izin listesi/sahip kuralları yine geçerlidir). - `commands.text` veya yerel komut kaydı etkin olmalıdır. -- `off|always|inbound|tagged`, oturum başına açma/kapama seçenekleridir (`/tts on`, `/tts always` için bir takma addır). -- `limit` ve `summary`, ana yapılandırmada değil, yerel tercihlerde saklanır. +- Yapılandırma `messages.tts.auto`, `off|always|inbound|tagged` kabul eder. +- `/tts on`, yerel TTS tercihini `always` olarak yazar; `/tts off`, `off` olarak yazar. +- `inbound` veya `tagged` varsayılanları istiyorsanız yapılandırmayı kullanın. +- `limit` ve `summary`, ana yapılandırmada değil yerel tercihlerde depolanır. - `/tts audio`, tek seferlik bir sesli yanıt üretir (TTS'yi açmaz). -- `/tts status`, son deneme için yedek görünürlüğünü içerir: +- `/tts status`, son deneme için yedek kullanım görünürlüğü içerir: - başarılı yedek: `Fallback: -> ` artı `Attempts: ...` - başarısızlık: `Error: ...` artı `Attempts: ...` - ayrıntılı tanılama: `Attempt details: provider:outcome(reasonCode) latency` -- OpenAI ve ElevenLabs API hataları artık ayrıştırılmış sağlayıcı hata ayrıntısını ve istek kimliğini (sağlayıcı tarafından döndürülürse) içerir; bu da TTS hata/günlüklerine yansıtılır. +- OpenAI ve ElevenLabs API hataları artık ayrıştırılmış sağlayıcı hata ayrıntısını ve istek kimliğini (sağlayıcı döndürürse) içerir; bu bilgiler TTS hata kayıtlarında/günlüklerinde gösterilir. ## Ajan aracı `tts` aracı, metni konuşmaya dönüştürür ve yanıt teslimi için bir ses eki döndürür. Kanal Feishu, Matrix, Telegram veya WhatsApp olduğunda, -ses bir dosya eki yerine sesli mesaj olarak teslim edilir. +ses dosya eki yerine sesli mesaj olarak teslim edilir. ## Gateway RPC