From 7b27bcbdf71a7f9beb16e12c2067bff4dccf81d8 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Mon, 6 Apr 2026 08:55:40 +0000 Subject: [PATCH] chore(i18n): refresh tr translations --- docs/tr/channels/matrix.md | 599 ++++++------ docs/tr/channels/slack.md | 347 ++++--- docs/tr/concepts/dreaming.md | 129 +-- docs/tr/gateway/configuration-reference.md | 1016 ++++++++++---------- docs/tr/plugins/sdk-migration.md | 365 +++---- docs/tr/plugins/sdk-overview.md | 469 ++++----- docs/tr/tools/image-generation.md | 118 ++- docs/tr/tools/video-generation.md | 172 ++-- 8 files changed, 1684 insertions(+), 1531 deletions(-) diff --git a/docs/tr/channels/matrix.md b/docs/tr/channels/matrix.md index 4a097e0d8..4ca2e5096 100644 --- a/docs/tr/channels/matrix.md +++ b/docs/tr/channels/matrix.md @@ -1,52 +1,52 @@ --- read_when: - - OpenClaw içinde Matrix kurulumu + - OpenClaw içinde Matrix kurma - Matrix E2EE ve doğrulamayı yapılandırma summary: Matrix destek durumu, kurulum ve yapılandırma örnekleri title: Matrix x-i18n: - generated_at: "2026-04-06T03:08:43Z" + generated_at: "2026-04-06T08:51:55Z" model: gpt-5.4 provider: openai - source_hash: 3e2d84c08d7d5b96db14b914e54f08d25334401cdd92eb890bc8dfb37b0ca2dc + source_hash: 06f833bf0ede81bad69f140994c32e8cc5d1635764f95fc5db4fc5dc25f2b85e source_path: channels/matrix.md workflow: 15 --- # Matrix -Matrix, OpenClaw için paketlenmiş Matrix kanal eklentisidir. +Matrix, OpenClaw için paketlenmiş Matrix kanal pluginidir. Resmi `matrix-js-sdk` kullanır ve DM'leri, odaları, ileti dizilerini, medyayı, tepkileri, anketleri, konumu ve E2EE'yi destekler. -## Paketlenmiş eklenti +## Paketlenmiş plugin -Matrix, mevcut OpenClaw sürümlerinde paketlenmiş bir eklenti olarak gelir; bu nedenle normal +Matrix, güncel OpenClaw sürümlerinde paketlenmiş bir plugin olarak gelir, bu nedenle normal paketlenmiş derlemelerde ayrı bir kurulum gerekmez. -Eski bir derlemeyi veya Matrix'i hariç tutan özel bir kurulumu kullanıyorsanız, onu -elle yükleyin: +Daha eski bir derlemeyi veya Matrix'i hariç tutan özel bir kurulumu kullanıyorsanız, onu +elle kurun: -npm'den yükleyin: +npm'den kurulum: ```bash openclaw plugins install @openclaw/matrix ``` -Yerel bir checkout'tan yükleyin: +Yerel checkout'tan kurulum: ```bash openclaw plugins install ./path/to/local/matrix-plugin ``` -Eklenti davranışı ve kurulum kuralları için [Plugins](/tr/tools/plugin) bölümüne bakın. +Plugin davranışı ve kurulum kuralları için [Pluginler](/tr/tools/plugin) bölümüne bakın. ## Kurulum -1. Matrix eklentisinin kullanılabilir olduğundan emin olun. +1. Matrix plugininin kullanılabilir olduğundan emin olun. - Güncel paketlenmiş OpenClaw sürümleri bunu zaten içerir. - - Eski/özel kurulumlar bunu yukarıdaki komutlarla elle ekleyebilir. + - Daha eski/özel kurulumlar bunu yukarıdaki komutlarla elle ekleyebilir. 2. Homeserver'ınızda bir Matrix hesabı oluşturun. -3. `channels.matrix` yapılandırmasını aşağıdakilerden biriyle yapın: +3. `channels.matrix` yapılandırmasını şu seçeneklerden biriyle ayarlayın: - `homeserver` + `accessToken`, veya - `homeserver` + `userId` + `password`. 4. Gateway'i yeniden başlatın. @@ -59,25 +59,25 @@ openclaw channels add openclaw configure --section channels ``` -Matrix sihirbazının gerçekte sordukları: +Matrix sihirbazının gerçekte sorduğu bilgiler: - homeserver URL'si -- kimlik doğrulama yöntemi: access token veya parola -- yalnızca parola ile kimlik doğrulamayı seçtiğinizde kullanıcı kimliği +- kimlik doğrulama yöntemi: erişim belirteci veya parola +- yalnızca parola kimlik doğrulamasını seçtiğinizde kullanıcı kimliği - isteğe bağlı cihaz adı - E2EE'nin etkinleştirilip etkinleştirilmeyeceği - Matrix oda erişiminin şimdi yapılandırılıp yapılandırılmayacağı Önemli sihirbaz davranışları: -- Seçilen hesap için Matrix kimlik doğrulama ortam değişkenleri zaten varsa ve bu hesabın kimlik doğrulaması yapılandırmada henüz kayıtlı değilse, sihirbaz bir ortam kısayolu sunar ve bu hesap için yalnızca `enabled: true` yazar. -- Etkileşimli olarak başka bir Matrix hesabı eklediğinizde, girilen hesap adı yapılandırma ve ortam değişkenlerinde kullanılan hesap kimliğine normalize edilir. Örneğin, `Ops Bot`, `ops-bot` olur. -- DM allowlist istemleri tam `@user:server` değerlerini doğrudan kabul eder. Görünen adlar yalnızca canlı dizin araması tek bir kesin eşleşme bulduğunda çalışır; aksi takdirde sihirbaz sizden tam Matrix kimliğiyle yeniden denemenizi ister. -- Oda allowlist istemleri oda kimliklerini ve takma adlarını doğrudan kabul eder. Ayrıca katılınmış oda adlarını canlı olarak çözebilirler, ancak çözümlenmeyen adlar yalnızca kurulum sırasında yazıldığı haliyle tutulur ve daha sonra çalışma zamanı allowlist çözümlemesi tarafından yok sayılır. `!room:server` veya `#alias:server` tercih edin. -- Çalışma zamanında oda/oturum kimliği kararlı Matrix oda kimliğini kullanır. Oda içinde tanımlanan takma adlar yalnızca arama girdisi olarak kullanılır; uzun vadeli oturum anahtarı veya kararlı grup kimliği olarak kullanılmaz. -- Oda adlarını kaydetmeden önce çözmek için `openclaw channels resolve --channel matrix "Project Room"` komutunu kullanın. +- Seçilen hesap için Matrix kimlik doğrulama ortam değişkenleri zaten varsa ve bu hesap için yapılandırmada zaten kaydedilmiş kimlik doğrulama yoksa, sihirbaz bir ortam kısayolu sunar ve bu hesap için yalnızca `enabled: true` yazar. +- Etkileşimli olarak başka bir Matrix hesabı eklediğinizde, girilen hesap adı yapılandırmada ve ortam değişkenlerinde kullanılan hesap kimliğine normalize edilir. Örneğin, `Ops Bot`, `ops-bot` olur. +- DM izin listesi istemleri tam `@user:server` değerlerini hemen kabul eder. Görünen adlar yalnızca canlı dizin araması tek bir tam eşleşme bulduğunda çalışır; aksi halde sihirbaz tam bir Matrix kimliğiyle yeniden denemenizi ister. +- Oda izin listesi istemleri oda kimliklerini ve takma adları doğrudan kabul eder. Ayrıca katılınmış oda adlarını canlı olarak çözebilirler, ancak çözülemeyen adlar kurulum sırasında yalnızca girildiği şekliyle tutulur ve daha sonra çalışma zamanındaki izin listesi çözümlemesi tarafından yok sayılır. `!room:server` veya `#alias:server` tercih edin. +- Çalışma zamanı oda/oturum kimliği kararlı Matrix oda kimliğini kullanır. Oda içinde tanımlanan takma adlar yalnızca arama girdileri olarak kullanılır, uzun vadeli oturum anahtarı veya kararlı grup kimliği olarak kullanılmaz. +- Oda adlarını kaydetmeden önce çözümlemek için `openclaw channels resolve --channel matrix "Project Room"` kullanın. -En az düzeyde token tabanlı kurulum: +Belirteç tabanlı asgari kurulum: ```json5 { @@ -92,7 +92,7 @@ En az düzeyde token tabanlı kurulum: } ``` -Parola tabanlı kurulum (girişten sonra token önbelleğe alınır): +Parola tabanlı kurulum (girişten sonra belirteç önbelleğe alınır): ```json5 { @@ -101,18 +101,18 @@ Parola tabanlı kurulum (girişten sonra token önbelleğe alınır): enabled: true, homeserver: "https://matrix.example.org", userId: "@bot:example.org", - password: "replace-me", // pragma: allowlist secret + password: "replace-me", // pragma: izin listesi gizli bilgisi deviceName: "OpenClaw Gateway", }, }, } ``` -Matrix, önbelleğe alınmış kimlik bilgilerini `~/.openclaw/credentials/matrix/` içinde saklar. +Matrix önbelleğe alınmış kimlik bilgilerini `~/.openclaw/credentials/matrix/` içinde saklar. Varsayılan hesap `credentials.json` kullanır; adlandırılmış hesaplar `credentials-.json` kullanır. -Orada önbelleğe alınmış kimlik bilgileri varsa, OpenClaw mevcut kimlik doğrulama doğrudan yapılandırmada ayarlı olmasa bile kurulum, doctor ve kanal durumu keşfi için Matrix'i yapılandırılmış olarak kabul eder. +Önbelleğe alınmış kimlik bilgileri burada mevcut olduğunda, mevcut kimlik doğrulama doğrudan yapılandırmada ayarlanmamış olsa bile, OpenClaw kurulum, doctor ve kanal durumu keşfi için Matrix'i yapılandırılmış olarak kabul eder. -Ortam değişkeni eşdeğerleri (yapılandırma anahtarı ayarlı değilse kullanılır): +Ortam değişkeni karşılıkları (yapılandırma anahtarı ayarlanmadığında kullanılır): - `MATRIX_HOMESERVER` - `MATRIX_ACCESS_TOKEN` @@ -140,14 +140,14 @@ Normalize edilmiş `ops-bot` hesap kimliği için şunları kullanın: - `MATRIX_OPS_X2D_BOT_HOMESERVER` - `MATRIX_OPS_X2D_BOT_ACCESS_TOKEN` -Matrix, hesap kimliklerindeki noktalama işaretlerini kapsamlı ortam değişkenlerinde çakışmaları önlemek için kaçar. -Örneğin, `-`, `_X2D_` olur; bu nedenle `ops-prod`, `MATRIX_OPS_X2D_PROD_*` eşlemesine dönüşür. +Matrix, hesap kimliklerindeki noktalama işaretlerini, kapsamlı ortam değişkenlerini çakışmasız tutmak için kaçışlar. +Örneğin, `-` karakteri `_X2D_` olur, bu nedenle `ops-prod`, `MATRIX_OPS_X2D_PROD_*` ile eşlenir. -Etkileşimli sihirbaz yalnızca bu kimlik doğrulama ortam değişkenleri zaten mevcutsa ve seçilen hesap için Matrix kimlik doğrulaması yapılandırmaya henüz kaydedilmemişse ortam değişkeni kısayolunu sunar. +Etkileşimli sihirbaz, bu kimlik doğrulama ortam değişkenleri zaten mevcutsa ve seçilen hesap için yapılandırmada zaten kaydedilmiş Matrix kimlik doğrulaması yoksa, yalnızca bu durumda ortam değişkeni kısayolunu sunar. ## Yapılandırma örneği -Bu, DM eşleştirmesi, oda allowlist'i ve etkin E2EE içeren pratik bir temel yapılandırmadır: +Bu, DM eşleştirme, oda izin listesi ve etkin E2EE içeren pratik bir temel yapılandırmadır: ```json5 { @@ -182,13 +182,20 @@ Bu, DM eşleştirmesi, oda allowlist'i ve etkin E2EE içeren pratik bir temel ya } ``` +`autoJoin`, yalnızca oda/grup davetleri için değil, genel olarak Matrix davetleri için geçerlidir. +Buna yeni DM tarzı davetler de dahildir. Davet anında OpenClaw, davet edilen +odanın sonunda DM mi yoksa grup mu olarak ele alınacağını güvenilir şekilde bilemez, bu nedenle +tüm davetler önce aynı `autoJoin` kararı üzerinden geçer. Bot katıldıktan ve oda +DM olarak sınıflandırıldıktan sonra `dm.policy` yine uygulanır; dolayısıyla `autoJoin` katılma davranışını, +`dm.policy` ise yanıt/erişim davranışını kontrol eder. + ## Akış önizlemeleri Matrix yanıt akışı isteğe bağlıdır. -OpenClaw'ın tek bir canlı önizleme -yanıtı göndermesini, model metin üretirken bu önizlemeyi yerinde düzenlemesini ve ardından -yanıt tamamlandığında bunu sonlandırmasını istiyorsanız `channels.matrix.streaming` değerini `"partial"` olarak ayarlayın: +OpenClaw'ın tek bir canlı önizleme yanıtı göndermesini, +model metin üretirken bu önizlemeyi yerinde düzenlemesini ve ardından yanıt tamamlandığında bunu +sonlandırmasını istiyorsanız `channels.matrix.streaming` değerini `"partial"` olarak ayarlayın: ```json5 { @@ -200,38 +207,38 @@ yanıt tamamlandığında bunu sonlandırmasını istiyorsanız `channels.matrix } ``` -- `streaming: "off"` varsayılandır. OpenClaw son yanıtı bekler ve onu tek seferde gönderir. -- `streaming: "partial"`, normal Matrix metin iletilerini kullanarak mevcut asistan bloğu için düzenlenebilir tek bir önizleme iletisi oluşturur. Bu, Matrix'in eski önizleme-öncelikli bildirim davranışını korur; bu nedenle standart istemciler tamamlanmış blok yerine ilk akış önizleme metni için bildirim gönderebilir. -- `streaming: "quiet"`, mevcut asistan bloğu için düzenlenebilir sessiz bir önizleme bildirimi oluşturur. Bunu yalnızca alıcı push kurallarını tamamlanmış önizleme düzenlemeleri için de yapılandırdığınızda kullanın. -- `blockStreaming: true` ayrı Matrix ilerleme iletilerini etkinleştirir. Önizleme akışı etkinleştirildiğinde, Matrix mevcut blok için canlı taslağı tutar ve tamamlanmış blokları ayrı iletiler olarak korur. -- Önizleme akışı açıkken `blockStreaming` kapalıysa, Matrix canlı taslağı yerinde düzenler ve blok veya tur bittiğinde aynı olayı sonlandırır. -- Önizleme artık tek bir Matrix olayına sığmıyorsa, OpenClaw önizleme akışını durdurur ve normal son teslimata geri döner. -- Medya yanıtları yine ekleri normal şekilde gönderir. Eski bir önizleme artık güvenli şekilde yeniden kullanılamıyorsa, OpenClaw son medya yanıtını göndermeden önce onu sansürler. -- Önizleme düzenlemeleri ek Matrix API çağrıları gerektirir. En korumacı hız sınırı davranışını istiyorsanız akışı kapalı bırakın. +- `streaming: "off"` varsayılandır. OpenClaw son yanıtı bekler ve onu bir kez gönderir. +- `streaming: "partial"`, geçerli asistan bloğu için normal Matrix metin mesajları kullanarak düzenlenebilir bir önizleme mesajı oluşturur. Bu, Matrix'in eski önizleme-öncelikli bildirim davranışını korur; bu yüzden standart istemciler bitmiş blok yerine ilk akış önizleme metni için bildirim gönderebilir. +- `streaming: "quiet"`, geçerli asistan bloğu için düzenlenebilir sessiz bir önizleme bildirimi oluşturur. Bunu yalnızca sonlandırılmış önizleme düzenlemeleri için alıcı push kurallarını da yapılandırıyorsanız kullanın. +- `blockStreaming: true`, ayrı Matrix ilerleme mesajlarını etkinleştirir. Önizleme akışı etkinken Matrix, geçerli blok için canlı taslağı korur ve tamamlanmış blokları ayrı mesajlar olarak saklar. +- Önizleme akışı açık ve `blockStreaming` kapalı olduğunda Matrix canlı taslağı yerinde düzenler ve blok veya tur tamamlandığında aynı olayı sonlandırır. +- Önizleme artık tek bir Matrix olayına sığmıyorsa OpenClaw önizleme akışını durdurur ve normal son teslimata geri döner. +- Medya yanıtları ekleri normal şekilde göndermeye devam eder. Eski bir önizleme artık güvenle yeniden kullanılamıyorsa OpenClaw son medya yanıtını göndermeden önce onu redakte eder. +- Önizleme düzenlemeleri ek Matrix API çağrılarına mal olur. En muhafazakar hız sınırı davranışını istiyorsanız akışı kapalı bırakın. `blockStreaming`, taslak önizlemeleri tek başına etkinleştirmez. -Önizleme düzenlemeleri için `streaming: "partial"` veya `streaming: "quiet"` kullanın; ardından yalnızca tamamlanmış asistan bloklarının ayrı ilerleme iletileri olarak görünür kalmasını da istiyorsanız `blockStreaming: true` ekleyin. +Önizleme düzenlemeleri için `streaming: "partial"` veya `streaming: "quiet"` kullanın; ardından yalnızca tamamlanmış asistan bloklarının ayrı ilerleme mesajları olarak görünür kalmasını da istiyorsanız `blockStreaming: true` ekleyin. -Özel push kuralları olmadan standart Matrix bildirimlerine ihtiyacınız varsa, önizleme-öncelikli davranış için `streaming: "partial"` kullanın veya yalnızca son teslimat için `streaming` özelliğini kapalı bırakın. `streaming: "off"` ile: +Özel push kuralları olmadan standart Matrix bildirimlerine ihtiyacınız varsa, önizleme-öncelikli davranış için `streaming: "partial"` kullanın veya yalnızca son teslimat için `streaming` değerini kapalı bırakın. `streaming: "off"` ile: -- `blockStreaming: true` her tamamlanmış bloğu normal bildirim veren bir Matrix iletisi olarak gönderir. -- `blockStreaming: false` yalnızca son tamamlanmış yanıtı normal bildirim veren bir Matrix iletisi olarak gönderir. +- `blockStreaming: true`, tamamlanan her bloğu normal bildirim veren bir Matrix mesajı olarak gönderir. +- `blockStreaming: false`, yalnızca son tamamlanmış yanıtı normal bildirim veren bir Matrix mesajı olarak gönderir. ### Sessiz sonlandırılmış önizlemeler için self-hosted push kuralları Kendi Matrix altyapınızı çalıştırıyorsanız ve sessiz önizlemelerin yalnızca bir blok veya son yanıt tamamlandığında bildirim göndermesini istiyorsanız, `streaming: "quiet"` ayarlayın ve sonlandırılmış önizleme düzenlemeleri için kullanıcı başına bir push kuralı ekleyin. -Bu genellikle homeserver genelinde bir yapılandırma değişikliği değil, alıcı kullanıcı kurulumu olur: +Bu genellikle homeserver genelinde bir yapılandırma değişikliği değil, alıcı kullanıcı tarafında bir kurulumdur: -Başlamadan önce hızlı eşleme: +Başlamadan önce hızlı özet: - alıcı kullanıcı = bildirimi alması gereken kişi - bot kullanıcısı = yanıtı gönderen OpenClaw Matrix hesabı -- aşağıdaki API çağrıları için alıcı kullanıcının access token'ını kullanın +- aşağıdaki API çağrıları için alıcı kullanıcının erişim belirtecini kullanın - push kuralındaki `sender` alanını bot kullanıcısının tam MXID'siyle eşleştirin -1. OpenClaw'ı sessiz önizlemeleri kullanacak şekilde yapılandırın: +1. OpenClaw'ı sessiz önizlemeler kullanacak şekilde yapılandırın: ```json5 { @@ -243,13 +250,13 @@ Başlamadan önce hızlı eşleme: } ``` -2. Alıcı hesabın halihazırda normal Matrix push bildirimleri aldığından emin olun. Sessiz önizleme - kuralları yalnızca o kullanıcının çalışan pusher'ları/cihazları zaten varsa çalışır. +2. Alıcı hesabın zaten normal Matrix push bildirimleri aldığından emin olun. Sessiz önizleme + kuralları yalnızca bu kullanıcının çalışan pusher'ları/cihazları zaten varsa çalışır. -3. Alıcı kullanıcının access token'ını alın. - - Botun token'ını değil, alan kullanıcının token'ını kullanın. - - Var olan bir istemci oturum token'ını yeniden kullanmak genellikle en kolay yoldur. - - Yeni bir token üretmeniz gerekiyorsa, standart Matrix Client-Server API üzerinden giriş yapabilirsiniz: +3. Alıcı kullanıcının erişim belirtecini alın. + - Botun belirtecini değil, alıcı kullanıcının belirtecini kullanın. + - Mevcut bir istemci oturum belirtecini yeniden kullanmak genellikle en kolay yoldur. + - Yeni bir belirteç üretmeniz gerekiyorsa standart Matrix Client-Server API üzerinden giriş yapabilirsiniz: ```bash curl -sS -X POST \ @@ -273,10 +280,10 @@ curl -sS \ "https://matrix.example.org/_matrix/client/v3/pushers" ``` -Bu, etkin pusher/cihaz döndürmüyorsa, aşağıdaki -OpenClaw kuralını eklemeden önce önce normal Matrix bildirimlerini düzeltin. +Bu çağrı etkin pusher/cihaz döndürmüyorsa, aşağıdaki +OpenClaw kuralını eklemeden önce normal Matrix bildirimlerini düzeltin. -OpenClaw, sonlandırılmış yalnızca metin önizleme düzenlemelerini şu işaretle işaretler: +OpenClaw, sonlandırılmış yalnızca metin içeren önizleme düzenlemelerini şu şekilde işaretler: ```json { @@ -317,20 +324,20 @@ curl -sS -X PUT \ Komutu çalıştırmadan önce şu değerleri değiştirin: - `https://matrix.example.org`: homeserver temel URL'niz -- `$USER_ACCESS_TOKEN`: alan kullanıcının access token'ı -- `openclaw-finalized-preview-botname`: bu alan kullanıcı için bu bota özgü bir kural kimliği -- `@bot:example.org`: alan kullanıcının MXID'si değil, OpenClaw Matrix bot MXID'niz +- `$USER_ACCESS_TOKEN`: alıcı kullanıcının erişim belirteci +- `openclaw-finalized-preview-botname`: bu alıcı kullanıcı için bu bota özgü bir kural kimliği +- `@bot:example.org`: alıcı kullanıcının MXID'si değil, OpenClaw Matrix bot MXID'niz Çoklu bot kurulumları için önemli: -- Push kuralları `ruleId` ile anahtarlanır. Aynı kural kimliğine karşı `PUT` komutunu yeniden çalıştırmak o tek kuralı günceller. -- Bir alan kullanıcı birden fazla OpenClaw Matrix bot hesabı için bildirim alacaksa, her gönderen eşleşmesi için benzersiz bir kural kimliğiyle bot başına bir kural oluşturun. -- Basit bir desen `openclaw-finalized-preview-` olur; örneğin `openclaw-finalized-preview-ops` veya `openclaw-finalized-preview-support`. +- Push kuralları `ruleId` ile anahtarlanır. Aynı kural kimliğine karşı `PUT` işlemini yeniden çalıştırmak, o tek kuralı günceller. +- Bir alıcı kullanıcının birden fazla OpenClaw Matrix bot hesabı için bildirim alması gerekiyorsa, her gönderici eşleşmesi için benzersiz kural kimliğine sahip bir kural oluşturun. +- Basit bir desen `openclaw-finalized-preview-` biçimidir; örneğin `openclaw-finalized-preview-ops` veya `openclaw-finalized-preview-support`. -Kural olay göndericisine göre değerlendirilir: +Kural olay göndericisine karşı değerlendirilir: -- alan kullanıcının token'ı ile kimlik doğrulayın -- `sender` alanını OpenClaw bot MXID'siyle eşleştirin +- alıcı kullanıcının belirteciyle kimlik doğrulayın +- `sender` alanını OpenClaw bot MXID'sine karşı eşleştirin 6. Kuralın var olduğunu doğrulayın: @@ -340,10 +347,10 @@ curl -sS \ "https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname" ``` -7. Akışlı bir yanıtı test edin. Sessiz modda oda, sessiz bir taslak önizleme göstermeli ve son +7. Akışlı bir yanıtı test edin. Sessiz modda oda sessiz bir taslak önizleme göstermeli ve son yerinde düzenleme blok veya tur tamamlandığında bir kez bildirim göndermelidir. -Kuralı daha sonra kaldırmanız gerekirse, aynı kural kimliğini alan kullanıcının token'ı ile silin: +Daha sonra kuralı kaldırmanız gerekirse, aynı kural kimliğini alıcı kullanıcının belirteciyle silin: ```bash curl -sS -X DELETE \ @@ -353,37 +360,37 @@ curl -sS -X DELETE \ Notlar: -- Kuralı botunkini değil, alan kullanıcının access token'ı ile oluşturun. -- Yeni kullanıcı tanımlı `override` kuralları varsayılan bastırma kurallarının önüne eklenir; bu nedenle ek bir sıralama parametresi gerekmez. -- Bu yalnızca OpenClaw'ın güvenli şekilde yerinde sonlandırabildiği yalnızca metin önizleme düzenlemelerini etkiler. Medya fallback'leri ve eski önizleme fallback'leri yine normal Matrix teslimatını kullanır. -- `GET /_matrix/client/v3/pushers` hiçbir pusher göstermiyorsa, kullanıcı bu hesap/cihaz için henüz çalışan Matrix push teslimine sahip değildir. +- Kuralı botunkiyle değil, alıcı kullanıcının erişim belirteciyle oluşturun. +- Yeni kullanıcı tanımlı `override` kuralları varsayılan bastırma kurallarının önüne eklenir, bu yüzden ek bir sıralama parametresine gerek yoktur. +- Bu yalnızca OpenClaw'ın güvenle yerinde sonlandırabildiği yalnızca metin içeren önizleme düzenlemelerini etkiler. Medya fallback'leri ve eski önizleme fallback'leri yine normal Matrix teslimatını kullanır. +- Eğer `GET /_matrix/client/v3/pushers` hiçbir pusher göstermiyorsa, kullanıcının bu hesap/cihaz için çalışan Matrix push teslimi henüz yoktur. #### Synapse Synapse için yukarıdaki kurulum genellikle tek başına yeterlidir: - Sonlandırılmış OpenClaw önizleme bildirimleri için özel bir `homeserver.yaml` değişikliği gerekmez. -- Synapse dağıtımınız zaten normal Matrix push bildirimleri gönderiyorsa, kullanıcı token'ı + yukarıdaki `pushrules` çağrısı ana kurulum adımıdır. -- Synapse'i bir reverse proxy veya worker'ların arkasında çalıştırıyorsanız, `/_matrix/client/.../pushrules/` isteğinin Synapse'e doğru ulaştığından emin olun. -- Synapse worker'ları kullanıyorsanız, pusher'ların sağlıklı olduğundan emin olun. Push teslimi ana süreç veya `synapse.app.pusher` / yapılandırılmış pusher worker'ları tarafından işlenir. +- Synapse dağıtımınız zaten normal Matrix push bildirimleri gönderiyorsa, yukarıdaki kullanıcı belirteci + `pushrules` çağrısı ana kurulum adımıdır. +- Synapse'i reverse proxy veya worker'ların arkasında çalıştırıyorsanız `/_matrix/client/.../pushrules/` yolunun Synapse'e doğru ulaştığından emin olun. +- Synapse worker'ları kullanıyorsanız pusher'ların sağlıklı olduğundan emin olun. Push teslimi ana süreç veya `synapse.app.pusher` / yapılandırılmış pusher worker'ları tarafından gerçekleştirilir. #### Tuwunel -Tuwunel için yukarıda gösterilen aynı kurulum akışını ve push kuralı API çağrısını kullanın: +Tuwunel için yukarıda gösterilen aynı kurulum akışını ve push-rule API çağrısını kullanın: -- Sonlandırılmış önizleme işaretleyicisinin kendisi için Tuwunel'e özgü bir yapılandırma gerekmez. -- Normal Matrix bildirimleri o kullanıcı için zaten çalışıyorsa, kullanıcı token'ı + yukarıdaki `pushrules` çağrısı ana kurulum adımıdır. -- Kullanıcı başka bir cihazda etkin olduğunda bildirimler kayboluyor gibi görünüyorsa, `suppress_push_when_active` etkin olup olmadığını kontrol edin. Tuwunel bu seçeneği Tuwunel 1.4.2 sürümünde 12 Eylül 2025 tarihinde ekledi ve bu seçenek bir cihaz etkin durumdayken diğer cihazlara gönderilen push'ları bilerek bastırabilir. +- Sonlandırılmış önizleme işaretçisi için Tuwunel'e özgü bir yapılandırma gerekmez. +- Normal Matrix bildirimleri bu kullanıcı için zaten çalışıyorsa, yukarıdaki kullanıcı belirteci + `pushrules` çağrısı ana kurulum adımıdır. +- Kullanıcı başka bir cihazda etkin durumdayken bildirimler kayboluyor gibi görünüyorsa `suppress_push_when_active` ayarının etkin olup olmadığını kontrol edin. Tuwunel bu seçeneği 12 Eylül 2025 tarihinde Tuwunel 1.4.2 sürümünde ekledi ve bu seçenek bir cihaz etkinken diğer cihazlara push gönderimini kasıtlı olarak bastırabilir. ## Şifreleme ve doğrulama -Şifreli (E2EE) odalarda, giden görsel olayları `thumbnail_file` kullanır; böylece görsel önizlemeleri tam ek ile birlikte şifrelenir. Şifrelenmemiş odalar yine düz `thumbnail_url` kullanır. Yapılandırma gerekmez — eklenti E2EE durumunu otomatik olarak algılar. +Şifreli (E2EE) odalarda, giden görsel olayları `thumbnail_file` kullanır; böylece görsel önizlemeleri tam ekle birlikte şifrelenir. Şifrelenmemiş odalar hâlâ düz `thumbnail_url` kullanır. Yapılandırma gerekmez — plugin E2EE durumunu otomatik olarak algılar. ### Botlar arası odalar -Varsayılan olarak, yapılandırılmış diğer OpenClaw Matrix hesaplarından gelen Matrix iletileri yok sayılır. +Varsayılan olarak, yapılandırılmış diğer OpenClaw Matrix hesaplarından gelen Matrix mesajları yok sayılır. -Kasıtlı olarak ajanlar arası Matrix trafiği istediğinizde `allowBots` kullanın: +Bilerek ajanlar arası Matrix trafiği istiyorsanız `allowBots` kullanın: ```json5 { @@ -400,13 +407,13 @@ Kasıtlı olarak ajanlar arası Matrix trafiği istediğinizde `allowBots` kulla } ``` -- `allowBots: true`, izin verilen odalarda ve DM'lerde yapılandırılmış diğer Matrix bot hesaplarından gelen iletileri kabul eder. -- `allowBots: "mentions"`, bu iletileri odalarda yalnızca bu bottan görünür şekilde bahsediyorsa kabul eder. DM'lere yine izin verilir. -- `groups..allowBots`, hesap düzeyindeki ayarı bir oda için geçersiz kılar. -- OpenClaw, kendi kendine yanıt döngülerini önlemek için yine aynı Matrix kullanıcı kimliğinden gelen iletileri yok sayar. -- Matrix burada yerel bir bot işareti sağlamaz; OpenClaw "bot tarafından yazılmış" ifadesini "bu OpenClaw gateway üzerinde yapılandırılmış başka bir Matrix hesabı tarafından gönderilmiş" olarak yorumlar. +- `allowBots: true`, izin verilen odalarda ve DM'lerde yapılandırılmış diğer Matrix bot hesaplarından gelen mesajları kabul eder. +- `allowBots: "mentions"`, bu mesajları odalarda yalnızca bu bottan açıkça bahsedildiğinde kabul eder. DM'lere yine izin verilir. +- `groups..allowBots`, hesap düzeyi ayarı tek bir oda için geçersiz kılar. +- OpenClaw, kendine yanıt döngülerini önlemek için yine aynı Matrix kullanıcı kimliğinden gelen mesajları yok sayar. +- Matrix burada yerel bir bot bayrağı sunmaz; OpenClaw "bot tarafından yazılmış" ifadesini "bu OpenClaw gateway'inde yapılandırılmış başka bir Matrix hesabı tarafından gönderilmiş" olarak ele alır. -Paylaşılan odalarda botlar arası trafiği etkinleştirirken sıkı oda allowlist'leri ve mention gereksinimleri kullanın. +Paylaşılan odalarda botlar arası trafiği etkinleştirirken sıkı oda izin listeleri ve mention gereksinimleri kullanın. Şifrelemeyi etkinleştirin: @@ -430,7 +437,7 @@ Doğrulama durumunu kontrol edin: openclaw matrix verify status ``` -Ayrıntılı durum (tam tanılama): +Ayrıntılı durum (tam tanı bilgileri): ```bash openclaw matrix verify status --verbose @@ -448,70 +455,70 @@ openclaw matrix verify status --include-recovery-key --json openclaw matrix verify bootstrap ``` -Çoklu hesap desteği: hesap başına kimlik bilgileri ve isteğe bağlı `name` ile `channels.matrix.accounts` kullanın. Ortak desen için [Configuration reference](/tr/gateway/configuration-reference#multi-account-all-channels) bölümüne bakın. +Çoklu hesap desteği: hesap başına kimlik bilgileri ve isteğe bağlı `name` ile `channels.matrix.accounts` kullanın. Paylaşılan desen için [Yapılandırma başvurusu](/tr/gateway/configuration-reference#multi-account-all-channels) bölümüne bakın. -Ayrıntılı bootstrap tanılaması: +Ayrıntılı bootstrap tanıları: ```bash openclaw matrix verify bootstrap --verbose ``` -Bootstrap öncesi yeni bir çapraz imzalama kimliği sıfırlamasını zorlayın: +Bootstrap işleminden önce yeni bir çapraz imzalama kimliği sıfırlamasını zorlayın: ```bash openclaw matrix verify bootstrap --force-reset-cross-signing ``` -Bu cihazı bir kurtarma anahtarıyla doğrulayın: +Bu cihazı bir kurtarma anahtarı ile doğrulayın: ```bash openclaw matrix verify device "" ``` -Ayrıntılı cihaz doğrulama ayrıntıları: +Ayrıntılı cihaz doğrulama bilgileri: ```bash openclaw matrix verify device "" --verbose ``` -Oda anahtarı yedekleme sağlığını kontrol edin: +Oda anahtarı yedeği durumunu kontrol edin: ```bash openclaw matrix verify backup status ``` -Ayrıntılı yedekleme sağlığı tanılaması: +Ayrıntılı yedek durumu tanıları: ```bash openclaw matrix verify backup status --verbose ``` -Sunucu yedeğinden oda anahtarlarını geri yükleyin: +Oda anahtarlarını sunucu yedeğinden geri yükleyin: ```bash openclaw matrix verify backup restore ``` -Ayrıntılı geri yükleme tanılaması: +Ayrıntılı geri yükleme tanıları: ```bash openclaw matrix verify backup restore --verbose ``` -Mevcut sunucu yedeğini silin ve yeni bir yedekleme temel düzeyi oluşturun. Saklanan -yedekleme anahtarı temiz şekilde yüklenemiyorsa, bu sıfırlama gizli depolamayı da yeniden oluşturarak -gelecekteki soğuk başlangıçların yeni yedekleme anahtarını yükleyebilmesini sağlayabilir: +Geçerli sunucu yedeğini silin ve yeni bir yedek temel çizgisi oluşturun. Saklanan +yedek anahtarı temiz şekilde yüklenemiyorsa, bu sıfırlama secret storage'ı da yeniden oluşturabilir; böylece +gelecekteki soğuk başlangıçlar yeni yedek anahtarını yükleyebilir: ```bash openclaw matrix verify backup reset --yes ``` -Tüm `verify` komutları varsayılan olarak özdür (sessiz dahili SDK günlüklemesi dahil) ve yalnızca `--verbose` ile ayrıntılı tanılama gösterir. +Tüm `verify` komutları varsayılan olarak kısadır (sessiz dahili SDK günlükleri dahil) ve ayrıntılı tanıları yalnızca `--verbose` ile gösterir. Betik yazarken tam makine tarafından okunabilir çıktı için `--json` kullanın. -Çoklu hesap kurulumlarında, Matrix CLI komutları `--account ` parametresini vermediğiniz sürece örtük Matrix varsayılan hesabını kullanır. -Birden fazla adlandırılmış hesap yapılandırırsanız, önce `channels.matrix.defaultAccount` ayarlayın; aksi takdirde bu örtük CLI işlemleri durur ve sizden açıkça bir hesap seçmenizi ister. -Doğrulama veya cihaz işlemlerinin açıkça adlandırılmış bir hesabı hedeflemesini istediğinizde `--account` kullanın: +Çoklu hesap kurulumlarında Matrix CLI komutları, siz `--account ` geçmediğiniz sürece örtük Matrix varsayılan hesabını kullanır. +Birden fazla adlandırılmış hesap yapılandırırsanız önce `channels.matrix.defaultAccount` ayarlayın; aksi halde bu örtük CLI işlemleri durur ve sizden açıkça bir hesap seçmenizi ister. +Doğrulama veya cihaz işlemlerinin belirli bir adlandırılmış hesabı açıkça hedeflemesini istediğinizde `--account` kullanın: ```bash openclaw matrix verify status --account assistant @@ -519,42 +526,43 @@ openclaw matrix verify backup restore --account assistant openclaw matrix devices list --account assistant ``` -Şifreleme devre dışıysa veya adlandırılmış bir hesap için kullanılamıyorsa, Matrix uyarıları ve doğrulama hataları o hesabın yapılandırma anahtarını işaret eder; örneğin `channels.matrix.accounts.assistant.encryption`. +Şifreleme belirli bir adlandırılmış hesap için devre dışıysa veya kullanılamıyorsa, Matrix uyarıları ve doğrulama hataları o hesabın yapılandırma anahtarını işaret eder; örneğin `channels.matrix.accounts.assistant.encryption`. ### "Doğrulanmış" ne anlama gelir -OpenClaw, bu Matrix cihazını yalnızca kendi çapraz imzalama kimliğiniz tarafından doğrulandığında doğrulanmış kabul eder. -Uygulamada, `openclaw matrix verify status --verbose` üç güven sinyali gösterir: +OpenClaw bu Matrix cihazını yalnızca cihaz sizin kendi çapraz imzalama kimliğiniz tarafından doğrulanmışsa doğrulanmış kabul eder. +Pratikte, `openclaw matrix verify status --verbose` üç güven sinyali gösterir: - `Locally trusted`: bu cihaz yalnızca mevcut istemci tarafından güvenilir kabul edilir -- `Cross-signing verified`: SDK, cihazın çapraz imzalama yoluyla doğrulandığını bildirir -- `Signed by owner`: cihaz kendi self-signing anahtarınız tarafından imzalanmıştır +- `Cross-signing verified`: SDK bu cihazın çapraz imzalama yoluyla doğrulandığını bildirir +- `Signed by owner`: cihaz sizin kendi self-signing anahtarınız tarafından imzalanmıştır -`Verified by owner`, yalnızca çapraz imzalama doğrulaması veya sahip imzası mevcut olduğunda `yes` olur. -Yerel güven tek başına OpenClaw'ın cihazı tamamen doğrulanmış kabul etmesi için yeterli değildir. +`Verified by owner`, yalnızca çapraz imzalama doğrulaması veya owner-signing mevcut olduğunda `yes` olur. +Yalnızca yerel güven, OpenClaw'ın cihazı tam doğrulanmış olarak kabul etmesi için yeterli değildir. ### Bootstrap ne yapar -`openclaw matrix verify bootstrap`, şifrelenmiş Matrix hesapları için onarım ve kurulum komutudur. +`openclaw matrix verify bootstrap`, şifreli Matrix hesapları için onarım ve kurulum komutudur. Aşağıdakilerin tümünü sırayla yapar: -- gizli depolamayı bootstrap eder ve mümkün olduğunda mevcut bir kurtarma anahtarını yeniden kullanır +- mümkün olduğunda mevcut kurtarma anahtarını yeniden kullanarak secret storage'ı bootstrap eder - çapraz imzalamayı bootstrap eder ve eksik genel çapraz imzalama anahtarlarını yükler -- mevcut cihazı işaretlemeyi ve çapraz imzalamayı dener +- mevcut cihazı işaretlemeye ve çapraz imzalamaya çalışır - henüz yoksa yeni bir sunucu tarafı oda anahtarı yedeği oluşturur -Homeserver çapraz imzalama anahtarlarını yüklemek için etkileşimli kimlik doğrulaması gerektiriyorsa, OpenClaw önce kimlik doğrulaması olmadan, ardından `m.login.dummy` ile, sonra `channels.matrix.password` yapılandırılmışsa `m.login.password` ile yüklemeyi dener. +Homeserver, çapraz imzalama anahtarlarını yüklemek için etkileşimli kimlik doğrulama gerektiriyorsa, OpenClaw yüklemeyi önce kimlik doğrulama olmadan, sonra `m.login.dummy` ile, ardından `channels.matrix.password` yapılandırılmışsa `m.login.password` ile dener. -`--force-reset-cross-signing` seçeneğini yalnızca mevcut çapraz imzalama kimliğini bilerek silmek ve yenisini oluşturmak istediğinizde kullanın. +Geçerli çapraz imzalama kimliğini bilerek atıp yenisini oluşturmak istiyorsanız yalnızca `--force-reset-cross-signing` kullanın. -Mevcut oda anahtarı yedeğini bilerek silmek ve gelecekteki iletiler için yeni -bir yedekleme temel düzeyi başlatmak istiyorsanız, `openclaw matrix verify backup reset --yes` kullanın. -Bunu yalnızca kurtarılamayan eski şifreli geçmişin erişilemez kalacağını ve -OpenClaw'ın mevcut yedekleme sırrı güvenli şekilde yüklenemiyorsa gizli depolamayı yeniden oluşturabileceğini kabul ediyorsanız yapın. +Geçerli oda anahtarı yedeğini bilerek atıp gelecekteki iletiler için yeni bir +yedek temel çizgisi başlatmak istiyorsanız `openclaw matrix verify backup reset --yes` kullanın. +Bunu yalnızca kurtarılamayan eski şifreli geçmişin erişilemez +kalacağını ve OpenClaw'ın mevcut yedek +gizli bilgisi güvenle yüklenemiyorsa secret storage'ı yeniden oluşturabileceğini kabul ettiğinizde yapın. -### Yeni yedekleme temel düzeyi +### Yeni yedek temel çizgisi -Gelecekteki şifreli iletilerin çalışmaya devam etmesini istiyorsanız ve kurtarılamayan eski geçmişi kaybetmeyi kabul ediyorsanız, şu komutları sırayla çalıştırın: +Gelecekteki şifreli iletilerin çalışmaya devam etmesini istiyor ve kurtarılamayan eski geçmişi kaybetmeyi kabul ediyorsanız, bu komutları sırayla çalıştırın: ```bash openclaw matrix verify backup reset --yes @@ -562,100 +570,100 @@ openclaw matrix verify backup status --verbose openclaw matrix verify status ``` -Adlandırılmış bir Matrix hesabını açıkça hedeflemek istediğinizde her komuta `--account ` ekleyin. +Belirli bir adlandırılmış Matrix hesabını açıkça hedeflemek istediğinizde her komuta `--account ` ekleyin. ### Başlangıç davranışı `encryption: true` olduğunda Matrix varsayılan olarak `startupVerification` değerini `"if-unverified"` yapar. -Başlangıçta bu cihaz hâlâ doğrulanmamışsa, Matrix başka bir Matrix istemcisinde öz-doğrulama ister, -biri zaten beklemedeyken yinelenen istekleri atlar ve yeniden başlatmalardan sonra tekrar denemeden önce yerel bir bekleme süresi uygular. +Başlangıçta, bu cihaz hâlâ doğrulanmamışsa Matrix başka bir Matrix istemcisinde self-verification isteyecek, +biri zaten beklemedeyken yinelenen istekleri atlayacak ve yeniden başlatmalardan sonra yeniden denemeden önce yerel bir bekleme süresi uygulayacaktır. Başarısız istek denemeleri varsayılan olarak başarılı istek oluşturmadan daha erken yeniden denenir. -Otomatik başlangıç isteklerini devre dışı bırakmak için `startupVerification: "off"` ayarlayın veya daha kısa ya da daha uzun bir yeniden deneme aralığı istiyorsanız `startupVerificationCooldownHours` değerini ayarlayın. +Otomatik başlangıç isteklerini devre dışı bırakmak için `startupVerification: "off"` ayarlayın veya daha kısa ya da daha uzun bir yeniden deneme penceresi istiyorsanız `startupVerificationCooldownHours` değerini ayarlayın. -Başlangıç ayrıca otomatik olarak korumacı bir kripto bootstrap geçişi de gerçekleştirir. -Bu geçiş, önce mevcut gizli depolamayı ve çapraz imzalama kimliğini yeniden kullanmayı dener ve siz açık bir bootstrap onarım akışı çalıştırmadığınız sürece çapraz imzalamayı sıfırlamaktan kaçınır. +Başlangıç ayrıca otomatik olarak muhafazakar bir kripto bootstrap geçişi yapar. +Bu geçiş önce mevcut secret storage ve çapraz imzalama kimliğini yeniden kullanmaya çalışır ve siz açık bir bootstrap onarım akışı çalıştırmadıkça çapraz imzalamayı sıfırlamaktan kaçınır. -Başlangıç bozuk bootstrap durumu bulursa ve `channels.matrix.password` yapılandırılmışsa, OpenClaw daha katı bir onarım yolunu deneyebilir. -Mevcut cihaz zaten owner-signed ise, OpenClaw bu kimliği otomatik olarak sıfırlamak yerine korur. +Başlangıç bozuk bootstrap durumu bulursa ve `channels.matrix.password` yapılandırılmışsa, OpenClaw daha sıkı bir onarım yolunu deneyebilir. +Mevcut cihaz zaten owner-signed ise OpenClaw bu kimliği otomatik olarak sıfırlamak yerine korur. -Önceki herkese açık Matrix eklentisinden yükseltme: +Önceki genel Matrix plugininden yükseltme: -- OpenClaw mümkün olduğunda aynı Matrix hesabını, access token'ı ve cihaz kimliğini otomatik olarak yeniden kullanır. -- Uygulanabilir herhangi bir Matrix geçiş değişikliği çalışmadan önce, OpenClaw `~/Backups/openclaw-migrations/` altında bir kurtarma anlık görüntüsü oluşturur veya yeniden kullanır. -- Birden fazla Matrix hesabı kullanıyorsanız, OpenClaw'ın bu paylaşılan eski durumu hangi hesabın alacağını bilmesi için eski düz depo düzeninden yükseltmeden önce `channels.matrix.defaultAccount` ayarlayın. -- Önceki eklenti Matrix oda anahtarı yedek çözme anahtarını yerel olarak sakladıysa, başlangıç veya `openclaw doctor --fix` bunu yeni kurtarma anahtarı akışına otomatik olarak aktarır. -- Matrix access token geçiş hazırlandıktan sonra değiştiyse, başlangıç artık otomatik yedek geri yüklemeden vazgeçmeden önce bekleyen eski geri yükleme durumu için kardeş token-hash depolama köklerini tarar. -- Matrix access token daha sonra aynı hesap, homeserver ve kullanıcı için değişirse, OpenClaw artık boş bir Matrix durum dizininden başlamak yerine en eksiksiz mevcut token-hash depolama kökünü yeniden kullanmayı tercih eder. -- Bir sonraki gateway başlangıcında, yedeklenmiş oda anahtarları otomatik olarak yeni kripto deposuna geri yüklenir. -- Eski eklentide hiç yedeklenmemiş yalnızca yerel oda anahtarları varsa, OpenClaw açık şekilde uyarır. Bu anahtarlar önceki rust kripto deposundan otomatik olarak dışa aktarılamaz; bu nedenle bazı eski şifreli geçmişler elle kurtarılana kadar erişilemez kalabilir. -- Tam yükseltme akışı, sınırlar, kurtarma komutları ve yaygın geçiş iletileri için [Matrix migration](/tr/install/migrating-matrix) bölümüne bakın. +- OpenClaw mümkün olduğunda aynı Matrix hesabını, erişim belirtecini ve cihaz kimliğini otomatik olarak yeniden kullanır. +- Herhangi bir eyleme dönüştürülebilir Matrix geçiş değişikliği çalıştırılmadan önce OpenClaw `~/Backups/openclaw-migrations/` altında bir kurtarma anlık görüntüsü oluşturur veya mevcut olanı yeniden kullanır. +- Birden fazla Matrix hesabı kullanıyorsanız, eski düz depo düzeninden yükseltmeden önce `channels.matrix.defaultAccount` ayarlayın; böylece OpenClaw bu paylaşılan eski durumun hangi hesap tarafından alınacağını bilir. +- Önceki plugin bir Matrix oda anahtarı yedek çözme anahtarını yerelde sakladıysa, başlangıç veya `openclaw doctor --fix` bunu otomatik olarak yeni kurtarma anahtarı akışına aktarır. +- Matrix erişim belirteci geçiş hazırlandıktan sonra değiştiyse, başlangıç artık otomatik yedek geri yüklemeden vazgeçmeden önce bekleyen eski geri yükleme durumunu aramak için komşu belirteç-hash depolama köklerini tarar. +- Matrix erişim belirteci daha sonra aynı hesap, homeserver ve kullanıcı için değişirse, OpenClaw artık boş bir Matrix durum dizininden başlamak yerine en eksiksiz mevcut belirteç-hash depolama kökünü yeniden kullanmayı tercih eder. +- Bir sonraki gateway başlangıcında yedeklenmiş oda anahtarları otomatik olarak yeni kripto deposuna geri yüklenir. +- Eski pluginde yalnızca yerel olup hiç yedeklenmemiş oda anahtarları varsa OpenClaw açık bir uyarı verir. Bu anahtarlar önceki rust kripto deposundan otomatik olarak dışa aktarılamaz, bu nedenle bazı eski şifreli geçmişler elle kurtarılana kadar erişilemez kalabilir. +- Tam yükseltme akışı, sınırlar, kurtarma komutları ve yaygın geçiş iletileri için [Matrix geçişi](/tr/install/migrating-matrix) bölümüne bakın. -Şifreli çalışma zamanı durumu, hesap başına, kullanıcı başına token-hash kökleri altında +Şifreli çalışma zamanı durumu, hesap başına ve kullanıcı başına belirteç-hash kökleri altında `~/.openclaw/matrix/accounts//__//` içinde düzenlenir. Bu dizin sync deposunu (`bot-storage.json`), kripto deposunu (`crypto/`), kurtarma anahtarı dosyasını (`recovery-key.json`), IndexedDB anlık görüntüsünü (`crypto-idb-snapshot.json`), -ileti dizisi bağlarını (`thread-bindings.json`) ve başlangıç doğrulama durumunu (`startup-verification.json`) -bu özellikler kullanıldığında içerir. -Token değişse de hesap kimliği aynı kaldığında, OpenClaw o hesap/homeserver/kullanıcı üçlüsü için en iyi mevcut -kökü yeniden kullanır; böylece önceki sync durumu, kripto durumu, ileti dizisi bağları +ileti dizisi bağlamalarını (`thread-bindings.json`) ve başlangıç doğrulama durumunu (`startup-verification.json`) +bu özellikler kullanımdayken içerir. +Belirteç değiştiğinde ancak hesap kimliği aynı kaldığında OpenClaw, o hesap/homeserver/kullanıcı üçlüsü için mevcut en iyi +kökü yeniden kullanır; böylece önceki sync durumu, kripto durumu, ileti dizisi bağlamaları ve başlangıç doğrulama durumu görünür kalır. -### Node crypto store modeli +### Node kripto deposu modeli -Bu eklentideki Matrix E2EE, Node içinde resmi `matrix-js-sdk` Rust kripto yolunu kullanır. -Kalıcı olmasını istediğinizde bu yol, yeniden başlatmalar arasında kripto durumunu korumak için IndexedDB destekli kalıcılık bekler. +Bu plugindeki Matrix E2EE, Node içinde resmi `matrix-js-sdk` Rust kripto yolunu kullanır. +Kripto durumunun yeniden başlatmalar arasında kalıcı olmasını istiyorsanız bu yol IndexedDB tabanlı kalıcılık bekler. -OpenClaw şu anda Node içinde bunu şu şekilde sağlar: +OpenClaw şu anda bunu Node içinde şu şekilde sağlar: -- SDK'nin beklediği IndexedDB API shim'i olarak `fake-indexeddb` kullanma -- `initRustCrypto` öncesinde Rust kripto IndexedDB içeriğini `crypto-idb-snapshot.json` dosyasından geri yükleme -- init sonrasında ve çalışma zamanı sırasında güncellenmiş IndexedDB içeriğini yeniden `crypto-idb-snapshot.json` içine kalıcı hale getirme -- gateway çalışma zamanı kalıcılığı ile CLI bakımının aynı anlık görüntü dosyasında yarışmaması için anlık görüntü geri yükleme ve kalıcılığı `crypto-idb-snapshot.json` üzerinde danışmalı bir dosya kilidiyle serileştirme +- SDK'nın beklediği IndexedDB API shim'i olarak `fake-indexeddb` kullanarak +- `initRustCrypto` öncesinde Rust kripto IndexedDB içeriğini `crypto-idb-snapshot.json` dosyasından geri yükleyerek +- init sonrasında ve çalışma zamanı sırasında güncellenmiş IndexedDB içeriğini tekrar `crypto-idb-snapshot.json` dosyasına yazarak +- gateway çalışma zamanı kalıcılığı ile CLI bakımının aynı anlık görüntü dosyası üzerinde yarışmaması için, anlık görüntü geri yükleme ve yazma işlemlerini `crypto-idb-snapshot.json` üzerinde danışmalı bir dosya kilidiyle serileştirerek -Bu, özel bir kripto uygulaması değil, uyumluluk/depolama altyapısıdır. +Bu, özel bir kripto uygulaması değil; uyumluluk/depolama altyapısıdır. Anlık görüntü dosyası hassas çalışma zamanı durumudur ve kısıtlayıcı dosya izinleriyle saklanır. -OpenClaw'ın güvenlik modeline göre gateway host ve yerel OpenClaw durum dizini zaten güvenilir operatör sınırı içindedir; bu nedenle bu öncelikle ayrı bir uzak güven sınırından ziyade operasyonel dayanıklılık konusudur. +OpenClaw'ın güvenlik modelinde, gateway sunucusu ve yerel OpenClaw durum dizini zaten güvenilen operatör sınırının içindedir; bu nedenle bu konu ayrı bir uzak güven sınırından çok operasyonel dayanıklılık konusudur. Planlanan iyileştirme: -- kalıcı Matrix anahtar materyali için SecretRef desteği eklemek; böylece kurtarma anahtarları ve ilgili depo şifreleme sırları yalnızca yerel dosyalardan değil OpenClaw gizli bilgi sağlayıcılarından da alınabilir +- kalıcı Matrix anahtar materyali için SecretRef desteği eklemek; böylece kurtarma anahtarları ve ilgili store-encryption gizli bilgileri yalnızca yerel dosyalardan değil, OpenClaw gizli bilgi sağlayıcılarından da alınabilir ## Profil yönetimi -Seçilen hesap için Matrix öz-profilini şu şekilde güncelleyin: +Seçilen hesabın Matrix öz-profilini şu komutla güncelleyin: ```bash openclaw matrix profile set --name "OpenClaw Assistant" openclaw matrix profile set --avatar-url https://cdn.example.org/avatar.png ``` -Adlandırılmış bir Matrix hesabını açıkça hedeflemek istediğinizde `--account ` ekleyin. +Belirli bir adlandırılmış Matrix hesabını açıkça hedeflemek istediğinizde `--account ` ekleyin. -Matrix, `mxc://` avatar URL'lerini doğrudan kabul eder. Bir `http://` veya `https://` avatar URL'si verdiğinizde, OpenClaw önce onu Matrix'e yükler ve çözümlenen `mxc://` URL'sini yeniden `channels.matrix.avatarUrl` içine (veya seçilen hesap geçersiz kılmasına) kaydeder. +Matrix, `mxc://` avatar URL'lerini doğrudan kabul eder. `http://` veya `https://` bir avatar URL'si verdiğinizde OpenClaw önce bunu Matrix'e yükler ve çözümlenen `mxc://` URL'sini tekrar `channels.matrix.avatarUrl` içine (veya seçilen hesap geçersiz kılmasına) kaydeder. ## Otomatik doğrulama bildirimleri -Matrix artık doğrulama yaşam döngüsü bildirimlerini doğrudan sıkı DM doğrulama odasına `m.notice` iletileri olarak gönderir. +Matrix artık doğrulama yaşam döngüsü bildirimlerini doğrudan sıkı DM doğrulama odasına `m.notice` mesajları olarak gönderir. Buna şunlar dahildir: - doğrulama isteği bildirimleri -- doğrulama hazır bildirimleri (açık "emoji ile doğrula" yönlendirmesiyle) -- doğrulama başlangıç ve tamamlama bildirimleri -- mevcut olduğunda SAS ayrıntıları (emoji ve ondalık) +- doğrulama hazır bildirimleri (açık "Emoji ile doğrula" yönlendirmesi ile) +- doğrulama başlangıç ve tamamlanma bildirimleri +- uygun olduğunda SAS ayrıntıları (emoji ve ondalık) -Başka bir Matrix istemcisinden gelen doğrulama istekleri izlenir ve OpenClaw tarafından otomatik kabul edilir. -Öz-doğrulama akışlarında, OpenClaw emoji doğrulaması kullanılabilir olduğunda SAS akışını da otomatik olarak başlatır ve kendi tarafını onaylar. -Başka bir Matrix kullanıcı/cihazından gelen doğrulama isteklerinde, OpenClaw isteği otomatik kabul eder ve ardından SAS akışının normal şekilde ilerlemesini bekler. -Doğrulamayı tamamlamak için Matrix istemcinizde emoji veya ondalık SAS değerini karşılaştırmanız ve orada "They match" onayı vermeniz yine gerekir. +Başka bir Matrix istemcisinden gelen doğrulama istekleri OpenClaw tarafından izlenir ve otomatik olarak kabul edilir. +Self-verification akışları için OpenClaw, emoji doğrulaması kullanılabilir olduğunda SAS akışını otomatik olarak başlatır ve kendi tarafını onaylar. +Başka bir Matrix kullanıcısı/cihazından gelen doğrulama istekleri için OpenClaw isteği otomatik olarak kabul eder ve ardından SAS akışının normal şekilde ilerlemesini bekler. +Doğrulamayı tamamlamak için yine de Matrix istemcinizde emoji veya ondalık SAS'ı karşılaştırmanız ve orada "Eşleşiyorlar" seçeneğini onaylamanız gerekir. -OpenClaw, kendi başlattığı yinelenen akışları körü körüne otomatik kabul etmez. Başlangıç, öz-doğrulama isteği zaten beklemedeyse yeni bir istek oluşturmaz. +OpenClaw, kendi başlattığı yinelenen akışları körü körüne otomatik kabul etmez. Self-verification isteği zaten beklemedeyken başlangıç yeni bir istek oluşturmayı atlar. -Doğrulama protokolü/sistem bildirimleri ajan sohbet hattına iletilmez; bu nedenle `NO_REPLY` üretmezler. +Doğrulama protokolü/sistem bildirimleri ajan sohbet hattına iletilmez, bu nedenle `NO_REPLY` üretmezler. ### Cihaz hijyeni -Eski OpenClaw tarafından yönetilen Matrix cihazları hesapta birikebilir ve şifreli oda güvenini anlamayı zorlaştırabilir. -Bunları şu komutla listeleyin: +Hesapta eski OpenClaw tarafından yönetilen Matrix cihazları birikebilir ve şifreli oda güvenini anlamayı zorlaştırabilir. +Şu komutla listeleyin: ```bash openclaw matrix devices list @@ -669,7 +677,7 @@ openclaw matrix devices prune-stale ### Doğrudan Oda Onarımı -Doğrudan ileti durumu eşzamansız hale gelirse, OpenClaw canlı DM yerine eski tekli odaları gösteren bayat `m.direct` eşlemeleriyle karşılaşabilir. Bir eş için mevcut eşlemeyi şu komutla inceleyin: +Doğrudan mesaj durumu senkron dışına çıkarsa OpenClaw, canlı DM yerine eski tekli odalara işaret eden bayat `m.direct` eşlemeleriyle karşılaşabilir. Bir eş için mevcut eşlemeyi incelemek için şunu kullanın: ```bash openclaw matrix direct inspect --user-id @alice:example.org @@ -681,49 +689,49 @@ openclaw matrix direct inspect --user-id @alice:example.org openclaw matrix direct repair --user-id @alice:example.org ``` -Onarım, Matrix'e özgü mantığı eklentinin içinde tutar: +Onarım, Matrix'e özgü mantığı plugin içinde tutar: -- önce `m.direct` içinde zaten eşlenmiş olan sıkı 1:1 DM'yi tercih eder -- aksi takdirde bu kullanıcıyla hâlihazırda katılınmış herhangi bir sıkı 1:1 DM'ye geri döner -- sağlıklı bir DM yoksa yeni bir doğrudan oda oluşturur ve `m.direct` eşlemesini ona işaret edecek şekilde yeniden yazar +- önce `m.direct` içinde zaten eşlenmiş olan sıkı bir 1:1 DM'yi tercih eder +- aksi halde o kullanıcıyla şu anda katılınmış olan herhangi bir sıkı 1:1 DM'ye geri döner +- sağlıklı bir DM yoksa yeni bir doğrudan oda oluşturur ve `m.direct` alanını onu işaret edecek şekilde yeniden yazar -Onarım akışı eski odaları otomatik olarak silmez. Yalnızca sağlıklı DM'yi seçer ve eşlemeyi günceller; böylece yeni Matrix gönderimleri, doğrulama bildirimleri ve diğer doğrudan ileti akışları yeniden doğru odayı hedefler. +Onarım akışı eski odaları otomatik olarak silmez. Yalnızca sağlıklı DM'yi seçer ve eşlemeyi günceller; böylece yeni Matrix gönderimleri, doğrulama bildirimleri ve diğer doğrudan mesaj akışları yeniden doğru odayı hedefler. ## İleti dizileri -Matrix, hem otomatik yanıtlar hem de ileti aracı gönderimleri için yerel Matrix ileti dizilerini destekler. +Matrix hem otomatik yanıtlar hem de message-tool gönderimleri için yerel Matrix ileti dizilerini destekler. -- `dm.sessionScope: "per-user"` (varsayılan), Matrix DM yönlendirmesini gönderen kapsamlı tutar; böylece birden fazla DM odası aynı eşe çözümlendiğinde tek bir oturumu paylaşabilir. -- `dm.sessionScope: "per-room"`, normal DM kimlik doğrulaması ve allowlist kontrollerini kullanmaya devam ederken her Matrix DM odasını kendi oturum anahtarına ayırır. -- Açık Matrix konuşma bağları yine `dm.sessionScope` ayarına üstün gelir; bu nedenle bağlanmış odalar ve ileti dizileri seçtikleri hedef oturumu korur. -- `threadReplies: "off"`, yanıtları üst düzeyde tutar ve gelen dizili iletileri ana oturumda tutar. -- `threadReplies: "inbound"`, yalnızca gelen ileti zaten o ileti dizisindeyse o ileti dizisi içinde yanıt verir. -- `threadReplies: "always"`, oda yanıtlarını tetikleyen iletiye köklenen bir ileti dizisinde tutar ve o konuşmayı ilk tetikleyen iletiden itibaren eşleşen ileti dizisi kapsamlı oturum üzerinden yönlendirir. -- `dm.threadReplies`, üst düzey ayarı yalnızca DM'ler için geçersiz kılar. Örneğin, odalardaki ileti dizilerini ayrık tutarken DM'leri düz tutabilirsiniz. -- Gelen dizili iletiler, ileti dizisi kök iletisini ek ajan bağlamı olarak içerir. -- İleti aracı gönderimleri artık hedef aynı odaysa veya aynı DM kullanıcı hedefiyse, açık `threadId` verilmediği sürece mevcut Matrix ileti dizisini otomatik devralır. -- Aynı oturumlu DM kullanıcı hedefi yeniden kullanımı yalnızca mevcut oturum meta verileri aynı Matrix hesabındaki aynı DM eşini kanıtladığında devreye girer; aksi takdirde OpenClaw normal kullanıcı kapsamlı yönlendirmeye geri döner. -- OpenClaw, bir Matrix DM odasının aynı paylaşılan Matrix DM oturumundaki başka bir DM odasıyla çakıştığını gördüğünde, ileti dizisi bağları etkinse ve `dm.sessionScope` ipucu mevcutsa bu odaya `/focus` kaçış yolunu içeren tek seferlik bir `m.notice` gönderir. -- Çalışma zamanı ileti dizisi bağları Matrix için desteklenir. `/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age` ve ileti dizisine bağlı `/acp spawn` artık Matrix odalarında ve DM'lerde çalışır. -- Üst düzey Matrix oda/DM `/focus`, `threadBindings.spawnSubagentSessions=true` olduğunda yeni bir Matrix ileti dizisi oluşturur ve bunu hedef oturuma bağlar. +- `dm.sessionScope: "per-user"` (varsayılan), Matrix DM yönlendirmesini gönderici kapsamlı tutar; böylece birden fazla DM odası aynı eşe çözülüyorsa tek bir oturumu paylaşabilir. +- `dm.sessionScope: "per-room"`, her Matrix DM odasını kendi oturum anahtarına ayırırken normal DM kimlik doğrulama ve izin listesi kontrollerini kullanmaya devam eder. +- Açık Matrix konuşma bağlamaları yine de `dm.sessionScope` üzerinde önceliklidir; bu nedenle bağlanmış odalar ve ileti dizileri seçtikleri hedef oturumu korur. +- `threadReplies: "off"`, yanıtları üst düzeyde tutar ve gelen ileti dizili mesajları ana oturumda tutar. +- `threadReplies: "inbound"`, yalnızca gelen mesaj zaten o ileti dizisindeyse ileti dizisi içinde yanıt verir. +- `threadReplies: "always"`, oda yanıtlarını tetikleyici mesaja köklenen bir ileti dizisinde tutar ve bu konuşmayı ilk tetikleyici mesajdan itibaren eşleşen ileti dizisi kapsamlı oturum üzerinden yönlendirir. +- `dm.threadReplies`, yalnızca DM'ler için üst düzey ayarı geçersiz kılar. Örneğin, odalardaki ileti dizilerini yalıtılmış tutarken DM'leri düz tutabilirsiniz. +- Gelen ileti dizili mesajlar, ileti dizisi kök mesajını ek ajan bağlamı olarak içerir. +- Message-tool gönderimleri artık hedef aynı oda veya aynı DM kullanıcı hedefi olduğunda mevcut Matrix ileti dizisini otomatik olarak devralır; açık bir `threadId` verilmişse bu geçerli değildir. +- Aynı oturumdaki DM kullanıcı hedefi yeniden kullanımı yalnızca mevcut oturum meta verileri aynı Matrix hesabındaki aynı DM eşini kanıtladığında devreye girer; aksi halde OpenClaw normal kullanıcı kapsamlı yönlendirmeye geri döner. +- OpenClaw, aynı paylaşılan Matrix DM oturumunda bir Matrix DM odasının başka bir DM odasıyla çakıştığını gördüğünde, ileti dizisi bağlamaları etkinse ve `dm.sessionScope` ipucuyla birlikte o odada bir kerelik `/focus` kaçış yolunu içeren bir `m.notice` yayınlar. +- Çalışma zamanı ileti dizisi bağlamaları Matrix için desteklenir. `/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age` ve ileti dizisine bağlı `/acp spawn` artık Matrix odalarında ve DM'lerde çalışır. +- Üst düzey Matrix oda/DM `/focus`, `threadBindings.spawnSubagentSessions=true` olduğunda yeni bir Matrix ileti dizisi oluşturur ve onu hedef oturuma bağlar. - Mevcut bir Matrix ileti dizisi içinde `/focus` veya `/acp spawn --thread here` çalıştırmak bunun yerine mevcut ileti dizisini bağlar. -## ACP konuşma bağları +## ACP konuşma bağlamaları Matrix odaları, DM'ler ve mevcut Matrix ileti dizileri sohbet yüzeyini değiştirmeden kalıcı ACP çalışma alanlarına dönüştürülebilir. Hızlı operatör akışı: - Kullanmaya devam etmek istediğiniz Matrix DM, oda veya mevcut ileti dizisi içinde `/acp spawn codex --bind here` çalıştırın. -- Üst düzey bir Matrix DM veya odasında, mevcut DM/oda sohbet yüzeyi olarak kalır ve gelecekteki iletiler oluşturulan ACP oturumuna yönlendirilir. -- Mevcut bir Matrix ileti dizisi içinde, `--bind here` mevcut ileti dizisini yerinde bağlar. +- Üst düzey bir Matrix DM veya odasında, mevcut DM/oda sohbet yüzeyi olarak kalır ve gelecekteki mesajlar oluşturulan ACP oturumuna yönlendirilir. +- Mevcut bir Matrix ileti dizisi içinde `--bind here`, mevcut ileti dizisini yerinde bağlar. - `/new` ve `/reset`, aynı bağlı ACP oturumunu yerinde sıfırlar. -- `/acp close`, ACP oturumunu kapatır ve bağı kaldırır. +- `/acp close`, ACP oturumunu kapatır ve bağlamayı kaldırır. Notlar: -- `--bind here`, alt bir Matrix ileti dizisi oluşturmaz. -- `threadBindings.spawnAcpSessions` yalnızca OpenClaw'ın alt bir Matrix ileti dizisi oluşturması veya bağlaması gereken `/acp spawn --thread auto|here` için gereklidir. +- `--bind here`, alt Matrix ileti dizisi oluşturmaz. +- `threadBindings.spawnAcpSessions`, yalnızca OpenClaw'ın alt Matrix ileti dizisi oluşturması veya bağlaması gereken `/acp spawn --thread auto|here` için gereklidir. ### İleti Dizisi Bağlama Yapılandırması @@ -735,29 +743,29 @@ Matrix, genel varsayılanları `session.threadBindings` üzerinden devralır ve - `threadBindings.spawnSubagentSessions` - `threadBindings.spawnAcpSessions` -Matrix ileti dizisine bağlı oluşturma işaretleri isteğe bağlıdır: +Matrix ileti dizisine bağlı spawn bayrakları isteğe bağlıdır: - Üst düzey `/focus` komutunun yeni Matrix ileti dizileri oluşturup bağlamasına izin vermek için `threadBindings.spawnSubagentSessions: true` ayarlayın. - `/acp spawn --thread auto|here` komutunun ACP oturumlarını Matrix ileti dizilerine bağlamasına izin vermek için `threadBindings.spawnAcpSessions: true` ayarlayın. ## Tepkiler -Matrix, giden tepki eylemlerini, gelen tepki bildirimlerini ve gelen onay tepkilerini destekler. +Matrix giden tepki eylemlerini, gelen tepki bildirimlerini ve gelen ack tepkilerini destekler. -- Giden tepki araçları `channels["matrix"].actions.reactions` ile sınırlandırılır. +- Giden tepki araçları `channels["matrix"].actions.reactions` ile denetlenir. - `react`, belirli bir Matrix olayına tepki ekler. - `reactions`, belirli bir Matrix olayı için mevcut tepki özetini listeler. - `emoji=""`, bot hesabının o olay üzerindeki kendi tepkilerini kaldırır. - `remove: true`, bot hesabından yalnızca belirtilen emoji tepkisini kaldırır. -Onay tepkisi kapsamı standart OpenClaw çözümleme sırasını kullanır: +Ack tepkileri standart OpenClaw çözümleme sırasını kullanır: - `channels["matrix"].accounts..ackReaction` - `channels["matrix"].ackReaction` - `messages.ackReaction` - ajan kimliği emoji fallback'i -Onay tepkisi kapsamı şu sırayla çözülür: +Ack tepki kapsamı şu sırayla çözülür: - `channels["matrix"].accounts..ackReactionScope` - `channels["matrix"].ackReactionScope` @@ -769,31 +777,31 @@ Tepki bildirim modu şu sırayla çözülür: - `channels["matrix"].reactionNotifications` - varsayılan: `own` -Mevcut davranış: +Geçerli davranış: -- `reactionNotifications: "own"`, bot tarafından yazılmış Matrix iletilerini hedeflediğinde eklenen `m.reaction` olaylarını iletir. +- `reactionNotifications: "own"`, bottan yazılmış Matrix mesajlarını hedeflediklerinde eklenen `m.reaction` olaylarını iletir. - `reactionNotifications: "off"`, tepki sistem olaylarını devre dışı bırakır. -- Tepki kaldırmaları hâlâ sistem olaylarına dönüştürülmez; çünkü Matrix bunları bağımsız `m.reaction` kaldırmaları olarak değil sansürler olarak gösterir. +- Tepki kaldırmaları hâlâ sistem olaylarına dönüştürülmez çünkü Matrix bunları bağımsız `m.reaction` kaldırmaları olarak değil, redaction olarak gösterir. ## Geçmiş bağlamı -- `channels.matrix.historyLimit`, bir Matrix oda iletisi ajanı tetiklediğinde `InboundHistory` olarak dahil edilen son oda iletilerinin sayısını kontrol eder. -- `messages.groupChat.historyLimit` değerine geri döner. Devre dışı bırakmak için `0` ayarlayın. -- Matrix oda geçmişi yalnızca odaya özeldir. DM'ler normal oturum geçmişini kullanmaya devam eder. -- Matrix oda geçmişi yalnızca bekleyen iletiler içindir: OpenClaw henüz yanıt tetiklememiş oda iletilerini tamponlar, sonra bir mention veya başka bir tetikleyici geldiğinde bu pencerenin anlık görüntüsünü alır. -- Mevcut tetikleyici ileti `InboundHistory` içine dahil edilmez; o tur için ana gelen gövdede kalır. -- Aynı Matrix olayının yeniden denemeleri, daha yeni oda iletilerine kaymak yerine orijinal geçmiş anlık görüntüsünü yeniden kullanır. +- `channels.matrix.historyLimit`, bir Matrix oda mesajı ajanı tetiklediğinde kaç son oda mesajının `InboundHistory` olarak ekleneceğini kontrol eder. +- Bu ayar `messages.groupChat.historyLimit` değerine geri döner. Her ikisi de ayarlanmamışsa etkin varsayılan `0` olur; bu nedenle mention-gated oda mesajları tamponlanmaz. Devre dışı bırakmak için `0` ayarlayın. +- Matrix oda geçmişi yalnızca oda içindir. DM'ler normal oturum geçmişini kullanmaya devam eder. +- Matrix oda geçmişi yalnızca pending öğeleri içerir: OpenClaw henüz yanıt tetiklememiş oda mesajlarını tamponlar, sonra bir mention veya başka bir tetikleyici geldiğinde bu pencerenin anlık görüntüsünü alır. +- Geçerli tetikleyici mesaj `InboundHistory` içine dahil edilmez; o tur için ana gelen gövdede kalır. +- Aynı Matrix olayının yeniden denemeleri, daha yeni oda mesajlarına doğru kaymak yerine özgün geçmiş anlık görüntüsünü yeniden kullanır. ## Bağlam görünürlüğü -Matrix, getirilen yanıt metni, ileti dizisi kökleri ve bekleyen geçmiş gibi ek oda bağlamı için paylaşılan `contextVisibility` denetimini destekler. +Matrix, alınan yanıt metni, ileti dizisi kökleri ve bekleyen geçmiş gibi ek oda bağlamı için paylaşılan `contextVisibility` denetimini destekler. - `contextVisibility: "all"` varsayılandır. Ek bağlam alındığı gibi korunur. -- `contextVisibility: "allowlist"`, ek bağlamı etkin oda/kullanıcı allowlist denetimleri tarafından izin verilen gönderenlerle sınırlar. -- `contextVisibility: "allowlist_quote"`, `allowlist` gibi davranır ancak yine de tek bir açık alıntılanmış yanıtı korur. +- `contextVisibility: "allowlist"`, ek bağlamı etkin oda/kullanıcı izin listesi kontrolleri tarafından izin verilen gönderenlere filtreler. +- `contextVisibility: "allowlist_quote"`, `allowlist` gibi davranır ancak yine de açık bir alıntılanmış yanıtı korur. -Bu ayar ek bağlam görünürlüğünü etkiler; gelen iletinin kendisinin yanıt tetikleyip tetikleyemeyeceğini değil. -Tetikleme yetkilendirmesi hâlâ `groupPolicy`, `groups`, `groupAllowFrom` ve DM politika ayarlarından gelir. +Bu ayar ek bağlam görünürlüğünü etkiler; gelen iletinin kendisinin bir yanıtı tetikleyip tetikleyemeyeceğini etkilemez. +Tetikleme yetkilendirmesi yine `groupPolicy`, `groups`, `groupAllowFrom` ve DM politika ayarlarından gelir. ## DM ve oda politikası örneği @@ -818,7 +826,7 @@ Tetikleme yetkilendirmesi hâlâ `groupPolicy`, `groups`, `groupAllowFrom` ve DM } ``` -Mention kapılama ve allowlist davranışı için [Groups](/tr/channels/groups) bölümüne bakın. +Mention-gating ve izin listesi davranışı için [Gruplar](/tr/channels/groups) bölümüne bakın. Matrix DM'leri için eşleştirme örneği: @@ -829,11 +837,11 @@ openclaw pairing approve matrix Onaylanmamış bir Matrix kullanıcısı onaydan önce size mesaj göndermeye devam ederse, OpenClaw aynı bekleyen eşleştirme kodunu yeniden kullanır ve yeni bir kod üretmek yerine kısa bir bekleme süresinden sonra yeniden hatırlatma yanıtı gönderebilir. -Paylaşılan DM eşleştirme akışı ve depolama düzeni için [Pairing](/tr/channels/pairing) bölümüne bakın. +Paylaşılan DM eşleştirme akışı ve depolama düzeni için [Eşleştirme](/tr/channels/pairing) bölümüne bakın. ## Exec onayları -Matrix, bir Matrix hesabı için exec onay istemcisi olarak davranabilir. +Matrix, bir Matrix hesabı için exec onay istemcisi olarak çalışabilir. - `channels.matrix.execApprovals.enabled` - `channels.matrix.execApprovals.approvers` (isteğe bağlı; `channels.matrix.dm.allowFrom` değerine geri döner) @@ -841,37 +849,37 @@ Matrix, bir Matrix hesabı için exec onay istemcisi olarak davranabilir. - `channels.matrix.execApprovals.agentFilter` - `channels.matrix.execApprovals.sessionFilter` -Onaylayıcılar `@owner:example.org` gibi Matrix kullanıcı kimlikleri olmalıdır. Matrix, `enabled` ayarsız veya `"auto"` olduğunda ve en az bir onaylayıcı çözümlenebildiğinde yerel exec onaylarını otomatik etkinleştirir; bu, ya `execApprovals.approvers` ya da `channels.matrix.dm.allowFrom` üzerinden olabilir. Matrix'i yerel onay istemcisi olarak açıkça devre dışı bırakmak için `enabled: false` ayarlayın. Aksi halde onay istekleri diğer yapılandırılmış onay yollarına veya exec onay fallback politikasına geri döner. +Onaylayıcılar `@owner:example.org` gibi Matrix kullanıcı kimlikleri olmalıdır. `enabled` ayarlanmamış veya `"auto"` ise ve en az bir onaylayıcı `execApprovals.approvers` ya da `channels.matrix.dm.allowFrom` üzerinden çözümlenebiliyorsa Matrix yerel exec onaylarını otomatik etkinleştirir. Matrix'i yerel onay istemcisi olarak açıkça devre dışı bırakmak için `enabled: false` ayarlayın. Aksi halde onay istekleri başka yapılandırılmış onay yollarına veya exec onay fallback politikasına geri döner. Yerel Matrix yönlendirmesi bugün yalnızca exec içindir: - `channels.matrix.execApprovals.*`, yalnızca exec onayları için yerel DM/kanal yönlendirmesini kontrol eder. -- Eklenti onayları hâlâ paylaşılan aynı sohbet `/approve` komutunu ve yapılandırılmış tüm `approvals.plugin` yönlendirmesini kullanır. -- Matrix, onaylayıcıları güvenli şekilde çıkarabildiğinde eklenti onayı yetkilendirmesi için yine `channels.matrix.dm.allowFrom` kullanabilir, ancak ayrı bir yerel eklenti onayı DM/kanal fanout yolu sunmaz. +- Plugin onayları hâlâ paylaşılan aynı sohbet içi `/approve` ve yapılandırılmış herhangi bir `approvals.plugin` iletmesini kullanır. +- Matrix, onaylayıcıları güvenle çıkarabildiğinde plugin onay yetkilendirmesi için yine `channels.matrix.dm.allowFrom` kullanabilir, ancak ayrı bir yerel plugin onayı DM/kanal fanout yolu sunmaz. -Teslimat kuralları: +Teslim kuralları: - `target: "dm"`, onay istemlerini onaylayıcı DM'lerine gönderir -- `target: "channel"`, istemi kaynak Matrix odasına veya DM'ye geri gönderir -- `target: "both"`, onaylayıcı DM'lerine ve kaynak Matrix odasına veya DM'ye gönderir +- `target: "channel"`, istemi kaynak Matrix oda veya DM'sine geri gönderir +- `target: "both"`, istemleri onaylayıcı DM'lerine ve kaynak Matrix oda veya DM'sine gönderir -Matrix onay istemleri, birincil onay iletisine tepki kısayolları ekler: +Matrix onay istemleri, birincil onay mesajında tepki kısayolları oluşturur: - `✅` = bir kez izin ver - `❌` = reddet -- `♾️` = karar etkin exec politikası tarafından izin veriliyorsa her zaman izin ver +- `♾️` = bu karar etkin exec politikası tarafından izin veriliyorsa her zaman izin ver -Onaylayıcılar bu ileti üzerinde tepki verebilir veya fallback slash komutlarını kullanabilir: `/approve allow-once`, `/approve allow-always` veya `/approve deny`. +Onaylayıcılar bu mesaja tepki verebilir veya fallback slash komutlarını kullanabilir: `/approve allow-once`, `/approve allow-always` veya `/approve deny`. -Yalnızca çözümlenmiş onaylayıcılar izin verebilir veya reddedebilir. Kanal teslimatı komut metnini içerir; bu nedenle `channel` veya `both` seçeneklerini yalnızca güvenilir odalarda etkinleştirin. +Yalnızca çözümlenmiş onaylayıcılar onaylayabilir veya reddedebilir. Kanal teslimi komut metnini içerir; bu nedenle `channel` veya `both` seçeneklerini yalnızca güvenilen odalarda etkinleştirin. -Matrix onay istemleri paylaşılan çekirdek onay planlayıcısını yeniden kullanır. Matrix'e özgü yerel yüzey exec onayları için yalnızca taşıma katmanıdır: oda/DM yönlendirmesi ile ileti gönderme/güncelleme/silme davranışı. +Matrix onay istemleri paylaşılan çekirdek onay planlayıcısını yeniden kullanır. Matrix'e özgü yerel yüzey exec onayları için yalnızca taşıma katmanıdır: oda/DM yönlendirmesi ve mesaj gönderme/güncelleme/silme davranışı. Hesap başına geçersiz kılma: - `channels.matrix.accounts..execApprovals` -İlgili belgeler: [Exec approvals](/tr/tools/exec-approvals) +İlgili belgeler: [Exec onayları](/tr/tools/exec-approvals) ## Çoklu hesap örneği @@ -903,21 +911,21 @@ Hesap başına geçersiz kılma: } ``` -Üst düzey `channels.matrix` değerleri, bir hesap tarafından geçersiz kılınmadığı sürece adlandırılmış hesaplar için varsayılan görevi görür. -Devralınan oda girdilerini tek bir Matrix hesabına `groups..account` (veya eski `rooms..account`) ile kapsamlandırabilirsiniz. -`account` içermeyen girdiler tüm Matrix hesapları arasında paylaşılır ve `account: "default"` içeren girdiler varsayılan hesap doğrudan üst düzey `channels.matrix.*` üzerinde yapılandırıldığında yine çalışır. -Kısmi paylaşılan kimlik doğrulama varsayılanları kendi başına ayrı bir örtük varsayılan hesap oluşturmaz. OpenClaw yalnızca üst düzey `default` hesabını, o varsayılan hesap yeni kimlik doğrulamaya sahipse (`homeserver` artı `accessToken` veya `homeserver` artı `userId` ve `password`) sentezler; adlandırılmış hesaplar, önbelleğe alınmış kimlik bilgileri daha sonra kimlik doğrulamayı sağlarsa `homeserver` artı `userId` üzerinden keşfedilebilir kalabilir. -Matrix'te zaten tam olarak bir adlandırılmış hesap varsa veya `defaultAccount` mevcut bir adlandırılmış hesap anahtarını işaret ediyorsa, tek hesaptan çoklu hesaba onarım/kurulum yükseltmesi yeni bir `accounts.default` girdisi oluşturmak yerine o hesabı korur. Yalnızca Matrix kimlik doğrulama/bootstrap anahtarları bu yükseltilmiş hesaba taşınır; paylaşılan teslimat politikası anahtarları üst düzeyde kalır. -Örtük yönlendirme, yoklama ve CLI işlemleri için OpenClaw'ın adlandırılmış bir Matrix hesabını tercih etmesini istiyorsanız `defaultAccount` ayarlayın. -Birden fazla adlandırılmış hesap yapılandırırsanız, örtük hesap seçimine dayanan CLI komutları için `defaultAccount` ayarlayın veya `--account ` geçin. +Üst düzey `channels.matrix` değerleri, bir hesap tarafından geçersiz kılınmadıkça adlandırılmış hesaplar için varsayılan görevi görür. +Devralınan oda girdilerini tek bir Matrix hesabına `groups..account` (veya eski `rooms..account`) ile sınırlayabilirsiniz. +`account` içermeyen girdiler tüm Matrix hesapları arasında paylaşılmış kalır ve `account: "default"` içeren girdiler varsayılan hesap doğrudan üst düzey `channels.matrix.*` üzerinde yapılandırıldığında yine çalışır. +Kısmi paylaşılan kimlik doğrulama varsayılanları tek başlarına ayrı bir örtük varsayılan hesap oluşturmaz. OpenClaw, üst düzey `default` hesabını yalnızca o varsayılan hesap yeni kimlik doğrulamaya sahipse (`homeserver` artı `accessToken` veya `homeserver` artı `userId` ve `password`) sentezler; adlandırılmış hesaplar, önbelleğe alınmış kimlik bilgileri kimlik doğrulamayı daha sonra sağlarsa `homeserver` artı `userId` üzerinden yine keşfedilebilir kalabilir. +Matrix zaten tam olarak bir adlandırılmış hesaba sahipse veya `defaultAccount` mevcut bir adlandırılmış hesap anahtarını işaret ediyorsa, tek hesaplıdan çok hesaplıya onarım/kurulum yükseltmesi yeni bir `accounts.default` girdisi oluşturmak yerine bu hesabı korur. Yalnızca Matrix kimlik doğrulama/bootstrap anahtarları bu yükseltilmiş hesaba taşınır; paylaşılan teslim politikası anahtarları üst düzeyde kalır. +Örtük yönlendirme, probing ve CLI işlemleri için OpenClaw'ın belirli bir adlandırılmış Matrix hesabını tercih etmesini istiyorsanız `defaultAccount` ayarlayın. +Birden fazla adlandırılmış hesap yapılandırıyorsanız, örtük hesap seçimine dayanan CLI komutları için `defaultAccount` ayarlayın veya `--account ` geçin. Bir komut için bu örtük seçimi geçersiz kılmak istediğinizde `openclaw matrix verify ...` ve `openclaw matrix devices ...` komutlarına `--account ` geçin. -## Özel/LAN homeserver'lar +## Özel/LAN homeserver'ları -Varsayılan olarak OpenClaw, siz -hesap başına açıkça izin vermediğiniz sürece SSRF koruması için özel/iç Matrix homeserver'larını engeller. +Varsayılan olarak OpenClaw, SSRF koruması nedeniyle özel/iç Matrix homeserver'larını engeller; siz +hesap başına açıkça izin verene kadar. -Homeserver'ınız localhost, bir LAN/Tailscale IP'si veya iç bir host adı üzerinde çalışıyorsa, +Homeserver'ınız localhost, bir LAN/Tailscale IP'si veya dahili bir ana makine adı üzerinde çalışıyorsa, o Matrix hesabı için `allowPrivateNetwork` etkinleştirin: ```json5 @@ -942,12 +950,12 @@ openclaw matrix account add \ --access-token syt_ops_xxx ``` -Bu isteğe bağlı etkinleştirme yalnızca güvenilir özel/iç hedeflere izin verir. `http://matrix.example.org:8008` gibi -genel düz metin homeserver'lar yine engellenir. Mümkün olduğunda `https://` tercih edin. +Bu açık katılım yalnızca güvenilen özel/iç hedeflere izin verir. Şunun gibi +genel açık metin homeserver'lar: `http://matrix.example.org:8008` yine engellenir. Mümkün olduğunda `https://` tercih edin. ## Matrix trafiğini proxy üzerinden yönlendirme -Matrix dağıtımınız açık bir giden HTTP(S) proxy gerektiriyorsa, `channels.matrix.proxy` ayarlayın: +Matrix dağıtımınız açık bir giden HTTP(S) proxy gerektiriyorsa `channels.matrix.proxy` ayarlayın: ```json5 { @@ -962,7 +970,7 @@ Matrix dağıtımınız açık bir giden HTTP(S) proxy gerektiriyorsa, `channels ``` Adlandırılmış hesaplar üst düzey varsayılanı `channels.matrix.accounts..proxy` ile geçersiz kılabilir. -OpenClaw aynı proxy ayarını çalışma zamanı Matrix trafiği ve hesap durumu yoklamaları için kullanır. +OpenClaw aynı proxy ayarını çalışma zamanı Matrix trafiği ve hesap durumu probe'ları için kullanır. ## Hedef çözümleme @@ -972,75 +980,76 @@ OpenClaw sizden bir oda veya kullanıcı hedefi istediğinde Matrix şu hedef bi - Odalar: `!room:server`, `room:!room:server` veya `matrix:room:!room:server` - Takma adlar: `#alias:server`, `channel:#alias:server` veya `matrix:channel:#alias:server` -Canlı dizin araması oturum açmış Matrix hesabını kullanır: +Canlı dizin araması giriş yapılmış Matrix hesabını kullanır: -- Kullanıcı aramaları o homeserver'daki Matrix kullanıcı dizinini sorgular. -- Oda aramaları açık oda kimliklerini ve takma adlarını doğrudan kabul eder, sonra bu hesap için katılınmış oda adlarını aramaya geri döner. -- Katılınmış oda adı araması en iyi çaba esaslıdır. Bir oda adı bir kimliğe veya takma ada çözümlenemezse, çalışma zamanı allowlist çözümlemesi tarafından yok sayılır. +- Kullanıcı aramaları, o homeserver'daki Matrix kullanıcı dizinini sorgular. +- Oda aramaları açık oda kimliklerini ve takma adları doğrudan kabul eder, sonra o hesap için katılınmış oda adlarında aramaya geri döner. +- Katılınmış oda adı araması en iyi çabadır. Bir oda adı bir kimliğe veya takma ada çözümlenemiyorsa, çalışma zamanındaki izin listesi çözümlemesi tarafından yok sayılır. ## Yapılandırma başvurusu - `enabled`: kanalı etkinleştirir veya devre dışı bırakır. - `name`: hesap için isteğe bağlı etiket. - `defaultAccount`: birden fazla Matrix hesabı yapılandırıldığında tercih edilen hesap kimliği. -- `homeserver`: homeserver URL'si; örneğin `https://matrix.example.org`. -- `allowPrivateNetwork`: bu Matrix hesabının özel/iç homeserver'lara bağlanmasına izin verir. Homeserver `localhost`, bir LAN/Tailscale IP'si veya `matrix-synapse` gibi iç bir host'a çözülüyorsa bunu etkinleştirin. -- `proxy`: Matrix trafiği için isteğe bağlı HTTP(S) proxy URL'si. Adlandırılmış hesaplar üst düzey varsayılanı kendi `proxy` değerleriyle geçersiz kılabilir. -- `userId`: tam Matrix kullanıcı kimliği; örneğin `@bot:example.org`. -- `accessToken`: token tabanlı kimlik doğrulama için access token. `channels.matrix.accessToken` ve `channels.matrix.accounts..accessToken` için env/file/exec sağlayıcılarında düz metin değerleri ve SecretRef değerleri desteklenir. Bkz. [Secrets Management](/tr/gateway/secrets). -- `password`: parola tabanlı giriş için parola. Düz metin değerleri ve SecretRef değerleri desteklenir. +- `homeserver`: homeserver URL'si, örneğin `https://matrix.example.org`. +- `allowPrivateNetwork`: bu Matrix hesabının özel/iç homeserver'lara bağlanmasına izin verir. Homeserver `localhost`, bir LAN/Tailscale IP'si veya `matrix-synapse` gibi dahili bir ana makine adına çözülüyorsa bunu etkinleştirin. +- `proxy`: Matrix trafiği için isteğe bağlı HTTP(S) proxy URL'si. Adlandırılmış hesaplar üst düzey varsayılanı kendi `proxy` ayarlarıyla geçersiz kılabilir. +- `userId`: tam Matrix kullanıcı kimliği, örneğin `@bot:example.org`. +- `accessToken`: belirteç tabanlı kimlik doğrulama için erişim belirteci. Düz metin değerler ve SecretRef değerleri, env/file/exec sağlayıcıları genelinde `channels.matrix.accessToken` ve `channels.matrix.accounts..accessToken` için desteklenir. Bkz. [Gizli Bilgi Yönetimi](/tr/gateway/secrets). +- `password`: parola tabanlı giriş için parola. Düz metin değerler ve SecretRef değerleri desteklenir. - `deviceId`: açık Matrix cihaz kimliği. -- `deviceName`: parola girişi için cihaz görünen adı. -- `avatarUrl`: profil eşitlemesi ve `set-profile` güncellemeleri için saklanan öz-avatar URL'si. +- `deviceName`: parola ile giriş için cihaz görünen adı. +- `avatarUrl`: profil senkronizasyonu ve `set-profile` güncellemeleri için saklanan öz-avatar URL'si. - `initialSyncLimit`: başlangıç sync olay sınırı. - `encryption`: E2EE'yi etkinleştirir. -- `allowlistOnly`: DM'ler ve odalar için yalnızca allowlist davranışını zorlar. -- `allowBots`: yapılandırılmış diğer OpenClaw Matrix hesaplarından gelen iletilere izin verir (`true` veya `"mentions"`). +- `allowlistOnly`: DM'ler ve odalar için yalnızca izin listesi davranışını zorlar. +- `allowBots`: yapılandırılmış diğer OpenClaw Matrix hesaplarından gelen mesajlara izin verir (`true` veya `"mentions"`). - `groupPolicy`: `open`, `allowlist` veya `disabled`. - `contextVisibility`: ek oda bağlamı görünürlük modu (`all`, `allowlist`, `allowlist_quote`). -- `groupAllowFrom`: oda trafiği için kullanıcı kimlikleri allowlist'i. -- `groupAllowFrom` girdileri tam Matrix kullanıcı kimlikleri olmalıdır. Çözümlenmemiş adlar çalışma zamanında yok sayılır. -- `historyLimit`: grup geçmiş bağlamı olarak dahil edilecek en fazla oda iletisi sayısı. `messages.groupChat.historyLimit` değerine geri döner. Devre dışı bırakmak için `0` ayarlayın. +- `groupAllowFrom`: oda trafiği için kullanıcı kimliği izin listesi. +- `groupAllowFrom` girdileri tam Matrix kullanıcı kimlikleri olmalıdır. Çözümlenmeyen adlar çalışma zamanında yok sayılır. +- `historyLimit`: grup geçmişi bağlamı olarak dahil edilecek azami oda mesajı sayısı. `messages.groupChat.historyLimit` değerine geri döner; her ikisi de ayarlanmamışsa etkin varsayılan `0` olur. Devre dışı bırakmak için `0` ayarlayın. - `replyToMode`: `off`, `first` veya `all`. - `markdown`: giden Matrix metni için isteğe bağlı Markdown işleme yapılandırması. -- `streaming`: `off` (varsayılan), `partial`, `quiet`, `true` veya `false`. `partial` ve `true`, normal Matrix metin iletileriyle önizleme-öncelikli taslak güncellemelerini etkinleştirir. `quiet`, self-hosted push-kuralı kurulumları için bildirim vermeyen önizleme bildirimlerini kullanır. -- `blockStreaming`: `true`, taslak önizleme akışı etkin olduğunda tamamlanmış asistan blokları için ayrı ilerleme iletilerini etkinleştirir. +- `streaming`: `off` (varsayılan), `partial`, `quiet`, `true` veya `false`. `partial` ve `true`, normal Matrix metin mesajları ile önizleme-öncelikli taslak güncellemelerini etkinleştirir. `quiet`, self-hosted push-rule kurulumları için bildirim vermeyen önizleme bildirimleri kullanır. +- `blockStreaming`: `true`, taslak önizleme akışı etkinken tamamlanmış asistan blokları için ayrı ilerleme mesajlarını etkinleştirir. - `threadReplies`: `off`, `inbound` veya `always`. - `threadBindings`: ileti dizisine bağlı oturum yönlendirmesi ve yaşam döngüsü için kanal başına geçersiz kılmalar. -- `startupVerification`: başlangıçta otomatik öz-doğrulama istek modu (`if-unverified`, `off`). -- `startupVerificationCooldownHours`: otomatik başlangıç doğrulama istekleri yeniden denenmeden önce bekleme süresi. -- `textChunkLimit`: giden ileti parça boyutu. +- `startupVerification`: başlangıçta otomatik self-verification istek modu (`if-unverified`, `off`). +- `startupVerificationCooldownHours`: otomatik başlangıç doğrulama isteklerini yeniden denemeden önce bekleme süresi. +- `textChunkLimit`: giden mesaj parça boyutu. - `chunkMode`: `length` veya `newline`. -- `responsePrefix`: giden yanıtlar için isteğe bağlı ileti öneki. -- `ackReaction`: bu kanal/hesap için isteğe bağlı onay tepkisi geçersiz kılması. -- `ackReactionScope`: isteğe bağlı onay tepkisi kapsamı geçersiz kılması (`group-mentions`, `group-all`, `direct`, `all`, `none`, `off`). +- `responsePrefix`: giden yanıtlar için isteğe bağlı mesaj öneki. +- `ackReaction`: bu kanal/hesap için isteğe bağlı ack tepki geçersiz kılması. +- `ackReactionScope`: isteğe bağlı ack tepki kapsamı geçersiz kılması (`group-mentions`, `group-all`, `direct`, `all`, `none`, `off`). - `reactionNotifications`: gelen tepki bildirim modu (`own`, `off`). -- `mediaMaxMb`: Matrix medya işleme için MB cinsinden medya boyut sınırı. Giden gönderimlere ve gelen medya işlemeye uygulanır. -- `autoJoin`: davete otomatik katılma politikası (`always`, `allowlist`, `off`). Varsayılan: `off`. -- `autoJoinAllowlist`: `autoJoin` değeri `allowlist` olduğunda izin verilen odalar/takma adlar. Takma ad girdileri davet işleme sırasında oda kimliklerine çözülür; OpenClaw davet edilen oda tarafından iddia edilen takma ad durumuna güvenmez. +- `mediaMaxMb`: Matrix medya işleme için MB cinsinden medya boyutu sınırı. Bu ayar giden gönderimlere ve gelen medya işlemeye uygulanır. +- `autoJoin`: davet otomatik katılma politikası (`always`, `allowlist`, `off`). Varsayılan: `off`. Bu ayar yalnızca oda/grup davetleri değil, DM tarzı davetler dahil genel Matrix davetleri için geçerlidir. OpenClaw bu kararı davet anında, katılınan odanın DM mi yoksa grup mu olarak sınıflandırılacağını henüz güvenilir şekilde belirleyemeden önce verir. +- `autoJoinAllowlist`: `autoJoin` değeri `allowlist` olduğunda izin verilen odalar/takma adlar. Takma ad girdileri davet işleme sırasında oda kimliklerine çözülür; OpenClaw davet edilen odanın iddia ettiği takma ad durumuna güvenmez. - `dm`: DM politika bloğu (`enabled`, `policy`, `allowFrom`, `sessionScope`, `threadReplies`). -- `dm.allowFrom` girdileri, onları canlı dizin aramasıyla zaten çözümlemediyseniz tam Matrix kullanıcı kimlikleri olmalıdır. -- `dm.sessionScope`: `per-user` (varsayılan) veya `per-room`. Aynı eş olsa bile her Matrix DM odasının ayrı bağlam tutmasını istiyorsanız `per-room` kullanın. -- `dm.threadReplies`: yalnızca DM için ileti dizisi politikası geçersiz kılması (`off`, `inbound`, `always`). Hem yanıt yerleşimi hem de DM'lerde oturum yalıtımı için üst düzey `threadReplies` ayarını geçersiz kılar. +- `dm.policy`: OpenClaw odaya katıldıktan ve onu DM olarak sınıflandırdıktan sonraki DM erişimini kontrol eder. Bir davetin otomatik katılıp katılmayacağını değiştirmez. +- `dm.allowFrom` girdileri, siz bunları canlı dizin aramasıyla zaten çözümlemediyseniz tam Matrix kullanıcı kimlikleri olmalıdır. +- `dm.sessionScope`: `per-user` (varsayılan) veya `per-room`. Eş aynı olsa bile her Matrix DM odasının ayrı bağlam tutmasını istiyorsanız `per-room` kullanın. +- `dm.threadReplies`: yalnızca DM'ler için ileti dizisi politikası geçersiz kılması (`off`, `inbound`, `always`). Bu ayar hem yanıt yerleşimi hem de DM'lerdeki oturum yalıtımı için üst düzey `threadReplies` ayarını geçersiz kılar. - `execApprovals`: Matrix yerel exec onay teslimi (`enabled`, `approvers`, `target`, `agentFilter`, `sessionFilter`). -- `execApprovals.approvers`: exec isteklerini onaylamasına izin verilen Matrix kullanıcı kimlikleri. `dm.allowFrom` zaten onaylayıcıları belirliyorsa isteğe bağlıdır. +- `execApprovals.approvers`: exec isteklerini onaylamaya izin verilen Matrix kullanıcı kimlikleri. `dm.allowFrom` zaten onaylayıcıları tanımlıyorsa isteğe bağlıdır. - `execApprovals.target`: `dm | channel | both` (varsayılan: `dm`). - `accounts`: adlandırılmış hesap başına geçersiz kılmalar. Üst düzey `channels.matrix` değerleri bu girdiler için varsayılan görevi görür. -- `groups`: oda başına politika eşlemesi. Oda kimliklerini veya takma adları tercih edin; çözümlenmemiş oda adları çalışma zamanında yok sayılır. Çözümleme sonrası oturum/grup kimliği kararlı oda kimliğini kullanırken, insan tarafından okunabilir etiketler yine oda adlarından gelir. -- `groups..account`: çoklu hesap kurulumlarında bir devralınan oda girdisini belirli bir Matrix hesabıyla sınırlar. +- `groups`: oda başına politika eşlemesi. Oda kimliklerini veya takma adları tercih edin; çözümlenmeyen oda adları çalışma zamanında yok sayılır. Çözümleme sonrasında oturum/grup kimliği kararlı oda kimliğini kullanır, insan tarafından okunabilir etiketler ise yine oda adlarından gelir. +- `groups..account`: çoklu hesap kurulumlarında devralınan tek bir oda girdisini belirli bir Matrix hesabıyla sınırlar. - `groups..allowBots`: yapılandırılmış bot gönderenleri için oda düzeyi geçersiz kılma (`true` veya `"mentions"`). -- `groups..users`: oda başına gönderen allowlist'i. +- `groups..users`: oda başına gönderen izin listesi. - `groups..tools`: oda başına araç izin/verme veya reddetme geçersiz kılmaları. -- `groups..autoReply`: oda düzeyi mention kapılama geçersiz kılması. `true`, o oda için mention gereksinimlerini devre dışı bırakır; `false` bunları yeniden zorlar. -- `groups..skills`: isteğe bağlı oda düzeyi skill filtresi. -- `groups..systemPrompt`: isteğe bağlı oda düzeyi system prompt parçası. +- `groups..autoReply`: oda düzeyi mention-gating geçersiz kılması. `true`, o oda için mention gereksinimlerini devre dışı bırakır; `false`, onları yeniden zorunlu kılar. +- `groups..skills`: isteğe bağlı oda düzeyi Skills filtresi. +- `groups..systemPrompt`: isteğe bağlı oda düzeyi system prompt parçacığı. - `rooms`: `groups` için eski takma ad. -- `actions`: eylem başına araç kapılama (`messages`, `reactions`, `pins`, `profile`, `memberInfo`, `channelInfo`, `verification`). +- `actions`: eylem başına araç denetimi (`messages`, `reactions`, `pins`, `profile`, `memberInfo`, `channelInfo`, `verification`). ## İlgili -- [Channels Overview](/tr/channels) — desteklenen tüm kanallar -- [Pairing](/tr/channels/pairing) — DM kimlik doğrulaması ve eşleştirme akışı -- [Groups](/tr/channels/groups) — grup sohbeti davranışı ve mention kapılama -- [Channel Routing](/tr/channels/channel-routing) — iletiler için oturum yönlendirmesi -- [Security](/tr/gateway/security) — erişim modeli ve sağlamlaştırma +- [Kanallara Genel Bakış](/tr/channels) — desteklenen tüm kanallar +- [Eşleştirme](/tr/channels/pairing) — DM kimlik doğrulaması ve eşleştirme akışı +- [Gruplar](/tr/channels/groups) — grup sohbeti davranışı ve mention-gating +- [Kanal Yönlendirme](/tr/channels/channel-routing) — mesajlar için oturum yönlendirmesi +- [Güvenlik](/tr/gateway/security) — erişim modeli ve sağlamlaştırma diff --git a/docs/tr/channels/slack.md b/docs/tr/channels/slack.md index 007201f50..89fa59acf 100644 --- a/docs/tr/channels/slack.md +++ b/docs/tr/channels/slack.md @@ -1,30 +1,30 @@ --- read_when: - - Slack kurulurken veya Slack socket/HTTP modunda hata ayıklarken -summary: Slack kurulumu ve çalışma zamanı davranışı (Socket Mode + HTTP Events API) + - Slack kurarken veya Slack socket/HTTP modunda hata ayıklarken +summary: Slack kurulumu ve çalışma zamanı davranışı (Socket Mode + HTTP Request URL'leri) title: Slack x-i18n: - generated_at: "2026-04-06T03:07:21Z" + generated_at: "2026-04-06T08:50:09Z" model: gpt-5.4 provider: openai - source_hash: 7e4ff2ce7d92276d62f4f3d3693ddb56ca163d5fdc2f1082ff7ba3421fada69c + source_hash: 897001c13d400cc8387a27000b82dd4c0512b2b88e2fe47785634aed8b7ab7af 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 Events API modu da desteklenir. +Durum: Slack uygulama entegrasyonları üzerinden DM'ler ve kanallar için üretime hazır. Varsayılan mod Socket Mode'dur; HTTP Request URL'leri de desteklenir. - - Slack DM'leri varsayılan olarak eşleme modunu kullanır. + + Slack DM'leri varsayılan olarak eşleştirme modunu kullanır. Yerel komut davranışı ve komut kataloğu. - Kanallar arası tanılama ve onarım çalışma kitapları. + Kanallar arası tanılama ve onarım kılavuzları. @@ -33,12 +33,12 @@ Durum: Slack uygulama entegrasyonları üzerinden DM'ler ve kanallar için üret - - Slack uygulaması ayarlarında: + + Slack uygulama ayarlarında: - - **Socket Mode**'u etkinleştirin + - **Socket Mode** etkinleştirin - `connections:write` ile **App Token** (`xapp-...`) oluşturun - - uygulamayı yükleyin ve **Bot Token**'ı (`xoxb-...`) kopyalayın + - uygulamayı yükleyin ve **Bot Token** (`xoxb-...`) kopyalayın @@ -65,8 +65,8 @@ SLACK_BOT_TOKEN=xoxb-... - - Şunlar için bot etkinliklerine abone olun: + + Şunlar için bot olaylarına abone olun: - `app_mention` - `message.channels`, `message.groups`, `message.im`, `message.mpim` @@ -75,7 +75,7 @@ SLACK_BOT_TOKEN=xoxb-... - `channel_rename` - `pin_added`, `pin_removed` - DM'ler için ayrıca App Home **Messages Tab**'ı etkinleştirin. + Ayrıca DM'ler için App Home **Messages Tab** özelliğini etkinleştirin. @@ -89,13 +89,13 @@ openclaw gateway - + - modu HTTP olarak ayarlayın (`channels.slack.mode="http"`) - - Slack **Signing Secret**'ını kopyalayın - - Event Subscriptions + Interactivity + Slash command Request URL'yi aynı webhook yoluna ayarlayın (varsayılan `/slack/events`) + - Slack **Signing Secret** değerini kopyalayın + - Event Subscriptions + Interactivity + Slash command Request URL değerini aynı webhook yoluna ayarlayın (varsayılan `/slack/events`) @@ -117,10 +117,10 @@ openclaw gateway - + Hesap başına HTTP modu desteklenir. - Kayıtların çakışmaması için her hesaba ayrı bir `webhookPath` verin. + Kayıtların çakışmaması için her hesaba farklı bir `webhookPath` verin. @@ -129,8 +129,8 @@ openclaw gateway ## Manifest ve kapsam denetim listesi - - + + ```json { @@ -205,8 +205,99 @@ openclaw gateway } ``` - + + + +```json +{ + "display_information": { + "name": "OpenClaw", + "description": "Slack connector for OpenClaw" + }, + "features": { + "bot_user": { + "display_name": "OpenClaw", + "always_online": true + }, + "app_home": { + "messages_tab_enabled": true, + "messages_tab_read_only_enabled": false + }, + "slash_commands": [ + { + "command": "/openclaw", + "description": "Send a message to OpenClaw", + "should_escape": false, + "url": "https://gateway-host.example.com/slack/events" + } + ] + }, + "oauth_config": { + "scopes": { + "bot": [ + "app_mentions:read", + "assistant:write", + "channels:history", + "channels:read", + "chat:write", + "commands", + "emoji:read", + "files:read", + "files:write", + "groups:history", + "groups:read", + "im:history", + "im:read", + "im:write", + "mpim:history", + "mpim:read", + "mpim:write", + "pins:read", + "pins:write", + "reactions:read", + "reactions:write", + "users:read" + ] + } + }, + "settings": { + "event_subscriptions": { + "request_url": "https://gateway-host.example.com/slack/events", + "bot_events": [ + "app_mention", + "channel_rename", + "member_joined_channel", + "member_left_channel", + "message.channels", + "message.groups", + "message.im", + "message.mpim", + "pin_added", + "pin_removed", + "reaction_added", + "reaction_removed" + ] + }, + "interactivity": { + "is_enabled": true, + "request_url": "https://gateway-host.example.com/slack/events", + "message_menu_options_url": "https://gateway-host.example.com/slack/events" + } + } +} +``` + + + + + + + Giden mesajların varsayılan Slack uygulaması kimliği yerine etkin ajan kimliğini (özel kullanıcı adı ve simge) kullanmasını istiyorsanız `chat:write.customize` bot kapsamını ekleyin. + + Bir emoji simgesi kullanıyorsanız Slack `:emoji_name:` söz dizimini bekler. + + `channels.slack.userToken` yapılandırırsanız, tipik okuma kapsamları şunlardır: @@ -216,7 +307,7 @@ openclaw gateway - `reactions:read` - `pins:read` - `emoji:read` - - `search:read` (Slack arama okumalarına bağlıysanız) + - `search:read` (Slack arama okumalarına bağımlıysanız) @@ -224,24 +315,23 @@ openclaw gateway ## Token modeli - Socket Mode için `botToken` + `appToken` gereklidir. -- HTTP modu için `botToken` + `signingSecret` gerekir. +- HTTP modu `botToken` + `signingSecret` gerektirir. - `botToken`, `appToken`, `signingSecret` ve `userToken`, düz metin dizelerini veya SecretRef nesnelerini kabul eder. -- Yapılandırma token'ları, ortam değişkeni yedeğinin önüne geçer. +- Yapılandırma token'ları ortam değişkeni yedeğinin önüne geçer. - `SLACK_BOT_TOKEN` / `SLACK_APP_TOKEN` ortam değişkeni yedeği yalnızca varsayılan hesap için geçerlidir. -- `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`). -- İsteğe bağlı: giden mesajların etkin ajan kimliğini kullanmasını istiyorsanız `chat:write.customize` ekleyin (özel `username` ve simge). `icon_emoji`, `:emoji_name:` sözdizimini kullanı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`). Durum anlık görüntüsü davranışı: - Slack hesap incelemesi, kimlik bilgisi başına `*Source` ve `*Status` - alanlarını izler (`botToken`, `appToken`, `signingSecret`, `userToken`). + alanlarını (`botToken`, `appToken`, `signingSecret`, `userToken`) izler. - Durum `available`, `configured_unavailable` veya `missing` olur. - `configured_unavailable`, hesabın SecretRef - veya başka bir satır içi olmayan gizli kaynak üzerinden yapılandırıldığı, + 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 - gerekli ikili `botTokenStatus` + `appTokenStatus` olur. +- HTTP modunda `signingSecretStatus` eklenir; Socket Mode'da gerekli + ikili `botTokenStatus` + `appTokenStatus` olur. Eylemler/dizin okumaları için, yapılandırılmışsa kullanıcı token'ı tercih edilebilir. Yazma işlemleri için bot token'ı tercih edilmeye devam eder; kullanıcı token'ı ile yazmaya yalnızca `userTokenReadOnly: false` olduğunda ve bot token'ı kullanılamadığında izin verilir. @@ -249,7 +339,7 @@ Eylemler/dizin okumaları için, yapılandırılmışsa kullanıcı token'ı ter ## Eylemler ve geçitler -Slack eylemleri `channels.slack.actions.*` tarafından kontrol edilir. +Slack eylemleri `channels.slack.actions.*` tarafından denetlenir. Mevcut Slack araçlarında kullanılabilen eylem grupları: @@ -261,17 +351,17 @@ Mevcut Slack araçlarında kullanılabilen eylem grupları: | memberInfo | etkin | | emojiList | etkin | -Mevcut Slack mesaj eylemleri arasında `send`, `upload-file`, `download-file`, `read`, `edit`, `delete`, `pin`, `unpin`, `list-pins`, `member-info` ve `emoji-list` bulunur. +Mevcut Slack mesaj eylemleri `send`, `upload-file`, `download-file`, `read`, `edit`, `delete`, `pin`, `unpin`, `list-pins`, `member-info` ve `emoji-list` öğelerini içerir. ## 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çine `"*"` eklenmesini gerektirir; eski: `channels.slack.dm.allowFrom`) + - `open` (`channels.slack.allowFrom` içinde `"*"` bulunmasını gerektirir; eski: `channels.slack.dm.allowFrom`) - `disabled` DM bayrakları: @@ -282,18 +372,18 @@ Mevcut Slack mesaj eylemleri arasında `send`, `upload-file`, `download-file`, ` - `dm.groupEnabled` (grup DM'leri varsayılan olarak false) - `dm.groupChannels` (isteğe bağlı MPIM izin listesi) - Çok hesaplı öncelik: + Çoklu hesap önceliği: - `channels.slack.accounts.default.allowFrom` yalnızca `default` hesabına uygulanır. - - Adlandırılmış hesaplar, kendi `allowFrom` alanları ayarlı değilse `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şleme için `openclaw pairing approve slack ` kullanılır. + DM'lerde eşleştirme `openclaw pairing approve slack ` kullanır. - `channels.slack.groupPolicy`, kanal işlemeyi kontrol eder: + `channels.slack.groupPolicy`, kanal işlemesini denetler: - `open` - `allowlist` @@ -301,26 +391,26 @@ Mevcut Slack mesaj eylemleri arasında `send`, `upload-file`, `download-file`, ` Kanal izin listesi `channels.slack.channels` altında bulunur ve kararlı kanal kimliklerini kullanmalıdır. - Çalışma zamanı notu: `channels.slack` tamamen eksikse (yalnızca ortam değişkeni kurulumu), ç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 eksikse (yalnızca ortam değişkeni kurulumu), çalışma zamanı `groupPolicy="allowlist"` değerine geri döner ve bir uyarı günlüğe kaydeder (`channels.defaults.groupPolicy` ayarlanmış olsa bile). Ad/kimlik çözümleme: - - kanal izin listesi girdileri ve DM izin listesi girdileri, token erişimi izin verdiğinde başlangıçta çözülür + - kanal izin listesi girdileri ve DM izin listesi girdileri, token erişimi izin verdiğinde başlangıçta çözümlenir - çö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 temellidir; doğrudan kullanıcı adı/slug eşleştirmesi için `channels.slack.dangerouslyAllowNameMatching: true` gerekir + - gelen yetkilendirme ve kanal yönlendirme varsayılan olarak önce kimlik ile yapılır; doğrudan kullanıcı adı/slug eşleştirmesi için `channels.slack.dangerouslyAllowNameMatching: true` gerekir - Kanal mesajları varsayılan olarak bahsetme ile kapılanır. + Kanal mesajları varsayılan olarak bahsetme ile geçitlenir. Bahsetme kaynakları: - açık uygulama bahsetmesi (`<@botId>`) - - bahsetme regex kalıpları (`agents.list[].groupChat.mentionPatterns`, yedek olarak `messages.groupChat.mentionPatterns`) - - bota yanıt verilen iş parçacığındaki örtük davranış + - bahsetme regex desenleri (`agents.list[].groupChat.mentionPatterns`, geri dönüş olarak `messages.groupChat.mentionPatterns`) + - örtük bottan-yanıta iş parçacığı davranışı - Kanal başına denetimler (`channels.slack.channels.`; adlar yalnızca başlangıç çözümlemesi veya `dangerouslyAllowNameMatching` yoluyla): + Kanal başına denetimler (`channels.slack.channels.`; adlar yalnızca başlangıç çözümlemesi veya `dangerouslyAllowNameMatching` ile): - `requireMention` - `users` (izin listesi) @@ -328,35 +418,35 @@ Mevcut Slack mesaj eylemleri arasında `send`, `upload-file`, `download-file`, ` - `skills` - `systemPrompt` - `tools`, `toolsBySender` - - `toolsBySender` anahtar biçimi: `id:`, `e164:`, `username:`, `name:` veya `"*"` jokeri - (eski öneksiz anahtarlar yine yalnızca `id:` ile eşleşir) + - `toolsBySender` anahtar biçimi: `id:`, `e164:`, `username:`, `name:` veya `"*"` joker karakteri + (eski ön ek kullanılmayan anahtarlar hâlâ yalnızca `id:` olarak eşlenir) ## İş parçacıkları, oturumlar ve yanıt etiketleri -- DM'ler `direct` olarak, kanallar `channel` olarak, MPIM'ler `group` olarak yönlendirilir. -- Varsayılan `session.dmScope=main` ile Slack DM'leri ajan ana oturumunda birleştirilir. +- DM'ler `direct`, kanallar `channel`, MPIM'ler `group` olarak yönlendirilir. +- Varsayılan `session.dmScope=main` ile Slack DM'leri ajan ana oturumuna daraltılır. - Kanal oturumları: `agent::slack:channel:`. -- Uygun olduğunda iş parçacığı yanıtları iş parçacığı oturum son ekleri (`:thread:`) oluşturabilir. -- `channels.slack.thread.historyScope` varsayılan olarak `thread`; `thread.inheritParent` varsayılan olarak `false` değerindedir. -- `channels.slack.thread.initialHistoryLimit`, yeni bir iş parçacığı oturumu başladığında kaç mevcut iş parçacığı mesajının getirileceğini kontrol eder (varsayılan `20`; devre dışı bırakmak için `0` ayarlayın). +- İş parçacığı yanıtları, gerektiğinde iş parçacığı oturum son ekleri (`:thread:`) oluşturabilir. +- `channels.slack.thread.historyScope` varsayılan olarak `thread`; `thread.inheritParent` varsayılan olarak `false` olur. +- `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). 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` -El ile yanıt etiketleri desteklenir: +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 iş parçacıklarını devre dışı bırakır. Bu, açık etiketlerin `"off"` modunda yine de uygulandığı Telegram'dan farklıdır. 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. +Not: `replyToMode="off"`, açık `[[reply_to_*]]` etiketleri dahil Slack'teki **tüm** yanıt iş parçacıklarını devre dışı bırakır. Bu durum, açık etiketlerin `"off"` modunda hâlâ dikkate alındığı Telegram'dan farklıdır. 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. @@ -365,29 +455,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`, aksi halde "👀") +- ajan kimliği emoji geri dönüşü (`agents.list[].identity.emoji`, aksi halde "👀") Notlar: -- Slack kısa kodlar bekler (örneğin `"eyes"`). -- Slack hesabı için veya genel olarak reaksiyonu devre dışı bırakmak amacıyla `""` kullanın. +- Slack kısa kod bekler (örneğin `"eyes"`). +- Slack hesabı için veya genel olarak reaksiyonu devre dışı bırakmak üzere `""` 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ı ile değiştirir. -- `block`: parçalı önizleme güncellemelerini ekler. +- `block`: parça parça önizleme güncellemeleri ekler. - `progress`: oluşturma sırasında ilerleme durum metni gösterir, ardından son metni gönderir. -`channels.slack.nativeStreaming`, `streaming` `partial` olduğunda Slack yerel metin akışını kontrol eder (varsayılan: `true`). +`channels.slack.nativeStreaming`, `streaming` değeri `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 iş parçacığı mevcut olmalıdır. İş parçacığı seçimi yine `replyToMode` değerini izler. Bu olmadan normal taslak önizleme kullanılır. +- Yerel metin akışının görünmesi için bir yanıt iş parçacığının kullanılabilir olması gerekir. İş parçacığı seçimi yine `replyToMode` kurallarını izler. Bu olmadan 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. +- Akış yanıtın ortasında başarısız olursa OpenClaw, kalan yükler için normal teslimata geri döner. -Slack yerel metin akışı yerine taslak önizlemeyi kullanın: +Slack yerel metin akışı yerine taslak önizleme kullanın: ```json5 { @@ -402,12 +492,12 @@ Slack yerel metin akışı yerine taslak önizlemeyi kullanın: Eski anahtarlar: -- `channels.slack.streamMode` (`replace | status_final | append`) otomatik olarak `channels.slack.streaming` alanına geçirilir. -- boolean `channels.slack.streaming`, otomatik olarak `channels.slack.nativeStreaming` alanına geçirilir. +- `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. -## Yazıyor reaksiyonu yedeği +## Yazma reaksiyonu geri dönüşü -`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 özellikle, varsayılan bir "is typing..." durum göstergesi kullanan iş parçacığı yanıtlarının 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 özellikle varsayılan "is typing..." durum göstergesini kullanan iş parçacığı yanıtları dışında yararlıdır. Çözümleme sırası: @@ -416,24 +506,24 @@ Eski anahtarlar: Notlar: -- Slack kısa kodlar bekler (örneğin `"hourglass_flowing_sand"`). -- Reaksiyon en iyi çaba esasına göredir ve yanıt veya hata yolu tamamlandıktan sonra temizleme işlemi otomatik olarak denenir. +- Slack kısa kod bekler (örneğin `"hourglass_flowing_sand"`). +- Reaksiyon en iyi çaba esaslıdır ve yanıt veya hata yolu tamamlandıktan sonra temizleme otomatik olarak denenir. -## Medya, parçalama ve teslimat +## Medya, parçalara ayırma ve teslimat - Slack dosya ekleri, Slack tarafından barındırılan özel URL'lerden indirilir (token ile kimliği doğrulanmış istek akışı) ve getirme 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 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. - Gelen çalışma zamanı boyut üst sınırı, `channels.slack.mediaMaxMb` ile geçersiz kılınmadıkça varsayılan olarak `20MB`'dır. + Ç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 iş parçacığı yanıtlarını içerebilir (`thread_ts`) - - 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ındaki MIME türü varsayılanlarını kullanır + - `channels.slack.chunkMode="newline"` paragraf öncelikli bölmeyi etkinleştirir + - 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 @@ -442,26 +532,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 yapılırken Slack konuşma API'leri üzerinden açılır. ## Komutlar ve slash davranışı -- Slack için yerel komut otomatik modu **kapalıdır** (`commands.native: "auto"` Slack yerel komutlarını etkinleştirmez). -- Yerel Slack komut işleyicilerini `channels.slack.commands.native: true` ile etkinleştirin (veya genel `commands.native: true`). -- Yerel komutlar etkinleştirildiğinde, Slack'te eşleşen slash komutlarını (`/` adları) kaydedin; tek istisna şudur: - - durum komutu için `/agentstatus` kaydedin (Slack `/status` komutunu ayırmıştır) +- 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, bir istisna dışında Slack'te eşleşen slash komutlarını (`/` adları) kaydedin: + - durum komutu için `/agentstatus` kaydedin (Slack `/status` komutunu ayırır) - Yerel komutlar etkin değilse, `channels.slack.slashCommand` üzerinden tek bir yapılandırılmış slash komutu çalıştırabilirsiniz. -- Yerel arg menüleri artık işleme stratejilerini uyarlıyor: - - 5 seçeneğe kadar: düğme blokları +- Yerel argüman menüleri artık işleme stratejilerini uyarlıyor: + - en fazla 5 seçenek: 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 + - 100'den fazla seçenek: etkileşim seçenek işleyicileri kullanılabiliyorsa eşzamansız seçenek filtreleme ile 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 komut argüman menüleri, seçilen bir değeri göndermeden önce bir onay iletişim kutusu kullanır. +- Uzun seçenek yüklerinde, Slash komutu argüman menüleri seçilen bir değeri göndermeden önce onay iletişim kutusu kullanır. -Varsayılan slash komut ayarları: +Varsayılan slash komutu ayarları: - `enabled: false` - `name: "openclaw"` @@ -472,11 +562,11 @@ Slash oturumları yalıtılmış anahtarlar kullanır: - `agent::slack:slash:` -ve yine de komut yürütmesini hedef konuşma oturumuna karşı yönlendirir (`CommandTargetSessionKey`). +ve yine de komut yürütmesini hedef konuşma oturumuna (`CommandTargetSessionKey`) karşı yönlendirir. ## Etkileşimli yanıtlar -Slack, ajan tarafından oluşturulan 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 işleyebilir, ancak bu özellik varsayılan olarak devre dışıdır. Bunu genel olarak etkinleştirin: @@ -492,7 +582,7 @@ Bunu genel olarak etkinleştirin: } ``` -Veya yalnızca bir Slack hesabı için etkinleştirin: +Veya bunu yalnızca bir Slack hesabı için etkinleştirin: ```json5 { @@ -510,31 +600,30 @@ 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 özel yanıt yönergeleri verebilir: - `[[slack_buttons: Approve:approve, Reject:reject]]` - `[[slack_select: Choose a target | Canary:canary, Production:production]]` -Bu yönergeler Slack Block Kit'e derlenir ve tıklamaları veya seçimleri mevcut Slack etkileşim etkinliği yolu üzerinden geri yönlendirir. +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. 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ğırma değerleri, ajanın doğrudan yazdığı ham değerler değil, OpenClaw tarafından üretilen opak token'lardır. -- Oluşturulan 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 geri çağırım değerleri, ajan tarafından yazılmış ham değerler değil, OpenClaw tarafından oluşturulan opak token'lardır. +- Oluşturulan 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. ## 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 davranabilir. +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 çözülebilir. -- Onaylayan yetkilendirmesi yine uygulanır: yalnızca onaylayıcı olarak tanımlanan kullanıcılar istekleri Slack üzerinden onaylayabilir veya reddedebilir. +- İstek zaten Slack'e ulaşıyorsa ve onay kimliği türü `plugin:` ise eklenti onayları yine aynı Slack yerel düğme yüzeyi üzerinden çözülebilir. +- Onaylayıcı yetkilendirmesi yine uygulanır: yalnızca onaylayıcı olarak tanımlanan kullanıcılar istekleri Slack üzerinden onaylayabilir veya reddedebilir. -Bu, diğer kanallarla aynı paylaşılan onay düğmesi yüzeyini kullanır. Slack uygulama ayarlarınızda `interactivity` etkin olduğunda, 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 bunlardır; OpenClaw -yalnızca araç sonucu sohbet -onaylarının kullanılamadığını söylediğinde veya tek yol el ile onay olduğunda manuel bir `/approve` komutu eklemelidir. +Bu, diğer kanallarla aynı paylaşılan onay düğmesi yüzeyini kullanır. Slack uygulaması ayarlarınızda `interactivity` etkin olduğunda onay istemleri doğrudan konuşmada Block Kit düğmeleri olarak işlenir. +Bu düğmeler mevcut olduğunda birincil onay kullanıcı deneyimi bunlardır; OpenClaw, +araç sonucu sohbet onaylarının kullanılamadığını veya tek yolun manuel onay olduğunu söylemedikçe yalnızca manuel bir `/approve` komutu içermelidir. Yapılandırma yolu: @@ -543,11 +632,11 @@ Yapılandırma yolu: - `channels.slack.execApprovals.target` (`dm` | `channel` | `both`, varsayılan: `dm`) - `agentFilter`, `sessionFilter` -Slack, `enabled` ayarlanmadığında veya `"auto"` olduğunda ve en az bir -onaylayıcı çözümlendiğinde 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. +`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 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 { @@ -558,7 +647,7 @@ 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, filtreler eklemek veya -kaynak sohbet teslimatını kullanmak istediğinizde gerekir: +köken sohbetine teslimatı seçmek istediğinizde gereklidir: ```json5 { @@ -574,23 +663,23 @@ kaynak sohbet teslimatını kullanmak istediğinizde gerekir: } ``` -Paylaşılan `approvals.exec` yönlendirmesi ayrıdır. Bunu yalnızca exec onay istemlerinin diğer sohbetlere veya açık bant dışı hedeflere de yönlendirilmesi gerektiğinde kullanın. Paylaşılan `approvals.plugin` yönlendirmesi de -ayrıdır; Slack yerel düğmeleri, bu istekler zaten -Slack'e ulaştığında eklenti onaylarını yine çözebilir. +Paylaşılan `approvals.exec` yönlendirmesi ayrıdır. Bunu yalnızca exec onay istemlerinin ayrıca +başka sohbetlere veya açık bant dışı hedeflere yönlendirilmesi gerektiğinde kullanın. Paylaşılan `approvals.plugin` yönlendirmesi de +ayrıdır; Slack yerel düğmeleri, bu istekler zaten Slack'e ulaştığında eklenti onaylarını yine çözebilir. -Aynı sohbette `/approve`, komutları zaten destekleyen Slack kanallarında ve DM'lerde de çalışır. Tam onay yönlendirme modeli için [Exec approvals](/tr/tools/exec-approvals) bölümüne bakın. +Aynı sohbet içinde `/approve`, komutları zaten destekleyen Slack kanallarında ve DM'lerinde de çalışır. Tam onay yönlendirme modeli için bkz. [Exec approvals](/tr/tools/exec-approvals). -## Etkinlikler ve operasyonel davranış +## Olaylar ve operasyonel davranış -- Mesaj düzenlemeleri/silmeleri/iş parçacığı yayınları sistem etkinliklerine eşlenir. -- Reaksiyon ekleme/kaldırma etkinlikleri sistem etkinliklerine eşlenir. -- Üye katılma/ayrılma, kanal oluşturma/yeniden adlandırma ve sabitleme ekleme/kaldırma etkinlikleri sistem etkinliklerine 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 konu/amaç meta verileri güvenilmeyen bağlam olarak değerlendirilir ve yönlendirme bağlamına enjekte edilebilir. -- İş parçacığı başlatıcısı ve ilk iş parçacığı geçmişi bağlam tohumu, 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 etkinlikleri üretir: +- Kanal konu/amaç meta verileri güvenilmeyen bağlam olarak değerlendirilir ve yönlendirme bağlamına eklenebilir. +- İş parçacığı başlatıcısı ve ilk iş parçacığı geçmişi bağlam tohumlaması, uygulanabildiğinde 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ı yayar: - blok eylemleri: seçilen değerler, etiketler, seçici değerleri ve `workflow_*` meta verileri - - yönlendirilmiş kanal meta verileri ve form girdileriyle modal `view_submission` ve `view_closed` etkinlikleri + - yönlendirilmiş kanal meta verileri ve form girdileri ile modal `view_submission` ve `view_closed` olayları ## Yapılandırma başvuru işaretçileri @@ -601,7 +690,7 @@ Birincil başvuru: 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` (acil durum; gerekmedikçe kapalı tutun) + - uyumluluk anahtarı: `dangerouslyAllowNameMatching` (son çare; gerekmedikçe kapalı tutun) - kanal erişimi: `groupPolicy`, `channels.*`, `channels.*.users`, `channels.*.requireMention` - iş parçacığı/geçmiş: `replyToMode`, `replyToModeByChatType`, `thread.*`, `historyLimit`, `dmHistoryLimit`, `dms.*.historyLimit` - teslimat: `textChunkLimit`, `chunkMode`, `mediaMaxMb`, `streaming`, `nativeStreaming` @@ -633,7 +722,7 @@ openclaw doctor - `channels.slack.dm.enabled` - `channels.slack.dmPolicy` (veya eski `channels.slack.dm.policy`) - - eşleme onayları / izin listesi girdileri + - eşleştirme onayları / izin listesi girdileri ```bash openclaw pairing list slack @@ -642,7 +731,7 @@ openclaw pairing list slack - Slack uygulama ayarlarında bot + uygulama token'larını ve Socket Mode etkinliğini doğrulayın. + Bot + uygulama token'larını ve Slack uygulama ayarlarında Socket Mode'un etkinleştirilmesini doğrulayın. `openclaw channels status --probe --json`, `botTokenStatus` veya `appTokenStatus: "configured_unavailable"` gösteriyorsa, Slack hesabı @@ -651,7 +740,7 @@ openclaw pairing list slack - + Şunları doğrulayın: - signing secret @@ -668,17 +757,17 @@ openclaw pairing list slack Şunlardan hangisini amaçladığınızı doğrulayın: - - Slack'te eşleşen slash komutları kaydedilmiş yerel komut modu (`channels.slack.commands.native: true`) - - veya tek slash komut modu (`channels.slack.slashCommand.enabled: true`) + - Slack'te eşleşen slash komutları kayıtlı olacak şekilde yerel komut modu (`channels.slack.commands.native: true`) + - veya tek slash komutu modu (`channels.slack.slashCommand.enabled: true`) - Ayrıca `commands.useAccessGroups` ve kanal/kullanıcı izin listelerini kontrol edin. + Ayrıca `commands.useAccessGroups` ile kanal/kullanıcı izin listelerini de kontrol edin. ## İlgili -- [Eşleme](/tr/channels/pairing) +- [Eşleştirme](/tr/channels/pairing) - [Gruplar](/tr/channels/groups) - [Güvenlik](/tr/gateway/security) - [Kanal yönlendirme](/tr/channels/channel-routing) diff --git a/docs/tr/concepts/dreaming.md b/docs/tr/concepts/dreaming.md index 94ebf871d..397127da2 100644 --- a/docs/tr/concepts/dreaming.md +++ b/docs/tr/concepts/dreaming.md @@ -1,15 +1,15 @@ --- read_when: - Bellek yükseltmenin otomatik olarak çalışmasını istiyorsunuz - - Her rüya görme evresinin ne yaptığını anlamak istiyorsunuz + - Her rüya görme aşamasının ne yaptığını anlamak istiyorsunuz - Pekiştirmeyi `MEMORY.md` dosyasını kirletmeden ayarlamak istiyorsunuz -summary: Hafif, derin ve REM evreleri ile Arka plan bellek pekiştirmesi ve bir Rüya Günlüğü +summary: Hafif, derin ve REM aşamaları ile bir Rüya Günlüğünü içeren arka plan bellek pekiştirmesi title: Rüya Görme (deneysel) x-i18n: - generated_at: "2026-04-06T03:06:18Z" + generated_at: "2026-04-06T08:49:09Z" model: gpt-5.4 provider: openai - source_hash: f27da718176bebf59fe8a80fddd4fb5b6d814ac5647f6c1e8344bcfb328db9de + source_hash: 36c4b1e70801d662090dc8ce20608c2f141c23cd7ce53c54e3dcf332c801fd4e source_path: concepts/dreaming.md workflow: 15 --- @@ -18,89 +18,89 @@ x-i18n: Rüya görme, `memory-core` içindeki arka plan bellek pekiştirme sistemidir. OpenClaw'ın güçlü kısa süreli sinyalleri kalıcı belleğe taşımasına yardımcı olurken -sürecin açıklanabilir ve gözden geçirilebilir kalmasını sağlar. +sürecin açıklanabilir ve incelenebilir kalmasını sağlar. Rüya görme **isteğe bağlıdır** ve varsayılan olarak devre dışıdır. -## Rüya görme ne yazar +## Rüya görme nereye yazar Rüya görme iki tür çıktı tutar: -- `memory/.dreams/` içinde **makine durumu** (geri çağırma deposu, evre sinyalleri, alım denetim noktaları, kilitler). -- `DREAMS.md` (veya mevcut `dreams.md`) içinde **insan tarafından okunabilir çıktı** ve `memory/dreaming//YYYY-MM-DD.md` altında isteğe bağlı evre raporu dosyaları. +- `memory/.dreams/` içinde **makine durumu** (hatırlama deposu, aşama sinyalleri, içe aktarma denetim noktaları, kilitler). +- `DREAMS.md` içinde (veya mevcut `dreams.md` içinde) **insan tarafından okunabilir çıktı** ve `memory/dreaming//YYYY-MM-DD.md` altındaki isteğe bağlı aşama raporu dosyaları. -Uzun vadeli yükseltme hâlâ yalnızca `MEMORY.md` dosyasına yazar. +Uzun vadeli yükseltme yine yalnızca `MEMORY.md` dosyasına yazar. -## Evre modeli +## Aşama modeli -Rüya görme üç iş birliği yapan evre kullanır: +Rüya görme üç işbirlikçi aşama kullanır: -| Evre | Amaç | Kalıcı yazım | +| Aşama | Amaç | Kalıcı yazma | | ----- | ----------------------------------------- | ----------------- | | Hafif | Son kısa süreli materyali sıralamak ve hazırlamak | Hayır | | Derin | Kalıcı adayları puanlamak ve yükseltmek | Evet (`MEMORY.md`) | | REM | Temalar ve tekrarlayan fikirler üzerine düşünmek | Hayır | -Bu evreler, ayrı kullanıcı yapılandırmalı -"kipler" değil, dahili uygulama ayrıntılarıdır. +Bu aşamalar, ayrı kullanıcı tarafından yapılandırılan +"modlar" değil, dahili uygulama ayrıntılarıdır. -### Hafif evre +### Hafif aşama -Hafif evre son günlük bellek sinyallerini ve geri çağırma izlerini alır, bunları tekilleştirir +Hafif aşama, son günlük bellek sinyallerini ve hatırlama izlerini içe alır, bunları yinelenenlerden arındırır ve aday satırları hazırlar. -- Kısa süreli geri çağırma durumundan ve son günlük bellek dosyalarından okur. -- Depolama satır içi çıktı içerdiğinde yönetilen bir `## Hafif Uyku` bloğu yazar. -- Daha sonraki derin sıralama için pekiştirme sinyalleri kaydeder. +- Kısa süreli hatırlama durumundan ve son günlük bellek dosyalarından okur. +- Depolama satır içi çıktı içerdiğinde yönetilen bir `## Light Sleep` bloğu yazar. +- Daha sonraki derin sıralama için pekiştirme sinyallerini kaydeder. - Asla `MEMORY.md` dosyasına yazmaz. -### Derin evre +### Derin aşama -Derin evre, neyin uzun vadeli belleğe dönüşeceğine karar verir. +Derin aşama, neyin uzun vadeli belleğe dönüşeceğine karar verir. -- Adayları ağırlıklı puanlama ve eşik geçitleri kullanarak sıralar. -- `minScore`, `minRecallCount` ve `minUniqueQueries` değerlerinin geçilmesini gerektirir. -- Yazmadan önce parçaları canlı günlük dosyalardan yeniden yükler; böylece eski/silinmiş parçalar atlanır. +- Adayları ağırlıklı puanlama ve eşik kapıları kullanarak sıralar. +- Geçmek için `minScore`, `minRecallCount` ve `minUniqueQueries` gerektirir. +- Yazmadan önce parçacıkları canlı günlük dosyalardan yeniden yükler; bu nedenle eski/silinmiş parçacıklar atlanır. - Yükseltilen girdileri `MEMORY.md` dosyasına ekler. -- `DREAMS.md` içine bir `## Derin Uyku` özeti yazar ve isteğe bağlı olarak `memory/dreaming/deep/YYYY-MM-DD.md` dosyasını yazar. +- `DREAMS.md` içine bir `## Deep Sleep` özeti yazar ve isteğe bağlı olarak `memory/dreaming/deep/YYYY-MM-DD.md` dosyasını yazar. -### REM evresi +### REM aşaması -REM evresi örüntüleri ve düşünsel sinyalleri çıkarır. +REM aşaması kalıpları ve yansıtıcı sinyalleri çıkarır. -- Son kısa süreli izlerden tema ve düşünce özetleri oluşturur. -- Depolama satır içi çıktı içerdiğinde yönetilen bir `## REM Uykusu` bloğu yazar. +- Son kısa süreli izlerden tema ve düşünsel özetler oluşturur. +- Depolama satır içi çıktı içerdiğinde yönetilen bir `## REM Sleep` bloğu yazar. - Derin sıralamada kullanılan REM pekiştirme sinyallerini kaydeder. - Asla `MEMORY.md` dosyasına yazmaz. ## Rüya Günlüğü -Rüya görme ayrıca `DREAMS.md` içinde anlatısal bir **Rüya Günlüğü** tutar. -Her evre yeterli materyale sahip olduktan sonra `memory-core`, en iyi çaba esasına dayalı bir arka plan -alt aracısı turu çalıştırır (varsayılan çalışma zamanı modelini kullanarak) ve kısa bir günlük girdisi ekler. +Rüya görme ayrıca `DREAMS.md` içinde anlatı biçiminde bir **Rüya Günlüğü** tutar. +Her aşama yeterli materyale sahip olduktan sonra `memory-core`, en iyi çaba ilkesine dayalı bir arka plan +alt aracı turu çalıştırır (varsayılan çalışma zamanı modeli kullanılarak) ve kısa bir günlük girdisi ekler. -Bu günlük, yükseltme kaynağı değil, Dreams UI içinde insanlar tarafından okunmak içindir. +Bu günlük, yükseltme kaynağı değil, Dreams kullanıcı arayüzünde insan tarafından okunmak içindir. ## Derin sıralama sinyalleri -Derin sıralama, evre pekiştirmesine ek olarak ağırlıklı altı temel sinyal kullanır: +Derin sıralama, aşama pekiştirmesine ek olarak altı ağırlıklı temel sinyal kullanır: | Sinyal | Ağırlık | Açıklama | | ------------------- | ------ | ------------------------------------------------ | | Sıklık | 0.24 | Girdinin biriktirdiği kısa süreli sinyal sayısı | -| İlgililik | 0.30 | Girdi için ortalama geri getirme kalitesi | +| İlgililik | 0.30 | Girdi için ortalama alma kalitesi | | Sorgu çeşitliliği | 0.15 | Onu ortaya çıkaran farklı sorgu/gün bağlamları | | Yakınlık | 0.15 | Zamana göre azalan tazelik puanı | | Pekiştirme | 0.10 | Çok günlük tekrar gücü | -| Kavramsal zenginlik | 0.06 | Parça/yoldan gelen kavram etiketi yoğunluğu | +| Kavramsal zenginlik | 0.06 | Parçacık/yoldan kavram etiketi yoğunluğu | -Hafif ve REM evresi isabetleri, -`memory/.dreams/phase-signals.json` içinden zamana göre azalan küçük bir artış ekler. +Hafif ve REM aşaması isabetleri, +`memory/.dreams/phase-signals.json` içinden yakınlığa göre azalan küçük bir artış ekler. ## Zamanlama Etkinleştirildiğinde `memory-core`, tam bir rüya görme -taraması için tek bir cron işi otomatik olarak yönetir. Her tarama evreleri sırayla çalıştırır: hafif -> REM -> derin. +taraması için tek bir cron job'ı otomatik olarak yönetir. Her tarama aşamaları sırayla çalıştırır: hafif -> REM -> derin. Varsayılan sıklık davranışı: @@ -148,7 +148,7 @@ Rüya görmeyi etkinleştirin: } ``` -## Eğik çizgi komutu +## Slash komutu ``` /dreaming status @@ -159,7 +159,7 @@ Rüya görmeyi etkinleştirin: ## CLI iş akışı -Önizleme veya el ile uygulama için CLI yükseltmesini kullanın: +Önizleme veya manuel uygulama için CLI yükseltmesini kullanın: ```bash openclaw memory promote @@ -168,36 +168,51 @@ openclaw memory promote --limit 5 openclaw memory status --deep ``` -El ile `memory promote`, CLI bayraklarıyla geçersiz kılınmadıkça varsayılan olarak -derin evre eşiklerini kullanır. +Manuel `memory promote`, CLI bayraklarıyla geçersiz kılınmadığı sürece varsayılan olarak +derin aşama eşiklerini kullanır. + +Belirli bir adayın neden yükseltileceğini veya yükseltilmeyeceğini açıklayın: + +```bash +openclaw memory promote-explain "router vlan" +openclaw memory promote-explain "router vlan" --json +``` + +REM yansımalarını, aday gerçekleri ve derin yükseltme çıktısını +hiçbir şey yazmadan önizleyin: + +```bash +openclaw memory rem-harness +openclaw memory rem-harness --json +``` ## Temel varsayılanlar Tüm ayarlar `plugins.entries.memory-core.config.dreaming` altında bulunur. -| Anahtar | Varsayılan | -| ----------- | ----------- | -| `enabled` | `false` | +| Anahtar | Varsayılan | +| ----------- | ---------- | +| `enabled` | `false` | | `frequency` | `0 3 * * *` | -Evre ilkesi, eşikler ve depolama davranışı dahili uygulama -ayrıntılarıdır (kullanıcıya yönelik yapılandırma değildir). +Aşama politikası, eşikler ve depolama davranışı dahili uygulama +ayrıntılarıdır (kullanıcıya dönük yapılandırma değildir). -Tam anahtar listesi için bkz. [Bellek yapılandırma başvurusu](/tr/reference/memory-config#dreaming-experimental). +Tam anahtar listesi için [Bellek yapılandırma başvurusu](/tr/reference/memory-config#dreaming-experimental) bölümüne bakın. -## Dreams UI +## Dreams kullanıcı arayüzü -Etkinleştirildiğinde Gateway içindeki **Dreams** sekmesi şunları gösterir: +Etkinleştirildiğinde Gateway **Dreams** sekmesi şunları gösterir: -- rüya görmenin mevcut etkin durumu -- evre düzeyinde durum ve yönetilen tarama varlığı -- kısa süreli, uzun vadeli ve bugün yükseltilen sayıları -- bir sonraki zamanlanan çalıştırmanın zamanı -- `doctor.memory.dreamDiary` tarafından desteklenen genişletilebilir bir Rüya Günlüğü okuyucusu +- geçerli rüya görme etkin durumunu +- aşama düzeyi durumu ve yönetilen tarama varlığını +- kısa vadeli, uzun vadeli ve bugün yükseltilen sayıları +- bir sonraki zamanlanmış çalıştırmanın zamanlamasını +- `doctor.memory.dreamDiary` tarafından desteklenen genişletilebilir bir Rüya Günlüğü okuyucusunu ## İlgili - [Bellek](/tr/concepts/memory) -- [Bellek Araması](/tr/concepts/memory-search) +- [Bellek Arama](/tr/concepts/memory-search) - [memory CLI](/cli/memory) - [Bellek yapılandırma başvurusu](/tr/reference/memory-config) diff --git a/docs/tr/gateway/configuration-reference.md b/docs/tr/gateway/configuration-reference.md index ec98f609b..08ab4b908 100644 --- a/docs/tr/gateway/configuration-reference.md +++ b/docs/tr/gateway/configuration-reference.md @@ -1,29 +1,29 @@ --- read_when: - - Tam alan düzeyinde yapılandırma anlamlarına veya varsayılanlara ihtiyaç duyduğunuzda - - Kanal, model, gateway veya araç yapılandırma bloklarını doğrularken + - Tam alan düzeyinde yapılandırma anlambilimi veya varsayılanlara ihtiyaç duyuyorsunuz + - Kanal, model, gateway 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 title: Yapılandırma Başvurusu x-i18n: - generated_at: "2026-04-06T03:12:28Z" + generated_at: "2026-04-06T08:55:40Z" model: gpt-5.4 provider: openai - source_hash: 6aa6b24b593f6f07118817afabea4cc7842aca6b7c5602b45f479b40c1685230 + source_hash: 6ae6c19666f65433361e1c8b100ae710448c8aa055a60c140241a8aea09b98a5 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 [Yapılandırma](/tr/gateway/configuration) bölümüne bakın. +`~/.openclaw/openclaw.json` içindeki kullanılabilir her alan. Görev odaklı bir genel bakış için bkz. [Configuration](/tr/gateway/configuration). -Yapılandırma biçimi **JSON5**'tir (yorumlara + sondaki virgüllere izin verilir). Tüm alanlar isteğe bağlıdır — OpenClaw atlandıklarında güvenli varsayılanlar kullanır. +Yapılandırma biçimi **JSON5**'tir (yorumlara + sondaki virgüllere izin verilir). Tüm alanlar isteğe bağlıdır — OpenClaw, atlandığı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 olarak başlar (`enabled: false` olmadıkça). ### DM ve grup erişimi @@ -31,26 +31,26 @@ 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; sahip 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 (şunun gerekmesiyle: `allowFrom: ["*"]`) | -| `disabled` | Tüm gelen DM'leri yok say | +| `pairing` (varsayılan) | Bilinmeyen gönderenler tek seferlik bir eşleştirme kodu alır; sahibin onaylaması gerekir | +| `allowlist` | Yalnızca `allowFrom` içindeki gönderenler (veya eşleştirilmiş izin deposu) | +| `open` | Tüm gelen DM'lere izin ver (`allowFrom: ["*"]` gerektirir) | +| `disabled` | Tüm gelen DM'leri yok say | -| Grup ilkesi | Davranış | +| Grup ilkesi | Davranış | | --------------------- | ------------------------------------------------------ | -| `allowlist` (varsayılan) | Yalnızca yapılandırılmış izin listesiyle eşleşen gruplar | -| `open` | Grup izin listelerini atlar (bahsetme geçitlemesi yine uygulanır) | -| `disabled` | Tüm grup/oda mesajlarını engeller | +| `allowlist` (varsayılan) | Yalnızca yapılandırılmış izin listesiyle eşleşen gruplar | +| `open` | Grup izin listelerini atla (bahsetme geçidi yine de uygulanır) | +| `disabled` | Tüm grup/oda mesajlarını engelle | -`channels.defaults.groupPolicy`, bir sağlayıcının `groupPolicy` değeri ayarlanmamış olduğunda 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ırlıdır. -Bir sağlayıcı bloğu tamamen eksikse (`channels.` yoksa), çalışma zamanı grup ilkesi bir başlangıç uyarısıyla `allowlist` (fail-closed) değerine geri döner. +`channels.defaults.groupPolicy`, bir sağlayıcının `groupPolicy` değeri ayarlanmadığında varsayılanı belirler. +Eşleştirme kodlarının süresi 1 saat sonra dolar. Bekleyen DM eşleştirme istekleri **kanal başına 3** ile sınırlandırılır. +Bir sağlayıcı bloğu tamamen eksikse (`channels.` yoksa), çalışma zamanındaki grup ilkesi bir başlangıç uyarısıyla birlikte `allowlist` (güvenli kapanma) değerine geri döner. ### Kanal model geçersiz kılmaları -Belirli kanal kimliklerini bir modele sabitlemek için `channels.modelByChannel` kullanın. Değerler `provider/model` veya yapılandırılmış model takma adlarını kabul eder. Kanal eşlemesi, bir oturumda zaten model geçersiz kılma yoksa uygulanır (örneğin `/model` ile ayarlanmışsa). +Belirli kanal kimliklerini bir modele sabitlemek için `channels.modelByChannel` kullanın. Değerler `provider/model` veya yapılandırılmış model takma adlarını kabul eder. Kanal eşlemesi, bir oturumun zaten model geçersiz kılması olmadığı zaman uygulanır (örneğin `/model` ile ayarlanmışsa). ```json5 { @@ -73,7 +73,7 @@ Belirli kanal kimliklerini bir modele sabitlemek için `channels.modelByChannel` ### Kanal varsayılanları ve heartbeat -Sağlayıcılar genelinde paylaşılan grup ilkesi ve heartbeat davranışı için `channels.defaults` kullanın: +Sağlayıcılar arasında paylaşılan grup ilkesi ve heartbeat davranışı için `channels.defaults` kullanın: ```json5 { @@ -91,15 +91,15 @@ Sağlayıcılar genelinde paylaşılan grup ilkesi ve heartbeat davranışı iç } ``` -- `channels.defaults.groupPolicy`: sağlayıcı düzeyindeki `groupPolicy` ayarlanmamış olduğunda geri dönüş 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ı içerir), `allowlist` (yalnızca izin listesine alınmış göndericilerin bağlamını içerir), `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 eder. -- `channels.defaults.heartbeat.showAlerts`: heartbeat çıktısına bozulmuş/hata durumlarını dahil eder. -- `channels.defaults.heartbeat.useIndicator`: kompakt gösterge tarzı heartbeat çıktısı oluşturur. +- `channels.defaults.groupPolicy`: bir sağlayıcı düzeyindeki `groupPolicy` ayarlanmadığında geri dönüş grup ilkesi. +- `channels.defaults.contextVisibility`: tüm kanallar için varsayılan ek bağlam görünürlük modu. Değerler: `all` (varsayılan, tüm alıntı/iş parçacığı/geçmiş bağlamını dahil et), `allowlist` (yalnızca izin verilen göndericilerden gelen bağlamı dahil et), `allowlist_quote` (allowlist ile aynı, ancak açık alıntı/yanıt bağlamını koru). 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, gateway'nin web kanalı (Baileys Web) üzerinden çalışır. Bağlı bir oturum bulunduğunda otomatik olarak başlar. +WhatsApp, gateway'nin web kanalı (Baileys Web) üzerinden çalışır. Bağlı bir oturum mevcut olduğunda otomatik olarak başlar. ```json5 { @@ -150,9 +150,9 @@ WhatsApp, gateway'nin web kanalı (Baileys Web) üzerinden çalışır. Bağlı } ``` -- Giden komutlar varsa varsayılan olarak `default` hesabını, aksi halde 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 ilk yapılandırılmış 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 geri dönüş varsayılan hesap seçimini geçersiz kılar. -- Eski tek hesaplı Baileys auth dizini, `openclaw doctor` tarafından `whatsapp/default` içine taşınır. +- Eski tek hesaplı Baileys yetkilendirme dizini, `openclaw doctor` tarafından `whatsapp/default` içine taşınır. - Hesap başına geçersiz kılmalar: `channels.whatsapp.accounts..sendReadReceipts`, `channels.whatsapp.accounts..dmPolicy`, `channels.whatsapp.accounts..allowFrom`. @@ -211,13 +211,13 @@ WhatsApp, gateway'nin web kanalı (Baileys Web) üzerinden çalışır. Bağlı } ``` -- Bot token: `channels.telegram.botToken` veya `channels.telegram.tokenFile` (yalnızca normal dosya; symlink'ler reddedilir), varsayılan hesap için geri dönüş olarak `TELEGRAM_BOT_TOKEN` ile. +- Bot tokeni: `channels.telegram.botToken` veya `channels.telegram.tokenFile` (yalnızca normal dosya; sembolik bağlantılar reddedilir), varsayılan hesap için geri dönüş 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), geri dönüş yönlendirmesini önlemek için açık bir varsayılan ayarlayın (`channels.telegram.defaultAccount` veya `channels.telegram.accounts.default`); bu eksik veya geçersiz olduğunda `openclaw doctor` uyarır. -- `configWrites: false`, Telegram tarafından başlatılan yapılandırma yazmalarını engeller (supergroup kimliği geçişleri, `/config set|unset`). -- `type: "acp"` içeren üst düzey `bindings[]` girdileri, forum konuları için kalıcı ACP bağlamalarını yapılandırır (`match.peer.id` içinde kanonik `chatId:topic:topicId` kullanın). Alan anlamları [ACP Agents](/tr/tools/acp-agents#channel-specific-settings) içinde paylaşılır. +- Çok hesaplı kurulumlarda (2+ hesap kimliği), geri dönüş yönlendirmesinden kaçınmak 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ır. +- `configWrites: false`, Telegram başlatımlı yapılandırma yazmalarını engeller (supergroup ID geçişleri, `/config set|unset`). +- `type: "acp"` içeren üst düzey `bindings[]` girdileri, forum başlıkları için kalıcı ACP bağlarını yapılandırır (`match.peer.id` içinde kanonik `chatId:topic:topicId` kullanın). Alan anlambilimi [ACP Agents](/tr/tools/acp-agents#channel-specific-settings) içinde paylaşılır. - Telegram akış önizlemeleri `sendMessage` + `editMessageText` kullanır (doğrudan ve grup sohbetlerinde çalışır). -- Yeniden deneme ilkesi: bkz. [Yeniden deneme ilkesi](/tr/concepts/retry). +- Yeniden deneme ilkesi: bkz. [Retry policy](/tr/concepts/retry). ### Discord @@ -283,7 +283,7 @@ WhatsApp, gateway'nin web kanalı (Baileys Web) üzerinden çalışır. Bağlı enabled: true, idleHours: 24, maxAgeHours: 0, - spawnSubagentSessions: false, // `sessions_spawn({ thread: true })` için açık katılım + spawnSubagentSessions: false, // `sessions_spawn({ thread: true })` için katılım gerektirir }, voice: { enabled: true, @@ -319,36 +319,36 @@ WhatsApp, gateway'nin web kanalı (Baileys Web) üzerinden çalışır. Bağlı } ``` -- Token: `channels.discord.token`, varsayılan hesap için geri dönüş olarak `DISCORD_BOT_TOKEN` ile. -- Açık bir Discord `token` sağlayan doğrudan giden çağrılar, çağrı için o token'ı kullanır; hesap yeniden deneme/ilke ayarları hâlâ etkin çalışma zamanı anlık görüntüsünde seçilen hesaptan gelir. +- Token: `channels.discord.token`, varsayılan hesap için geri dönüş olarak `DISCORD_BOT_TOKEN`. +- 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çili 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. -- Teslimat hedefleri için `user:` (DM) veya `channel:` (guild kanalı) kullanın; çıplak sayısal kimlikler reddedilir. -- Guild slug'ları küçük harftir ve boşluklar `-` ile değiştirilir; kanal anahtarları slug'lanmış adı kullanır (`#` olmadan). 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 (kendi mesajları yine filtrelenir). -- `channels.discord.guilds..ignoreOtherMentions` (ve kanal geçersiz kılmaları), bottan bahsetmeyen ancak başka bir kullanıcıdan veya rolden bahseden mesajları düşürür (@everyone/@here hariç). -- `maxLinesPerMessage` (varsayılan 17), mesajlar 2000 karakterin altında olsa bile uzun mesajları böler. -- `channels.discord.threadBindings`, Discord konuya bağlı yönlendirmeyi kontrol eder: - - `enabled`: konuya bağlı oturum özellikleri için Discord geçersiz kılması (`/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age` ve bağlı teslimat/yönlendirme) - - `idleHours`: saat cinsinden etkin olmama 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 konu oluşturma/bağlama için açık katılım anahtarı -- `type: "acp"` içeren üst düzey `bindings[]` girdileri, kanallar ve konular için kalıcı ACP bağlamalarını yapılandırır (`match.peer.id` içinde kanal/konu kimliğini kullanın). Alan anlamları [ACP Agents](/tr/tools/acp-agents#channel-specific-settings) içinde paylaşılı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ılmış mesajlar varsayılan olarak yok sayılır. `allowBots: true` bunları etkinleştirir; yalnızca botu mention eden bot mesajlarını kabul etmek için `allowBots: "mentions"` kullanın (kendi mesajları yine filtrelenir). +- `channels.discord.guilds..ignoreOtherMentions` (ve kanal geçersiz kılmaları), başka bir kullanıcıyı veya rolü mention edip botu mention etmeyen mesajları düşürür (@everyone/@here hariç). +- `maxLinesPerMessage` (varsayılan 17), 2000 karakterin altında olsa bile uzun mesajları böler. +- `channels.discord.threadBindings`, Discord 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`: hareketsizlik nedeniyle otomatik odak kaldırma için saat cinsinden Discord geçersiz kılması (`0` devre dışı bırakır) + - `maxAgeHours`: zorunlu maksimum yaş için saat cinsinden 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 anahtarı +- `type: "acp"` içeren üst düzey `bindings[]` girdileri, kanallar ve iş parçacıkları için kalıcı ACP bağlarını yapılandırır (`match.peer.id` içinde kanal/iş parçacığı kimliğini kullanın). Alan anlambilimi [ACP Agents](/tr/tools/acp-agents#channel-specific-settings) içinde paylaşılı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 olduğu gibi geçirilir (varsayılan olarak `true` ve `24`). -- OpenClaw ayrıca tekrarlanan çözme hatalarından sonra bir ses oturumundan çıkıp yeniden katılarak ses alma kurtarmayı dener. -- `channels.discord.streaming`, kanonik 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 mevcudiyetine 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ştirilebilir ad/etiket eşleştirmeyi yeniden etkinleştirir (acil durum uyumluluk modu). +- `channels.discord.voice.daveEncryption` ve `channels.discord.voice.decryptionFailureTolerance`, `@discordjs/voice` DAVE seçeneklerine doğrudan aktarılır (varsayılan olarak `true` ve `24`). +- OpenClaw ayrıca, tekrarlanan şifre çözme hatalarından sonra bir ses oturumundan çıkıp yeniden katılarak ses alımını kurtarmaya çalışır. +- `channels.discord.streaming`, kanonik akış modu anahtarıdır. Eski `streamMode` ve boole `streaming` değerleri otomatik olarak geçirilir. +- `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 (cam kırma 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` içinden onaylayıcılar çözümlenebildiğinde etkinleşir. + - `enabled`: `true`, `false` veya `"auto"` (varsayılan). Otomatik modda exec onayları, onaylayıcılar `approvers` veya `commands.ownerAllowFrom` içinden çö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ı aracı kimliği izin listesi. Tüm aracılar için onay iletmek istiyorsanız atlayın. + - `agentFilter`: isteğe bağlı ajan kimliği izin listesi. Tüm ajanlar için onay iletmek için atlayın. - `sessionFilter`: isteğe bağlı oturum anahtarı desenleri (alt dize veya regex). - - `target`: onay istemlerinin nereye gönderileceği. `"dm"` (varsayılan) onaylayıcı DM'lerine gönderir, `"channel"` kaynak kanala gönderir, `"both"` her ikisine de gönderir. Hedef `"channel"` içerdiğinde düğmeler yalnızca çözülmüş onaylayıcılar tarafından kullanılabilir. - - `cleanupAfterResolve`: `true` olduğunda, onay, ret veya zaman aşımından sonra onay DM'lerini siler. + - `target`: onay istemlerinin nereye gönderileceği. `"dm"` (varsayılan) onaylayıcı DM'lerine gönderir, `"channel"` kaynak kanala gönderir, `"both"` her ikisine gönderir. Hedef `"channel"` içerdiğinde, düğmeler yalnızca çözümlenmiş onaylayıcılar tarafından kullanılabilir. + - `cleanupAfterResolve`: `true` olduğunda, onay, ret veya zaman aşımı sonrasında onay DM'lerini siler. -**Tepki bildirim modları:** `off` (yok), `own` (botun mesajları, varsayılan), `all` (tüm mesajlar), `allowlist` (tüm mesajlarda `guilds..users` içinden). +**Tepki bildirimi modları:** `off` (yok), `own` (botun mesajları, varsayılan), `all` (tüm mesajlar), `allowlist` (`guilds..users` içinden tüm mesajlarda). ### Google Chat @@ -379,11 +379,11 @@ WhatsApp, gateway'nin web kanalı (Baileys Web) üzerinden çalışır. Bağlı } ``` -- Hizmet hesabı JSON'u: satır içi (`serviceAccount`) veya dosya tabanlı (`serviceAccountFile`). -- Hizmet hesabı SecretRef de desteklenir (`serviceAccountRef`). +- Service account JSON: satır içi (`serviceAccount`) veya dosya tabanlı (`serviceAccountFile`). +- Service account SecretRef de desteklenir (`serviceAccountRef`). - Ortam geri dönüşleri: `GOOGLE_CHAT_SERVICE_ACCOUNT` veya `GOOGLE_CHAT_SERVICE_ACCOUNT_FILE`. -- Teslimat hedefleri için `spaces/` veya `users/` kullanın. -- `channels.googlechat.dangerouslyAllowNameMatching`, değiştirilebilir e-posta ilkesi eşleştirmeyi yeniden etkinleştirir (acil durum uyumluluk modu). +- Teslim hedefleri için `spaces/` veya `users/` kullanın. +- `channels.googlechat.dangerouslyAllowNameMatching`, değiştirilebilir e-posta principal eşlemesini yeniden etkinleştirir (cam kırma uyumluluk modu). ### Slack @@ -448,38 +448,38 @@ WhatsApp, gateway'nin web kanalı (Baileys Web) üzerinden çalışır. Bağlı } ``` -- **Socket modu**, hem `botToken` hem de `appToken` gerektirir (varsayılan hesap ortam geri dönüşü için `SLACK_BOT_TOKEN` + `SLACK_APP_TOKEN`). -- **HTTP modu**, `botToken` ile birlikte `signingSecret` gerektirir (kökte veya hesap başına). +- **Socket mode** hem `botToken` hem de `appToken` gerektirir (varsayılan hesap ortam geri dönüşü için `SLACK_BOT_TOKEN` + `SLACK_APP_TOKEN`). +- **HTTP mode** `botToken` artı `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, hesap + dizelerini veya SecretRef nesnelerini kabul eder. +- Slack hesap anlık görüntüleri, hesap başına kimlik bilgisi kaynak/durum alanlarını şu şekilde gösterir: `botTokenSource`, `botTokenStatus`, `appTokenStatus` ve HTTP modunda - `signingSecretStatus` gibi kimlik bilgisi kaynağı/durumu 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. + `signingSecretStatus`. `configured_unavailable`, hesabın + SecretRef ile yapılandırıldığı ancak geçerli komut/çalışma zamanı yolunun + gizli değerini çözemediği anlamına gelir. +- `configWrites: false`, Slack başlatımlı yapılandırma yazmaları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`, kanonik akış modu anahtarıdır. Eski `streamMode` ve boolean `streaming` değerleri otomatik olarak taşınır. -- Teslimat hedefleri için `user:` (DM) veya `channel:` kullanın. +- `channels.slack.streaming`, kanonik akış modu anahtarıdır. Eski `streamMode` ve boole `streaming` değerleri otomatik olarak geçirilir. +- 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). -**Konu oturumu yalıtımı:** `thread.historyScope` konu başına (varsayılan) veya kanal genelinde paylaşılır. `thread.inheritParent`, üst kanal transkriptini yeni konulara kopyalar. +**İş 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 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 | -| ----------- | ---------- | ---------------------- | -| 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 | +| 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 | ### Mattermost -Mattermost bir plugin olarak gelir: `openclaw plugins install @openclaw/mattermost`. +Mattermost bir plugin olarak dağıtılır: `openclaw plugins install @openclaw/mattermost`. ```json5 { @@ -496,10 +496,10 @@ Mattermost bir plugin olarak gelir: `openclaw plugins install @openclaw/mattermo "team-channel-id": { requireMention: false }, }, commands: { - native: true, // açık katılım + native: true, // katılım gerektirir nativeSkills: true, callbackPath: "/api/channels/mattermost/command", - // Ters proxy/herkese açık dağıtımlar için isteğe bağlı açık URL + // 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, @@ -509,20 +509,22 @@ Mattermost bir plugin olarak gelir: `openclaw plugins install @openclaw/mattermo } ``` -Sohbet modları: `oncall` (@-bahsetmesinde yanıt ver, varsayılan), `onmessage` (her mesaj), `onchar` (tetik önekiyle başlayan mesajlar). +Sohbet modları: `oncall` (@-mention ile 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.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 token'larla kimlik doğrulanır. Kayıt başarısız olursa veya hiçbir komut etkinleştirilmezse, OpenClaw callback'leri +- Yerel slash callback'leri, + Mattermost tarafından slash komut kaydı sırasında döndürülen komut başına tokenlarla doğrulanır. Kayıt başarısız olursa veya hiçbir + komut etkinleştirilmezse, OpenClaw callback'leri `Unauthorized: invalid command token.` ile reddeder. -- Özel/tailnet/dahili callback host'ları için Mattermost, - `ServiceSettings.AllowedUntrustedInternalConnections` içine callback host'u/alan adını eklemenizi isteyebilir. - Tam URL değil, host/alan adı değerleri kullanın. -- `channels.mattermost.configWrites`: Mattermost tarafından başlatılan yapılandırma yazmalarına izin ver veya bunları reddet. +- Özel/tailnet/iç callback ana makineleri için Mattermost, + `ServiceSettings.AllowedUntrustedInternalConnections` içine callback ana makinesini/etki alanını eklemeyi gerektirebilir. + Tam URL değil, ana makine/etki alanı değerleri kullanın. +- `channels.mattermost.configWrites`: Mattermost başlatımlı yapılandırma yazmalarına izin ver veya engelle. - `channels.mattermost.requireMention`: kanallarda yanıt vermeden önce `@mention` gerektir. -- `channels.mattermost.groups..requireMention`: kanal başına bahsetme geçitlemesi geçersiz kılması (varsayılan için `"*"`). +- `channels.mattermost.groups..requireMention`: kanal başına mention geçidi 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 @@ -532,7 +534,7 @@ Mattermost yerel komutları etkinleştirildiğinde: channels: { signal: { enabled: true, - account: "+15555550123", // isteğe bağlı hesap bağlaması + account: "+15555550123", // isteğe bağlı hesap bağı dmPolicy: "pairing", allowFrom: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"], configWrites: true, @@ -544,10 +546,10 @@ 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şlatmayı belirli bir Signal hesap kimliğine sabitle. -- `channels.signal.configWrites`: Signal tarafından başlatılan yapılandırma yazmalarına izin ver veya bunları reddet. +- `channels.signal.account`: kanal başlangıcını belirli bir Signal hesap kimliğine sabitle. +- `channels.signal.configWrites`: Signal başlatımlı yapılandırma yazmaları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 @@ -560,7 +562,7 @@ BlueBubbles, önerilen iMessage yoludur (plugin destekli, `channels.bluebubbles` bluebubbles: { enabled: true, dmPolicy: "pairing", - // serverUrl, password, webhookPath, group controls ve gelişmiş actions: + // serverUrl, password, webhookPath, group controls ve gelişmiş eylemler: // bkz. /channels/bluebubbles }, }, @@ -569,12 +571,12 @@ BlueBubbles, önerilen iMessage yoludur (plugin destekli, `channels.bluebubbles` - 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[]` girdileri, BlueBubbles konuşmalarını kalıcı ACP oturumlarına bağlayabilir. `match.peer.id` içinde bir BlueBubbles tanıtıcısı veya hedef dizesi (`chat_id:*`, `chat_guid:*`, `chat_identifier:*`) kullanın. Paylaşılan alan anlamları: [ACP Agents](/tr/tools/acp-agents#channel-specific-settings). +- `type: "acp"` içeren üst düzey `bindings[]` girdileri, BlueBubbles konuşmalarını kalıcı ACP oturumlarına bağlayabilir. `match.peer.id` içinde bir BlueBubbles handle veya hedef dizgesi (`chat_id:*`, `chat_guid:*`, `chat_identifier:*`) kullanın. Paylaşılan alan anlambilimi: [ACP Agents](/tr/tools/acp-agents#channel-specific-settings). - Tam BlueBubbles kanal yapılandırması [BlueBubbles](/tr/channels/bluebubbles) içinde belgelenmiştir. ### iMessage -OpenClaw `imsg rpc` (stdio üzerinden JSON-RPC) başlatır. Daemon veya port gerekmez. +OpenClaw, `imsg rpc` (stdio üzerinden JSON-RPC) başlatır. Daemon veya port gerekmez. ```json5 { @@ -600,13 +602,13 @@ OpenClaw `imsg rpc` (stdio üzerinden JSON-RPC) başlatır. Daemon veya port ger - İ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 DB için Full Disk Access gerekir. +- Mesajlar veritabanına Full Disk Access gerektirir. - `chat_id:` hedeflerini tercih edin. Sohbetleri listelemek için `imsg chats --limit 20` kullanın. -- `cliPath` bir SSH sarmalayıcısına işaret edebilir; SCP ek dosya getirme için `remoteHost` (`host` veya `user@host`) ayarlayın. -- `attachmentRoots` ve `remoteAttachmentRoots`, gelen ek dosya yollarını kısıtlar (varsayılan: `/Users/*/Library/Messages/Attachments`). -- SCP katı host-key denetimi kullanır, bu nedenle relay host 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 bunları reddet. -- `type: "acp"` içeren üst düzey `bindings[]` girdileri, iMessage konuşmalarını kalıcı ACP oturumlarına bağlayabilir. `match.peer.id` içinde normalize edilmiş bir tanıtıcı veya açık bir sohbet hedefi (`chat_id:*`, `chat_guid:*`, `chat_identifier:*`) kullanın. Paylaşılan alan anlamları: [ACP Agents](/tr/tools/acp-agents#channel-specific-settings). +- `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ı sınırlar (varsayılan: `/Users/*/Library/Messages/Attachments`). +- SCP katı ana makine anahtarı denetimi kullanır, bu yüzden relay ana makine anahtarının zaten `~/.ssh/known_hosts` içinde bulunduğundan emin olun. +- `channels.imessage.configWrites`: iMessage başlatımlı yapılandırma yazmalarına izin ver veya engelle. +- `type: "acp"` içeren üst düzey `bindings[]` girdileri, iMessage konuşmalarını kalıcı ACP oturumlarına bağlayabilir. `match.peer.id` içinde normalize edilmiş bir handle veya açık sohbet hedefi (`chat_id:*`, `chat_guid:*`, `chat_identifier:*`) kullanın. Paylaşılan alan anlambilimi: [ACP Agents](/tr/tools/acp-agents#channel-specific-settings). @@ -651,16 +653,16 @@ 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. - `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.allowPrivateNetwork`, özel/dahili homeserver'lara izin verir. `proxy` ve `allowPrivateNetwork` birbirinden bağımsız denetimlerdir. +- `channels.matrix.allowPrivateNetwork`, özel/iç homeserver'lara izin verir. `proxy` ve `allowPrivateNetwork` bağımsız denetimlerdir. - `channels.matrix.defaultAccount`, çok hesaplı kurulumlarda tercih edilen hesabı seçer. - `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` içinden onaylayıcılar çözümlenebildiğinde etkinleşir. - - `approvers`: exec isteklerini onaylamasına izin verilen Matrix kullanıcı kimlikleri (ör. `@owner:example.org`). - - `agentFilter`: isteğe bağlı aracı kimliği izin listesi. Tüm aracılar için onay iletmek istiyorsanız atlayın. + - `enabled`: `true`, `false` veya `"auto"` (varsayılan). Otomatik modda exec onayları, onaylayıcılar `approvers` veya `commands.ownerAllowFrom` içinden çözümlenebildiğinde etkinleşir. + - `approvers`: exec isteklerini onaylamasına izin verilen Matrix kullanıcı kimlikleri (örn. `@owner:example.org`). + - `agentFilter`: isteğe bağlı ajan kimliği izin listesi. Tüm ajanlar için onay iletmek için 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 gruplanacağını kontrol eder: `per-user` (varsayılan) yönlendirilmiş eş tarafından paylaşır, `per-room` ise her DM odasını yalıtır. +- `channels.matrix.dm.sessionScope`, Matrix DM'lerinin oturumlara nasıl gruplanacağını kontrol eder: `per-user` (varsayılan) yönlendirilen eşe göre paylaşır, `per-room` ise her DM odasını izole eder. - 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. @@ -674,7 +676,7 @@ Microsoft Teams, uzantı desteklidir ve `channels.msteams` altında yapılandır msteams: { enabled: true, configWrites: true, - // appId, appPassword, tenantId, webhook, team/channel policies: + // appId, appPassword, tenantId, webhook, takım/kanal ilkeleri: // bkz. /channels/msteams }, }, @@ -709,11 +711,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çitlemesi) [IRC](/tr/channels/irc) içinde belgelenmiştir. +- Tam IRC kanal yapılandırması (host/port/TLS/kanallar/izin listeleri/mention geçidi) [IRC](/tr/channels/irc) içinde 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 biri kendi `accountId` değerine sahip): ```json5 { @@ -725,7 +727,7 @@ Kanal başına birden çok hesap çalıştırın (her biri kendi `accountId` de botToken: "123456:ABC...", }, alerts: { - name: "Uyarılar botu", + name: "Uyarı botu", botToken: "987654:XYZ...", }, }, @@ -734,28 +736,28 @@ Kanal başına birden çok hesap çalıştırın (her biri kendi `accountId` de } ``` -- `default`, `accountId` atlandığında kullanılır (CLI + yönlendirme). -- Ortam token'ları yalnızca **default** hesap için geçerlidir. +- `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 aracıya yönlendirmek için `bindings[].match.accountId` kullanın. -- `openclaw channels add` (veya kanal onboarding'i) ile default olmayan bir hesabı, hâlâ tek hesaplı üst düzey kanal yapılandırması üzerindeyken eklerseniz, OpenClaw önce hesap kapsamlı üst düzey tek hesap değerlerini kanal hesap haritasına yükseltir; böylece özgün hesap çalışmaya devam eder. Çoğu kanal bunları `channels..accounts.default` içine taşır; Matrix bunun yerine mevcut eşleşen bir adlandırılmış/default hedefi koruyabilir. -- Mevcut yalnızca kanal bağlamaları (`accountId` yok) default hesapla eşleşmeye devam eder; hesap kapsamlı bağlamalar isteğe bağlı olmaya devam eder. -- `openclaw doctor --fix` de karışık şekilleri, o kanal için seçilen yükseltilmiş hesaba hesap kapsamlı üst düzey tek hesap değerlerini taşıyarak onarır. Çoğu kanal `accounts.default` kullanır; Matrix bunun yerine mevcut eşleşen bir adlandırılmış/default hedefi koruyabilir. +- Her hesabı farklı bir ajana yönlendirmek için `bindings[].match.accountId` kullanın. +- `openclaw channels add` (veya kanal onboarding) ile varsayılan olmayan bir hesap ekleyip hâlâ tek hesaplı üst düzey kanal yapılandırmasındaysanız, OpenClaw önce hesap kapsamlı üst düzey tek hesap değerlerini kanal hesap eşlemesine taşır, böylece orijinal 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`, hesap kapsamlı üst düzey tek hesap değerlerini o kanal için seçilen yükseltilmiş hesaba taşıyarak karışık biçimleri de onarır. Çoğu kanal `accounts.default` kullanır; Matrix 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 özel kanal sayfalarında belgelenir (örneğin Feishu, Matrix, LINE, Nostr, Zalo, Nextcloud Talk, Synology Chat ve Twitch). -Tam kanal dizini için bkz.: [Kanallar](/tr/channels). +Tam kanal dizini için bkz.: [Channels](/tr/channels). -### Grup sohbeti bahsetme geçitlemesi +### Grup sohbeti mention geçidi -Grup mesajları varsayılan olarak **bahsetme gerektirir** (meta veri bahsetmesi veya güvenli regex desenleri). WhatsApp, Telegram, Discord, Google Chat ve iMessage grup sohbetlerinde uygulanır. +Grup mesajları varsayılan olarak **mention gerektirir** (meta veri mention'ı veya güvenli regex desenleri). WhatsApp, Telegram, Discord, Google Chat ve iMessage grup sohbetlerine uygulanır. -**Bahsetme türleri:** +**Mention türleri:** -- **Meta veri bahsetmeleri**: Platformun yerel @-bahsetmeleri. WhatsApp self-chat modunda yok sayılır. +- **Meta veri mention'ları**: Yerel platform @-mention'ları. WhatsApp self-chat modunda yok sayılır. - **Metin desenleri**: `agents.list[].groupChat.mentionPatterns` içindeki güvenli regex desenleri. Geçersiz desenler ve güvenli olmayan iç içe tekrarlar yok sayılır. -- Bahsetme geçitlemesi yalnızca algılama mümkün olduğunda uygulanır (yerel bahsetmeler veya en az bir desen). +- Mention geçidi, yalnızca algılama mümkün olduğunda uygulanır (yerel mention'lar veya en az bir desen). ```json5 { @@ -785,13 +787,13 @@ Grup mesajları varsayılan olarak **bahsetme gerektirir** (meta veri bahsetmesi } ``` -Çözümleme: DM başına geçersiz kılma → sağlayıcı varsayılanı → sınır yok (tümü tutulur). +Çözümleme: DM başına geçersiz kılma → sağlayıcı varsayılanı → sınır yok (tümü korunur). Desteklenenler: `telegram`, `whatsapp`, `discord`, `slack`, `signal`, `imessage`, `msteams`. #### Self-chat modu -Self-chat modunu etkinleştirmek için kendi numaranızı `allowFrom` içine ekleyin (yerel @-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 { @@ -819,11 +821,11 @@ Self-chat modunu etkinleştirmek için kendi numaranızı `allowFrom` içine ekl commands: { native: "auto", // desteklendiğinde yerel komutları kaydet text: true, // sohbet mesajlarında /commands ayrıştır - bash: false, // ! kullanımına izin ver (takma ad: /bash) + bash: false, // ! öğesine izin ver (takma ad: /bash) bashForegroundMs: 2000, - config: false, // /config izinli mi - debug: false, // /debug izinli mi - restart: false, // /restart + gateway restart aracı izinli mi + config: false, // /config öğesine izin ver + debug: false, // /debug öğesine izin ver + restart: false, // /restart + gateway yeniden başlatma aracına izin ver allowFrom: { "*": ["user1"], discord: ["user:123"], @@ -835,22 +837,22 @@ Self-chat modunu etkinleştirmek için kendi numaranızı `allowFrom` içine ekl -- Metin komutları başında `/` olan **bağımsız** mesajlar olmalıdır. +- Metin komutları, başında `/` olan **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. - `channels.telegram.customCommands`, ek Telegram bot menü girdileri ekler. -- `bash: true`, host shell için `! ` özelliğini etkinleştirir. `tools.elevated.enabled` ve gönderenin `tools.elevated.allowFrom.` içinde olması gerekir. -- `config: true`, `/config` komutunu etkinleştirir (`openclaw.json` okur/yazar). Gateway `chat.send` istemcileri için kalıcı `/config set|unset` yazmaları ayrıca `operator.admin` gerektirir; salt okunur `/config show` normal yazma kapsamlı operator istemcileri için kullanılabilir olmaya devam eder. +- `bash: true`, ana makine kabuğu için `! ` komutunu etkinleştirir. `tools.elevated.enabled` ve gönderenin `tools.elevated.allowFrom.` içinde olması gerekir. +- `config: true`, `/config` komutunu etkinleştirir (`openclaw.json` okur/yazar). Gateway `chat.send` istemcileri için kalıcı `/config set|unset` yazmaları ayrıca `operator.admin` gerektirir; salt okunur `/config show` normal yazma kapsamlı operator istemcileri için kullanılabilir kalır. - `channels..configWrites`, kanal başına yapılandırma değişikliklerini geçitler (varsayılan: true). -- Çok hesaplı kanallarda `channels..accounts..configWrites`, o hesabı hedefleyen yazmaları da geçitler (örneğin `/allowlist --config --account ` veya `/config set channels..accounts....`). -- `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. +- Çok hesaplı kanallar için `channels..accounts..configWrites`, o hesabı hedefleyen yazmaları da geçitler (örneğin `/allowlist --config --account ` veya `/config set channels..accounts....`). +- `allowFrom`, sağlayıcı başınadır. Ayarlandığında **tek** yetkilendirme kaynağıdır (kanal izin listeleri/eşleştirme ve `useAccessGroups` yok sayılır). +- `useAccessGroups: false`, `allowFrom` ayarlı olmadığında komutların erişim grubu ilkelerini atlamasına izin verir. --- -## Aracı varsayılanları +## Ajan varsayılanları ### `agents.defaults.workspace` @@ -864,7 +866,7 @@ Varsayılan: `~/.openclaw/workspace`. ### `agents.defaults.repoRoot` -Sistem isteminin Runtime satırında gösterilen isteğe bağlı depo kökü. Ayarlanmamışsa OpenClaw ç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ü. Ayarlanmazsa, OpenClaw çalışma alanından yukarı doğru yürüyerek otomatik algılar. ```json5 { @@ -874,25 +876,26 @@ Sistem isteminin Runtime satırında gösterilen isteğe bağlı depo kökü. Ay ### `agents.defaults.skills` -`agents.list[].skills` ayarlamayan aracılar için isteğe bağlı varsayılan Skills 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" }, // github, weather devralır - { id: "docs", skills: ["docs-search"] }, // varsayılanların yerini alır - { id: "locked-down", skills: [] }, // Skills yok + { id: "writer" }, // github, weather değerlerini devralır + { id: "docs", skills: ["docs-search"] }, // varsayılanların yerine geçer + { id: "locked-down", skills: [] }, // skill yok ], }, } ``` -- Varsayılan olarak sınırsız Skills için `agents.defaults.skills` alanını atlayın. -- Varsayılanları devralmak için `agents.list[].skills` alanını atlayın. -- Skills olmaması için `agents.list[].skills: []` ayarlayın. -- Boş olmayan bir `agents.list[].skills` listesi, o aracı 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. +- Hiç skill olmaması için `agents.list[].skills: []` ayarlayın. +- Boş olmayan `agents.list[].skills` listesi, o ajan için son kümedir; + varsayılanlarla birleştirilmez. ### `agents.defaults.skipBootstrap` @@ -904,9 +907,21 @@ Sistem isteminin Runtime satırında gösterilen isteğe bağlı depo kökü. Ay } ``` +### `agents.defaults.contextInjection` + +Çalışma alanı bootstrap dosyalarının sistem istemine ne zaman enjekte edileceğini kontrol eder. Varsayılan: `"always"`. + +- `"continuation-skip"`: güvenli devam dönüşlerinde (tamamlanmış bir assistant yanıtından sonra), çalışma alanı bootstrap yeniden enjeksiyonu atlanır ve istem boyutu azaltılır. Heartbeat çalıştırmaları ve sıkıştırma sonrası yeniden denemeler yine de bağlamı yeniden oluşturur. + +```json5 +{ + agents: { defaults: { contextInjection: "continuation-skip" } }, +} +``` + ### `agents.defaults.bootstrapMaxChars` -Kırpılmadan önce çalışma alanı bootstrap dosyası başına maksimum karakter. Varsayılan: `20000`. +Kısaltmadan önce çalışma alanı bootstrap dosyası başına maksimum karakter. Varsayılan: `20000`. ```json5 { @@ -916,7 +931,7 @@ Kırpılmadan önce çalışma alanı bootstrap dosyası başına maksimum karak ### `agents.defaults.bootstrapTotalMaxChars` -Tüm çalışma alanı bootstrap dosyaları boyunca enjekte edilen toplam maksimum karakter. Varsayılan: `150000`. +Tüm çalışma alanı bootstrap dosyaları arasında enjekte edilen toplam maksimum karakter. Varsayılan: `150000`. ```json5 { @@ -926,12 +941,12 @@ Tüm çalışma alanı bootstrap dosyaları boyunca enjekte edilen toplam maksim ### `agents.defaults.bootstrapPromptTruncationWarning` -Bootstrap bağlamı kırpıldığında aracıya görünür uyarı metnini kontrol eder. +Bootstrap bağlamı kısaltıldığında ajana görünen uyarı metnini kontrol eder. Varsayılan: `"once"`. -- `"off"`: sistem istemine asla uyarı metni ekleme. -- `"once"`: benzersiz her kırpma imzası için uyarıyı bir kez ekle (önerilir). -- `"always"`: kırpma olduğunda her çalıştırmada uyarı ekle. +- `"off"`: sistem istemine asla uyarı metni enjekte etme. +- `"once"`: her benzersiz kısaltma imzası için bir kez uyarı enjekte et (önerilir). +- `"always"`: kısaltma mevcut olduğunda her çalıştırmada uyarı enjekte et. ```json5 { @@ -941,11 +956,11 @@ Varsayılan: `"once"`. ### `agents.defaults.imageMaxDimensionPx` -Sağlayıcı çağrılarından önce transkript/araç görsel bloklarında en uzun görsel kenarı için maksimum piksel boyutu. +Sağlayıcı çağrılarından önce transcript/tool görüntü bloklarında en uzun görüntü kenarı için maksimum piksel boyutu. Varsayılan: `1200`. -Daha düşük değerler genellikle ağır ekran görüntüsü çalıştırmalarında vision token kullanımını ve istek yük boyutunu azaltır. -Daha yüksek değerler daha fazla görsel ayrıntı korur. +Daha düşük değerler genellikle vision token kullanımını ve istek yükü boyutunu azaltır. +Daha yüksek değerler daha fazla görsel ayrıntıyı korur. ```json5 { @@ -955,7 +970,7 @@ Daha yüksek değerler daha fazla görsel ayrıntı korur. ### `agents.defaults.userTimezone` -Sistem istemi bağlamı için saat dilimi (mesaj zaman damgaları değil). Host saat dilimine geri döner. +Sistem istemi bağlamı için saat dilimi (mesaj zaman damgaları değil). Ana makine saat dilimine geri döner. ```json5 { @@ -965,7 +980,7 @@ Sistem istemi bağlamı için saat dilimi (mesaj zaman damgaları değil). Host ### `agents.defaults.timeFormat` -Sistem istemindeki saat biçimi. Varsayılan: `auto` (işletim sistemi tercihi). +Sistem istemindeki saat biçimi. Varsayılan: `auto` (OS tercihi). ```json5 { @@ -1020,61 +1035,61 @@ Sistem istemindeki saat biçimi. Varsayılan: `auto` (işletim sistemi tercihi). - `model`: bir dize (`"provider/model"`) veya bir nesne (`{ primary, fallbacks }`) kabul eder. - Dize biçimi yalnızca birincil modeli ayarlar. - - Nesne biçimi birincil artı sıralı failover modellerini ayarlar. + - Nesne biçimi birincil model artı sıralı failover modellerini ayarlar. - `imageModel`: bir dize (`"provider/model"`) veya bir 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 geri dönüş yönlendirmesi olarak kullanılır. + - `image` araç yolu tarafından vision model yapılandırması olarak kullanılır. + - Ayrıca seçilen/varsayılan model görüntü girdisini kabul edemediğinde geri dönüş yönlendirmesi için kullanılır. - `imageGenerationModel`: bir dize (`"provider/model"`) veya bir nesne (`{ primary, fallbacks }`) kabul eder. - - Paylaşılan görsel oluşturma yeteneği ve görsel üreten gelecekteki araç/plugin yüzeylerinde kullanılır. - - Tipik değerler: yerel Gemini görsel oluşturma 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`. + - Paylaşılan görsel oluşturma yeteneği ve gelecekte görsel üreten araç/plugin yüzeyleri tarafından kullanılır. + - Tipik değerler: yerel Gemini görsel oluşturma için `google/gemini-3.1-flash-image-preview`, fal için `fal/fal-ai/flux/dev` veya OpenAI Images için `openai/gpt-image-1`. - Bir sağlayıcı/modeli doğrudan seçerseniz, eşleşen sağlayıcı auth/API anahtarını da yapılandırın (örneğin `google/*` için `GEMINI_API_KEY` veya `GOOGLE_API_KEY`, `openai/*` için `OPENAI_API_KEY`, `fal/*` için `FAL_KEY`). - - Atlanırsa `image_generate`, auth destekli bir sağlayıcı varsayılanını yine de çıkarabilir. Önce geçerli varsayılan sağlayıcıyı, sonra kalan kayıtlı görsel oluşturma sağlayıcılarını sağlayıcı kimliği sırasına göre dener. + - Atlanırsa `image_generate` yine de auth destekli sağlayıcı varsayılanını çıkarabilir. Önce mevcut varsayılan sağlayıcıyı, sonra kalan kayıtlı görsel oluşturma sağlayıcılarını sağlayıcı kimliği sırasıyla dener. - `musicGenerationModel`: bir dize (`"provider/model"`) veya bir nesne (`{ primary, fallbacks }`) kabul eder. - Paylaşılan müzik oluşturma 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`, auth destekli bir sağlayıcı varsayılanını yine de çıkarabilir. Önce geçerli varsayılan sağlayıcıyı, sonra kalan kayıtlı müzik oluşturma sağlayıcılarını sağlayıcı kimliği sırasına göre dener. + - Atlanırsa `music_generate` yine de auth destekli sağlayıcı varsayılanını çıkarabilir. Önce mevcut varsayılan sağlayıcıyı, sonra kalan kayıtlı müzik oluşturma sağlayıcılarını sağlayıcı kimliği sırasıyla dener. - Bir sağlayıcı/modeli doğrudan seçerseniz, eşleşen sağlayıcı auth/API anahtarını da yapılandırın. - `videoGenerationModel`: bir dize (`"provider/model"`) veya bir nesne (`{ primary, fallbacks }`) kabul eder. - Paylaşılan video oluşturma 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`, auth destekli bir sağlayıcı varsayılanını yine de çıkarabilir. Önce geçerli varsayılan sağlayıcıyı, sonra kalan kayıtlı video oluşturma sağlayıcılarını sağlayıcı kimliği sırasına göre dener. + - Atlanırsa `video_generate` yine de auth destekli sağlayıcı varsayılanını çıkarabilir. Önce mevcut varsayılan sağlayıcıyı, sonra kalan kayıtlı video oluşturma sağlayıcılarını sağlayıcı kimliği sırasıyla dener. - Bir sağlayıcı/modeli doğrudan seçerseniz, eşleşen sağlayıcı auth/API anahtarını da yapılandırın. - - Paketlenmiş Qwen video oluşturma 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. + - Paketlenmiş Qwen video oluşturma sağlayıcısı şu anda en fazla 1 çıktı videosu, 1 girdi görüntüsü, 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ı için model yönlendirmede kullanılır. - - Atlanırsa PDF aracı `imageModel` değerine, sonra çözümlenmiş oturum/varsayılan modele geri döner. -- `pdfMaxBytesMb`: çağrı zamanında `maxBytesMb` geçirilmediğinde `pdf` aracı için varsayılan PDF boyut sınırı. -- `pdfMaxPages`: `pdf` aracındaki çıkarım geri dönüş modu tarafından dikkate alınan varsayılan maksimum sayfa sayısı. -- `verboseDefault`: aracılar için varsayılan verbose düzeyi. Değerler: `"off"`, `"on"`, `"full"`. Varsayılan: `"off"`. -- `elevatedDefault`: aracılar için varsayılan elevated-output düzeyi. Değerler: `"off"`, `"on"`, `"ask"`, `"full"`. Varsayılan: `"on"`. -- `model.primary`: biçim `provider/model` (örn. `openai/gpt-5.4`). Sağlayıcıyı atlarsanız OpenClaw önce bir takma adı, sonra tam o 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 (eski uyumluluk davranışı, bu nedenle açık `provider/model` tercih edilir). Bu sağlayıcı artık yapılandırılmış varsayılan modeli sunmuyorsa, OpenClaw eski ve 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. + - `pdf` aracı tarafından model yönlendirmesi için kullanılır. + - Atlanırsa PDF aracı önce `imageModel`, sonra çözülmüş oturum/varsayılan modele geri döner. +- `pdfMaxBytesMb`: çağrı anında `maxBytesMb` geçirilmediğinde `pdf` aracı için varsayılan PDF boyut sınırı. +- `pdfMaxPages`: `pdf` aracında çıkarım geri dönüş modu tarafından dikkate alınan varsayılan maksimum sayfa sayısı. +- `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`: biçim `provider/model` (örn. `openai/gpt-5.4`). Sağlayıcıyı atlarsanız, OpenClaw önce bir takma adı, sonra bu tam model kimliği için benzersiz yapılandırılmış sağlayıcı eşleşmesini dener ve ancak ondan sonra 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ı yüzeye çıkarmak yerine ilk yapılandırılmış sağlayıcı/modele geri döner. - `models`: yapılandırılmış model kataloğu ve `/model` için izin listesi. Her girdi `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 taban), `agents.defaults.models["provider/model"].params` (model başına) tarafından geçersiz kılınır, ardından eşleşen aracı kimliği için `agents.list[].params` anahtar başına geçersiz kılar. Ayrıntılar için [Prompt Caching](/tr/reference/prompt-caching) bölümüne bakın. -- Bu alanları değiştiren yapılandırma yazarları (örneğin `/models set`, `/models set-image` ve fallback ekle/kaldır komutları), kanonik nesne biçimini kaydeder ve mümkün olduğunda mevcut fallback listelerini korur. -- `maxConcurrent`: oturumlar arasında en fazla paralel aracı çalıştırma sayısı (her oturum yine serileştirilir). Varsayılan: 4. +- `params` birleştirme önceliği (yapılandırma): `agents.defaults.params` (genel temel), `agents.defaults.models["provider/model"].params` (model başına) ile geçersiz kılınır, ardından `agents.list[].params` (eşleşen ajan kimliği) anahtar başına geçersiz kılar. Ayrıntılar için bkz. [Prompt Caching](/tr/reference/prompt-caching). +- Bu alanları değiştiren yapılandırma yazıcıları (örneğin `/models set`, `/models set-image` ve fallback ekleme/kaldırma komutları) kanonik nesne biçimini kaydeder ve mümkün olduğunda mevcut fallback listelerini korur. +- `maxConcurrent`: oturumlar arasında en fazla paralel ajan çalıştırma sayısı (her oturum yine de seri hale getirilir). 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çindeyse uygulanır): -| 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` | +| 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ılanlara üstün gelir. +Yapılandırdığınız takma adlar her zaman varsayılanları geçersiz kılar. -Z.AI GLM-4.x modelleri, `--thinking off` ayarlamazsanız veya `agents.defaults.models["zai/"].params.thinking` değerini kendiniz tanımlamazsanız otomatik olarak thinking modunu etkinleştirir. -Z.AI modelleri araç çağrısı akışı için varsayılan olarak `tool_stream` etkinleştirir. Bunu devre dışı bırakmak için `agents.defaults.models["zai/"].params.tool_stream` değerini `false` yapın. +Z.AI GLM-4.x modelleri, `--thinking off` ayarlamadığınız veya `agents.defaults.models["zai/"].params.thinking` değerini kendiniz tanımlamadığınız sürece thinking modunu otomatik 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. - `sessionArg` ayarlandığında oturumlar desteklenir. -- `imageArg` dosya yollarını kabul ettiğinde görsel pass-through desteklenir. +- `imageArg` dosya yollarını kabul ettiğinde görüntü doğrudan geçişi desteklenir. ### `agents.defaults.heartbeat` @@ -1088,8 +1103,8 @@ Periyodik heartbeat çalıştırmaları. every: "30m", // 0m devre dışı bırakır model: "openai/gpt-5.4-mini", includeReasoning: false, - lightContext: false, // varsayılan: false; true yalnızca çalışma alanı bootstrap dosyalarından HEARTBEAT.md dosyasını tutar - isolatedSession: false, // varsayılan: false; true her heartbeat'i taze bir oturumda çalıştırır (konuşma geçmişi yok) + lightContext: false, // varsayılan: false; true yalnızca çalışma alanı bootstrap dosyalarından HEARTBEAT.md tutar + isolatedSession: false, // varsayılan: false; true her heartbeat'i yeni bir oturumda çalıştırır (konuşma geçmişi yok) session: "main", to: "+15555550123", directPolicy: "allow", // allow (varsayılan) | block @@ -1103,13 +1118,13 @@ Periyodik heartbeat çalıştırmaları. } ``` -- `every`: süre dizesi (ms/s/m/h). Varsayılan: `30m` (API anahtarı auth) veya `1h` (OAuth auth). Devre dışı bırakmak için `0m` ayarlayın. -- `suppressToolErrorWarnings`: true olduğunda heartbeat çalıştırmaları sırasında araç hata uyarı payload'larını bastırır. -- `directPolicy`: doğrudan/DM teslim ilkesidir. `allow` (varsayılan) doğrudan hedef teslimine izin verir. `block`, doğrudan hedef teslimini bastırır ve `reason=dm-blocked` üretir. +- `every`: süre dizgesi (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ış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, önceki konuşma geçmişi olmayan taze bir oturumda çalıştırılır. Cron `sessionTarget: "isolated"` ile aynı yalıtım deseni. Heartbeat başına token maliyetini yaklaşık ~100K'dan ~2-5K token'a düşürür. -- Aracı başına: `agents.list[].heartbeat` ayarlayın. Herhangi bir aracı `heartbeat` tanımladığında heartbeat'leri **yalnızca o aracılar** çalıştırır. -- Heartbeat'ler tam aracı dönüşleri çalıştırır — daha kısa aralıklar daha fazla token tüketir. +- `isolatedSession`: true olduğunda her heartbeat önceki konuşma geçmişi olmadan yeni bir oturumda çalışır. Cron `sessionTarget: "isolated"` ile aynı yalıtım deseni. Heartbeat başına token maliyetini yaklaşık 100K'dan yaklaşık 2-5K tokena düşürür. +- Ajan başına: `agents.list[].heartbeat` ayarlayın. Herhangi bir ajan `heartbeat` tanımlarsa, heartbeat'leri **yalnızca bu ajanlar** çalıştırır. +- Heartbeat'ler tam ajan dönüşleri çalıştırır — daha kısa aralıklar daha fazla token tüketir. ### `agents.defaults.compaction` @@ -1122,15 +1137,15 @@ Periyodik heartbeat çalıştırmaları. timeoutSeconds: 900, reserveTokensFloor: 24000, identifierPolicy: "strict", // strict | off | custom - identifierInstructions: "Dağıtım kimliklerini, bilet kimliklerini ve host:port çiftlerini tam olarak koru.", // identifierPolicy=custom olduğunda kullanılır - postCompactionSections: ["Session Startup", "Red Lines"], // [] yeniden eklemeyi 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 kısa bir bildirim gönder (varsayılan: false) + identifierInstructions: "Dağıtım kimliklerini, ticket 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", // isteğe bağlı yalnızca compaction modeli geçersiz kılması + notifyUser: true, // sıkıştırma başladığında kullanıcıya kısa bir bildirim gönder (varsayılan: false) memoryFlush: { enabled: true, softThresholdTokens: 6000, - systemPrompt: "Oturum compaction'a 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 NO_REPLY token'ı ile yanıt ver.", + 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 token olan NO_REPLY ile yanıt ver.", }, }, }, @@ -1138,18 +1153,18 @@ Periyodik heartbeat çalıştırmaları. } ``` -- `mode`: `default` veya `safeguard` (uzun geçmişler için parça parça özetleme). Bkz. [Compaction](/tr/concepts/compaction). -- `timeoutSeconds`: OpenClaw'ın tek bir compaction işlemini iptal etmeden önce izin verdiği maksimum saniye sayısı. Varsayılan: `900`. -- `identifierPolicy`: `strict` (varsayılan), `off` veya `custom`. `strict`, compaction özetleme sırasında yerleşik opak tanımlayıcı koruma yönergelerini başa ekler. +- `mode`: `default` veya `safeguard` (uzun geçmişler için parçalı özetleme). Bkz. [Compaction](/tr/concepts/compaction). +- `timeoutSeconds`: OpenClaw'ın iptal etmeden önce tek bir sıkıştırma işlemine izin verdiği azami saniye. Varsayılan: `900`. +- `identifierPolicy`: `strict` (varsayılan), `off` veya `custom`. `strict`, sıkıştırma özetlemesinden önce yerleşik opak tanımlayıcı koruma yönergelerini 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 `["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 geri dönüşü olarak kabul edilir. -- `model`: yalnızca compaction özetleme için isteğe bağlı `provider/model-id` geçersiz kılması. Ana oturumun bir modeli korumasını ancak compaction özetlerinin başka bir modelde ç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 kapalıdır; böylece compaction sessiz kalır. -- `memoryFlush`: otomatik compaction'dan önce kalıcı anıları depolamak için sessiz aracı dönüşü. Çalışma alanı salt okunursa atlanır. +- `postCompactionSections`: sıkıştırma sonrası yeniden enjekte edilecek isteğe bağlı AGENTS.md H2/H3 bölüm adları. Varsayılan `["Session Startup", "Red Lines"]`; devre dışı bırakmak için `[]` ayarlayın. Ayarlanmadığında veya açıkça bu varsayılan çifte ayarlandığında, daha eski `Every Session`/`Safety` başlıkları da eski geri dönüş olarak kabul edilir. +- `model`: yalnızca sıkıştırma özetlemesi için isteğe bağlı `provider/model-id` geçersiz kılması. Ana oturum bir modeli korurken sıkıştırma özetleri başka bir modelde çalışsın istiyorsanız bunu kullanın; ayarlanmazsa sıkıştırma oturumun birincil modelini kullanır. +- `notifyUser`: `true` olduğunda sıkıştırma başladığında kullanıcıya kısa bir bildirim gönderir (örneğin "Bağlam sıkıştırılıyor..."). Varsayılan olarak kapalıdır, böylece sıkıştırma sessiz kalır. +- `memoryFlush`: otomatik sıkıştırmadan önce kalıcı anıları depolamak için sessiz ajan dönüşü. Çalışma alanı salt okunursa atlanır. ### `agents.defaults.contextPruning` -LLM'e göndermeden önce bellek içi bağlamdan **eski araç sonuçlarını** budar. Disk üzerindeki oturum geçmişini değiştirmez. +LLM'ye göndermeden önce bellek içi bağlamdan **eski araç sonuçlarını** budar. Diskteki oturum geçmişini **değiştirmez**. ```json5 { @@ -1174,22 +1189,22 @@ LLM'e göndermeden önce bellek içi bağlamdan **eski araç sonuçlarını** bu - `mode: "cache-ttl"` budama geçişlerini etkinleştirir. -- `ttl`, budamanın ne sıklıkla yeniden ç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ırpar, sonra gerekirse eski araç sonuçlarını tamamen temizler. +- `ttl`, budamanın tekrar ne sıklıkla çalışabileceğini kontrol eder (son önbellek dokunuşundan sonra). +- Budama önce büyük araç sonuçlarını yumuşak şekilde kırpar, gerekirse daha eski araç sonuçlarını tamamen temizler. -**Soft-trim**, başı + sonu korur ve ortaya `...` ekler. +**Soft-trim**, başlangıç + sonu korur ve ortaya `...` ekler. **Hard-clear**, tüm araç sonucunu yer tutucuyla değiştirir. Notlar: -- Görsel blokları asla kırpılmaz/temizlenmez. -- Oranlar tam token sayıları değil, karakter tabanlıdır (yaklaşık). -- `keepLastAssistants` kadar assistant mesajı yoksa budama atlanır. +- Görüntü blokları asla kırpılmaz/temizlenmez. +- Oranlar token sayısı değil, karakter tabanlıdır (yaklaşık). +- `keepLastAssistants` sayısından daha az assistant mesajı varsa budama atlanır. -Davranış ayrıntıları için [Session Pruning](/tr/concepts/session-pruning) bölümüne bakın. +Davranış ayrıntıları için bkz. [Session Pruning](/tr/concepts/session-pruning). ### Blok akışı @@ -1201,17 +1216,17 @@ Davranış ayrıntıları için [Session Pruning](/tr/concepts/session-pruning) blockStreamingBreak: "text_end", // text_end | message_end blockStreamingChunk: { minChars: 800, maxChars: 1200 }, blockStreamingCoalesce: { idleMs: 1000 }, - humanDelay: { mode: "natural" }, // off | natural | custom (minMs/maxMs kullanın) + humanDelay: { mode: "natural" }, // off | natural | custom (minMs/maxMs kullan) }, }, } ``` -- Telegram dışı 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 olarak `minChars: 1500`. -- `humanDelay`: blok yanıtlar arasında rastgele duraklama. `natural` = 800–2500ms. Aracı başına geçersiz kılma: `agents.list[].humanDelay`. +- Telegram dışı kanallar blok yanıtları etkinleştirmek için açık `*.blockStreaming: true` gerektirir. +- Kanal geçersiz kılmaları: `channels..blockStreamingCoalesce` (ve hesap başına varyantları). Signal/Slack/Discord/Google Chat varsayılanı `minChars: 1500`. +- `humanDelay`: blok yanıtları arasında rastgele duraklama. `natural` = 800–2500ms. Ajan başına geçersiz kılma: `agents.list[].humanDelay`. -Davranış + parçalama ayrıntıları için [Streaming](/tr/concepts/streaming) bölümüne bakın. +Davranış + parçalama ayrıntıları için bkz. [Streaming](/tr/concepts/streaming). ### Yazıyor göstergeleri @@ -1226,7 +1241,7 @@ Davranış + parçalama ayrıntıları için [Streaming](/tr/concepts/streaming) } ``` -- 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). @@ -1235,7 +1250,7 @@ Bkz. [Typing Indicators](/tr/concepts/typing-indicators). ### `agents.defaults.sandbox` -Gömülü aracı için isteğe bağlı sandboxing. Tam kılavuz için [Sandboxing](/tr/gateway/sandboxing) bölümüne bakın. +Gömülü ajan için isteğe bağlı sandboxing. Tam kılavuz için bkz. [Sandboxing](/tr/gateway/sandboxing). ```json5 { @@ -1332,49 +1347,49 @@ Gömülü aracı için isteğe bağlı sandboxing. Tam kılavuz için [Sandboxin -**Backend:** +**Arka uç:** - `docker`: yerel Docker çalışma zamanı (varsayılan) - `ssh`: genel SSH destekli uzak çalışma zamanı - `openshell`: OpenShell çalışma zamanı -`backend: "openshell"` seçildiğinde çalışma zamanına özgü ayarlar -`plugins.entries.openshell.config` altına taşınır. +`backend: "openshell"` seçildiğinde, çalışma zamanına özgü ayarlar +`plugins.entries.openshell.config` içine taşınır. -**SSH backend yapılandırması:** +**SSH arka uç yapılandırması:** - `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 materyalize ettiği satır içi içerikler veya SecretRef'ler -- `strictHostKeyChecking` / `updateHostKeys`: OpenSSH host-key ilke düğmeleri +- `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 ana makine anahtarı ilkesi düğmeleri **SSH auth önceliği:** -- `identityData`, `identityFile` değerine üstün gelir -- `certificateData`, `certificateFile` değerine üstün gelir -- `knownHostsData`, `knownHostsFile` değerine üstün gelir -- SecretRef destekli `*Data` değerleri, sandbox oturumu başlamadan önce etkin gizli bilgi çalışma zamanı anlık görüntüsünden çözülür +- `identityData`, `identityFile` değerini geçersiz kılar +- `certificateData`, `certificateFile` değerini geçersiz kılar +- `knownHostsData`, `knownHostsFile` değerini geçersiz kılar +- SecretRef destekli `*Data` değerleri, sandbox oturumu başlamadan önce etkin gizli bilgiler çalışma zamanı anlık görüntüsünden çözülür -**SSH backend davranışı:** +**SSH arka uç davranışı:** -- uzak çalışma alanını oluşturma veya yeniden oluşturma sonrası bir kez tohumlar -- sonra uzak SSH çalışma alanını kanonik tutar +- oluşturma veya yeniden oluşturma sonrasında uzak çalışma alanını bir kez tohumlar +- ardından uzak SSH çalışma alanını kanonik tutar - `exec`, dosya araçları ve medya yollarını SSH üzerinden yönlendirir -- uzak değişiklikleri otomatik olarak host'a geri eşitlemez -- sandbox browser kapsayıcılarını desteklemez +- uzak değişiklikleri otomatik olarak ana makineye geri senkronize etmez +- sandbox tarayıcı kapsayıcılarını desteklemez **Çalışma alanı erişimi:** - `none`: `~/.openclaw/sandboxes` altında kapsam başına sandbox çalışma alanı -- `ro`: `/workspace` içinde sandbox çalışma alanı, `/agent` içinde salt okunur bağlanmış aracı çalışma alanı -- `rw`: aracı çalışma alanı `/workspace` içine okuma/yazma olarak bağlanır +- `ro`: `/workspace` altında sandbox çalışma alanı, `/agent` altında salt okunur bağlanmış ajan çalışma alanı +- `rw`: ajan çalışma alanı `/workspace` konumuna okuma/yazma olarak bağlanır **Kapsam:** - `session`: oturum başına kapsayıcı + çalışma alanı -- `agent`: aracı başına bir kapsayıcı + çalışma alanı (varsayılan) +- `agent`: ajan başına bir kapsayıcı + çalışma alanı (varsayılan) - `shared`: paylaşılan kapsayıcı ve çalışma alanı (oturumlar arası yalıtım yok) **OpenShell plugin yapılandırması:** @@ -1405,30 +1420,30 @@ Gömülü aracı için isteğe bağlı sandboxing. Tam kılavuz için [Sandboxin **OpenShell modu:** -- `mirror`: exec öncesi uzaktakini yerelden tohumla, exec sonrası geri eşitle; yerel çalışma alanı kanonik kalır -- `remote`: uzak ortamı sandbox oluşturulduğunda bir kez tohumla, sonra uzak çalışma alanını kanonik tut +- `mirror`: exec öncesi uzağı yerelden tohumla, exec sonrası geri senkronize et; yerel çalışma alanı kanonik kalır +- `remote`: sandbox oluşturulduğunda uzağı bir kez tohumla, ardından uzak çalışma alanını kanonik tut -`remote` modunda, OpenClaw dışında host üzerinde yapılan yerel düzenlemeler tohumlama adımından sonra sandbox'a otomatik olarak eşitlenmez. -Taşıma SSH üzerinden OpenShell sandbox'ına yapılır, ancak sandbox yaşam döngüsü ve isteğe bağlı mirror eşitleme plugin tarafından yönetilir. +`remote` modunda, OpenClaw dışında yapılan ana makine yerel düzenlemeleri tohumlama adımından sonra otomatik olarak sandbox içine senkronize edilmez. +Taşıma SSH üzerinden OpenShell sandbox içine yapılır, ancak sandbox yaşam döngüsü ve isteğe bağlı mirror sync plugin tarafından yönetilir. -**`setupCommand`**, kapsayıcı oluşturulduktan sonra bir kez çalışır (`sh -lc` ile). Ağ çıkışı, yazılabilir kök, root kullanıcı gerektirir. +**`setupCommand`**, kapsayıcı oluşturulduktan sonra bir kez çalışır (`sh -lc` aracılığıyla). Ağ çıkışı, yazılabilir kök ve root kullanıcı gerekir. -**Kapsayıcılar varsayılan olarak `network: "none"` kullanır** — aracı dış erişime ihtiyaç duyuyorsa bunu `"bridge"` (veya özel bir bridge ağı) olarak ayarlayın. -`"host"` engellenir. `"container:"` varsayılan olarak engellenir; bunu ancak açıkça -`sandbox.docker.dangerouslyAllowContainerNamespaceJoin: true` ayarlarsanız kullanabilirsiniz (acil durum). +**Kapsayıcıların varsayılanı `network: "none"`** — ajanın dış erişime ihtiyacı varsa `"bridge"` (veya özel bir bridge ağı) olarak ayarlayın. +`"host"` engellenmiştir. `"container:"`, yalnızca +`sandbox.docker.dangerouslyAllowContainerNamespaceJoin: true` açıkça ayarlanırsa varsayılan olarak izin verilir (cam kırma). -**Gelen ekler**, etkin çalışma alanındaki `media/inbound/*` içine sahnelenir. +**Gelen ek dosyalar**, etkin çalışma alanındaki `media/inbound/*` konumuna hazırlanır. -**`docker.binds`**, ek host dizinlerini bağlar; genel ve aracı başına bind'ler birleştirilir. +**`docker.binds`**, ek ana makine dizinlerini bağlar; genel ve ajan başına bağlar birleştirilir. -**Sandboxed browser** (`sandbox.browser.enabled`): bir kapsayıcı içinde Chromium + CDP. noVNC URL'si sistem istemine enjekte edilir. `openclaw.json` içinde `browser.enabled` gerekmez. -noVNC gözlemci erişimi varsayılan olarak VNC auth kullanır ve OpenClaw, paylaşılan URL içinde şifreyi açığa çıkarmak yerine kısa ömürlü bir token URL üretir. +**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ü bir token URL üretir. -- `allowHostControl: false` (varsayılan), sandbox oturumlarının host browser'ı hedeflemesini engeller. -- `network` varsayılan olarak `openclaw-sandbox-browser` kullanır (özel bridge ağı). Yalnızca açıkça genel bridge bağlantısı istediğinizde `bridge` olarak ayarlayın. -- `cdpSourceRange`, CDP girişini kapsayıcı kenarında isteğe bağlı olarak bir CIDR aralığına kısıtlar (örneğin `172.21.0.1/32`). -- `sandbox.browser.binds`, ek host dizinlerini yalnızca sandbox browser kapsayıcısı içine bağlar. Ayarlandığında (`[]` dahil), browser kapsayıcısı için `docker.binds` değerinin yerini alır. -- Başlatma varsayılanları `scripts/sandbox-browser-entrypoint.sh` içinde tanımlanır ve kapsayıcı host'ları için ayarlanmıştır: +- `allowHostControl: false` (varsayılan), sandboxed oturumların ana makine tarayıcısını hedeflemesini engeller. +- `network` varsayılanı `openclaw-sandbox-browser`'dır (özel bridge ağı). Yalnızca açıkça genel bridge bağlantısı istediğinizde `bridge` olarak ayarlayın. +- `cdpSourceRange`, CDP girişini kapsayıcı kenarında isteğe bağlı olarak bir CIDR aralığıyla sınırlayabilir (örneğin `172.21.0.1/32`). +- `sandbox.browser.binds`, ek ana makine dizinlerini yalnızca sandbox browser kapsayıcısına bağlar. Ayarlandığında (`[]` dahil), tarayıcı kapsayıcısı için `docker.binds` değerinin yerini alır. +- Başlatma varsayılanları `scripts/sandbox-browser-entrypoint.sh` içinde tanımlanır ve kapsayıcı ana makineleri için ayarlanmıştır: - `--remote-debugging-address=127.0.0.1` - `--remote-debugging-port=` - `--user-data-dir=${HOME}/.chrome` @@ -1447,29 +1462,28 @@ noVNC gözlemci erişimi varsayılan olarak VNC auth kullanır ve OpenClaw, payl - `--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ı gerektiriyorsa + 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 uzantıları yeniden etkinleştirmek için - `OPENCLAW_BROWSER_DISABLE_EXTENSIONS=0` kullanın. - - `--renderer-process-limit=2` değeri - `OPENCLAW_BROWSER_RENDERER_PROCESS_LIMIT=` ile değiştirilebilir; - Chromium'un varsayılan süreç sınırını kullanmak için `0` ayarlayın. - - `noSandbox` etkinse ayrıca `--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 bir browser görseli ve özel bir entrypoint kullanın. + - `OPENCLAW_BROWSER_DISABLE_EXTENSIONS=0`, iş akışınız + bunlara bağlıysa uzantıları yeniden etkinleştirir. + - `--renderer-process-limit=2`, + `OPENCLAW_BROWSER_RENDERER_PROCESS_LIMIT=` ile değiştirilebilir; Chromium'un + varsayılan süreç sınırını kullanmak için `0` ayarlayın. + - ayrıca `noSandbox` etkinleştirildiğinde `--no-sandbox` ve `--disable-setuid-sandbox`. + - Varsayılanlar kapsayıcı görüntüsü taban çizgisidir; kapsayıcı varsayılanlarını değiştirmek için özel giriş noktasına sahip özel bir tarayıcı görüntüsü kullanın. -Browser sandboxing ve `sandbox.docker.binds` şu anda yalnızca Docker'da desteklenir. +Tarayıcı sandboxing ve `sandbox.docker.binds` şu anda yalnızca Docker'da desteklenmektedir. -Görselleri derleyin: +Görüntüleri derleme: ```bash -scripts/sandbox-setup.sh # ana sandbox görseli -scripts/sandbox-browser-setup.sh # isteğe bağlı browser görseli +scripts/sandbox-setup.sh # ana sandbox görüntüsü +scripts/sandbox-browser-setup.sh # isteğe bağlı tarayıcı görüntüsü ``` -### `agents.list` (aracı başına geçersiz kılmalar) +### `agents.list` (ajan başına geçersiz kılmalar) ```json5 { @@ -1478,15 +1492,15 @@ scripts/sandbox-browser-setup.sh # isteğe bağlı browser görseli { id: "main", default: true, - name: "Ana Aracı", + name: "Ana Ajan", workspace: "~/.openclaw/workspace", agentDir: "~/.openclaw/agents/main/agent", model: "anthropic/claude-opus-4-6", // veya { primary, fallbacks } - thinkingDefault: "high", // aracı başına thinking düzeyi geçersiz kılması - reasoningDefault: "on", // aracı başına reasoning görünürlüğü geçersiz kılması - fastModeDefault: false, // aracı başına fast mode geçersiz kılması + 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 fast mode geçersiz kılması params: { cacheRetention: "none" }, // eşleşen defaults.models params değerlerini anahtar bazında geçersiz kılar - skills: ["docs-search"], // ayarlandığında agents.defaults.skills değerinin yerini alır + skills: ["docs-search"], // ayarlandığında agents.defaults.skills değerinin yerine geçer identity: { name: "Samantha", theme: "yardımsever tembel hayvan", @@ -1517,26 +1531,26 @@ scripts/sandbox-browser-setup.sh # isteğe bağlı browser görseli } ``` -- `id`: kararlı aracı kimliği (gerekli). -- `default`: birden fazlası ayarlıysa ilki 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 (`[]`, genel fallback'leri devre dışı bırakır). Yalnızca `primary` geçersiz kılan cron görevleri, siz `fallbacks: []` ayarlamadıkça yine varsayılan fallback'leri devralır. -- `params`: `agents.defaults.models` içindeki seçilen model girdisinin üzerine birleştirilen aracı başına akış parametreleri. Tüm model kataloğunu kopyalamadan `cacheRetention`, `temperature` veya `maxTokens` gibi aracıya özgü geçersiz kılmalar için bunu kullanın. -- `skills`: isteğe bağlı aracı başına Skills izin listesi. Atlanırsa aracı, ayarlıysa `agents.defaults.skills` değerini devralır; açık bir liste varsayılanlarla birleşmek yerine onların yerini alır ve `[]` hiçbir Skills olmadığı anlamına gelir. -- `thinkingDefault`: isteğe bağlı aracı başına varsayılan thinking düzeyi (`off | minimal | low | medium | high | xhigh | adaptive`). Mesaj başına veya oturum geçersiz kılması ayarlanmamış olduğunda bu aracı için `agents.defaults.thinkingDefault` değerini geçersiz kılar. -- `reasoningDefault`: isteğe bağlı aracı başına varsayılan reasoning görünürlüğü (`on | off | stream`). Mesaj başına veya oturum reasoning geçersiz kılması ayarlanmamış olduğunda uygulanır. -- `fastModeDefault`: isteğe bağlı aracı başına varsayılan fast mode değeri (`true | false`). Mesaj başına veya oturum fast-mode geçersiz kılması ayarlanmamış olduğunda uygulanır. -- `runtime`: isteğe bağlı aracı başına çalışma zamanı tanımlayıcısı. Aracının varsayılan olarak ACP harness oturumları kullanması gerekiyorsa `runtime.acp` varsayılanları (`agent`, `backend`, `mode`, `cwd`) ile `type: "acp"` kullanın. -- `identity.avatar`: çalışma alanına göreli yol, `http(s)` URL veya `data:` URI. +- `id`: kararlı ajan kimliği (zorunlu). +- `default`: birden fazlası ayarlanırsa ilki kazanır (uyarı günlüğe yazılır). Hiçbiri ayarlanmazsa ilk liste girdisi varsayılandır. +- `model`: dize biçimi yalnızca `primary` değerini geçersiz kılar; nesne biçimi `{ primary, fallbacks }` her ikisini de geçersiz kılar (`[]`, genel fallback'leri devre dışı bırakır). Yalnızca `primary` geçersiz kılan cron işleri, `fallbacks: []` ayarlamadığınız sürece varsayılan fallback'leri yine de devralır. +- `params`: seçilen model girdisi üzerindeki `agents.defaults.models` değerinin üstüne birleştirilen ajan başına akış parametreleri. Tüm model kataloğunu kopyalamadan `cacheRetention`, `temperature` veya `maxTokens` gibi ajan özel geçersiz kılmaları için bunu kullanın. +- `skills`: isteğe bağlı ajan başına skill izin listesi. Atlanırsa ajan, ayarlıysa `agents.defaults.skills` değerini devralır; açık liste varsayılanlarla birleştirilmez, onların yerine geçer ve `[]` skill yok anlamına gelir. +- `thinkingDefault`: isteğe bağlı ajan başına varsayılan thinking düzeyi (`off | minimal | low | medium | high | xhigh | adaptive`). Mesaj başına veya oturum geçersiz kılması ayarlı olmadığında bu ajan için `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 reasoning geçersiz kılması ayarlı olmadığında uygulanır. +- `fastModeDefault`: isteğe bağlı ajan başına fast mode varsayılanı (`true | false`). Mesaj başına veya oturum fast-mode geçersiz kılması ayarlı olmadığında uygulanır. +- `runtime`: isteğe bağlı ajan başına çalışma zamanı tanımlayıcısı. Ajan ACP harness oturumlarına varsayılan olsun isteniyorsa `type: "acp"` ile `runtime.acp` varsayılanlarını (`agent`, `backend`, `mode`, `cwd`) kullanın. +- `identity.avatar`: çalışma alanına göreli yol, `http(s)` URL'si veya `data:` URI'si. - `identity`, varsayılanlar türetir: `ackReaction` için `emoji`, `mentionPatterns` için `name`/`emoji`. -- `subagents.allowAgents`: `sessions_spawn` için aracı kimliği izin listesi (`["*"]` = herhangi biri; varsayılan: yalnızca aynı aracı). -- Sandbox devralma koruması: isteyen oturum sandbox içindeyse, `sessions_spawn` sandbox dışında çalışacak hedefleri reddeder. -- `subagents.requireAgentId`: true olduğunda, `agentId` atlayan `sessions_spawn` çağrılarını engeller (açık profil seçimini zorlar; varsayılan: false). +- `subagents.allowAgents`: `sessions_spawn` için ajan kimliği izin listesi (`["*"]` = herhangi biri; varsayılan: yalnızca aynı ajan). +- Sandbox kalıtım koruması: istekte bulunan oturum sandboxed ise `sessions_spawn`, sandbox olmadan çalışacak hedefleri reddeder. +- `subagents.requireAgentId`: true olduğunda `agentId` atlayan `sessions_spawn` çağrılarını engeller (açık profil seçimini zorlar; varsayılan: false). --- -## Çoklu aracı yönlendirmesi +## Çok ajanlı yönlendirme -Bir Gateway içinde birden çok yalıtılmış aracı ç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 { @@ -1553,29 +1567,29 @@ Bir Gateway içinde birden çok yalıtılmış aracı çalıştırın. Bkz. [Mul } ``` -### Bağlama eşleşme alanları +### Bağ eşleştirme alanları -- `type` (isteğe bağlı): normal yönlendirme için `route` (tip yoksa route varsayılır), kalıcı ACP konuşma bağlamaları için `acp`. -- `match.channel` (gerekli) +- `type` (isteğe bağlı): normal yönlendirme için `route` (eksik type varsayılan olarak 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ü) - `acp` (isteğe bağlı; yalnızca `type: "acp"` için): `{ mode, label, cwd, backend }` -**Deterministik eşleşme sırası:** +**Belirlenimci eşleşme sırası:** 1. `match.peer` 2. `match.guildId` 3. `match.teamId` -4. `match.accountId` (tam eşleşme, peer/guild/team yok) +4. `match.accountId` (tam eşleşme, peer/guild/team olmadan) 5. `match.accountId: "*"` (kanal genelinde) -6. Varsayılan aracı +6. Varsayılan ajan -Her katmanda, eşleşen ilk `bindings` girdisi kazanır. +Her katman içinde ilk eşleşen `bindings` girdisi kazanır. -`type: "acp"` girdileri için OpenClaw tam konuşma kimliğine göre çözer (`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ümleme yapar (`match.channel` + hesap + `match.peer.id`) ve yukarıdaki route binding katman sırasını kullanmaz. -### Aracı başına erişim profilleri +### Ajan başına erişim profilleri @@ -1670,7 +1684,7 @@ Her katmanda, eşleşen ilk `bindings` girdisi kazanır. -Öncelik ayrıntıları için [Multi-Agent Sandbox & Tools](/tr/tools/multi-agent-sandbox-tools) bölümüne bakın. +Öncelik ayrıntıları için bkz. [Multi-Agent Sandbox & Tools](/tr/tools/multi-agent-sandbox-tools). --- @@ -1696,7 +1710,7 @@ Her katmanda, eşleşen ilk `bindings` girdisi kazanır. }, resetTriggers: ["/new", "/reset"], store: "~/.openclaw/agents/{agentId}/sessions/sessions.json", - parentForkMaxTokens: 100000, // bu token sayısının üstünde üst konu fork'unu atla (0 devre dışı bırakır) + parentForkMaxTokens: 100000, // bunun üzerindeki token sayısında parent-thread fork atlanır (0 devre dışı bırakır) maintenance: { mode: "warn", // warn | enforce pruneAfter: "30d", @@ -1708,8 +1722,8 @@ Her katmanda, eşleşen ilk `bindings` girdisi kazanır. }, threadBindings: { enabled: true, - idleHours: 24, // saat cinsinden varsayılan etkin olmama otomatik odak kaldırma (`0` devre dışı bırakır) - maxAgeHours: 0, // saat cinsinden varsayılan katı maksimum yaş (`0` devre dışı bırakır) + idleHours: 24, // varsayılan hareketsizlik nedeniyle otomatik odak kaldırma saati (`0` devre dışı bırakır) + maxAgeHours: 0, // varsayılan zorunlu maksimum yaş saati (`0` devre dışı bırakır) }, mainKey: "main", // eski (çalışma zamanı her zaman "main" kullanır) agentToAgent: { maxPingPongTurns: 5 }, @@ -1721,37 +1735,37 @@ Her katmanda, eşleşen ilk `bindings` girdisi kazanır. } ``` - + - **`scope`**: grup sohbeti bağlamları için temel oturum gruplama stratejisi. - - `per-sender` (varsayılan): her gönderici, bir kanal bağlamı içinde yalıtılmış bir oturum alır. - - `global`: bir kanal bağlamındaki tüm katılımcılar tek bir oturumu paylaşır (yalnızca paylaşılan bağlam istendiğinde kullanın). + - `per-sender` (varsayılan): her gönderici, 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 istendiğinde kullanın). - **`dmScope`**: DM'lerin nasıl gruplandığı. - `main`: tüm DM'ler ana oturumu paylaşır. - - `per-peer`: kanallar arasında gönderen kimliğine göre 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 kanonik kimlikleri sağlayıcı önekli peer'lere eşler. -- **`reset`**: birincil sıfırlama ilkesi. `daily`, yerel saatte `atHour` zamanında sıfırlar; `idle`, `idleMinutes` sonrasında sıfırlar. Her ikisi de yapılandırılmışsa hangisi önce dolarsa o kazanır. + - `per-peer`: kanallar arasında gönderen kimliğine göre yalıt. + - `per-channel-peer`: kanal + gönderen başına yalıt (çok kullanıcılı inbox'lar için önerilir). + - `per-account-channel-peer`: hesap + kanal + gönderen başına yalıt (çok hesap için önerilir). +- **`identityLinks`**: kanallar arası oturum paylaşımı için kanonik kimlikleri sağlayıcı önekli eşlere eşleyen harita. +- **`reset`**: birincil sıfırlama ilkesi. `daily`, yerel saatte `atHour` zamanında sıfırlar; `idle`, `idleMinutes` sonrasında sıfırlar. Her ikisi de yapılandırıldığında hangisinin süresi önce dolarsa o 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`**: fork edilmiş bir konu oturumu oluşturulurken izin verilen en fazla üst oturum `totalTokens` değeri (varsayılan `100000`). - - Üst oturum `totalTokens` değeri bu değerin üzerindeyse OpenClaw üst transkript geçmişini devralmak yerine yeni bir konu oturumu başlatır. - - Bu korumayı devre dışı bırakmak ve üst fork'u her zaman izinli yapmak 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`**: aracıdan aracıya değişimler sırasında aracılar arasındaki en yüksek geri yanıt turu sayısı (tamsayı, 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ştir. İlk deny kazanır. -- **`maintenance`**: oturum deposu temizliği + saklama denetimleri. +- **`parentForkMaxTokens`**: fork edilmiş iş parçacığı oturumu oluştururken izin verilen maksimum ana oturum `totalTokens` değeri (varsayılan `100000`). + - Parent `totalTokens` bu değerin üzerindeyse OpenClaw, parent transcript geçmişini devralmak yerine yeni bir iş parçacığı oturumu başlatır. + - Bu korumayı devre dışı bırakmak ve parent fork'a her zaman izin vermek için `0` ayarlayın. +- **`mainKey`**: eski alan. Çalışma zamanı artık her zaman ana doğrudan sohbet kovası için `"main"` kullanır. +- **`agentToAgent.maxPingPongTurns`**: ajanlar arası alışveriş sırasında ajanlar arasındaki maksimum yanıt dönüşü sayısı (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ştirme yapar. İlk deny kazanır. +- **`maintenance`**: oturum deposu temizleme + saklama denetimleri. - `mode`: `warn` yalnızca uyarı ü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`). + - `maxEntries`: `sessions.json` içindeki maksimum girdi sayısı (varsayılan `500`). - `rotateBytes`: `sessions.json` bu boyutu aştığında döndür (varsayılan `10mb`). - - `resetArchiveRetention`: `*.reset.` transkript arşivleri için saklama süresi. Varsayılan olarak `pruneAfter` kullanılır; devre dışı bırakmak için `false` ayarlayın. - - `maxDiskBytes`: oturum dizini için isteğe bağlı disk bütçesi. `warn` modunda uyarılar günlüğe yazılır; `enforce` modunda önce en eski artifaktlar/oturumlar kaldırılır. - - `highWaterBytes`: bütçe temizliğinden sonraki isteğe bağlı hedef. Varsayılan `maxDiskBytes` değerinin `%80`'idir. -- **`threadBindings`**: konuya bağlı oturum özellikleri için genel varsayılanlar. + - `resetArchiveRetention`: `*.reset.` transcript arşivleri için saklama süresi. Varsayılan olarak `pruneAfter`; devre dışı bırakmak için `false` ayarlayın. + - `maxDiskBytes`: isteğe bağlı oturumlar dizini disk bütçesi. `warn` modunda uyarı günlüğe yazılır; `enforce` modunda en eski yapıtlar/oturumlar önce kaldırılır. + - `highWaterBytes`: bütçe temizliğinden sonraki isteğe bağlı hedef. Varsayılan olarak `maxDiskBytes` değerinin `%80`'i. +- **`threadBindings`**: iş parçacığına bağlı oturum özellikleri için genel varsayılanlar. - `enabled`: ana varsayılan anahtar (sağlayıcılar geçersiz kılabilir; Discord `channels.discord.threadBindings.enabled` kullanır) - - `idleHours`: saat cinsinden varsayılan etkin olmama 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) + - `idleHours`: hareketsizlik nedeniyle otomatik odak kaldırma için varsayılan saat (`0` devre dışı bırakır; sağlayıcılar geçersiz kılabilir) + - `maxAgeHours`: zorunlu maksimum yaş için varsayılan saat (`0` devre dışı bırakır; sağlayıcılar geçersiz kılabilir) @@ -1795,30 +1809,30 @@ Kanal/hesap başına geçersiz kılmalar: `channels..responsePrefix`, ` **Şablon değişkenleri:** -| 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}`| Aracı kimlik adı | (`"auto"` ile aynı) | +| Değişken | Açıklama | Örnek | +| ----------------- | ---------------------- | --------------------------- | +| `{model}` | Kısa model adı | `claude-opus-4-6` | +| `{modelFull}` | Tam model tanımlayıcısı | `anthropic/claude-opus-4-6` | +| `{provider}` | Sağlayıcı adı | `anthropic` | +| `{thinkingLevel}` | Geçerli thinking düzeyi | `high`, `low`, `off` | +| `{identity.name}` | Ajan kimlik adı | (`"auto"` ile aynı) | -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 harf duyarsızdır. `{think}`, `{thinkingLevel}` için takma addır. -### Ack reaction +### Ack tepkisi -- Varsayılan olarak etkin aracının `identity.emoji` değeridir, aksi halde `"👀"`. Devre dışı bırakmak için `""` ayarlayın. +- Varsayılan olarak etkin ajanın `identity.emoji` değeri kullanılır, aksi halde `"👀"`. Devre dışı bırakmak için `""` ayarlayın. - Kanal başına geçersiz kılmalar: `channels..ackReaction`, `channels..accounts..ackReaction`. -- Çözümleme sırası: hesap → kanal → `messages.ackReaction` → kimlik geri dönüşü. +- Çözümleme sırası: hesap → kanal → `messages.ackReaction` → identity geri dönüşü. - 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 ayarlanmamışsa, ack tepkileri etkinken durum tepkileri etkin kalır. - Telegram'da yaşam döngüsü durum tepkilerini etkinleştirmek için bunu açıkça `true` olarak ayarlayın. + 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 gelen hızlı, yalnızca metin içeren mesajları tek bir aracı dönüşünde toplar. Medya/ek dosyalar hemen boşaltılır. Kontrol komutları debouncing'i atlar. +Aynı göndericiden gelen hızlı salt metin mesajlarını tek bir ajan dönüşünde birleştirir. Medya/ekler hemen temizlenir. Denetim komutları debounce'u atlar. ### TTS (text-to-speech) @@ -1861,12 +1875,12 @@ Aynı göndericiden gelen hızlı, yalnızca metin içeren mesajları tek bir ar } ``` -- `auto`, otomatik TTS'yi kontrol eder. `/tts off|always|inbound|tagged`, oturum başına geçersiz kılar. +- `auto`, otomatik TTS'yi kontrol eder. `/tts off|always|inbound|tagged` oturum başına geçersiz kılar. - `summaryModel`, otomatik özet için `agents.defaults.model.primary` değerini geçersiz kılar. -- `modelOverrides` varsayılan olarak etkindir; `modelOverrides.allowProvider` varsayılan olarak `false` değerindedir (açık katılım). -- API anahtarları geri dönüş 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` şeklindedir. -- `openai.baseUrl` OpenAI dışı bir uç noktaya işaret ettiğinde OpenClaw bunu OpenAI uyumlu bir TTS sunucusu olarak ele alır ve model/ses doğrulamasını gevşetir. +- `modelOverrides` varsayılan olarak etkindir; `modelOverrides.allowProvider` varsayılan olarak `false`'dur (katılım gerektirir). +- API anahtarları `ELEVENLABS_API_KEY`/`XI_API_KEY` ve `OPENAI_API_KEY` değerlerine geri döner. +- `openai.baseUrl`, OpenAI TTS uç noktasını geçersiz kılar. Çözümleme sırası yapılandırma, ardından `OPENAI_TTS_BASE_URL`, ardından `https://api.openai.com/v1`. +- `openai.baseUrl` OpenAI dışı bir uç noktaya işaret ettiğinde, OpenClaw bunu OpenAI uyumlu bir TTS sunucusu olarak değerlendirir ve model/ses doğrulamasını gevşetir. --- @@ -1896,13 +1910,13 @@ Talk modu için varsayılanlar (macOS/iOS/Android). } ``` -- `talk.provider`, birden çok Talk sağlayıcısı yapılandırıldığında `talk.providers` içindeki bir anahtarla eşleşmelidir. +- `talk.provider`, birden fazla 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.` içine taşınır. -- Ses kimlikleri geri dönüş olarak `ELEVENLABS_VOICE_ID` veya `SAG_VOICE_ID` kullanır. -- `providers.*.apiKey`, düz metin dizeleri veya SecretRef nesnelerini kabul eder. -- `ELEVENLABS_API_KEY` geri dönüşü, yalnızca yapılandırılmış bir Talk API anahtarı yoksa uygulanır. -- `providers.*.voiceAliases`, Talk yönergelerinin dostane adlar kullanmasına izin verir. -- `silenceTimeoutMs`, Talk modunun transkripti göndermeden önce kullanıcı sessizliğinden sonra ne kadar bekleyeceğini kontrol eder. Ayarlanmamışsa platformun varsayılan duraklama penceresi korunur (`macOS ve Android'de 700 ms, iOS'ta 900 ms`). +- Voice ID'ler `ELEVENLABS_VOICE_ID` veya `SAG_VOICE_ID` değerlerine geri döner. +- `providers.*.apiKey`, düz metin dizeleri veya SecretRef nesneleri kabul eder. +- `ELEVENLABS_API_KEY` geri dönüşü yalnızca Talk API anahtarı yapılandırılmadığında uygulanır. +- `providers.*.voiceAliases`, Talk yönergelerinin kullanıcı dostu adlar kullanmasını sağlar. +- `silenceTimeoutMs`, Talk modunun kullanıcı sessizliğinden sonra transcript'i göndermeden önce ne kadar bekleyeceğini kontrol eder. Ayarlanmazsa platform varsayılan duraklama penceresi korunur (`macOS ve Android'de 700 ms, iOS'te 900 ms`). --- @@ -1910,37 +1924,37 @@ Talk modu için varsayılanlar (macOS/iOS/Android). ### Araç profilleri -`tools.profile`, `tools.allow`/`tools.deny` öncesinde temel bir izin listesi ayarlar: +`tools.profile`, `tools.allow`/`tools.deny` öncesinde temel bir izin listesi belirler: -Yerel onboarding, ayarlanmamış 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ı varsayılan olarak `tools.profile: "coding"` ile oluşturur (mevcut açık profiller korunur). -| Profil | İçerir | -| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | -| `minimal` | yalnızca `session_status` | +| Profil | Şunları iç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ışla aynıdır) | +| `messaging` | `group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status` | +| `full` | Kısıtlama yok (ayarlanmamış ile aynı) | ### Araç grupları -| Grup | Araçlar | -| ------------------ | ---------------------------------------------------------------------------------------------------------------------- | -| `group:runtime` | `exec`, `process`, `code_execution` (`bash`, `exec` için takma ad olarak kabul edilir) | -| `group:fs` | `read`, `write`, `edit`, `apply_patch` | +| Grup | Araçlar | +| ------------------ | ----------------------------------------------------------------------------------------------------------------------- | +| `group:runtime` | `exec`, `process`, `code_execution` (`bash`, `exec` için takma ad olarak kabul edilir) | +| `group:fs` | `read`, `write`, `edit`, `apply_patch` | | `group:sessions` | `sessions_list`, `sessions_history`, `sessions_send`, `sessions_spawn`, `sessions_yield`, `subagents`, `session_status` | -| `group:memory` | `memory_search`, `memory_get` | -| `group:web` | `web_search`, `x_search`, `web_fetch` | -| `group:ui` | `browser`, `canvas` | -| `group:automation` | `cron`, `gateway` | -| `group:messaging` | `message` | -| `group:nodes` | `nodes` | -| `group:agents` | `agents_list` | -| `group:media` | `image`, `image_generate`, `video_generate`, `tts` | -| `group:openclaw` | Tüm yerleşik araçlar (sağlayıcı plugin'leri hariç) | +| `group:memory` | `memory_search`, `memory_get` | +| `group:web` | `web_search`, `x_search`, `web_fetch` | +| `group:ui` | `browser`, `canvas` | +| `group:automation` | `cron`, `gateway` | +| `group:messaging` | `message` | +| `group:nodes` | `nodes` | +| `group:agents` | `agents_list` | +| `group:media` | `image`, `image_generate`, `video_generate`, `tts` | +| `group:openclaw` | Tüm yerleşik araçlar (sağlayıcı plugin'leri hariç) | ### `tools.allow` / `tools.deny` -Genel araç izin/verme reddetme ilkesi (deny kazanır). Büyük/küçük harfe duyarsızdır, `*` joker karakterlerini destekler. Docker sandbox kapalıyken bile uygulanır. +Genel araç izin/verme ilkesi (deny kazanır). Büyük/küçük harf duyarsızdır, `*` joker karakterlerini destekler. Docker sandbox kapalıyken bile uygulanır. ```json5 { @@ -1982,9 +1996,9 @@ Sandbox dışındaki elevated exec erişimini kontrol eder: } ``` -- Aracı 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 saklar; satır içi yönergeler tek bir mesaja uygulanır. -- Elevated `exec`, sandboxing'i atlar ve yapılandırılmış kaçış yolunu kullanır (`gateway` varsayılan veya exec hedefi `node` olduğunda `node`). +- Ajan 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 saklar; satır içi yönergeler yalnızca tek mesaj için uygulanır. +- Elevated `exec`, sandboxing'i atlar ve yapılandırılmış kaçış yolunu kullanır (`gateway` varsayılan, veya exec hedefi `node` olduğunda `node`). ### `tools.exec` @@ -2008,8 +2022,8 @@ Sandbox dışındaki elevated exec erişimini kontrol eder: ### `tools.loopDetection` -Araç döngüsü güvenlik denetimleri varsayılan olarak **devre dışıdır**. Algılamayı etkinleştirmek için `enabled: true` ayarlayın. -Ayarlar genel olarak `tools.loopDetection` içinde tanımlanabilir ve aracı 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 genel olarak `tools.loopDetection` içinde tanımlanabilir ve ajan başına `agents.list[].tools.loopDetection` ile geçersiz kılınabilir. ```json5 { @@ -2031,12 +2045,12 @@ Ayarlar genel olarak `tools.loopDetection` içinde tanımlanabilir ve aracı ba ``` - `historySize`: döngü analizi için tutulan maksimum araç çağrısı geçmişi. -- `warningThreshold`: uyarılar için tekrarlayan ilerleme olmayan desen eşiği. +- `warningThreshold`: uyarılar için tekrarlayan ilerleme yok deseni eşiği. - `criticalThreshold`: kritik döngüleri engellemek için daha yüksek tekrar eşiği. -- `globalCircuitBreakerThreshold`: herhangi bir ilerleme olmayan çalışma için katı durdurma eşiği. -- `detectors.genericRepeat`: aynı araç/aynı bağımsız değişken çağrılarında uyar. -- `detectors.knownPollNoProgress`: bilinen yoklama araçlarında (`process.poll`, `command_status` vb.) uyar/engelle. -- `detectors.pingPong`: değişimli ilerleme olmayan çift desenlerinde uyar/engelle. +- `globalCircuitBreakerThreshold`: ilerleme olmayan her çalıştırma için katı durdurma eşiği. +- `detectors.genericRepeat`: tekrarlanan aynı araç/aynı argüman çağrıları için uyarır. +- `detectors.knownPollNoProgress`: bilinen poll araçlarında (`process.poll`, `command_status` vb.) uyarır/engeller. +- `detectors.pingPong`: dönüşümlü ilerleme olmayan çift desenleri için uyarır/engeller. - `warningThreshold >= criticalThreshold` veya `criticalThreshold >= globalCircuitBreakerThreshold` ise doğrulama başarısız olur. ### `tools.web` @@ -2071,7 +2085,7 @@ Ayarlar genel olarak `tools.loopDetection` içinde tanımlanabilir ve aracı ba ### `tools.media` -Gelen medya anlamayı yapılandırır (görsel/ses/video): +Gelen medya anlamayı yapılandırır (görüntü/ses/video): ```json5 { @@ -2079,7 +2093,7 @@ Gelen medya anlamayı yapılandırır (görsel/ses/video): media: { concurrency: 2, asyncCompletion: { - directSend: false, // açık katılım: tamamlanan asenkron müzik/videoyu doğrudan kanala gönder + directSend: false, // katılım gerektirir: tamamlanan async music/video'yu doğrudan kanala gönder }, audio: { enabled: true, @@ -2114,19 +2128,19 @@ Gelen medya anlamayı yapılandırır (görsel/ses/video): **CLI girdisi** (`type: "cli"`): - `command`: çalıştırılacak yürütülebilir dosya -- `args`: şablonlu bağımsız değişkenler (`{{MediaPath}}`, `{{Prompt}}`, `{{MaxChars}}` vb. desteklenir) +- `args`: şablonlanmış argümanlar (`{{MediaPath}}`, `{{Prompt}}`, `{{MaxChars}}` vb. destekler) **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. -- Başarısızlıklar bir sonraki girdiye geri döner. +- `prompt`, `maxChars`, `maxBytes`, `timeoutSeconds`, `language`: girdi başına geçersiz kılmalar. +- Başarısızlıklar sonraki girdiye geri döner. -Sağlayıcı auth, 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`. -**Asenkron tamamlama alanları:** +**Async completion alanları:** -- `asyncCompletion.directSend`: `true` olduğunda tamamlanan asenkron `music_generate` +- `asyncCompletion.directSend`: `true` olduğunda, tamamlanan async `music_generate` ve `video_generate` görevleri önce doğrudan kanal teslimini dener. Varsayılan: `false` (eski requester-session wake/model-delivery yolu). @@ -2149,7 +2163,7 @@ Sağlayıcı auth, standart sırayı izler: `auth-profiles.json` → ortam deği Oturum araçlarının (`sessions_list`, `sessions_history`, `sessions_send`) hangi oturumları hedefleyebileceğini kontrol eder. -Varsayılan: `tree` (geçerli oturum + onun başlattığı oturumlar, örneğin alt aracılar). +Varsayılan: `tree` (geçerli oturum + onun tarafından oluşturulan oturumlar, örneğin subagent'lar). ```json5 { @@ -2165,10 +2179,10 @@ Varsayılan: `tree` (geçerli oturum + onun başlattığı oturumlar, örneğin Notlar: - `self`: yalnızca geçerli oturum anahtarı. -- `tree`: geçerli oturum + geçerli oturumun başlattığı oturumlar (alt aracılar). -- `agent`: geçerli aracı kimliğine ait herhangi bir oturum (aynı aracı 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. Aracılar arası hedefleme için yine de `tools.agentToAgent` gerekir. -- Sandbox clamp: geçerli oturum sandbox içindeyse ve `agents.defaults.sandbox.sessionToolsVisibility="spawned"` ise, `tools.sessions.visibility="all"` olsa bile görünürlük `tree` olarak zorlanır. +- `tree`: geçerli oturum + geçerli oturum tarafından oluşturulan oturumlar (subagent'lar). +- `agent`: geçerli 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 için yine de `tools.agentToAgent` gerekir. +- Sandbox clamp: geçerli oturum sandboxed ise ve `agents.defaults.sandbox.sessionToolsVisibility="spawned"` ise görünürlük, `tools.sessions.visibility="all"` olsa bile `tree` olarak zorlanır. ### `tools.sessions_spawn` @@ -2179,8 +2193,8 @@ Notlar: tools: { sessions_spawn: { attachments: { - enabled: false, // açık katılım: satır içi dosya eklerine izin vermek için true yapın - maxTotalBytes: 5242880, // tüm dosyalar genelinde toplam 5 MB + enabled: false, // katılım gerektirir: satır içi dosya eklerine izin vermek için true ayarlayın + maxTotalBytes: 5242880, // tüm dosyalar arasında toplam 5 MB maxFiles: 50, maxFileBytes: 1048576, // dosya başına 1 MB retainOnSessionKeep: false, // cleanup="keep" olduğunda ekleri koru @@ -2192,16 +2206,16 @@ Notlar: Notlar: -- Ekler yalnızca `runtime: "subagent"` için desteklenir. ACP çalışma zamanı bunları reddeder. -- Dosyalar, `.manifest.json` ile birlikte alt çalışma alanında `.openclaw/attachments//` içine materyalize edilir. -- Ek içeriği transkript kalıcılığından otomatik olarak redakte edilir. -- Base64 girdileri katı alfabe/dolgu denetimleri ve decode öncesi boyut korumasıyla doğrulanır. -- Dosya izinleri dizinler için `0700`, dosyalar için `0600` olur. -- Temizleme `cleanup` ilkesini izler: `delete` her zaman ekleri kaldırır; `keep`, bunları yalnızca `retainOnSessionKeep: true` olduğunda tutar. +- Ek dosyalar yalnızca `runtime: "subagent"` için desteklenir. ACP çalışma zamanı bunları reddeder. +- Dosyalar çocuk çalışma alanında `.openclaw/attachments//` içine `.manifest.json` ile birlikte somutlaştırılır. +- Ek içeriği transcript kalıcılığından otomatik olarak redakte edilir. +- Base64 girdileri katı alfabe/padding denetimleri ve çözümleme öncesi boyut koruması ile doğrulanır. +- Dosya izinleri dizinler için `0700`, dosyalar için `0600`'dür. +- Temizleme, `cleanup` ilkesini izler: `delete` ekleri her zaman kaldırır; `keep` yalnızca `retainOnSessionKeep: true` olduğunda onları korur. ### `tools.experimental` -Deneysel yerleşik araç bayrakları. Çalışma zamanına özgü bir 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ıkça varsayılan kapalıdır. ```json5 { @@ -2215,9 +2229,9 @@ Deneysel yerleşik araç bayrakları. Çalışma zamanına özgü bir otomatik e Notlar: -- `planTool`: trivial olmayan çok adımlı iş takibi için yapılandırılmış `update_plan` aracını etkinleştirir. +- `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. -- Etkinleştirildiğinde sistem istemi de kullanım yönergeleri ekler; böylece model bunu yalnızca önemli işler için kullanır ve en fazla bir adımı `in_progress` durumda tutar. +- Etkinleştirildiğinde, sistem istemi de 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` tutar. ### `agents.defaults.subagents` @@ -2237,16 +2251,16 @@ Notlar: } ``` -- `model`: başlatılan alt aracılar için varsayılan model. Atlanırsa alt aracılar çağıranın modelini devralır. -- `allowAgents`: isteyen aracı kendi `subagents.allowAgents` değerini ayarlamadığında `sessions_spawn` için hedef aracı kimliklerinin varsayılan izin listesi (`["*"]` = herhangi biri; varsayılan: yalnızca aynı aracı). -- `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 aracı başına araç ilkesi: `tools.subagents.tools.allow` / `tools.subagents.tools.deny`. +- `model`: oluşturulan alt ajanlar için varsayılan model. Atlanırsa alt ajanlar çağıranın modelini devralır. +- `allowAgents`: istekte bulunan 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ı yok demektir. +- Alt ajan başına araç ilkesi: `tools.subagents.tools.allow` / `tools.subagents.tools.deny`. --- -## Özel sağlayıcılar ve base 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ırmadaki `models.providers` veya `~/.openclaw/agents//agent/models.json` aracılığıyla ekleyin. +OpenClaw, yerleşik model kataloğunu kullanır. `models.providers` ile veya `~/.openclaw/agents//agent/models.json` ile özel sağlayıcılar ekleyin. ```json5 { @@ -2275,46 +2289,46 @@ OpenClaw yerleşik model kataloğunu kullanır. Özel sağlayıcıları yapılan } ``` -- Özel auth ihtiyaçları için `authHeader: true` + `headers` kullanın. -- Aracı 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`). +- Ö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ı olan `PI_CODING_AGENT_DIR`). - Eşleşen sağlayıcı kimlikleri için birleştirme önceliği: - - Boş olmayan aracı `models.json` `baseUrl` değerleri kazanır. - - Boş olmayan aracı `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 ile yönetilen sağlayıcı `apiKey` değerleri, çözümlenmiş gizli bilgileri kalıcılaştırmak yerine kaynak belirteçlerinden (`ENV_VAR_NAME` ortam başvuruları için, dosya/exec başvuruları için `secretref-managed`) yenilenir. - - SecretRef ile yönetilen sağlayıcı header değerleri, kaynak belirteçlerinden (`ENV_VAR_NAME` ortam başvuruları için `secretref-env:ENV_VAR_NAME`, dosya/exec başvuruları için `secretref-managed`) yenilenir. - - Boş veya eksik aracı `apiKey`/`baseUrl`, yapılandırmadaki `models.providers` değerine geri döner. - - Eşleşen model `contextWindow`/`maxTokens`, 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; modelin doğal metadata'sını değiştirmeden etkili bağlamı sınırlandırmak için bunu kullanın. - - Yapılandırmanın `models.json` dosyasını tamamen yeniden yazmasını istediğinizde `models.mode: "replace"` kullanın. - - Belirteç kalıcılığı kaynak açısından yetkilidir: belirteçler, çö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. + - 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ülmüş gizli bilgileri kalıcılaştırmak yerine kaynak işaretlerinden (`ENV_VAR_NAME` env refs için, `secretref-managed` file/exec refs için) yenilenir. + - SecretRef tarafından yönetilen sağlayıcı header değerleri de kaynak işaretlerinden yenilenir (`secretref-env:ENV_VAR_NAME` env refs için, `secretref-managed` file/exec refs için). + - 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 ve örtük katalog değerleri arasındaki daha yüksek değeri kullanır. + - Eşleşen model `contextTokens`, varsa açık çalışma zamanı sınırını korur; modelin yerel metadata'sını değiştirmeden etkili 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. + - İşaretçi kalıcılığı kaynak yetkilidir: işaretçiler çözülmüş ç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ı +### Sağlayıcı alan ayrıntıları - `models.mode`: sağlayıcı katalog davranışı (`merge` veya `replace`). -- `models.providers`: sağlayıcı kimliğine göre anahtarlanmış özel sağlayıcı haritası. -- `models.providers.*.api`: istek adaptörü (`openai-completions`, `openai-responses`, `anthropic-messages`, `google-generative-ai` vb.). -- `models.providers.*.apiKey`: sağlayıcı kimlik bilgisi (SecretRef/ortam ikamesi tercih edilir). +- `models.providers`: sağlayıcı kimliğiyle anahtarlanmış özel sağlayıcı eşlemesi. +- `models.providers.*.api`: istek bağdaştırıcısı (`openai-completions`, `openai-responses`, `anthropic-messages`, `google-generative-ai` vb). +- `models.providers.*.apiKey`: sağlayıcı kimlik bilgisi (SecretRef/env substitution tercih edilir). - `models.providers.*.auth`: auth stratejisi (`api-key`, `token`, `oauth`, `aws-sdk`). -- `models.providers.*.injectNumCtxForOpenAICompat`: Ollama + `openai-completions` için isteklere `options.num_ctx` enjekte eder (varsayılan: `true`). -- `models.providers.*.authHeader`: gerektiğinde kimlik bilgisinin `Authorization` başlığı üzerinden taşınmasını zorlar. -- `models.providers.*.baseUrl`: upstream API base URL. -- `models.providers.*.headers`: proxy/tenant 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ı. +- `models.providers.*.injectNumCtxForOpenAICompat`: Ollama + `openai-completions` için `options.num_ctx` isteklere enjekte eder (varsayılan: `true`). +- `models.providers.*.authHeader`: gerektiğinde kimlik bilgisinin `Authorization` başlığında taşınmasını zorlar. +- `models.providers.*.baseUrl`: upstream API temel URL'si. +- `models.providers.*.headers`: proxy/tenant yönlendirmesi için ek statik başlıklar. +- `models.providers.*.request`: model-provider 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`: 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ı bir `tls` alt nesnesini 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`. + - `request.proxy`: HTTP proxy geçersiz kılması. Modlar: `"env-proxy"` (`HTTP_PROXY`/`HTTPS_PROXY` env vars kullan), `"explicit-proxy"` (`url` ile). Her iki mod da isteğe bağlı `tls` alt 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 girdileri. -- `models.providers.*.models.*.contextWindow`: doğal model bağlam penceresi metadata'sı. -- `models.providers.*.models.*.contextTokens`: isteğe bağlı çalışma zamanı bağlam sınırı. Modelin doğal `contextWindow` değerinden daha küçük etkili bir bağlam bütçesi istiyorsanız bunu kullanın. -- `models.providers.*.models.*.compat.supportsDeveloperRole`: isteğe bağlı uyumluluk ipucu. `api: "openai-completions"` ve boş olmayan doğal olmayan bir `baseUrl` için (host `api.openai.com` değilse), OpenClaw bunu çalışma zamanında `false` olarak zorlar. Boş/atlanmış `baseUrl`, varsayılan OpenAI davranışını korur. -- `plugins.entries.amazon-bedrock.config.discovery`: Bedrock otomatik keşif ayarları kökü. +- `models.providers.*.models.*.contextWindow`: yerel model bağlam penceresi metadata'sı. +- `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 bir bağlam bütçesi istiyorsanız bunu kullanın. +- `models.providers.*.models.*.compat.supportsDeveloperRole`: isteğe bağlı uyumluluk ipucu. `api: "openai-completions"` ve boş olmayan yerel olmayan `baseUrl` (host `api.openai.com` değil) için OpenClaw bunu çalışma zamanında `false` olarak zorlar. Boş/atlanmış `baseUrl`, varsayılan OpenAI davranışını korur. +- `plugins.entries.amazon-bedrock.config.discovery`: Bedrock otomatik keşif ayarlarının kökü. - `plugins.entries.amazon-bedrock.config.discovery.enabled`: örtük keşfi aç/kapat. - `plugins.entries.amazon-bedrock.config.discovery.region`: keşif için AWS bölgesi. -- `plugins.entries.amazon-bedrock.config.discovery.providerFilter`: hedefli keşif için isteğe bağlı sağlayıcı kimliği filtresi. -- `plugins.entries.amazon-bedrock.config.discovery.refreshInterval`: keşif yenileme için yoklama aralığı. +- `plugins.entries.amazon-bedrock.config.discovery.providerFilter`: hedefli keşif için isteğe bağlı provider-id filtresi. +- `plugins.entries.amazon-bedrock.config.discovery.refreshInterval`: keşif yenileme anket aralığı. - `plugins.entries.amazon-bedrock.config.discovery.defaultContextWindow`: keşfedilen modeller için geri dönüş bağlam penceresi. -- `plugins.entries.amazon-bedrock.config.discovery.defaultMaxTokens`: keşfedilen modeller için geri dönüş maksimum çıktı token'ı. +- `plugins.entries.amazon-bedrock.config.discovery.defaultMaxTokens`: keşfedilen modeller için geri dönüş maksimum çıktı tokenı. ### Sağlayıcı örnekleri @@ -2369,7 +2383,7 @@ Cerebras için `cerebras/zai-glm-4.7`; doğrudan Z.AI için `zai/glm-4.7` kullan } ``` -`OPENCODE_API_KEY` (veya `OPENCODE_ZEN_API_KEY`) ayarlayın. Zen kataloğu için `opencode/...`, Go kataloğu için `opencode-go/...` başvurularını kullanın. Kısayol: `openclaw onboard --auth-choice opencode-zen` veya `openclaw onboard --auth-choice opencode-go`. +`OPENCODE_API_KEY` (veya `OPENCODE_ZEN_API_KEY`) ayarlayın. Zen kataloğu için `opencode/...` referansları veya Go kataloğu için `opencode-go/...` referansları kullanın. Kısayol: `openclaw onboard --auth-choice opencode-zen` veya `openclaw onboard --auth-choice opencode-go`. @@ -2386,11 +2400,11 @@ Cerebras için `cerebras/zai-glm-4.7`; doğrudan Z.AI için `zai/glm-4.7` kullan } ``` -`ZAI_API_KEY` ayarlayın. `z.ai/*` ve `z-ai/*`, kabul edilen takma adlardır. Kısayol: `openclaw onboard --auth-choice zai-api-key`. +`ZAI_API_KEY` ayarlayın. `z.ai/*` ve `z-ai/*` kabul edilen takma adlardır. Kısayol: `openclaw onboard --auth-choice zai-api-key`. - 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 bir sağlayıcı tanımlayın. +- Genel uç nokta için base URL geçersiz kılmalı özel sağlayıcı tanımlayın. @@ -2432,8 +2446,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 sunduğunu bildirir ve OpenClaw bunu artık yalnızca yerleşik sağlayıcı kimliğine değil, uç nokta -yeteneklerine göre anahtarlıyor. +`openai-completions` taşıması üzerinde akış kullanımı uyumluluğu ilan eder ve OpenClaw artık bunu yalnızca yerleşik sağlayıcı kimliğine değil uç nokta +yeteneklerine göre anahtarlamaktadır. @@ -2534,8 +2548,8 @@ Base URL `/v1` içermemelidir (Anthropic istemcisi bunu ekler). Kısayol: `openc `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, siz açıkça `thinking` ayarlamadıkça MiniMax thinking'i -varsayılan olarak devre dışı bırakır. `/fast on` veya +Anthropic uyumlu akış yolunda OpenClaw, siz açıkça `thinking` +ayarlamadığınız sürece varsayılan olarak MiniMax thinking özelliğini devre dışı bırakır. `/fast on` veya `params.fastMode: true`, `MiniMax-M2.7` değerini `MiniMax-M2.7-highspeed` olarak yeniden yazar. @@ -2543,7 +2557,7 @@ varsayılan olarak devre dışı bırakır. `/fast on` veya -Bkz. [Local Models](/tr/gateway/local-models). Kısaca: ciddi donanım üzerinde LM Studio Responses API aracılığıyla büyük bir yerel model çalıştırın; geri dönüş için host edilen modelleri birleştirilmiş tutun. +Bkz. [Local Models](/tr/gateway/local-models). Özetle: güçlü donanımda LM Studio Responses API üzerinden büyük yerel bir model çalıştırın; geri dönüş için barındırılan modelleri birleştirilmiş tutun. @@ -2574,18 +2588,18 @@ Bkz. [Local Models](/tr/gateway/local-models). Kısaca: ciddi donanım üzerinde } ``` -- `allowBundled`: yalnızca paketlenmiş Skills için isteğe bağlı izin listesi (yönetilen/çalışma alanı Skills etkilenmez). -- `load.extraDirs`: ek paylaşılan Skills kökleri (en düşük öncelik). -- `install.preferBrew`: true olduğunda, diğer kurucu türlerine geri dönmeden önce `brew` - mevcutsa Homebrew kurucularını tercih eder. +- `allowBundled`: yalnızca paketlenmiş Skills için isteğe bağlı izin listesi (managed/workspace Skills etkilenmez). +- `load.extraDirs`: ek paylaşılan skill kökleri (en düşük öncelik). +- `install.preferBrew`: `brew` + kullanılabilir olduğunda diğer kurucu türlerine geri düşmeden önce Homebrew kurucularını tercih et. - `install.nodeManager`: `metadata.openclaw.install` - özellikleri için düğüm kurucu tercihi (`npm` | `pnpm` | `yarn` | `bun`). -- `entries..enabled: false`, paketlenmiş/kurulu olsa bile bir Skill'i devre dışı bırakır. -- `entries..apiKey`: birincil ortam değişkeni bildiren Skills için kolaylık alanı (düz metin dize veya SecretRef nesnesi). + özellikleri için node kurucu tercihi (`npm` | `pnpm` | `yarn` | `bun`). +- `entries..enabled: false`, bir skill paketlenmiş/kurulu olsa bile onu devre dışı bırakır. +- `entries..apiKey`: birincil env var tanımlayan skill'ler için kolaylık alanı (düz metin dize veya SecretRef nesnesi). --- -## Plugins +## Plugin'ler ```json5 { @@ -2610,40 +2624,40 @@ Bkz. [Local Models](/tr/gateway/local-models). Kısaca: ciddi donanım üzerinde ``` - `~/.openclaw/extensions`, `/.openclaw/extensions` ve `plugins.load.paths` içinden yüklenir. -- Keşif, yerel OpenClaw plugin'lerini ve uyumlu Codex paketlerini ve Claude paketlerini, manifest'siz Claude varsayılan düzen paketleri dahil, kabul eder. +- Keşif, yerel OpenClaw plugin'lerinin yanı sıra uyumlu Codex bundle'larını ve Claude bundle'larını, manifest'siz Claude varsayılan düzen bundle'ları dahil olacak şekilde kabul eder. - **Yapılandırma değişiklikleri gateway yeniden başlatması gerektirir.** - `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 haritası. -- `plugins.entries..hooks.allowPromptInjection`: `false` olduğunda çekirdek `before_prompt_build` işlemini engeller ve eski `before_agent_start` içindeki prompt değiştirici alanları yok sayar; eski `modelOverride` ve `providerOverride` korunur. Yerel plugin hook'larına ve desteklenen paket tarafından sağlanan hook dizinlerine uygulanır. -- `plugins.entries..subagent.allowModelOverride`: bu plugin'e arka plan alt aracı çalıştırmaları için çalışma başına `provider` ve `model` geçersiz kılmaları isteme konusunda açık güven verin. -- `plugins.entries..subagent.allowedModels`: güvenilen alt aracı geçersiz kılmaları için isteğe bağlı kanonik `provider/model` hedef izin listesi. Herhangi bir modele izin vermek istediğinizden eminseniz yalnızca `"*"` kullanın. -- `plugins.entries..config`: plugin tanımlı yapılandırma nesnesi (mümkün olduğunda yerel OpenClaw plugin şemasıyla doğrulanır). +- `plugins.entries..apiKey`: desteklendiğinde plugin düzeyinde API anahtarı kolaylık alanı. +- `plugins.entries..env`: plugin kapsamlı env var haritası. +- `plugins.entries..hooks.allowPromptInjection`: `false` olduğunda çekirdek `before_prompt_build` işlemini engeller ve eski `before_agent_start` içinden istemi değiştiren alanları yok sayar, ancak eski `modelOverride` ve `providerOverride` değerlerini korur. Yerel plugin hook'larına ve desteklenen bundle tarafından sağlanan 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ça güvenin. +- `plugins.entries..subagent.allowedModels`: güvenilen subagent geçersiz kılmaları için isteğe bağlı kanonik `provider/model` hedef izin listesi. Yalnızca bilinçli olarak her modeli izin vermek istiyorsanız `"*"` kullanın. +- `plugins.entries..config`: plugin tanımlı yapılandırma nesnesi (varsa yerel OpenClaw plugin şeması ile 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öner. - - `baseUrl`: Firecrawl API base URL (varsayılan: `https://api.firecrawl.dev`). + - `apiKey`: Firecrawl API anahtarı (SecretRef kabul eder). `plugins.entries.firecrawl.config.webSearch.apiKey`, eski `tools.web.fetch.firecrawl.apiKey` veya `FIRECRAWL_API_KEY` env var değerine geri döner. + - `baseUrl`: Firecrawl API temel URL'si (varsayılan: `https://api.firecrawl.dev`). - `onlyMainContent`: sayfalardan yalnızca ana içeriği çıkar (varsayılan: `true`). - `maxAgeMs`: milisaniye cinsinden maksimum önbellek yaşı (varsayılan: `172800000` / 2 gün). - - `timeoutSeconds`: scrape istek zaman aşımı, saniye cinsinden (varsayılan: `60`). + - `timeoutSeconds`: scrape istek 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ştir. - - `model`: arama için kullanılacak Grok modeli (ör. `"grok-4-1-fast"`). -- `plugins.entries.memory-core.config.dreaming`: bellek dreaming (deneysel) ayarları. Aşamalar ve eşikler için [Dreaming](/concepts/dreaming) bölümüne bakın. + - `model`: arama için kullanılacak Grok modeli (örn. `"grok-4-1-fast"`). +- `plugins.entries.memory-core.config.dreaming`: bellek dreaming (deneysel) ayarları. Fazlar 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 kadansı (varsayılan `"0 3 * * *"`). - - aşama ilkesi ve eşikler uygulama ayrıntılarıdır (kullanıcıya dönük yapılandırma anahtarları değildir). -- Etkin Claude bundle plugin'leri ayrıca `settings.json` içinden gömülü Pi varsayılanları da katkıda bulunabilir; OpenClaw bunları ham OpenClaw yapılandırma yamaları olarak değil, temizlenmiş aracı ayarları olarak uygular. + - `frequency`: her tam dreaming taraması için cron sıklığı (varsayılan `"0 3 * * *"`). + - faz ilkesi ve eşikler uygulama ayrıntılarıdır (kullanıcıya yönelik yapılandırma anahtarları değildir). +- Etkin Claude bundle plugin'leri ayrıca `settings.json` içinden gömülü Pi varsayılanları da katkılayabilir; OpenClaw bunları ham OpenClaw yapılandırma yamaları olarak değil, temizlenmiş ajan 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çmedikçe varsayılan `"legacy"` olur. -- `plugins.installs`: `openclaw plugins update` tarafından kullanılan CLI yönetimli kurulum metadata'sı. +- `plugins.slots.contextEngine`: etkin bağlam motoru plugin kimliğini seçin; başka bir motor kurup seçmediğiniz sürece varsayılan `"legacy"` olur. +- `plugins.installs`: `openclaw plugins update` tarafından kullanılan CLI tarafından yönetilen kurulum metadata'sı. - `source`, `spec`, `sourcePath`, `installPath`, `version`, `resolvedName`, `resolvedVersion`, `resolvedSpec`, `integrity`, `shasum`, `resolvedAt`, `installedAt` içerir. - - `plugins.installs.*` değerlerini yönetilen durum olarak ele alın; elle düzenleme yerine CLI komutlarını tercih edin. + - `plugins.installs.*` alanlarını yönetilen durum olarak değerlendirin; el ile düzenlemek yerine CLI komutlarını tercih edin. Bkz. [Plugins](/tr/tools/plugin). --- -## Browser +## Tarayıcı ```json5 { @@ -2680,25 +2694,25 @@ Bkz. [Plugins](/tr/tools/plugin). ``` - `evaluateEnabled: false`, `act:evaluate` ve `wait --fn` özelliklerini devre dışı bırakır. -- `ssrfPolicy.dangerouslyAllowPrivateNetwork`, ayarlanmamışsa varsayılan olarak `true` olur (güvenilir ağ modeli). -- Yalnızca herkese açık browser gezintisi için katı mod istiyorsanız `ssrfPolicy.dangerouslyAllowPrivateNetwork: false` ayarlayın. -- Katı modda, uzak CDP profil uç noktaları (`profiles.*.cdpUrl`) de erişilebilirlik/keşif kontrolleri sırasında aynı özel ağ engellemesine tabidir. +- `ssrfPolicy.dangerouslyAllowPrivateNetwork`, ayarlanmadığında varsayılan olarak `true` olur (güvenilir ağ modeli). +- Sıkı yalnızca genel tarayıcı gezinmesi için `ssrfPolicy.dangerouslyAllowPrivateNetwork: false` ayarlayın. +- Sıkı modda uzak CDP profil uç noktaları (`profiles.*.cdpUrl`), erişilebilirlik/keşif denetimleri sırasında aynı özel ağ engellemesine tabidir. - `ssrfPolicy.allowPrivateNetwork`, eski takma ad olarak desteklenmeye devam eder. -- Katı modda açık istisnalar için `ssrfPolicy.hostnameAllowlist` ve `ssrfPolicy.allowedHostnames` kullanın. -- Uzak profiller yalnızca bağlanma modundadır (başlat/durdur/sıfırla devre dışı). +- Sıkı modda açık istisnalar için `ssrfPolicy.hostnameAllowlist` ve `ssrfPolicy.allowedHostnames` kullanın. +- Uzak profiller yalnızca attach-only'dir (start/stop/reset devre dışı). - `profiles.*.cdpUrl`, `http://`, `https://`, `ws://` ve `wss://` kabul eder. - OpenClaw'ın `/json/version` keşfetmesini istiyorsanız HTTP(S) kullanın; sağlayıcınız size doğrudan bir DevTools WebSocket URL'si veriyorsa WS(S) + OpenClaw'ın `/json/version` keşfetmesini istediğinizde HTTP(S) kullanın; sağlayıcınız size doğrudan DevTools WebSocket URL'si verdiğinde WS(S) kullanın. -- `existing-session` profilleri yalnızca host üzerinde çalışır ve CDP yerine Chrome MCP kullanır. -- `existing-session` profilleri, Brave veya Edge gibi belirli bir - Chromium tabanlı browser profilini hedeflemek için `userDataDir` ayarlayabilir. -- `existing-session` profilleri, mevcut Chrome MCP rota sınırlamalarını korur: - CSS seçici hedefleme yerine anlık görüntü/ref tabanlı actions, tek dosya yükleme - hook'ları, iletişim kutusu zaman aşımı geçersiz kılmaları yok, `wait --load networkidle` yok, ayrıca - `responsebody`, PDF dışa aktarma, indirme yakalama veya toplu actions yok. -- Yerel yönetilen `openclaw` profilleri `cdpPort` ve `cdpUrl` değerlerini otomatik atar; yalnızca - uzak CDP için `cdpUrl` değerini açıkça ayarlayın. -- Otomatik algılama sırası: Chromium tabanlıysa varsayılan browser → Chrome → Brave → Edge → Chromium → Chrome Canary. -- Kontrol hizmeti: yalnızca loopback (port `gateway.port` değerinden türetilir, varsayılan `18791`). -- `extraArgs`, yerel Chromium başlatmaya ek bayraklar ekler (örneğin - `--disable-gpu`, pencere boyutlandırma veya hata ay \ No newline at end of file +- `existing-session` profilleri yalnızca host içindir ve CDP yerine Chrome MCP kullanır. +- `existing-session` profilleri, Brave veya Edge gibi belirli + Chromium tabanlı tarayıcı profillerini hedeflemek için `userDataDir` ayarlayabilir. +- `existing-session` profilleri mevcut Chrome MCP rota sınırlarını korur: + CSS seçici hedefleme yerine snapshot/ref tabanlı eylemler, tek dosya yükleme + kancaları, diyalog zaman aşımı geçersiz kılmaları yok, `wait --load networkidle` yok + ve `responsebody`, PDF dışa aktarma, indirme yakalama veya toplu eylemler yok. +- Yerel yönetilen `openclaw` profilleri `cdpPort` ve `cdpUrl` otomatik atar; yalnızca uzak CDP için + `cdpUrl` açıkça ayarlayın. +- Otomatik algılama sırası: varsayılan tarayıcı Chromium tabanlıysa → Chrome → Brave → Edge → Chromium → Chrome Canary. +- Denetim hizmeti: yalnızca loopback (port `gateway.port` değerinden türetilir, varsayılan `18791`). +- `extraArgs`, yerel Chromium başlatmasına ek başlatma bayrakları ekler (örneğin + `--disable-gpu`, pencere boy \ No newline at end of file diff --git a/docs/tr/plugins/sdk-migration.md b/docs/tr/plugins/sdk-migration.md index 82fabc668..21cc2cb44 100644 --- a/docs/tr/plugins/sdk-migration.md +++ b/docs/tr/plugins/sdk-migration.md @@ -1,102 +1,105 @@ --- read_when: - - '`OPENCLAW_PLUGIN_SDK_COMPAT_DEPRECATED` uyarısını görüyorsunuz' - - '`OPENCLAW_EXTENSION_API_DEPRECATED` uyarısını görüyorsunuz' + - OPENCLAW_PLUGIN_SDK_COMPAT_DEPRECATED uyarısını görüyorsunuz + - OPENCLAW_EXTENSION_API_DEPRECATED uyarısını görüyorsunuz - Bir plugin'i modern plugin mimarisine güncelliyorsunuz - - Harici bir OpenClaw plugin'inin bakımını yapıyorsunuz + - Harici bir OpenClaw plugin'ini bakımını yapıyorsunuz sidebarTitle: Migrate to SDK -summary: Eski geri uyumluluk katmanından modern plugin SDK'sına geçiş yapın +summary: Eski geriye dönük uyumluluk katmanından modern plugin SDK'ya geçiş yapın title: Plugin SDK Geçişi x-i18n: - generated_at: "2026-04-06T03:10:56Z" + generated_at: "2026-04-06T08:50:04Z" model: gpt-5.4 provider: openai - source_hash: b71ce69b30c3bb02da1b263b1d11dc3214deae5f6fc708515e23b5a1c7bb7c8f + source_hash: 94f12d1376edd8184714cc4dbea4a88fa8ed652f65e9365ede6176f3bf441b33 source_path: plugins/sdk-migration.md workflow: 15 --- # Plugin SDK Geçişi -OpenClaw, geniş bir geri uyumluluk katmanından odaklı, belgelenmiş içe aktarmalara sahip modern bir plugin -mimarisine geçti. Plugin'iniz yeni mimariden önce -geliştirildiyse, bu kılavuz geçiş yapmanıza yardımcı olur. +OpenClaw, geniş bir geriye dönük uyumluluk katmanından odaklı ve belgelenmiş +içe aktarmalara sahip modern bir plugin mimarisine geçti. Plugin'iniz yeni +mimari öncesinde oluşturulduysa, bu kılavuz geçiş yapmanıza yardımcı olur. ## Neler değişiyor -Eski plugin sistemi, plugin'lerin tek bir giriş noktasından -ihtiyaç duydukları her şeyi içe aktarmasına izin veren iki geniş yüzey sağlıyordu: +Eski plugin sistemi, plugin'lerin tek bir giriş noktasından ihtiyaç duydukları +her şeyi içe aktarmasına izin veren iki geniş yüzey sağlıyordu: -- **`openclaw/plugin-sdk/compat`** — onlarca - yardımcıyı yeniden dışa aktaran tek bir içe aktarma. Yeni plugin mimarisi inşa edilirken eski hook tabanlı plugin'lerin çalışmaya devam etmesi için tanıtıldı. -- **`openclaw/extension-api`** — plugin'lere - gömülü agent çalıştırıcısı gibi host tarafı yardımcılarına doğrudan erişim veren bir köprü. +- **`openclaw/plugin-sdk/compat`** — onlarca yardımcıyı yeniden dışa aktaran + tek bir içe aktarma. Yeni plugin mimarisi oluşturulurken eski hook tabanlı + plugin'lerin çalışmaya devam etmesini sağlamak için sunuldu. +- **`openclaw/extension-api`** — plugin'lere gömülü ajan çalıştırıcısı gibi + ana makine tarafı yardımcılarına doğrudan erişim veren bir köprü. -Her iki yüzey de artık **kullanım dışı**. Çalışma zamanında hâlâ çalışırlar, ancak yeni -plugin'ler bunları kullanmamalıdır ve mevcut plugin'ler bunlar sonraki büyük sürümde kaldırılmadan önce geçiş yapmalıdır. +Bu iki yüzey artık **kullanımdan kaldırıldı**. Çalışma zamanında hâlâ +çalışırlar, ancak yeni plugin'ler bunları kullanmamalıdır ve mevcut +plugin'ler, bir sonraki büyük sürüm bunları kaldırmadan önce geçiş yapmalıdır. - Geri uyumluluk katmanı gelecekteki bir büyük sürümde kaldırılacaktır. - Hâlâ bu yüzeylerden içe aktarma yapan plugin'ler bu gerçekleştiğinde bozulacaktır. + Geriye dönük uyumluluk katmanı gelecekteki bir büyük sürümde kaldırılacaktır. + Hâlâ bu yüzeylerden içe aktarma yapan plugin'ler bu gerçekleştiğinde bozulur. -## Bunun nedeni neydi +## Bu neden değişti Eski yaklaşım sorunlara yol açıyordu: - **Yavaş başlangıç** — tek bir yardımcıyı içe aktarmak onlarca ilgisiz modülü yüklüyordu -- **Döngüsel bağımlılıklar** — geniş yeniden dışa aktarmalar içe aktarma döngüleri oluşturmayı kolaylaştırıyordu -- **Belirsiz API yüzeyi** — hangi dışa aktarmaların kararlı, hangilerinin dahili olduğunu anlamanın bir yolu yoktu +- **Döngüsel bağımlılıklar** — geniş yeniden dışa aktarmalar, içe aktarma döngüleri oluşturmayı kolaylaştırıyordu +- **Belirsiz API yüzeyi** — hangi dışa aktarımların kararlı, hangilerinin dahili olduğunu anlamanın bir yolu yoktu Modern plugin SDK bunu düzeltir: her içe aktarma yolu (`openclaw/plugin-sdk/\`) -küçük, kendi kendine yeten, açık amaçlı ve belgelenmiş sözleşmeye sahip bir modüldür. +net bir amaca ve belgelenmiş sözleşmeye sahip küçük, kendi içinde yeterli bir modüldür. -Paketlenmiş kanallar için eski sağlayıcı kolaylık arayüzleri de kaldırıldı. -`openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`, +Paket içi kanallar için eski sağlayıcı kolaylık seam'leri de artık yok. Şu tür +içe aktarmalar: `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`, `openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`, -kanal markalı yardımcı arayüzleri ve -`openclaw/plugin-sdk/telegram-core` gibi içe aktarmalar, kararlı plugin sözleşmeleri değil, -özel mono-repo kısayollarıydı. Bunun yerine dar, genel SDK alt yollarını kullanın. Paketlenmiş -plugin çalışma alanı içinde, sağlayıcıya ait yardımcıları o plugin'in kendi -`api.ts` veya `runtime-api.ts` dosyasında tutun. +kanal markalı yardımcı seam'leri ve +`openclaw/plugin-sdk/telegram-core`, kararlı plugin sözleşmeleri değil, mono-repo +için özel kısayollardı. Bunun yerine dar kapsamlı genel SDK alt yollarını +kullanın. Paketli plugin çalışma alanı içinde, sağlayıcıya ait yardımcıları o +plugin'in kendi `api.ts` veya `runtime-api.ts` dosyasında tutun. -Geçerli paketlenmiş sağlayıcı örnekleri: +Mevcut paketli sağlayıcı örnekleri: - Anthropic, Claude'a özgü akış yardımcılarını kendi `api.ts` / - `contract-api.ts` arayüzünde tutar -- OpenAI, sağlayıcı oluşturucuları, varsayılan model yardımcılarını ve gerçek zamanlı sağlayıcı - oluşturucularını kendi `api.ts` dosyasında tutar -- OpenRouter, sağlayıcı oluşturucuyu ve onboarding/yapılandırma yardımcılarını kendi + `contract-api.ts` seam'inde tutar +- OpenAI, sağlayıcı oluşturucularını, varsayılan model yardımcılarını ve + gerçek zamanlı sağlayıcı oluşturucularını kendi `api.ts` dosyasında tutar +- OpenRouter, sağlayıcı oluşturucu ve onboarding/config yardımcılarını kendi `api.ts` dosyasında tutar ## Nasıl geçiş yapılır - + Plugin'iniz `openclaw/plugin-sdk/windows-spawn` kullanıyorsa, çözümlenmemiş Windows - `.cmd`/`.bat` sarmalayıcıları artık açıkça - `allowShellFallback: true` geçmediğiniz sürece kapalı şekilde başarısız olur. + `.cmd`/`.bat` sarmalayıcıları artık siz açıkça + `allowShellFallback: true` geçmedikçe kapalı şekilde başarısız olur. ```typescript - // Önce + // Before const program = applyWindowsSpawnProgramPolicy({ candidate }); - // Sonra + // After const program = applyWindowsSpawnProgramPolicy({ candidate, - // Bunu yalnızca kabuk aracılı geri dönüşü kasıtlı olarak - // kabul eden güvenilir uyumluluk çağıranları için ayarlayın. + // Only set this for trusted compatibility callers that intentionally + // accept shell-mediated fallback. allowShellFallback: true, }); ``` - Çağıranınız kabuk geri dönüşüne kasıtlı olarak dayanmıyorsa, + Çağıran tarafınız shell fallback davranışına kasıtlı olarak bağlı değilse, `allowShellFallback` ayarlamayın ve bunun yerine fırlatılan hatayı ele alın. - - Plugin'inizde kullanım dışı yüzeylerden biri üzerinden yapılan içe aktarmaları arayın: + + Plugin'inizde kullanımdan kaldırılmış iki yüzeyden herhangi birinden yapılan + içe aktarmaları arayın: ```bash grep -r "plugin-sdk/compat" my-plugin/ @@ -105,38 +108,38 @@ Geçerli paketlenmiş sağlayıcı örnekleri: - - Eski yüzeydeki her dışa aktarma, belirli bir modern içe aktarma yoluna karşılık gelir: + + Eski yüzeydeki her dışa aktarma, belirli bir modern içe aktarma yoluna eşlenir: ```typescript - // Önce (kullanım dışı geri uyumluluk katmanı) + // Before (deprecated backwards-compatibility layer) import { createChannelReplyPipeline, createPluginRuntimeStore, resolveControlCommandGate, } from "openclaw/plugin-sdk/compat"; - // Sonra (modern odaklı içe aktarmalar) + // After (modern focused imports) import { createChannelReplyPipeline } from "openclaw/plugin-sdk/channel-reply-pipeline"; import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store"; import { resolveControlCommandGate } from "openclaw/plugin-sdk/command-auth"; ``` - Host tarafı yardımcıları için doğrudan içe aktarma yapmak yerine + Ana makine tarafı yardımcılar için doğrudan içe aktarma yapmak yerine enjekte edilen plugin çalışma zamanını kullanın: ```typescript - // Önce (kullanım dışı extension-api köprüsü) + // Before (deprecated extension-api bridge) import { runEmbeddedPiAgent } from "openclaw/extension-api"; const result = await runEmbeddedPiAgent({ sessionId, prompt }); - // Sonra (enjekte edilen çalışma zamanı) + // After (injected runtime) const result = await api.runtime.agent.runEmbeddedPiAgent({ sessionId, prompt }); ``` - Aynı kalıp diğer eski köprü yardımcıları için de geçerlidir: + Aynı desen diğer eski köprü yardımcıları için de geçerlidir: - | Eski içe aktarma | Modern karşılığı | + | Eski içe aktarma | Modern eşdeğeri | | --- | --- | | `resolveAgentDir` | `api.runtime.agent.resolveAgentDir` | | `resolveAgentWorkspaceDir` | `api.runtime.agent.resolveAgentWorkspaceDir` | @@ -159,161 +162,170 @@ Geçerli paketlenmiş sağlayıcı örnekleri: ## İçe aktarma yolu başvurusu - | İçe aktarma yolu | Amaç | Temel dışa aktarmalar | + | İçe aktarma yolu | Amaç | Temel dışa aktarımlar | | --- | --- | --- | | `plugin-sdk/plugin-entry` | Kanonik plugin giriş yardımcısı | `definePluginEntry` | | `plugin-sdk/core` | Kanal giriş tanımları/oluşturucuları için eski şemsiye yeniden dışa aktarma | `defineChannelPluginEntry`, `createChatChannelPlugin` | - | `plugin-sdk/config-schema` | Kök yapılandırma şeması dışa aktarımı | `OpenClawSchema` | + | `plugin-sdk/config-schema` | Kök config şema dışa aktarımı | `OpenClawSchema` | | `plugin-sdk/provider-entry` | Tek sağlayıcılı giriş yardımcısı | `defineSingleProviderPluginEntry` | | `plugin-sdk/channel-core` | Odaklı kanal giriş tanımları ve oluşturucuları | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` | | `plugin-sdk/setup` | Paylaşılan kurulum sihirbazı yardımcıları | Allowlist istemleri, kurulum durumu oluşturucuları | - | `plugin-sdk/setup-runtime` | Kurulum zamanı çalışma zamanı yardımcıları | İçe aktarma açısından güvenli kurulum yama bağdaştırıcıları, lookup-note yardımcıları, `promptResolvedAllowFrom`, `splitSetupEntries`, devredilmiş kurulum proxy'leri | + | `plugin-sdk/setup-runtime` | Kurulum zamanı çalışma zamanı yardımcıları | İçe aktarma için güvenli kurulum yama bağdaştırıcıları, arama notu yardımcıları, `promptResolvedAllowFrom`, `splitSetupEntries`, devredilen kurulum proxy'leri | | `plugin-sdk/setup-adapter-runtime` | Kurulum bağdaştırıcı yardımcıları | `createEnvPatchedAccountSetupAdapter` | | `plugin-sdk/setup-tools` | Kurulum araç yardımcıları | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` | - | `plugin-sdk/account-core` | Çok hesaplı yardımcılar | Hesap listesi/yapılandırma/eylem geçidi yardımcıları | + | `plugin-sdk/account-core` | Çoklu hesap yardımcıları | Hesap listesi/config/eylem kapısı yardımcıları | | `plugin-sdk/account-id` | Hesap kimliği yardımcıları | `DEFAULT_ACCOUNT_ID`, hesap kimliği normalleştirme | - | `plugin-sdk/account-resolution` | Hesap arama yardımcıları | Hesap arama + varsayılan geri dönüş yardımcıları | - | `plugin-sdk/account-helpers` | Dar hesap yardımcıları | Hesap listesi/hesap eylemi yardımcıları | + | `plugin-sdk/account-resolution` | Hesap arama yardımcıları | Hesap arama + varsayılan fallback yardımcıları | + | `plugin-sdk/account-helpers` | Dar kapsamlı hesap yardımcıları | Hesap listesi/hesap eylemi yardımcıları | | `plugin-sdk/channel-setup` | Kurulum sihirbazı bağdaştırıcıları | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, ayrıca `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` | - | `plugin-sdk/channel-pairing` | DM eşleme ilkelleri | `createChannelPairingController` | - | `plugin-sdk/channel-reply-pipeline` | Yanıt öneki + yazıyor durumu bağlantısı | `createChannelReplyPipeline` | - | `plugin-sdk/channel-config-helpers` | Yapılandırma bağdaştırıcı fabrikaları | `createHybridChannelConfigAdapter` | - | `plugin-sdk/channel-config-schema` | Yapılandırma şeması oluşturucuları | Kanal yapılandırma şeması türleri | - | `plugin-sdk/telegram-command-config` | Telegram komut yapılandırma yardımcıları | Komut adı normalleştirme, açıklama kırpma, yinelenen/çakışma doğrulaması | + | `plugin-sdk/channel-pairing` | DM eşleştirme temel bileşenleri | `createChannelPairingController` | + | `plugin-sdk/channel-reply-pipeline` | Yanıt öneki + yazıyor durumu altyapısı | `createChannelReplyPipeline` | + | `plugin-sdk/channel-config-helpers` | Config bağdaştırıcı fabrikaları | `createHybridChannelConfigAdapter` | + | `plugin-sdk/channel-config-schema` | Config şeması oluşturucuları | Kanal config şeması türleri | + | `plugin-sdk/telegram-command-config` | Telegram komut config yardımcıları | Komut adı normalleştirme, açıklama kırpma, tekrar/çakışma doğrulaması | | `plugin-sdk/channel-policy` | Grup/DM ilke çözümleme | `resolveChannelGroupRequireMention` | - | `plugin-sdk/channel-lifecycle` | Hesap durumu izleme | `createAccountStatusSink` | + | `plugin-sdk/channel-lifecycle` | Hesap durumu takibi | `createAccountStatusSink` | | `plugin-sdk/inbound-envelope` | Gelen zarf yardımcıları | Paylaşılan rota + zarf oluşturucu yardımcıları | | `plugin-sdk/inbound-reply-dispatch` | Gelen yanıt yardımcıları | Paylaşılan kaydet ve dağıt yardımcıları | | `plugin-sdk/messaging-targets` | Mesajlaşma hedefi ayrıştırma | Hedef ayrıştırma/eşleştirme yardımcıları | | `plugin-sdk/outbound-media` | Giden medya yardımcıları | Paylaşılan giden medya yükleme | - | `plugin-sdk/outbound-runtime` | Giden çalışma zamanı yardımcıları | Giden kimlik/gönderme temsilci yardımcıları | - | `plugin-sdk/thread-bindings-runtime` | İş parçacığı bağlama yardımcıları | İş parçacığı bağlama yaşam döngüsü ve bağdaştırıcı yardımcıları | - | `plugin-sdk/agent-media-payload` | Eski medya payload yardımcıları | Eski alan düzenleri için agent medya payload oluşturucu | - | `plugin-sdk/channel-runtime` | Kullanım dışı uyumluluk shim'i | Yalnızca eski kanal çalışma zamanı yardımcıları | - | `plugin-sdk/channel-send-result` | Gönderim sonucu türleri | Yanıt sonucu türleri | + | `plugin-sdk/outbound-runtime` | Giden çalışma zamanı yardımcıları | Giden kimlik/gönderim delege yardımcıları | + | `plugin-sdk/thread-bindings-runtime` | Thread-binding yardımcıları | Thread-binding yaşam döngüsü ve bağdaştırıcı yardımcıları | + | `plugin-sdk/agent-media-payload` | Eski medya payload yardımcıları | Eski alan düzenleri için ajan medya payload oluşturucusu | + | `plugin-sdk/channel-runtime` | Kullanımdan kaldırılmış uyumluluk shim'i | Yalnızca eski kanal çalışma zamanı yardımcıları | + | `plugin-sdk/channel-send-result` | Gönderim sonuç türleri | Yanıt sonuç türleri | | `plugin-sdk/runtime-store` | Kalıcı plugin depolaması | `createPluginRuntimeStore` | - | `plugin-sdk/runtime` | Geniş çalışma zamanı yardımcıları | Çalışma zamanı/günlükleme/yedekleme/plugin kurulum yardımcıları | - | `plugin-sdk/runtime-env` | Dar çalışma zamanı ortam yardımcıları | Logger/çalışma zamanı ortamı, zaman aşımı, yeniden deneme ve backoff yardımcıları | - | `plugin-sdk/plugin-runtime` | Paylaşılan plugin çalışma zamanı yardımcıları | Plugin komutları/hook'lar/http/etkileşimli yardımcılar | - | `plugin-sdk/hook-runtime` | Hook ardışık düzen yardımcıları | Paylaşılan webhook/dahili hook ardışık düzen yardımcıları | - | `plugin-sdk/lazy-runtime` | Tembel çalışma zamanı yardımcıları | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` | - | `plugin-sdk/process-runtime` | Süreç yardımcıları | Paylaşılan exec yardımcıları | + | `plugin-sdk/runtime` | Geniş çalışma zamanı yardımcıları | Çalışma zamanı/günlükleme/yedekleme/plugin yükleme yardımcıları | + | `plugin-sdk/runtime-env` | Dar kapsamlı çalışma zamanı ortam yardımcıları | Logger/çalışma zamanı ortamı, zaman aşımı, retry ve backoff yardımcıları | + | `plugin-sdk/plugin-runtime` | Paylaşılan plugin çalışma zamanı yardımcıları | Plugin komutları/hook'lar/http/etkileşimli yardımcıları | + | `plugin-sdk/hook-runtime` | Hook işlem hattı yardımcıları | Paylaşılan webhook/dahili hook işlem hattı yardımcıları | + | `plugin-sdk/lazy-runtime` | Lazy çalışma zamanı yardımcıları | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` | + | `plugin-sdk/process-runtime` | Process yardımcıları | Paylaşılan exec yardımcıları | | `plugin-sdk/cli-runtime` | CLI çalışma zamanı yardımcıları | Komut biçimlendirme, beklemeler, sürüm yardımcıları | - | `plugin-sdk/gateway-runtime` | Gateway yardımcıları | Gateway istemcisi ve channel-status yama yardımcıları | - | `plugin-sdk/config-runtime` | Yapılandırma yardımcıları | Yapılandırma yükleme/yazma yardımcıları | - | `plugin-sdk/telegram-command-config` | Telegram komut yardımcıları | Paketlenmiş Telegram sözleşme yüzeyi kullanılamadığında geri dönüş açısından kararlı Telegram komut doğrulama yardımcıları | - | `plugin-sdk/approval-runtime` | Onay istemi yardımcıları | Exec/plugin onay payload, onay yeteneği/profil yardımcıları, yerel onay yönlendirme/çalışma zamanı yardımcıları | + | `plugin-sdk/gateway-runtime` | Gateway yardımcıları | Gateway istemcisi ve kanal durumu yama yardımcıları | + | `plugin-sdk/config-runtime` | Config yardımcıları | Config yükleme/yazma yardımcıları | + | `plugin-sdk/telegram-command-config` | Telegram komut yardımcıları | Paketli Telegram sözleşme yüzeyi kullanılamadığında fallback açısından kararlı Telegram komut doğrulama yardımcıları | + | `plugin-sdk/approval-runtime` | Onay istemi yardımcıları | Exec/plugin onay payload'u, onay yeteneği/profil yardımcıları, yerel onay yönlendirme/çalışma zamanı yardımcıları | | `plugin-sdk/approval-auth-runtime` | Onay kimlik doğrulama yardımcıları | Onaylayıcı çözümleme, aynı sohbet eylem kimlik doğrulaması | | `plugin-sdk/approval-client-runtime` | Onay istemci yardımcıları | Yerel exec onay profili/filtre yardımcıları | | `plugin-sdk/approval-delivery-runtime` | Onay teslim yardımcıları | Yerel onay yeteneği/teslim bağdaştırıcıları | | `plugin-sdk/approval-native-runtime` | Onay hedef yardımcıları | Yerel onay hedefi/hesap bağlama yardımcıları | | `plugin-sdk/approval-reply-runtime` | Onay yanıt yardımcıları | Exec/plugin onay yanıt payload yardımcıları | - | `plugin-sdk/security-runtime` | Güvenlik yardımcıları | Paylaşılan güven, DM geçitleme, harici içerik ve gizli bilgi toplama yardımcıları | - | `plugin-sdk/ssrf-policy` | SSRF ilke yardımcıları | Host allowlist ve özel ağ ilke yardımcıları | - | `plugin-sdk/ssrf-runtime` | SSRF çalışma zamanı yardımcıları | Sabitlenmiş dağıtıcı, korumalı fetch, SSRF ilke yardımcıları | - | `plugin-sdk/collection-runtime` | Sınırlandırılmış önbellek yardımcıları | `pruneMapToMaxSize` | - | `plugin-sdk/diagnostic-runtime` | Tanılama geçitleme yardımcıları | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` | + | `plugin-sdk/security-runtime` | Güvenlik yardımcıları | Paylaşılan güven, DM kapılama, external-content ve secret-collection yardımcıları | + | `plugin-sdk/ssrf-policy` | SSRF ilke yardımcıları | Ana makine allowlist ve özel ağ ilkesi yardımcıları | + | `plugin-sdk/ssrf-runtime` | SSRF çalışma zamanı yardımcıları | Pinned-dispatcher, guarded fetch, SSRF ilke yardımcıları | + | `plugin-sdk/collection-runtime` | Sınırlı önbellek yardımcıları | `pruneMapToMaxSize` | + | `plugin-sdk/diagnostic-runtime` | Tanılama kapılama yardımcıları | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` | | `plugin-sdk/error-runtime` | Hata biçimlendirme yardımcıları | `formatUncaughtError`, `isApprovalNotFoundError`, hata grafiği yardımcıları | | `plugin-sdk/fetch-runtime` | Sarmalanmış fetch/proxy yardımcıları | `resolveFetch`, proxy yardımcıları | - | `plugin-sdk/host-runtime` | Host normalleştirme yardımcıları | `normalizeHostname`, `normalizeScpRemoteHost` | - | `plugin-sdk/retry-runtime` | Yeniden deneme yardımcıları | `RetryConfig`, `retryAsync`, ilke çalıştırıcıları | + | `plugin-sdk/host-runtime` | Ana makine normalleştirme yardımcıları | `normalizeHostname`, `normalizeScpRemoteHost` | + | `plugin-sdk/retry-runtime` | Retry yardımcıları | `RetryConfig`, `retryAsync`, ilke çalıştırıcıları | | `plugin-sdk/allow-from` | Allowlist biçimlendirme | `formatAllowFromLowercase` | | `plugin-sdk/allowlist-resolution` | Allowlist girdi eşleme | `mapAllowlistResolutionInputs` | - | `plugin-sdk/command-auth` | Komut geçitleme ve komut yüzeyi yardımcıları | `resolveControlCommandGate`, gönderen yetkilendirme yardımcıları, komut kayıt yardımcıları | - | `plugin-sdk/secret-input` | Gizli girdi ayrıştırma | Gizli girdi yardımcıları | - | `plugin-sdk/webhook-ingress` | Webhook istek yardımcıları | Webhook hedef yardımcı programları | + | `plugin-sdk/command-auth` | Komut kapılama ve komut yüzeyi yardımcıları | `resolveControlCommandGate`, gönderici yetkilendirme yardımcıları, komut kayıt yardımcıları | + | `plugin-sdk/secret-input` | Secret girdi ayrıştırma | Secret girdi yardımcıları | + | `plugin-sdk/webhook-ingress` | Webhook istek yardımcıları | Webhook hedef yardımcıları | | `plugin-sdk/webhook-request-guards` | Webhook gövde koruma yardımcıları | İstek gövdesi okuma/sınır yardımcıları | - | `plugin-sdk/reply-runtime` | Paylaşılan yanıt çalışma zamanı | Gelen dağıtım, heartbeat, yanıt planlayıcı, parçalara ayırma | - | `plugin-sdk/reply-dispatch-runtime` | Dar yanıt dağıtım yardımcıları | Sonlandırma + sağlayıcı dağıtım yardımcıları | + | `plugin-sdk/reply-runtime` | Paylaşılan yanıt çalışma zamanı | Gelen dağıtım, heartbeat, yanıt planlayıcı, parçalama | + | `plugin-sdk/reply-dispatch-runtime` | Dar kapsamlı yanıt dağıtım yardımcıları | Sonlandırma + sağlayıcı dağıtım yardımcıları | | `plugin-sdk/reply-history` | Yanıt geçmişi yardımcıları | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` | - | `plugin-sdk/reply-reference` | Yanıt referans planlama | `createReplyReferencePlanner` | - | `plugin-sdk/reply-chunking` | Yanıt parça yardımcıları | Metin/markdown parçalara ayırma yardımcıları | + | `plugin-sdk/reply-reference` | Yanıt referansı planlama | `createReplyReferencePlanner` | + | `plugin-sdk/reply-chunking` | Yanıt parçalayıcı yardımcıları | Metin/markdown parçalama yardımcıları | | `plugin-sdk/session-store-runtime` | Oturum deposu yardımcıları | Depo yolu + updated-at yardımcıları | - | `plugin-sdk/state-paths` | Durum yolu yardımcıları | Durum ve OAuth dizin yardımcıları | + | `plugin-sdk/state-paths` | Durum yolu yardımcıları | Durum ve OAuth dizini yardımcıları | | `plugin-sdk/routing` | Yönlendirme/oturum anahtarı yardımcıları | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, oturum anahtarı normalleştirme yardımcıları | - | `plugin-sdk/status-helpers` | Kanal durum yardımcıları | Kanal/hesap durum özeti oluşturucuları, çalışma zamanı durumu varsayılanları, sorun meta verisi yardımcıları | - | `plugin-sdk/target-resolver-runtime` | Hedef çözümleyici yardımcıları | Paylaşılan hedef çözümleyici yardımcıları | - | `plugin-sdk/string-normalization-runtime` | Dize normalleştirme yardımcıları | Slug/dize normalleştirme yardımcıları | - | `plugin-sdk/request-url` | İstek URL yardımcıları | İstek benzeri girdilerden dize URL çıkarma | - | `plugin-sdk/run-command` | Zamanlamalı komut yardımcıları | Normalize edilmiş stdout/stderr ile zamanlamalı komut çalıştırıcı | - | `plugin-sdk/param-readers` | Parametre okuyucuları | Yaygın araç/CLI parametre okuyucuları | - | `plugin-sdk/tool-send` | Araç gönderim çıkarımı | Araç argümanlarından kanonik gönderim hedef alanlarını çıkar | + | `plugin-sdk/status-helpers` | Kanal durumu yardımcıları | Kanal/hesap durum özeti oluşturucuları, çalışma zamanı durum varsayılanları, issue metadata yardımcıları | + | `plugin-sdk/target-resolver-runtime` | Hedef çözücü yardımcıları | Paylaşılan hedef çözücü yardımcıları | + | `plugin-sdk/string-normalization-runtime` | Dizge normalleştirme yardımcıları | Slug/dizge normalleştirme yardımcıları | + | `plugin-sdk/request-url` | İstek URL yardımcıları | İstek benzeri girdilerden dizge URL çıkarma | + | `plugin-sdk/run-command` | Zamanlı komut yardımcıları | Normalleştirilmiş stdout/stderr ile zamanlı komut çalıştırıcısı | + | `plugin-sdk/param-readers` | Param okuyucular | Yaygın araç/CLI param okuyucuları | + | `plugin-sdk/tool-send` | Araç gönderim çıkarımı | Araç argümanlarından kanonik gönderim hedef alanlarını çıkarma | | `plugin-sdk/temp-path` | Geçici yol yardımcıları | Paylaşılan geçici indirme yolu yardımcıları | - | `plugin-sdk/logging-core` | Günlükleme yardımcıları | Alt sistem logger ve redaksiyon yardımcıları | + | `plugin-sdk/logging-core` | Günlükleme yardımcıları | Alt sistem logger ve redaction yardımcıları | | `plugin-sdk/markdown-table-runtime` | Markdown tablo yardımcıları | Markdown tablo modu yardımcıları | | `plugin-sdk/reply-payload` | Mesaj yanıt türleri | Yanıt payload türleri | - | `plugin-sdk/provider-setup` | Düzenlenmiş yerel/self-hosted sağlayıcı kurulum yardımcıları | Self-hosted sağlayıcı keşif/yapılandırma yardımcıları | - | `plugin-sdk/self-hosted-provider-setup` | Odaklı OpenAI uyumlu self-hosted sağlayıcı kurulum yardımcıları | Aynı self-hosted sağlayıcı keşif/yapılandırma yardımcıları | + | `plugin-sdk/provider-setup` | Düzenlenmiş local/self-hosted sağlayıcı kurulum yardımcıları | Self-hosted sağlayıcı keşfi/config yardımcıları | + | `plugin-sdk/self-hosted-provider-setup` | Odaklı OpenAI uyumlu self-hosted sağlayıcı kurulum yardımcıları | Aynı self-hosted sağlayıcı keşfi/config yardımcıları | | `plugin-sdk/provider-auth-runtime` | Sağlayıcı çalışma zamanı kimlik doğrulama yardımcıları | Çalışma zamanı API anahtarı çözümleme yardımcıları | | `plugin-sdk/provider-auth-api-key` | Sağlayıcı API anahtarı kurulum yardımcıları | API anahtarı onboarding/profil yazma yardımcıları | - | `plugin-sdk/provider-auth-result` | Sağlayıcı auth-result yardımcıları | Standart OAuth auth-result oluşturucu | - | `plugin-sdk/provider-auth-login` | Sağlayıcı etkileşimli oturum açma yardımcıları | Paylaşılan etkileşimli oturum açma yardımcıları | - | `plugin-sdk/provider-env-vars` | Sağlayıcı ortam değişkeni yardımcıları | Sağlayıcı kimlik doğrulama ortam değişkeni arama yardımcıları | + | `plugin-sdk/provider-auth-result` | Sağlayıcı auth-result yardımcıları | Standart OAuth auth-result oluşturucusu | + | `plugin-sdk/provider-auth-login` | Sağlayıcı etkileşimli giriş yardımcıları | Paylaşılan etkileşimli giriş yardımcıları | + | `plugin-sdk/provider-env-vars` | Sağlayıcı env var yardımcıları | Sağlayıcı kimlik doğrulama env var arama yardımcıları | | `plugin-sdk/provider-model-shared` | Paylaşılan sağlayıcı model/yeniden oynatma yardımcıları | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, paylaşılan replay-policy oluşturucuları, sağlayıcı uç nokta yardımcıları ve model kimliği normalleştirme yardımcıları | | `plugin-sdk/provider-catalog-shared` | Paylaşılan sağlayıcı katalog yardımcıları | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` | - | `plugin-sdk/provider-onboard` | Sağlayıcı onboarding yamaları | Onboarding yapılandırma yardımcıları | - | `plugin-sdk/provider-http` | Sağlayıcı HTTP yardımcıları | Genel sağlayıcı HTTP/uç nokta yetenek yardımcıları | - | `plugin-sdk/provider-web-fetch` | Sağlayıcı web-fetch yardımcıları | Web-fetch sağlayıcı kaydı/önbellek yardımcıları | - | `plugin-sdk/provider-web-search` | Sağlayıcı web-search yardımcıları | Web-search sağlayıcı kaydı/önbellek/yapılandırma yardımcıları | + | `plugin-sdk/provider-onboard` | Sağlayıcı onboarding yamaları | Onboarding config yardımcıları | + | `plugin-sdk/provider-http` | Sağlayıcı HTTP yardımcıları | Genel sağlayıcı HTTP/uç nokta yeteneği yardımcıları | + | `plugin-sdk/provider-web-fetch` | Sağlayıcı web-fetch yardımcıları | Web-fetch sağlayıcı kayıt/önbellek yardımcıları | + | `plugin-sdk/provider-web-search` | Sağlayıcı web-search yardımcıları | Web-search sağlayıcı kayıt/önbellek/config yardımcıları | | `plugin-sdk/provider-tools` | Sağlayıcı araç/şema uyumluluk yardımcıları | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini şema temizleme + tanılama ve `resolveXaiModelCompatPatch` / `applyXaiModelCompat` gibi xAI uyumluluk yardımcıları | | `plugin-sdk/provider-usage` | Sağlayıcı kullanım yardımcıları | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` ve diğer sağlayıcı kullanım yardımcıları | | `plugin-sdk/provider-stream` | Sağlayıcı akış sarmalayıcı yardımcıları | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, akış sarmalayıcı türleri ve paylaşılan Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot sarmalayıcı yardımcıları | - | `plugin-sdk/keyed-async-queue` | Sıralı async kuyruğu | `KeyedAsyncQueue` | + | `plugin-sdk/keyed-async-queue` | Sıralı async kuyruk | `KeyedAsyncQueue` | | `plugin-sdk/media-runtime` | Paylaşılan medya yardımcıları | Medya fetch/dönüştürme/depolama yardımcıları ve medya payload oluşturucuları | - | `plugin-sdk/media-understanding` | Medya anlama yardımcıları | Medya anlama sağlayıcı türleri ve sağlayıcıya dönük görsel/ses yardımcı dışa aktarmaları | - | `plugin-sdk/text-runtime` | Paylaşılan metin yardımcıları | Assistant görünür metin temizleme, markdown işleme/parçalama/tablo yardımcıları, redaksiyon yardımcıları, directive-tag yardımcıları, safe-text yardımcıları ve ilgili metin/günlükleme yardımcıları | - | `plugin-sdk/text-chunking` | Metin parçalara ayırma yardımcıları | Giden metin parçalara ayırma yardımcısı | - | `plugin-sdk/speech` | Konuşma yardımcıları | Konuşma sağlayıcı türleri ve sağlayıcıya dönük directive, registry ve doğrulama yardımcıları | - | `plugin-sdk/speech-core` | Paylaşılan konuşma çekirdeği | Konuşma sağlayıcı türleri, registry, directives, normalleştirme | - | `plugin-sdk/realtime-transcription` | Gerçek zamanlı transkripsiyon yardımcıları | Sağlayıcı türleri ve registry yardımcıları | - | `plugin-sdk/realtime-voice` | Gerçek zamanlı ses yardımcıları | Sağlayıcı türleri ve registry yardımcıları | - | `plugin-sdk/image-generation-core` | Paylaşılan görsel oluşturma çekirdeği | Görsel oluşturma türleri, failover, kimlik doğrulama ve registry yardımcıları | - | `plugin-sdk/music-generation` | Müzik oluşturma yardımcıları | Müzik oluşturma sağlayıcı/istek/sonuç türleri | - | `plugin-sdk/music-generation-core` | Paylaşılan müzik oluşturma çekirdeği | Müzik oluşturma türleri, failover yardımcıları, sağlayıcı arama ve model başvurusu ayrıştırma | - | `plugin-sdk/video-generation` | Video oluşturma yardımcıları | Video oluşturma sağlayıcı/istek/sonuç türleri | - | `plugin-sdk/video-generation-core` | Paylaşılan video oluşturma çekirdeği | Video oluşturma türleri, failover yardımcıları, sağlayıcı arama ve model başvurusu ayrıştırma | - | `plugin-sdk/interactive-runtime` | Etkileşimli yanıt yardımcıları | Etkileşimli yanıt payload normalleştirme/azaltma | - | `plugin-sdk/channel-config-primitives` | Kanal yapılandırma ilkelleri | Dar kanal config-schema ilkelleri | - | `plugin-sdk/channel-config-writes` | Kanal yapılandırma yazma yardımcıları | Kanal yapılandırma yazma yetkilendirme yardımcıları | - | `plugin-sdk/channel-plugin-common` | Paylaşılan kanal başlangıç bölümü | Paylaşılan kanal plugin başlangıç bölümü dışa aktarmaları | - | `plugin-sdk/channel-status` | Kanal durum yardımcıları | Paylaşılan kanal durum anlık görüntüsü/özeti yardımcıları | - | `plugin-sdk/allowlist-config-edit` | Allowlist yapılandırma yardımcıları | Allowlist yapılandırma düzenleme/okuma yardımcıları | - | `plugin-sdk/group-access` | Grup erişimi yardımcıları | Paylaşılan grup erişimi karar yardımcıları | + | `plugin-sdk/media-generation-runtime` | Paylaşılan medya üretim yardımcıları | Görsel/video/müzik üretimi için paylaşılan failover yardımcıları, aday seçimi ve eksik model mesajlaşması | + | `plugin-sdk/media-understanding` | Media-understanding yardımcıları | Media understanding sağlayıcı türleri ve sağlayıcıya dönük görsel/ses yardımcı dışa aktarımları | + | `plugin-sdk/text-runtime` | Paylaşılan metin yardımcıları | Asistan tarafından görülebilen metni temizleme, markdown işleme/parçalama/tablo yardımcıları, redaction yardımcıları, directive-tag yardımcıları, safe-text yardımcıları ve ilgili metin/günlükleme yardımcıları | + | `plugin-sdk/text-chunking` | Metin parçalama yardımcıları | Giden metin parçalama yardımcısı | + | `plugin-sdk/speech` | Konuşma yardımcıları | Konuşma sağlayıcı türleri ve sağlayıcıya dönük directive, kayıt ve doğrulama yardımcıları | + | `plugin-sdk/speech-core` | Paylaşılan konuşma çekirdeği | Konuşma sağlayıcı türleri, kayıt, directive'ler, normalleştirme | + | `plugin-sdk/realtime-transcription` | Gerçek zamanlı transkripsiyon yardımcıları | Sağlayıcı türleri ve kayıt yardımcıları | + | `plugin-sdk/realtime-voice` | Gerçek zamanlı ses yardımcıları | Sağlayıcı türleri ve kayıt yardımcıları | + | `plugin-sdk/image-generation-core` | Paylaşılan görsel üretim çekirdeği | Görsel üretim türleri, failover, kimlik doğrulama ve kayıt yardımcıları | + | `plugin-sdk/music-generation` | Müzik üretim yardımcıları | Müzik üretim sağlayıcı/istek/sonuç türleri | + | `plugin-sdk/music-generation-core` | Paylaşılan müzik üretim çekirdeği | Müzik üretim türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma | + | `plugin-sdk/video-generation` | Video üretim yardımcıları | Video üretim sağlayıcı/istek/sonuç türleri | + | `plugin-sdk/video-generation-core` | Paylaşılan video üretim çekirdeği | Video üretim türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma | + | `plugin-sdk/interactive-runtime` | Etkileşimli yanıt yardımcıları | Etkileşimli yanıt payload normalleştirme/indirgeme | + | `plugin-sdk/channel-config-primitives` | Kanal config temel bileşenleri | Dar kapsamlı kanal config-schema temel bileşenleri | + | `plugin-sdk/channel-config-writes` | Kanal config yazma yardımcıları | Kanal config yazma yetkilendirme yardımcıları | + | `plugin-sdk/channel-plugin-common` | Paylaşılan kanal prelude'u | Paylaşılan kanal plugin prelude dışa aktarımları | + | `plugin-sdk/channel-status` | Kanal durumu yardımcıları | Paylaşılan kanal durum anlık görüntü/özet yardımcıları | + | `plugin-sdk/allowlist-config-edit` | Allowlist config yardımcıları | Allowlist config düzenleme/okuma yardımcıları | + | `plugin-sdk/group-access` | Grup erişim yardımcıları | Paylaşılan grup erişim karar yardımcıları | | `plugin-sdk/direct-dm` | Doğrudan DM yardımcıları | Paylaşılan doğrudan DM kimlik doğrulama/koruma yardımcıları | - | `plugin-sdk/extension-shared` | Paylaşılan extension yardımcıları | Pasif kanal/durum yardımcı ilkelileri | - | `plugin-sdk/webhook-targets` | Webhook hedef yardımcıları | Webhook hedef registry ve rota kurulum yardımcıları | - | `plugin-sdk/webhook-path` | Webhook yol yardımcıları | Webhook yol normalleştirme yardımcıları | + | `plugin-sdk/extension-shared` | Paylaşılan extension yardımcıları | Pasif kanal/durum yardımcı temel bileşenleri | + | `plugin-sdk/webhook-targets` | Webhook hedef yardımcıları | Webhook hedef kaydı ve rota kurulum yardımcıları | + | `plugin-sdk/webhook-path` | Webhook yol yardımcıları | Webhook yolu normalleştirme yardımcıları | | `plugin-sdk/web-media` | Paylaşılan web medya yardımcıları | Uzak/yerel medya yükleme yardımcıları | | `plugin-sdk/zod` | Zod yeniden dışa aktarımı | Plugin SDK tüketicileri için yeniden dışa aktarılan `zod` | - | `plugin-sdk/memory-core` | Paketlenmiş memory-core yardımcıları | Bellek yöneticisi/yapılandırma/dosya/CLI yardımcı yüzeyi | - | `plugin-sdk/memory-core-engine-runtime` | Bellek motoru çalışma zamanı cephesi | Bellek dizin/aroma çalışma zamanı cephesi | - | `plugin-sdk/memory-core-host-engine-foundation` | Bellek host foundation motoru | Bellek host foundation motoru dışa aktarmaları | - | `plugin-sdk/memory-core-host-engine-embeddings` | Bellek host embedding motoru | Bellek host embedding motoru dışa aktarmaları | - | `plugin-sdk/memory-core-host-engine-qmd` | Bellek host QMD motoru | Bellek host QMD motoru dışa aktarmaları | - | `plugin-sdk/memory-core-host-engine-storage` | Bellek host depolama motoru | Bellek host depolama motoru dışa aktarmaları | - | `plugin-sdk/memory-core-host-multimodal` | Bellek host çok modlu yardımcıları | Bellek host çok modlu yardımcıları | - | `plugin-sdk/memory-core-host-query` | Bellek host sorgu yardımcıları | Bellek host sorgu yardımcıları | - | `plugin-sdk/memory-core-host-secret` | Bellek host gizli bilgi yardımcıları | Bellek host gizli bilgi yardımcıları | - | `plugin-sdk/memory-core-host-status` | Bellek host durum yardımcıları | Bellek host durum yardımcıları | - | `plugin-sdk/memory-core-host-runtime-cli` | Bellek host CLI çalışma zamanı | Bellek host CLI çalışma zamanı yardımcıları | - | `plugin-sdk/memory-core-host-runtime-core` | Bellek host çekirdek çalışma zamanı | Bellek host çekirdek çalışma zamanı yardımcıları | - | `plugin-sdk/memory-core-host-runtime-files` | Bellek host dosya/çalışma zamanı yardımcıları | Bellek host dosya/çalışma zamanı yardımcıları | - | `plugin-sdk/memory-lancedb` | Paketlenmiş memory-lancedb yardımcıları | Memory-lancedb yardımcı yüzeyi | - | `plugin-sdk/testing` | Test yardımcı programları | Test yardımcıları ve mock'lar | + | `plugin-sdk/memory-core` | Paketli memory-core yardımcıları | Bellek yöneticisi/config/dosya/CLI yardımcı yüzeyi | + | `plugin-sdk/memory-core-engine-runtime` | Bellek motoru çalışma zamanı cephesi | Bellek indeksleme/arama çalışma zamanı cephesi | + | `plugin-sdk/memory-core-host-engine-foundation` | Bellek ana makine foundation motoru | Bellek ana makine foundation motoru dışa aktarımları | + | `plugin-sdk/memory-core-host-engine-embeddings` | Bellek ana makine embedding motoru | Bellek ana makine embedding motoru dışa aktarımları | + | `plugin-sdk/memory-core-host-engine-qmd` | Bellek ana makine QMD motoru | Bellek ana makine QMD motoru dışa aktarımları | + | `plugin-sdk/memory-core-host-engine-storage` | Bellek ana makine depolama motoru | Bellek ana makine depolama motoru dışa aktarımları | + | `plugin-sdk/memory-core-host-multimodal` | Bellek ana makine multimodal yardımcıları | Bellek ana makine multimodal yardımcıları | + | `plugin-sdk/memory-core-host-query` | Bellek ana makine sorgu yardımcıları | Bellek ana makine sorgu yardımcıları | + | `plugin-sdk/memory-core-host-secret` | Bellek ana makine secret yardımcıları | Bellek ana makine secret yardımcıları | + | `plugin-sdk/memory-core-host-events` | Bellek ana makine olay günlüğü yardımcıları | Bellek ana makine olay günlüğü yardımcıları | + | `plugin-sdk/memory-core-host-status` | Bellek ana makine durum yardımcıları | Bellek ana makine durum yardımcıları | + | `plugin-sdk/memory-core-host-runtime-cli` | Bellek ana makine CLI çalışma zamanı | Bellek ana makine CLI çalışma zamanı yardımcıları | + | `plugin-sdk/memory-core-host-runtime-core` | Bellek ana makine çekirdek çalışma zamanı | Bellek ana makine çekirdek çalışma zamanı yardımcıları | + | `plugin-sdk/memory-core-host-runtime-files` | Bellek ana makine dosya/çalışma zamanı yardımcıları | Bellek ana makine dosya/çalışma zamanı yardımcıları | + | `plugin-sdk/memory-host-core` | Bellek ana makine çekirdek çalışma zamanı takma adı | Bellek ana makine çekirdek çalışma zamanı yardımcıları için satıcıdan bağımsız takma ad | + | `plugin-sdk/memory-host-events` | Bellek ana makine olay günlüğü takma adı | Bellek ana makine olay günlüğü yardımcıları için satıcıdan bağımsız takma ad | + | `plugin-sdk/memory-host-files` | Bellek ana makine dosya/çalışma zamanı takma adı | Bellek ana makine dosya/çalışma zamanı yardımcıları için satıcıdan bağımsız takma ad | + | `plugin-sdk/memory-host-markdown` | Yönetilen markdown yardımcıları | Belleğe bitişik plugin'ler için paylaşılan yönetilen markdown yardımcıları | + | `plugin-sdk/memory-host-search` | Etkin bellek arama cephesi | Lazy etkin bellek search-manager çalışma zamanı cephesi | + | `plugin-sdk/memory-host-status` | Bellek ana makine durumu takma adı | Bellek ana makine durum yardımcıları için satıcıdan bağımsız takma ad | + | `plugin-sdk/memory-lancedb` | Paketli memory-lancedb yardımcıları | Memory-lancedb yardımcı yüzeyi | + | `plugin-sdk/testing` | Test yardımcıları | Test yardımcıları ve mock'lar | -Bu tablo kasıtlı olarak tam SDK -yüzeyi değil, yaygın geçiş alt kümesidir. 200+'den fazla giriş noktasının tam listesi -`scripts/lib/plugin-sdk-entrypoints.json` içinde bulunur. +Bu tablo kasıtlı olarak tam SDK yüzeyi değil, yaygın geçiş alt kümesidir. +200'den fazla giriş noktasının tam listesi +`scripts/lib/plugin-sdk-entrypoints.json` içinde yer alır. -Bu liste hâlâ -`plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`, -`plugin-sdk/zalo-setup` ve `plugin-sdk/matrix*` gibi bazı paketlenmiş plugin yardımcı arayüzlerini içerir. Bunlar paketlenmiş plugin bakımı ve uyumluluğu için dışa aktarılmaya devam eder, ancak kasıtlı olarak -yaygın geçiş tablosunda yer almazlar ve yeni plugin kodu için önerilen hedef değildirler. +Bu listede hâlâ `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`, +`plugin-sdk/zalo-setup` ve `plugin-sdk/matrix*` gibi bazı paketli plugin yardımcı +seam'leri yer alır. Bunlar paketli plugin bakımı ve uyumluluk için dışa +aktarılmaya devam eder, ancak yaygın geçiş tablosuna kasıtlı olarak dahil +edilmemiştir ve yeni plugin kodu için önerilen hedef değildir. -Aynı kural aşağıdaki gibi diğer paketlenmiş yardımcı aileleri için de geçerlidir: +Aynı kural diğer paketli yardımcı aileleri için de geçerlidir; örneğin: -- browser destek yardımcıları: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` +- tarayıcı desteği yardımcıları: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` - Matrix: `plugin-sdk/matrix*` - LINE: `plugin-sdk/line*` - IRC: `plugin-sdk/irc*` @@ -324,24 +336,25 @@ Aynı kural aşağıdaki gibi diğer paketlenmiş yardımcı aileleri için de g `plugin-sdk/twitch`, `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, - `plugin-sdk/thread-ownership` ve `plugin-sdk/voice-call` gibi paketlenmiş yardımcı/plugin yüzeyleri + `plugin-sdk/thread-ownership` ve `plugin-sdk/voice-call` gibi + paketli yardımcı/plugin yüzeyleri -`plugin-sdk/github-copilot-token` şu anda dar belirteç yardımcı +`plugin-sdk/github-copilot-token` şu anda dar kapsamlı token-helper yüzeyi olan `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` ve `resolveCopilotApiToken` öğelerini dışa aktarır. -İşle en iyi eşleşen en dar içe aktarmayı kullanın. Bir dışa aktarma bulamazsanız, -`src/plugin-sdk/` içindeki kaynağı kontrol edin veya Discord'da sorun. +Yapılan işe en uygun en dar içe aktarmayı kullanın. Bir dışa aktarma +bulamıyorsanız `src/plugin-sdk/` altındaki kaynağı kontrol edin veya Discord'da sorun. ## Kaldırma zaman çizelgesi -| Ne zaman | Ne olur | -| ---------------------- | ----------------------------------------------------------------------- | -| **Şimdi** | Kullanım dışı yüzeyler çalışma zamanında uyarı verir | -| **Sonraki büyük sürüm** | Kullanım dışı yüzeyler kaldırılır; bunları hâlâ kullanan plugin'ler başarısız olur | +| Ne zaman | Ne olur | +| ---------------------- | ---------------------------------------------------------------------- | +| **Şimdi** | Kullanımdan kaldırılmış yüzeyler çalışma zamanında uyarılar üretir | +| **Bir sonraki büyük sürüm** | Kullanımdan kaldırılmış yüzeyler kaldırılır; bunları hâlâ kullanan plugin'ler başarısız olur | -Tüm çekirdek plugin'ler zaten geçirilmiştir. Harici plugin'ler -sonraki büyük sürümden önce geçiş yapmalıdır. +Tüm çekirdek plugin'ler zaten geçirilmiştir. Harici plugin'ler bir sonraki büyük +sürümden önce geçiş yapmalıdır. ## Uyarıları geçici olarak bastırma @@ -356,9 +369,9 @@ Bu geçici bir kaçış kapağıdır, kalıcı bir çözüm değildir. ## İlgili -- [Başlangıç](/tr/plugins/building-plugins) — ilk plugin'inizi geliştirin -- [SDK Overview](/tr/plugins/sdk-overview) — tam alt yol içe aktarma başvurusu -- [Kanal Plugin'leri](/tr/plugins/sdk-channel-plugins) — kanal plugin'leri geliştirme -- [Sağlayıcı Plugin'leri](/tr/plugins/sdk-provider-plugins) — sağlayıcı plugin'leri geliştirme -- [Plugin İç Yapısı](/tr/plugins/architecture) — mimariye derin bakış -- [Plugin Manifest](/tr/plugins/manifest) — manifest şeması başvurusu +- [Başlangıç](/tr/plugins/building-plugins) — ilk plugin'inizi oluşturun +- [SDK Genel Bakış](/tr/plugins/sdk-overview) — alt yollar için tam içe aktarma başvurusu +- [Kanal Plugin'leri](/tr/plugins/sdk-channel-plugins) — kanal plugin'leri oluşturma +- [Sağlayıcı Plugin'leri](/tr/plugins/sdk-provider-plugins) — sağlayıcı plugin'leri oluşturma +- [Plugin İç Yapıları](/tr/plugins/architecture) — mimariye derinlemesine bakış +- [Plugin Manifesti](/tr/plugins/manifest) — manifest şeması başvurusu diff --git a/docs/tr/plugins/sdk-overview.md b/docs/tr/plugins/sdk-overview.md index f87e81792..1980572a5 100644 --- a/docs/tr/plugins/sdk-overview.md +++ b/docs/tr/plugins/sdk-overview.md @@ -1,30 +1,30 @@ --- read_when: - - Hangi SDK alt yolundan içe aktarma yapmanız gerektiğini bilmeniz gerekiyor + - Hangi SDK alt yolundan içe aktarma yapılacağını bilmeniz gerekiyor - OpenClawPluginApi üzerindeki tüm kayıt yöntemleri için bir başvuru istiyorsunuz - Belirli bir SDK dışa aktarımını arıyorsunuz sidebarTitle: SDK Overview -summary: İçe aktarma eşlemesi, kayıt API başvurusu ve SDK mimarisi +summary: İçe aktarma eşlemi, kayıt API başvurusu ve SDK mimarisi title: Plugin SDK Genel Bakış x-i18n: - generated_at: "2026-04-06T03:11:21Z" + generated_at: "2026-04-06T08:51:22Z" model: gpt-5.4 provider: openai - source_hash: d801641f26f39dc21490d2a69a337ff1affb147141360916b8b58a267e9f822a + source_hash: acd2887ef52c66b2f234858d812bb04197ecd0bfb3e4f7bf3622f8fdc765acad source_path: plugins/sdk-overview.md workflow: 15 --- # Plugin SDK Genel Bakış -Plugin SDK, eklentiler ile çekirdek arasındaki türlendirilmiş sözleşmedir. Bu sayfa, -**neyin içe aktarılacağı** ve **neleri kaydedebileceğiniz** için başvurudur. +Plugin SDK, plugin'ler ile çekirdek arasındaki türlendirilmiş sözleşmedir. Bu sayfa, +**neyi içe aktaracağınız** ve **neyi kaydedebileceğiniz** için başvurudur. **Nasıl yapılır kılavuzu mu arıyorsunuz?** - - İlk eklenti mi? [Başlarken](/tr/plugins/building-plugins) ile başlayın - - Kanal eklentisi mi? [Kanal Eklentileri](/tr/plugins/sdk-channel-plugins) bölümüne bakın - - Sağlayıcı eklentisi mi? [Sağlayıcı Eklentileri](/tr/plugins/sdk-provider-plugins) bölümüne bakın + - İlk plugin mi? [Başlangıç](/tr/plugins/building-plugins) ile başlayın + - Kanal plugin'i mi? [Channel Plugins](/tr/plugins/sdk-channel-plugins) sayfasına bakın + - Sağlayıcı plugin'i mi? [Provider Plugins](/tr/plugins/sdk-provider-plugins) sayfasına bakın ## İçe aktarma kuralı @@ -36,303 +36,317 @@ import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry"; import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core"; ``` -Her alt yol küçük, kendi içinde yeterli bir modüldür. Bu, başlangıcı hızlı tutar ve -döngüsel bağımlılık sorunlarını önler. Kanala özgü giriş/oluşturma yardımcıları için -`openclaw/plugin-sdk/channel-core` yolunu tercih edin; daha geniş şemsiye yüzeyi ve +Her alt yol küçük, kendi içinde tamamlanmış bir modüldür. Bu, başlatmayı hızlı tutar +ve dairesel bağımlılık sorunlarını önler. Kanala özel giriş/oluşturma yardımcıları için, +`openclaw/plugin-sdk/channel-core` yolunu tercih edin; daha geniş şemsiye yüzey ve `buildChannelConfigSchema` gibi paylaşılan yardımcılar için `openclaw/plugin-sdk/core` yolunu kullanın. `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`, -`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp` veya -kanal markalı yardımcı yüzeyler gibi sağlayıcı adlı kolaylık yolları eklemeyin ya da bunlara bağlı kalmayın. -Paketlenmiş eklentiler, genel -SDK alt yollarını kendi `api.ts` veya `runtime-api.ts` barrel dosyaları içinde birleştirmelidir ve çekirdek -ya bu eklenti yerel barrel dosyalarını kullanmalı ya da ihtiyaç gerçekten kanallar arasıysa -dar bir genel SDK sözleşmesi eklemelidir. +`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp` gibi +sağlayıcı adlı kolaylık yüzeyleri veya kanal markalı yardımcı yüzeyler +eklemeyin ya da bunlara bağımlı olmayın. Paketlenmiş plugin'ler, +genel SDK alt yollarını kendi `api.ts` veya `runtime-api.ts` varil dosyaları içinde +birleştirmelidir; çekirdek ise ya bu plugin-yerel varil dosyalarını kullanmalı ya da +ihtiyaç gerçekten kanallar arasıysa dar bir genel SDK sözleşmesi eklemelidir. -Oluşturulan dışa aktarma eşlemesi hâlâ `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, +Oluşturulan dışa aktarma eşlemi hâlâ +`plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`, `plugin-sdk/zalo-setup` ve `plugin-sdk/matrix*` gibi -küçük bir paketlenmiş eklenti yardımcı yüzeyi kümesi içerir. Bu -alt yollar yalnızca paketlenmiş eklenti bakımı ve uyumluluk içindir; aşağıdaki ortak tabloda kasıtlı olarak -yer almazlar ve yeni üçüncü taraf eklentiler için önerilen -içe aktarma yolu değildirler. +küçük bir paketlenmiş plugin yardımcı yüzeyi kümesi içerir. Bu +alt yollar yalnızca paketlenmiş plugin bakımı ve uyumluluğu için vardır; +aşağıdaki ortak tabloda bilinçli olarak yer verilmezler ve yeni üçüncü taraf +plugin'ler için önerilen içe aktarma yolu değildirler. ## Alt yol başvurusu -En yaygın kullanılan alt yollar, amaçlarına göre gruplandırılmıştır. 200'den fazla alt yolun -oluşturulmuş tam listesi `scripts/lib/plugin-sdk-entrypoints.json` içinde bulunur. +Amaca göre gruplanmış, en yaygın kullanılan alt yollar. 200'den fazla +alt yolun oluşturulmuş tam listesi `scripts/lib/plugin-sdk-entrypoints.json` +dosyasında bulunur. -Ayrılmış paketlenmiş eklenti yardımcı alt yolları bu oluşturulmuş listede görünmeye devam eder. -Bir belge sayfası birini açıkça genel olarak öne çıkarmadıkça, bunları uygulama ayrıntısı/uyumluluk yüzeyleri olarak değerlendirin. +Ayrılmış paketlenmiş-plugin yardımcı alt yolları bu oluşturulmuş listede hâlâ görünür. +Bir doküman sayfası bunlardan birini açıkça herkese açık olarak öne çıkarmadıkça, +bunları uygulama ayrıntısı/uyumluluk yüzeyleri olarak değerlendirin. -### Eklenti girişi +### Plugin girişi -| Alt yol | Temel dışa aktarımlar | -| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | -| `plugin-sdk/plugin-entry` | `definePluginEntry` | -| `plugin-sdk/core` | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema` | -| `plugin-sdk/config-schema` | `OpenClawSchema` | -| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` | +| Alt yol | Ana dışa aktarımlar | +| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | +| `plugin-sdk/plugin-entry` | `definePluginEntry` | +| `plugin-sdk/core` | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema` | +| `plugin-sdk/config-schema` | `OpenClawSchema` | +| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` | - | Alt yol | Temel dışa aktarımlar | + | Alt yol | Ana dışa aktarımlar | | --- | --- | | `plugin-sdk/channel-core` | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` | - | `plugin-sdk/config-schema` | Kök `openclaw.json` Zod şeması dışa aktarımı (`OpenClawSchema`) | + | `plugin-sdk/config-schema` | Kök `openclaw.json` Zod şema dışa aktarımı (`OpenClawSchema`) | | `plugin-sdk/channel-setup` | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, ayrıca `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` | | `plugin-sdk/setup` | Paylaşılan kurulum sihirbazı yardımcıları, izin listesi istemleri, kurulum durumu oluşturucuları | | `plugin-sdk/setup-runtime` | `createPatchedAccountSetupAdapter`, `createEnvPatchedAccountSetupAdapter`, `createSetupInputPresenceValidator`, `noteChannelLookupFailure`, `noteChannelLookupSummary`, `promptResolvedAllowFrom`, `splitSetupEntries`, `createAllowlistSetupWizardProxy`, `createDelegatedSetupWizardProxy` | | `plugin-sdk/setup-adapter-runtime` | `createEnvPatchedAccountSetupAdapter` | | `plugin-sdk/setup-tools` | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` | - | `plugin-sdk/account-core` | Çok hesaplı yapılandırma/eylem kapısı yardımcıları, varsayılan hesap geri dönüş yardımcıları | - | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, hesap kimliği normalizasyon yardımcıları | + | `plugin-sdk/account-core` | Çoklu hesap yapılandırma/eylem-geçidi yardımcıları, varsayılan hesap geri dönüş yardımcıları | + | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, hesap kimliği normalleştirme yardımcıları | | `plugin-sdk/account-resolution` | Hesap arama + varsayılan geri dönüş yardımcıları | | `plugin-sdk/account-helpers` | Dar hesap listesi/hesap eylemi yardımcıları | | `plugin-sdk/channel-pairing` | `createChannelPairingController` | | `plugin-sdk/channel-reply-pipeline` | `createChannelReplyPipeline` | | `plugin-sdk/channel-config-helpers` | `createHybridChannelConfigAdapter` | | `plugin-sdk/channel-config-schema` | Kanal yapılandırma şeması türleri | - | `plugin-sdk/telegram-command-config` | Paketlenmiş sözleşme geri dönüşüyle Telegram özel komut normalizasyonu/doğrulama yardımcıları | + | `plugin-sdk/telegram-command-config` | Paketlenmiş sözleşme geri dönüşüyle Telegram özel komut normalleştirme/doğrulama yardımcıları | | `plugin-sdk/channel-policy` | `resolveChannelGroupRequireMention` | | `plugin-sdk/channel-lifecycle` | `createAccountStatusSink` | | `plugin-sdk/inbound-envelope` | Paylaşılan gelen yönlendirme + zarf oluşturucu yardımcıları | - | `plugin-sdk/inbound-reply-dispatch` | Paylaşılan gelen kayıt etme ve dağıtım yardımcıları | + | `plugin-sdk/inbound-reply-dispatch` | Paylaşılan gelen kayıt ve dağıtım yardımcıları | | `plugin-sdk/messaging-targets` | Hedef ayrıştırma/eşleştirme yardımcıları | | `plugin-sdk/outbound-media` | Paylaşılan giden medya yükleme yardımcıları | - | `plugin-sdk/outbound-runtime` | Giden kimlik/gönderme temsilci yardımcıları | + | `plugin-sdk/outbound-runtime` | Giden kimlik/gönderim temsilci yardımcıları | | `plugin-sdk/thread-bindings-runtime` | İş parçacığı bağlama yaşam döngüsü ve bağdaştırıcı yardımcıları | - | `plugin-sdk/agent-media-payload` | Eski aracı medya yükü oluşturucu | + | `plugin-sdk/agent-media-payload` | Eski aracı medya yükü oluşturucusu | | `plugin-sdk/conversation-runtime` | Konuşma/iş parçacığı bağlama, eşleştirme ve yapılandırılmış bağlama yardımcıları | - | `plugin-sdk/runtime-config-snapshot` | Çalışma zamanı yapılandırma anlık görüntüsü yardımcısı | + | `plugin-sdk/runtime-config-snapshot` | Çalışma zamanı yapılandırma anlık görüntü yardımcısı | | `plugin-sdk/runtime-group-policy` | Çalışma zamanı grup ilkesi çözümleme yardımcıları | | `plugin-sdk/channel-status` | Paylaşılan kanal durum anlık görüntüsü/özet yardımcıları | - | `plugin-sdk/channel-config-primitives` | Dar kanal yapılandırma-şeması ilkelleri | + | `plugin-sdk/channel-config-primitives` | Dar kanal yapılandırma şeması ilkel öğeleri | | `plugin-sdk/channel-config-writes` | Kanal yapılandırma yazma yetkilendirme yardımcıları | - | `plugin-sdk/channel-plugin-common` | Paylaşılan kanal eklentisi başlangıç dışa aktarımları | + | `plugin-sdk/channel-plugin-common` | Paylaşılan kanal plugin başlangıç dışa aktarımları | | `plugin-sdk/allowlist-config-edit` | İzin listesi yapılandırma düzenleme/okuma yardımcıları | - | `plugin-sdk/group-access` | Paylaşılan grup erişimi karar yardımcıları | + | `plugin-sdk/group-access` | Paylaşılan grup erişim kararı yardımcıları | | `plugin-sdk/direct-dm` | Paylaşılan doğrudan DM kimlik doğrulama/koruma yardımcıları | - | `plugin-sdk/interactive-runtime` | Etkileşimli yanıt yükü normalizasyonu/indirgeme yardımcıları | + | `plugin-sdk/interactive-runtime` | Etkileşimli yanıt yükü normalleştirme/indirgeme yardımcıları | | `plugin-sdk/channel-inbound` | Debounce, mention eşleştirme, zarf yardımcıları | | `plugin-sdk/channel-send-result` | Yanıt sonuç türleri | | `plugin-sdk/channel-actions` | `createMessageToolButtonsSchema`, `createMessageToolCardSchema` | | `plugin-sdk/channel-targets` | Hedef ayrıştırma/eşleştirme yardımcıları | - | `plugin-sdk/channel-contract` | Kanal sözleşmesi türleri | - | `plugin-sdk/channel-feedback` | Geri bildirim/tepki bağlantısı | + | `plugin-sdk/channel-contract` | Kanal sözleşme türleri | + | `plugin-sdk/channel-feedback` | Geri bildirim/reaksiyon kablolaması | - | Alt yol | Temel dışa aktarımlar | + | Alt yol | Ana dışa aktarımlar | | --- | --- | | `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` | - | `plugin-sdk/provider-setup` | Seçilmiş yerel/kendi barındırılan sağlayıcı kurulum yardımcıları | - | `plugin-sdk/self-hosted-provider-setup` | Odaklı OpenAI uyumlu kendi barındırılan sağlayıcı kurulum yardımcıları | - | `plugin-sdk/provider-auth-runtime` | Sağlayıcı eklentileri için çalışma zamanı API anahtarı çözümleme yardımcıları | - | `plugin-sdk/provider-auth-api-key` | API anahtarı başlangıcı/profil yazma yardımcıları | - | `plugin-sdk/provider-auth-result` | Standart OAuth kimlik doğrulama sonucu oluşturucusu | - | `plugin-sdk/provider-auth-login` | Sağlayıcı eklentileri için paylaşılan etkileşimli giriş yardımcıları | - | `plugin-sdk/provider-env-vars` | Sağlayıcı kimlik doğrulama ortam değişkeni arama yardımcıları | + | `plugin-sdk/provider-setup` | Düzenlenmiş yerel/kendi kendine barındırılan sağlayıcı kurulum yardımcıları | + | `plugin-sdk/self-hosted-provider-setup` | Odaklanmış OpenAI uyumlu kendi kendine barındırılan sağlayıcı kurulum yardımcıları | + | `plugin-sdk/provider-auth-runtime` | Sağlayıcı plugin'leri için çalışma zamanı API anahtarı çözümleme yardımcıları | + | `plugin-sdk/provider-auth-api-key` | API anahtarı ilk kurulum/profil yazma yardımcıları | + | `plugin-sdk/provider-auth-result` | Standart OAuth kimlik doğrulama-sonucu oluşturucusu | + | `plugin-sdk/provider-auth-login` | Sağlayıcı plugin'leri için paylaşılan etkileşimli giriş yardımcıları | + | `plugin-sdk/provider-env-vars` | Sağlayıcı kimlik doğrulama env var arama yardımcıları | | `plugin-sdk/provider-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile` | - | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, paylaşılan yeniden oynatma ilkesi oluşturucuları, sağlayıcı uç nokta yardımcıları ve `normalizeNativeXaiModelId` gibi model kimliği normalizasyon yardımcıları | + | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, paylaşılan replay-policy oluşturucuları, sağlayıcı uç nokta yardımcıları ve `normalizeNativeXaiModelId` gibi model kimliği normalleştirme yardımcıları | | `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` | | `plugin-sdk/provider-http` | Genel sağlayıcı HTTP/uç nokta yetenek yardımcıları | - | `plugin-sdk/provider-web-fetch` | Web-fetch sağlayıcı kaydı/önbellek yardımcıları | - | `plugin-sdk/provider-web-search` | Web arama sağlayıcı kaydı/önbellek/yapılandırma yardımcıları | - | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini şema temizliği + tanılama ve `resolveXaiModelCompatPatch` / `applyXaiModelCompat` gibi xAI uyumluluk yardımcıları | + | `plugin-sdk/provider-web-fetch` | Web-fetch sağlayıcı kayıt/önbellek yardımcıları | + | `plugin-sdk/provider-web-search` | Web-search sağlayıcı kayıt/önbellek/yapılandırma yardımcıları | + | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini şema temizleme + tanılama ve `resolveXaiModelCompatPatch` / `applyXaiModelCompat` gibi xAI uyumluluk yardımcıları | | `plugin-sdk/provider-usage` | `fetchClaudeUsage` ve benzerleri | | `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, akış sarmalayıcı türleri ve paylaşılan Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot sarmalayıcı yardımcıları | - | `plugin-sdk/provider-onboard` | Başlangıç yapılandırması yama yardımcıları | - | `plugin-sdk/global-singleton` | İşlem yerel singleton/eşleme/önbellek yardımcıları | + | `plugin-sdk/provider-onboard` | İlk katılım yapılandırma yama yardımcıları | + | `plugin-sdk/global-singleton` | İşlem-yerel singleton/map/önbellek yardımcıları | - | Alt yol | Temel dışa aktarımlar | + | Alt yol | Ana dışa aktarımlar | | --- | --- | - | `plugin-sdk/command-auth` | `resolveControlCommandGate`, komut kayıt yardımcıları, gönderen yetkilendirme yardımcıları | - | `plugin-sdk/approval-auth-runtime` | Onaylayan çözümleme ve aynı sohbet eylem kimlik doğrulama yardımcıları | + | `plugin-sdk/command-auth` | `resolveControlCommandGate`, komut kayıt defteri yardımcıları, gönderen yetkilendirme yardımcıları | + | `plugin-sdk/approval-auth-runtime` | Onaylayıcı çözümleme ve aynı sohbet eylem kimlik doğrulama yardımcıları | | `plugin-sdk/approval-client-runtime` | Yerel exec onay profili/filtre yardımcıları | | `plugin-sdk/approval-delivery-runtime` | Yerel onay yeteneği/teslim bağdaştırıcıları | | `plugin-sdk/approval-native-runtime` | Yerel onay hedefi + hesap bağlama yardımcıları | - | `plugin-sdk/approval-reply-runtime` | Exec/eklenti onay yanıt yükü yardımcıları | + | `plugin-sdk/approval-reply-runtime` | Exec/plugin onay yanıt yükü yardımcıları | | `plugin-sdk/command-auth-native` | Yerel komut kimlik doğrulama + yerel oturum hedefi yardımcıları | | `plugin-sdk/command-detection` | Paylaşılan komut algılama yardımcıları | - | `plugin-sdk/command-surface` | Komut gövdesi normalizasyonu ve komut yüzeyi yardımcıları | + | `plugin-sdk/command-surface` | Komut gövdesi normalleştirme ve komut yüzeyi yardımcıları | | `plugin-sdk/allow-from` | `formatAllowFromLowercase` | | `plugin-sdk/security-runtime` | Paylaşılan güven, DM geçitleme, dış içerik ve gizli bilgi toplama yardımcıları | | `plugin-sdk/ssrf-policy` | Ana makine izin listesi ve özel ağ SSRF ilkesi yardımcıları | - | `plugin-sdk/ssrf-runtime` | Sabitlenmiş dağıtıcı, SSRF korumalı fetch ve SSRF ilkesi yardımcıları | - | `plugin-sdk/secret-input` | Gizli bilgi girdisi ayrıştırma yardımcıları | + | `plugin-sdk/ssrf-runtime` | Sabitlenmiş-dispatcher, SSRF korumalı fetch ve SSRF ilkesi yardımcıları | + | `plugin-sdk/secret-input` | Gizli bilgi girdi ayrıştırma yardımcıları | | `plugin-sdk/webhook-ingress` | Webhook istek/hedef yardımcıları | | `plugin-sdk/webhook-request-guards` | İstek gövdesi boyutu/zaman aşımı yardımcıları | - | Alt yol | Temel dışa aktarımlar | + | Alt yol | Ana dışa aktarımlar | | --- | --- | - | `plugin-sdk/runtime` | Geniş çalışma zamanı/günlükleme/yedekleme/eklenti kurulum yardımcıları | - | `plugin-sdk/runtime-env` | Dar çalışma zamanı ortamı, günlükleyici, zaman aşımı, yeniden deneme ve backoff yardımcıları | + | `plugin-sdk/runtime` | Geniş çalışma zamanı/günlükleme/yedekleme/plugin kurulum yardımcıları | + | `plugin-sdk/runtime-env` | Dar çalışma zamanı env, logger, zaman aşımı, yeniden deneme ve backoff yardımcıları | | `plugin-sdk/runtime-store` | `createPluginRuntimeStore` | - | `plugin-sdk/plugin-runtime` | Paylaşılan eklenti komutu/kanca/http/etkileşimli yardımcıları | - | `plugin-sdk/hook-runtime` | Paylaşılan webhook/dahili kanca hattı yardımcıları | + | `plugin-sdk/plugin-runtime` | Paylaşılan plugin komutu/hook/http/etkileşimli yardımcıları | + | `plugin-sdk/hook-runtime` | Paylaşılan webhook/dahili hook işlem hattı yardımcıları | | `plugin-sdk/lazy-runtime` | `createLazyRuntimeModule`, `createLazyRuntimeMethod` ve `createLazyRuntimeSurface` gibi tembel çalışma zamanı içe aktarma/bağlama yardımcıları | | `plugin-sdk/process-runtime` | Süreç exec yardımcıları | | `plugin-sdk/cli-runtime` | CLI biçimlendirme, bekleme ve sürüm yardımcıları | | `plugin-sdk/gateway-runtime` | Gateway istemcisi ve kanal durumu yama yardımcıları | | `plugin-sdk/config-runtime` | Yapılandırma yükleme/yazma yardımcıları | - | `plugin-sdk/telegram-command-config` | Paketlenmiş Telegram sözleşme yüzeyi kullanılamasa bile Telegram komut adı/açıklama normalizasyonu ve yinelenen/çakışma denetimleri | - | `plugin-sdk/approval-runtime` | Exec/eklenti onay yardımcıları, onay yeteneği oluşturucuları, kimlik doğrulama/profil yardımcıları, yerel yönlendirme/çalışma zamanı yardımcıları | + | `plugin-sdk/telegram-command-config` | Paketlenmiş Telegram sözleşme yüzeyi kullanılamadığında bile Telegram komut adı/açıklaması normalleştirme ve yinelenen/çakışma denetimleri | + | `plugin-sdk/approval-runtime` | Exec/plugin onay yardımcıları, onay yeteneği oluşturucuları, kimlik doğrulama/profil yardımcıları, yerel yönlendirme/çalışma zamanı yardımcıları | | `plugin-sdk/reply-runtime` | Paylaşılan gelen/yanıt çalışma zamanı yardımcıları, parçalama, dağıtım, heartbeat, yanıt planlayıcı | | `plugin-sdk/reply-dispatch-runtime` | Dar yanıt dağıtımı/sonlandırma yardımcıları | | `plugin-sdk/reply-history` | `buildHistoryContext`, `recordPendingHistoryEntry` ve `clearHistoryEntriesIfEnabled` gibi paylaşılan kısa pencere yanıt geçmişi yardımcıları | | `plugin-sdk/reply-reference` | `createReplyReferencePlanner` | | `plugin-sdk/reply-chunking` | Dar metin/markdown parçalama yardımcıları | - | `plugin-sdk/session-store-runtime` | Oturum deposu yolu + güncellenme zamanı yardımcıları | + | `plugin-sdk/session-store-runtime` | Oturum deposu yolu + updated-at yardımcıları | | `plugin-sdk/state-paths` | Durum/OAuth dizin yolu yardımcıları | - | `plugin-sdk/routing` | `resolveAgentRoute`, `buildAgentSessionKey` ve `resolveDefaultAgentBoundAccountId` gibi yönlendirme/oturum anahtarı/hesap bağlama yardımcıları | - | `plugin-sdk/status-helpers` | Paylaşılan kanal/hesap durumu özeti yardımcıları, çalışma zamanı durumu varsayılanları ve sorun meta verisi yardımcıları | - | `plugin-sdk/target-resolver-runtime` | Paylaşılan hedef çözücü yardımcıları | - | `plugin-sdk/string-normalization-runtime` | Slug/dize normalizasyon yardımcıları | + | `plugin-sdk/routing` | `resolveAgentRoute`, `buildAgentSessionKey` ve `resolveDefaultAgentBoundAccountId` gibi rota/oturum anahtarı/hesap bağlama yardımcıları | + | `plugin-sdk/status-helpers` | Paylaşılan kanal/hesap durum özeti yardımcıları, çalışma zamanı durumu varsayılanları ve sorun meta verisi yardımcıları | + | `plugin-sdk/target-resolver-runtime` | Paylaşılan hedef çözümleyici yardımcıları | + | `plugin-sdk/string-normalization-runtime` | Slug/dize normalleştirme yardımcıları | | `plugin-sdk/request-url` | Fetch/istek benzeri girdilerden dize URL'leri çıkarma | - | `plugin-sdk/run-command` | Normalize stdout/stderr sonuçları ile zamanlı komut çalıştırıcı | - | `plugin-sdk/param-readers` | Yaygın araç/CLI parametre okuyucuları | + | `plugin-sdk/run-command` | Normalize edilmiş stdout/stderr sonuçlarıyla zamanlanmış komut çalıştırıcısı | + | `plugin-sdk/param-readers` | Ortak araç/CLI parametre okuyucuları | | `plugin-sdk/tool-send` | Araç argümanlarından standart gönderim hedefi alanlarını çıkarma | | `plugin-sdk/temp-path` | Paylaşılan geçici indirme yolu yardımcıları | - | `plugin-sdk/logging-core` | Alt sistem günlükleyicisi ve sansürleme yardımcıları | - | `plugin-sdk/markdown-table-runtime` | Markdown tablo kipi yardımcıları | - | `plugin-sdk/json-store` | Küçük JSON durumu okuma/yazma yardımcıları | + | `plugin-sdk/logging-core` | Alt sistem logger ve redaksiyon yardımcıları | + | `plugin-sdk/markdown-table-runtime` | Markdown tablo modu yardımcıları | + | `plugin-sdk/json-store` | Küçük JSON durum okuma/yazma yardımcıları | | `plugin-sdk/file-lock` | Yeniden girişli dosya kilidi yardımcıları | - | `plugin-sdk/persistent-dedupe` | Disk destekli tekilleştirme önbelleği yardımcıları | - | `plugin-sdk/acp-runtime` | ACP çalışma zamanı/oturum ve yanıt dağıtım yardımcıları | - | `plugin-sdk/agent-config-primitives` | Dar aracı çalışma zamanı yapılandırma-şeması ilkelleri | + | `plugin-sdk/persistent-dedupe` | Disk destekli dedupe önbellek yardımcıları | + | `plugin-sdk/acp-runtime` | ACP çalışma zamanı/oturum ve yanıt dağıtımı yardımcıları | + | `plugin-sdk/agent-config-primitives` | Dar aracı çalışma zamanı yapılandırma şeması ilkel öğeleri | | `plugin-sdk/boolean-param` | Esnek boolean parametre okuyucusu | | `plugin-sdk/dangerous-name-runtime` | Tehlikeli ad eşleştirme çözümleme yardımcıları | - | `plugin-sdk/device-bootstrap` | Cihaz bootstrap ve eşleştirme belirteci yardımcıları | - | `plugin-sdk/extension-shared` | Paylaşılan pasif kanal ve durum yardımcı ilkelleri | + | `plugin-sdk/device-bootstrap` | Cihaz önyükleme ve eşleştirme belirteci yardımcıları | + | `plugin-sdk/extension-shared` | Paylaşılan pasif kanal ve durum yardımcısı ilkel öğeleri | | `plugin-sdk/models-provider-runtime` | `/models` komutu/sağlayıcı yanıt yardımcıları | - | `plugin-sdk/skill-commands-runtime` | Skill komut listeleme yardımcıları | - | `plugin-sdk/native-command-registry` | Yerel komut kaydı/oluşturma/serileştirme yardımcıları | - | `plugin-sdk/provider-zai-endpoint` | Z.AI uç nokta algılama yardımcıları | + | `plugin-sdk/skill-commands-runtime` | Skills komut listeleme yardımcıları | + | `plugin-sdk/native-command-registry` | Yerel komut kayıt defteri/oluşturma/serileştirme yardımcıları | + | `plugin-sdk/provider-zai-endpoint` | Z.A.I uç nokta algılama yardımcıları | | `plugin-sdk/infra-runtime` | Sistem olayı/heartbeat yardımcıları | | `plugin-sdk/collection-runtime` | Küçük sınırlı önbellek yardımcıları | | `plugin-sdk/diagnostic-runtime` | Tanılama bayrağı ve olay yardımcıları | | `plugin-sdk/error-runtime` | Hata grafiği, biçimlendirme, paylaşılan hata sınıflandırma yardımcıları, `isApprovalNotFoundError` | - | `plugin-sdk/fetch-runtime` | Sarılmış fetch, proxy ve sabitlenmiş arama yardımcıları | - | `plugin-sdk/host-runtime` | Ana makine adı ve SCP ana makine normalizasyon yardımcıları | + | `plugin-sdk/fetch-runtime` | Sarmalanmış fetch, proxy ve sabitlenmiş arama yardımcıları | + | `plugin-sdk/host-runtime` | Ana makine adı ve SCP ana makinesi normalleştirme yardımcıları | | `plugin-sdk/retry-runtime` | Yeniden deneme yapılandırması ve yeniden deneme çalıştırıcı yardımcıları | - | `plugin-sdk/agent-runtime` | Aracı dizini/kimlik/çalışma alanı yardımcıları | - | `plugin-sdk/directory-runtime` | Yapılandırma destekli dizin sorgulama/tekilleştirme | + | `plugin-sdk/agent-runtime` | Aracı dizini/kimliği/çalışma alanı yardımcıları | + | `plugin-sdk/directory-runtime` | Yapılandırma destekli dizin sorgusu/dedupe | | `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` | - | Alt yol | Temel dışa aktarımlar | + | Alt yol | Ana dışa aktarımlar | | --- | --- | - | `plugin-sdk/media-runtime` | Medya yükü oluşturucularına ek olarak paylaşılan medya getirme/dönüştürme/depolama yardımcıları | - | `plugin-sdk/media-understanding` | Medya anlama sağlayıcı türleri ile sağlayıcıya dönük görsel/ses yardımcı dışa aktarımları | - | `plugin-sdk/text-runtime` | Aracıya görünür metin temizleme, markdown işleme/parçalama/tablo yardımcıları, sansürleme yardımcıları, yönerge etiketi yardımcıları ve güvenli metin yardımcıları gibi paylaşılan metin/markdown/günlükleme yardımcıları | + | `plugin-sdk/media-runtime` | Medya yükü oluşturucularına ek olarak paylaşılan medya fetch/dönüştürme/depolama yardımcıları | + | `plugin-sdk/media-generation-runtime` | Paylaşılan medya oluşturma failover yardımcıları, aday seçimi ve eksik model mesajlaşması | + | `plugin-sdk/media-understanding` | Medya anlama sağlayıcı türleri ve sağlayıcı taraflı görsel/ses yardımcı dışa aktarımları | + | `plugin-sdk/text-runtime` | Asistan tarafından görülebilen metin ayıklama, markdown işleme/parçalama/tablo yardımcıları, redaksiyon yardımcıları, direktif etiketi yardımcıları ve güvenli metin yardımcıları gibi paylaşılan metin/markdown/günlükleme yardımcıları | | `plugin-sdk/text-chunking` | Giden metin parçalama yardımcısı | - | `plugin-sdk/speech` | Konuşma sağlayıcı türleri ile sağlayıcıya dönük yönerge, kayıt ve doğrulama yardımcıları | - | `plugin-sdk/speech-core` | Paylaşılan konuşma sağlayıcı türleri, kayıt, yönerge ve normalizasyon yardımcıları | - | `plugin-sdk/realtime-transcription` | Gerçek zamanlı transkripsiyon sağlayıcı türleri ve kayıt yardımcıları | - | `plugin-sdk/realtime-voice` | Gerçek zamanlı ses sağlayıcı türleri ve kayıt yardımcıları | - | `plugin-sdk/image-generation` | Görsel üretimi sağlayıcı türleri | - | `plugin-sdk/image-generation-core` | Paylaşılan görsel üretimi türleri, geri dönüş, kimlik doğrulama ve kayıt yardımcıları | - | `plugin-sdk/music-generation` | Müzik üretimi sağlayıcı/istek/sonuç türleri | - | `plugin-sdk/music-generation-core` | Paylaşılan müzik üretimi türleri, geri dönüş yardımcıları, sağlayıcı arama ve model başvurusu ayrıştırma | - | `plugin-sdk/video-generation` | Video üretimi sağlayıcı/istek/sonuç türleri | - | `plugin-sdk/video-generation-core` | Paylaşılan video üretimi türleri, geri dönüş yardımcıları, sağlayıcı arama ve model başvurusu ayrıştırma | - | `plugin-sdk/webhook-targets` | Webhook hedef kaydı ve rota kurulum yardımcıları | - | `plugin-sdk/webhook-path` | Webhook yolu normalizasyon yardımcıları | + | `plugin-sdk/speech` | Konuşma sağlayıcı türleri ve sağlayıcı taraflı direktif, kayıt defteri ve doğrulama yardımcıları | + | `plugin-sdk/speech-core` | Paylaşılan konuşma sağlayıcı türleri, kayıt defteri, direktif ve normalleştirme yardımcıları | + | `plugin-sdk/realtime-transcription` | Gerçek zamanlı transkripsiyon sağlayıcı türleri ve kayıt defteri yardımcıları | + | `plugin-sdk/realtime-voice` | Gerçek zamanlı ses sağlayıcı türleri ve kayıt defteri yardımcıları | + | `plugin-sdk/image-generation` | Görsel oluşturma sağlayıcı türleri | + | `plugin-sdk/image-generation-core` | Paylaşılan görsel oluşturma türleri, failover, kimlik doğrulama ve kayıt defteri yardımcıları | + | `plugin-sdk/music-generation` | Müzik oluşturma sağlayıcı/istek/sonuç türleri | + | `plugin-sdk/music-generation-core` | Paylaşılan müzik oluşturma türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma | + | `plugin-sdk/video-generation` | Video oluşturma sağlayıcı/istek/sonuç türleri | + | `plugin-sdk/video-generation-core` | Paylaşılan video oluşturma türleri, failover yardımcıları, sağlayıcı arama ve model-ref ayrıştırma | + | `plugin-sdk/webhook-targets` | Webhook hedef kayıt defteri ve rota kurulum yardımcıları | + | `plugin-sdk/webhook-path` | Webhook yol normalleştirme yardımcıları | | `plugin-sdk/web-media` | Paylaşılan uzak/yerel medya yükleme yardımcıları | - | `plugin-sdk/zod` | Plugin SDK kullanıcıları için yeniden dışa aktarılmış `zod` | + | `plugin-sdk/zod` | Plugin SDK tüketicileri için yeniden dışa aktarılan `zod` | | `plugin-sdk/testing` | `installCommonResolveTargetErrorCases`, `shouldAckReaction` | - | Alt yol | Temel dışa aktarımlar | + | Alt yol | Ana dışa aktarımlar | | --- | --- | | `plugin-sdk/memory-core` | Yönetici/yapılandırma/dosya/CLI yardımcıları için paketlenmiş memory-core yardımcı yüzeyi | | `plugin-sdk/memory-core-engine-runtime` | Bellek dizini/arama çalışma zamanı cephesi | - | `plugin-sdk/memory-core-host-engine-foundation` | Bellek ana makine temel motoru dışa aktarımları | - | `plugin-sdk/memory-core-host-engine-embeddings` | Bellek ana makine gömme motoru dışa aktarımları | - | `plugin-sdk/memory-core-host-engine-qmd` | Bellek ana makine QMD motoru dışa aktarımları | - | `plugin-sdk/memory-core-host-engine-storage` | Bellek ana makine depolama motoru dışa aktarımları | - | `plugin-sdk/memory-core-host-multimodal` | Bellek ana makine çok modlu yardımcıları | + | `plugin-sdk/memory-core-host-engine-foundation` | Bellek ana makine foundation engine dışa aktarımları | + | `plugin-sdk/memory-core-host-engine-embeddings` | Bellek ana makine embedding engine dışa aktarımları | + | `plugin-sdk/memory-core-host-engine-qmd` | Bellek ana makine QMD engine dışa aktarımları | + | `plugin-sdk/memory-core-host-engine-storage` | Bellek ana makine storage engine dışa aktarımları | + | `plugin-sdk/memory-core-host-multimodal` | Bellek ana makine multimodal yardımcıları | | `plugin-sdk/memory-core-host-query` | Bellek ana makine sorgu yardımcıları | | `plugin-sdk/memory-core-host-secret` | Bellek ana makine gizli bilgi yardımcıları | + | `plugin-sdk/memory-core-host-events` | Bellek ana makine olay günlüğü yardımcıları | | `plugin-sdk/memory-core-host-status` | Bellek ana makine durum yardımcıları | | `plugin-sdk/memory-core-host-runtime-cli` | Bellek ana makine CLI çalışma zamanı yardımcıları | | `plugin-sdk/memory-core-host-runtime-core` | Bellek ana makine çekirdek çalışma zamanı yardımcıları | | `plugin-sdk/memory-core-host-runtime-files` | Bellek ana makine dosya/çalışma zamanı yardımcıları | + | `plugin-sdk/memory-host-core` | Bellek ana makine çekirdek çalışma zamanı yardımcıları için üreticiden bağımsız takma ad | + | `plugin-sdk/memory-host-events` | Bellek ana makine olay günlüğü yardımcıları için üreticiden bağımsız takma ad | + | `plugin-sdk/memory-host-files` | Bellek ana makine dosya/çalışma zamanı yardımcıları için üreticiden bağımsız takma ad | + | `plugin-sdk/memory-host-markdown` | Belleğe bitişik plugin'ler için paylaşılan yönetilen-markdown yardımcıları | + | `plugin-sdk/memory-host-search` | Arama yöneticisi erişimi için etkin bellek çalışma zamanı cephesi | + | `plugin-sdk/memory-host-status` | Bellek ana makine durum yardımcıları için üreticiden bağımsız takma ad | | `plugin-sdk/memory-lancedb` | Paketlenmiş memory-lancedb yardımcı yüzeyi | - + | Aile | Geçerli alt yollar | Amaçlanan kullanım | | --- | --- | --- | - | Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Paketlenmiş browser eklentisi destek yardımcıları (`browser-support` uyumluluk barrel'i olarak kalır) | + | Tarayıcı | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Paketlenmiş tarayıcı plugin desteği yardımcıları (`browser-support` uyumluluk varili olarak kalır) | | Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Paketlenmiş Matrix yardımcı/çalışma zamanı yüzeyi | | Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Paketlenmiş LINE yardımcı/çalışma zamanı yüzeyi | | IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Paketlenmiş IRC yardımcı yüzeyi | - | Kanala özgü yardımcılar | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Paketlenmiş kanal uyumluluğu/yardımcı yüzeyleri | - | Kimlik doğrulama/eklentiye özgü yardımcılar | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Paketlenmiş özellik/eklenti yardımcı yüzeyleri; `plugin-sdk/github-copilot-token` şu anda `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` ve `resolveCopilotApiToken` dışa aktarımlarını içerir | + | Kanala özgü yardımcılar | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Paketlenmiş kanal uyumluluk/yardımcı yüzeyleri | + | Kimlik doğrulama/plugin'e özgü yardımcılar | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Paketlenmiş özellik/plugin yardımcı yüzeyleri; `plugin-sdk/github-copilot-token` şu anda `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` ve `resolveCopilotApiToken` dışa aktarır | ## Kayıt API'si -`register(api)` geri çağırımı, şu yöntemlere sahip bir `OpenClawPluginApi` nesnesi alır: +`register(api)` geri çağrısı, şu yöntemlere sahip bir `OpenClawPluginApi` +nesnesi alır: ### Yetenek kaydı -| Yöntem | Kaydettiği şey | -| ------------------------------------------------ | ----------------------------- | -| `api.registerProvider(...)` | Metin çıkarımı (LLM) | -| `api.registerChannel(...)` | Mesajlaşma kanalı | +| Yöntem | Kaydettiği şey | +| ------------------------------------------------ | ------------------------------- | +| `api.registerProvider(...)` | Metin çıkarımı (LLM) | +| `api.registerChannel(...)` | Mesajlaşma kanalı | | `api.registerSpeechProvider(...)` | Metinden konuşmaya / STT sentezi | | `api.registerRealtimeTranscriptionProvider(...)` | Akışlı gerçek zamanlı transkripsiyon | | `api.registerRealtimeVoiceProvider(...)` | Çift yönlü gerçek zamanlı ses oturumları | -| `api.registerMediaUnderstandingProvider(...)` | Görsel/ses/video analizi | -| `api.registerImageGenerationProvider(...)` | Görsel üretimi | -| `api.registerMusicGenerationProvider(...)` | Müzik üretimi | -| `api.registerVideoGenerationProvider(...)` | Video üretimi | -| `api.registerWebFetchProvider(...)` | Web fetch / scrape sağlayıcısı | -| `api.registerWebSearchProvider(...)` | Web arama | +| `api.registerMediaUnderstandingProvider(...)` | Görsel/ses/video analizi | +| `api.registerImageGenerationProvider(...)` | Görsel oluşturma | +| `api.registerMusicGenerationProvider(...)` | Müzik oluşturma | +| `api.registerVideoGenerationProvider(...)` | Video oluşturma | +| `api.registerWebFetchProvider(...)` | Web fetch / scrape sağlayıcısı | +| `api.registerWebSearchProvider(...)` | Web arama | ### Araçlar ve komutlar -| Yöntem | Kaydettiği şey | -| ------------------------------- | -------------------------------------------- | +| Yöntem | Kaydettiği şey | +| ------------------------------- | ---------------------------------------------- | | `api.registerTool(tool, opts?)` | Aracı aracı (zorunlu veya `{ optional: true }`) | -| `api.registerCommand(def)` | Özel komut (LLM'yi atlar) | +| `api.registerCommand(def)` | Özel komut (LLM'yi atlar) | ### Altyapı -| Yöntem | Kaydettiği şey | -| ---------------------------------------------- | ---------------------- | -| `api.registerHook(events, handler, opts?)` | Olay kancası | -| `api.registerHttpRoute(params)` | Gateway HTTP uç noktası | -| `api.registerGatewayMethod(name, handler)` | Gateway RPC yöntemi | -| `api.registerCli(registrar, opts?)` | CLI alt komutu | -| `api.registerService(service)` | Arka plan hizmeti | -| `api.registerInteractiveHandler(registration)` | Etkileşimli işleyici | +| Yöntem | Kaydettiği şey | +| ---------------------------------------------- | ----------------------------------- | +| `api.registerHook(events, handler, opts?)` | Olay hook'u | +| `api.registerHttpRoute(params)` | Gateway HTTP uç noktası | +| `api.registerGatewayMethod(name, handler)` | Gateway RPC yöntemi | +| `api.registerCli(registrar, opts?)` | CLI alt komutu | +| `api.registerService(service)` | Arka plan hizmeti | +| `api.registerInteractiveHandler(registration)` | Etkileşimli işleyici | +| `api.registerMemoryPromptSupplement(builder)` | Eklemeli belleğe bitişik istem bölümü | +| `api.registerMemoryCorpusSupplement(adapter)` | Eklemeli bellek arama/okuma derlemi | Ayrılmış çekirdek yönetici ad alanları (`config.*`, `exec.approvals.*`, `wizard.*`, -`update.*`) bir eklenti daha dar bir gateway yöntem kapsamı atamaya çalışsa bile her zaman -`operator.admin` olarak kalır. Eklentiye ait yöntemler için -eklentiye özgü önekleri tercih edin. +`update.*`), bir plugin daha dar bir gateway yöntem kapsamı atamaya çalışsa bile +her zaman `operator.admin` olarak kalır. Plugin sahipli yöntemler için +plugin'e özgü önekleri tercih edin. -### CLI kayıt meta verisi +### CLI kayıt meta verileri `api.registerCli(registrar, opts?)`, iki tür üst düzey meta veri kabul eder: -- `commands`: kayıtçının sahip olduğu açık komut kökleri -- `descriptors`: kök CLI yardımı, yönlendirme ve tembel eklenti CLI kaydı için - ayrıştırma zamanındaki komut tanımlayıcıları +- `commands`: kayıt görevlisinin sahip olduğu açık komut kökleri +- `descriptors`: kök CLI yardımı, + yönlendirme ve tembel plugin CLI kaydı için ayrıştırma zamanlı komut tanımlayıcıları -Bir eklenti komutunun normal kök CLI yolunda tembel yüklemeli kalmasını istiyorsanız, -o kayıtçının açığa çıkardığı her üst düzey komut kökünü kapsayan `descriptors` +Bir plugin komutunun normal kök CLI yolunda tembel yüklenmiş kalmasını istiyorsanız, +bu kayıt görevlisinin açtığı her üst düzey komut kökünü kapsayan `descriptors` sağlayın. ```typescript @@ -345,7 +359,7 @@ api.registerCli( descriptors: [ { name: "matrix", - description: "Matrix hesaplarını, doğrulamayı, cihazları ve profil durumunu yönetin", + description: "Matrix hesaplarını, doğrulamayı, cihazları ve profil durumunu yönet", hasSubcommands: true, }, ], @@ -353,109 +367,110 @@ api.registerCli( ); ``` -`commands` tek başına yalnızca normal kök CLI'de tembel kayıt gerekmediğinde kullanılmalıdır. -Bu hevesli uyumluluk yolu desteklenmeye devam eder, ancak ayrıştırma zamanında tembel yükleme için -tanımlayıcı destekli yer tutucular kurmaz. +Yalnızca `commands` kullanımını, tembel kök CLI kaydına ihtiyaç duymadığınızda +tercih edin. Bu hevesli uyumluluk yolu desteklenmeye devam eder, ancak ayrıştırma zamanı +tembel yükleme için tanımlayıcı destekli yer tutucular kurmaz. -### Özel yuvalar +### Ayrıcalıklı yuvalar -| Yöntem | Kaydettiği şey | -| ------------------------------------------ | ------------------------------------- | -| `api.registerContextEngine(id, factory)` | Bağlam motoru (aynı anda bir etkin) | -| `api.registerMemoryPromptSection(builder)` | Bellek prompt bölümü oluşturucusu | -| `api.registerMemoryFlushPlan(resolver)` | Bellek temizleme planı çözücüsü | -| `api.registerMemoryRuntime(runtime)` | Bellek çalışma zamanı bağdaştırıcısı | +| Yöntem | Kaydettiği şey | +| ------------------------------------------ | --------------------------------- | +| `api.registerContextEngine(id, factory)` | Bağlam motoru (aynı anda bir etkin) | +| `api.registerMemoryPromptSection(builder)` | Bellek istem bölümü oluşturucusu | +| `api.registerMemoryFlushPlan(resolver)` | Bellek temizleme planı çözümleyicisi | +| `api.registerMemoryRuntime(runtime)` | Bellek çalışma zamanı bağdaştırıcısı | ### Bellek gömme bağdaştırıcıları -| Yöntem | Kaydettiği şey | -| ---------------------------------------------- | ----------------------------------------------- | -| `api.registerMemoryEmbeddingProvider(adapter)` | Etkin eklenti için bellek gömme bağdaştırıcısı | +| Yöntem | Kaydettiği şey | +| ---------------------------------------------- | ---------------------------------------------- | +| `api.registerMemoryEmbeddingProvider(adapter)` | Etkin plugin için bellek gömme bağdaştırıcısı | - `registerMemoryPromptSection`, `registerMemoryFlushPlan` ve - `registerMemoryRuntime`, bellek eklentilerine özeldir. -- `registerMemoryEmbeddingProvider`, etkin bellek eklentisinin bir - veya daha fazla gömme bağdaştırıcısı kimliği kaydetmesine izin verir (örneğin `openai`, `gemini` veya - eklenti tanımlı özel bir kimlik). + `registerMemoryRuntime`, bellek plugin'lerine özeldir. +- `registerMemoryEmbeddingProvider`, etkin bellek plugin'inin bir + veya daha fazla gömme bağdaştırıcısı kimliği kaydetmesini sağlar + (örneğin `openai`, `gemini` veya plugin tarafından tanımlanan özel bir kimlik). - `agents.defaults.memorySearch.provider` ve - `agents.defaults.memorySearch.fallback` gibi kullanıcı yapılandırmaları, - kaydedilmiş bu bağdaştırıcı kimliklerine göre çözülür. + `agents.defaults.memorySearch.fallback` gibi kullanıcı yapılandırmaları + bu kayıtlı bağdaştırıcı kimliklerine göre çözülür. ### Olaylar ve yaşam döngüsü -| Yöntem | Ne yaptığı | -| -------------------------------------------- | ---------------------------- | -| `api.on(hookName, handler, opts?)` | Türlendirilmiş yaşam döngüsü kancası | -| `api.onConversationBindingResolved(handler)` | Konuşma bağlama geri çağırımı | +| Yöntem | Ne yapar | +| -------------------------------------------- | ----------------------------- | +| `api.on(hookName, handler, opts?)` | Türlendirilmiş yaşam döngüsü hook'u | +| `api.onConversationBindingResolved(handler)` | Konuşma bağlama geri çağrısı | -### Kanca karar anlambilimi +### Hook karar anlamları -- `before_tool_call`: `{ block: true }` döndürmek sonlandırıcıdır. Herhangi bir işleyici bunu ayarladığında daha düşük öncelikli işleyiciler atlanır. -- `before_tool_call`: `{ block: false }` döndürmek karar verilmemiş sayılır (`block` değerini hiç vermemekle aynıdır), geçersiz kılma sayılmaz. -- `before_install`: `{ block: true }` döndürmek sonlandırıcıdır. Herhangi bir işleyici bunu ayarladığında daha düşük öncelikli işleyiciler atlanır. -- `before_install`: `{ block: false }` döndürmek karar verilmemiş sayılır (`block` değerini hiç vermemekle aynıdır), geçersiz kılma sayılmaz. -- `reply_dispatch`: `{ handled: true, ... }` döndürmek sonlandırıcıdır. Herhangi bir işleyici dağıtımı üstlendiğinde daha düşük öncelikli işleyiciler ve varsayılan model dağıtım yolu atlanır. -- `message_sending`: `{ cancel: true }` döndürmek sonlandırıcıdır. Herhangi bir işleyici bunu ayarladığında daha düşük öncelikli işleyiciler atlanır. -- `message_sending`: `{ cancel: false }` döndürmek karar verilmemiş sayılır (`cancel` değerini hiç vermemekle aynıdır), geçersiz kılma sayılmaz. +- `before_tool_call`: `{ block: true }` döndürmek kesindir. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır. +- `before_tool_call`: `{ block: false }` döndürmek karar yok olarak değerlendirilir (`block` alanını hiç vermemekle aynıdır), geçersiz kılma olarak değil. +- `before_install`: `{ block: true }` döndürmek kesindir. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır. +- `before_install`: `{ block: false }` döndürmek karar yok olarak değerlendirilir (`block` alanını hiç vermemekle aynıdır), geçersiz kılma olarak değil. +- `reply_dispatch`: `{ handled: true, ... }` döndürmek kesindir. Herhangi bir işleyici dağıtımı üstlendiğinde, daha düşük öncelikli işleyiciler ve varsayılan model dağıtım yolu atlanır. +- `message_sending`: `{ cancel: true }` döndürmek kesindir. Herhangi bir işleyici bunu ayarladığında, daha düşük öncelikli işleyiciler atlanır. +- `message_sending`: `{ cancel: false }` döndürmek karar yok olarak değerlendirilir (`cancel` alanını hiç vermemekle aynıdır), geçersiz kılma olarak değil. -### API nesnesi alanları +### API nesne alanları -| Alan | Tür | Açıklama | -| ----------------------- | ------------------------- | ---------------------------------------------------------------------------------------------- | -| `api.id` | `string` | Eklenti kimliği | -| `api.name` | `string` | Görünen ad | -| `api.version` | `string?` | Eklenti sürümü (isteğe bağlı) | -| `api.description` | `string?` | Eklenti açıklaması (isteğe bağlı) | -| `api.source` | `string` | Eklenti kaynak yolu | -| `api.rootDir` | `string?` | Eklenti kök dizini (isteğe bağlı) | -| `api.config` | `OpenClawConfig` | Geçerli yapılandırma anlık görüntüsü (varsa etkin bellek içi çalışma zamanı anlık görüntüsü) | -| `api.pluginConfig` | `Record` | `plugins.entries..config` içinden eklentiye özgü yapılandırma | -| `api.runtime` | `PluginRuntime` | [Çalışma zamanı yardımcıları](/tr/plugins/sdk-runtime) | -| `api.logger` | `PluginLogger` | Kapsamlı günlükleyici (`debug`, `info`, `warn`, `error`) | -| `api.registrationMode` | `PluginRegistrationMode` | Geçerli yükleme kipi; `"setup-runtime"` hafif, tam giriş öncesi başlangıç/kurulum penceresidir | -| `api.resolvePath(input)` | `(string) => string` | Yolu eklenti köküne göre çözümle | +| Alan | Tür | Açıklama | +| ----------------------- | ------------------------- | ------------------------------------------------------------------------------------------ | +| `api.id` | `string` | Plugin kimliği | +| `api.name` | `string` | Görünen ad | +| `api.version` | `string?` | Plugin sürümü (isteğe bağlı) | +| `api.description` | `string?` | Plugin açıklaması (isteğe bağlı) | +| `api.source` | `string` | Plugin kaynak yolu | +| `api.rootDir` | `string?` | Plugin kök dizini (isteğe bağlı) | +| `api.config` | `OpenClawConfig` | Geçerli yapılandırma anlık görüntüsü (mevcut olduğunda etkin bellek içi çalışma zamanı anlık görüntüsü) | +| `api.pluginConfig` | `Record` | `plugins.entries..config` içindeki plugin'e özgü yapılandırma | +| `api.runtime` | `PluginRuntime` | [Çalışma zamanı yardımcıları](/tr/plugins/sdk-runtime) | +| `api.logger` | `PluginLogger` | Kapsamlı logger (`debug`, `info`, `warn`, `error`) | +| `api.registrationMode` | `PluginRegistrationMode` | Geçerli yükleme modu; `"setup-runtime"` tam giriş öncesi hafif başlatma/kurulum penceresidir | +| `api.resolvePath(input)` | `(string) => string` | Yolu plugin köküne göre çözümleme | ## Dahili modül kuralı -Eklentiniz içinde dahili içe aktarımlar için yerel barrel dosyaları kullanın: +Plugin'iniz içinde, dahili içe aktarmalar için yerel varil dosyaları kullanın: ``` my-plugin/ - api.ts # Harici tüketiciler için genel dışa aktarımlar + api.ts # Dış tüketiciler için herkese açık dışa aktarımlar runtime-api.ts # Yalnızca dahili çalışma zamanı dışa aktarımları - index.ts # Eklenti giriş noktası + index.ts # Plugin giriş noktası setup-entry.ts # Yalnızca kurulum için hafif giriş (isteğe bağlı) ``` - Kendi eklentinizi üretim kodunda asla `openclaw/plugin-sdk/` - üzerinden içe aktarmayın. Dahili içe aktarımları `./api.ts` veya - `./runtime-api.ts` üzerinden yönlendirin. SDK yolu yalnızca harici sözleşmedir. + Üretim kodunda kendi plugin'inizi `openclaw/plugin-sdk/` + üzerinden asla içe aktarmayın. Dahili içe aktarmaları `./api.ts` veya + `./runtime-api.ts` üzerinden yönlendirin. SDK yolu yalnızca dış sözleşmedir. -Cephe üzerinden yüklenen paketlenmiş eklenti genel yüzeyleri (`api.ts`, `runtime-api.ts`, -`index.ts`, `setup-entry.ts` ve benzeri genel giriş dosyaları), OpenClaw zaten çalışıyorsa artık -etkin çalışma zamanı yapılandırma anlık görüntüsünü tercih eder. Henüz çalışma zamanı anlık görüntüsü yoksa, -diskteki çözülmüş yapılandırma dosyasına geri dönerler. +Cephe üzerinden yüklenen paketlenmiş plugin herkese açık yüzeyleri (`api.ts`, `runtime-api.ts`, +`index.ts`, `setup-entry.ts` ve benzer herkese açık giriş dosyaları), OpenClaw zaten çalışıyorsa +artık etkin çalışma zamanı yapılandırma anlık görüntüsünü tercih eder. Henüz çalışma zamanı +anlık görüntüsü yoksa, diskteki çözümlenmiş yapılandırma dosyasına geri dönerler. -Sağlayıcı eklentileri ayrıca, bir yardımcı kasıtlı olarak sağlayıcıya özgüyse ve henüz -genel bir SDK alt yoluna ait değilse dar bir eklenti yerel sözleşme barrel'i de sunabilir. -Mevcut paketlenmiş örnek: Anthropic sağlayıcısı, Anthropic beta-header ve `service_tier` mantığını genel bir -`plugin-sdk/*` sözleşmesine yükseltmek yerine Claude akış yardımcılarını kendi genel -`api.ts` / `contract-api.ts` yüzeyinde tutar. +Sağlayıcı plugin'leri ayrıca, bir yardımcı bilinçli olarak sağlayıcıya özgüyse ve henüz +genel bir SDK alt yoluna ait değilse dar bir plugin-yerel sözleşme varili de sunabilir. +Güncel paketlenmiş örnek: Anthropic sağlayıcısı, Anthropic beta-header ve `service_tier` +mantığını genel bir `plugin-sdk/*` sözleşmesine taşımak yerine, Claude akış yardımcılarını +kendi herkese açık `api.ts` / `contract-api.ts` yüzeyinde tutar. -Diğer mevcut paketlenmiş örnekler: +Diğer güncel paketlenmiş örnekler: - `@openclaw/openai-provider`: `api.ts`, sağlayıcı oluşturucuları, - varsayılan model yardımcıları ve gerçek zamanlı sağlayıcı oluşturucuları dışa aktarır -- `@openclaw/openrouter-provider`: `api.ts`, sağlayıcı oluşturucusuna ek olarak - başlangıç/yapılandırma yardımcılarını dışa aktarır + varsayılan model yardımcılarını ve gerçek zamanlı sağlayıcı oluşturucularını dışa aktarır +- `@openclaw/openrouter-provider`: `api.ts`, sağlayıcı oluşturucusunu ve + ilk katılım/yapılandırma yardımcılarını dışa aktarır - Uzantı üretim kodu ayrıca `openclaw/plugin-sdk/` - içe aktarımlarından da kaçınmalıdır. Bir yardımcı gerçekten paylaşılıyorsa, iki eklentiyi birbirine bağlamak yerine - bunu `openclaw/plugin-sdk/speech`, `.../provider-model-shared` veya başka - bir yetenek odaklı yüzey gibi tarafsız bir SDK alt yoluna yükseltin. + Extension üretim kodu ayrıca `openclaw/plugin-sdk/` + içe aktarımlarından da kaçınmalıdır. Bir yardımcı gerçekten paylaşılıyorsa, + iki plugin'i birbirine bağlamak yerine bunu `openclaw/plugin-sdk/speech`, + `.../provider-model-shared` veya başka bir yetenek odaklı yüzey gibi + tarafsız bir SDK alt yoluna taşıyın. ## İlgili diff --git a/docs/tr/tools/image-generation.md b/docs/tr/tools/image-generation.md index a60693fdf..e348ac689 100644 --- a/docs/tr/tools/image-generation.md +++ b/docs/tr/tools/image-generation.md @@ -1,25 +1,25 @@ --- read_when: - - Aracı üzerinden görsel üretme - - Görsel üretimi sağlayıcılarını ve modellerini yapılandırma - - '`image_generate` aracı parametrelerini anlama' -summary: Yapılandırılmış sağlayıcıları kullanarak görseller oluşturun ve düzenleyin (OpenAI, Google Gemini, fal, MiniMax, ComfyUI, Vydra) -title: Görsel Üretimi + - Aracı üzerinden görsel oluşturma + - Görsel oluşturma sağlayıcılarını ve modellerini yapılandırma + - '`image_generate` aracının parametrelerini anlama' +summary: Yapılandırılmış sağlayıcıları (OpenAI, Google Gemini, fal, MiniMax, ComfyUI, Vydra) kullanarak görseller oluşturun ve düzenleyin +title: Görsel Oluşturma x-i18n: - generated_at: "2026-04-06T03:13:22Z" + generated_at: "2026-04-06T08:49:06Z" model: gpt-5.4 provider: openai - source_hash: dde416dd1441a06605db85b5813cf61ccfc525813d6db430b7b7dfa53d6a3134 + source_hash: 903cc522c283a8da2cbd449ae3e25f349a74d00ecfdaf0f323fd8aa3f2107aea source_path: tools/image-generation.md workflow: 15 --- -# Görsel Üretimi +# Görsel Oluşturma -`image_generate` aracı, aracının yapılandırılmış sağlayıcılarınızı kullanarak görseller oluşturmasına ve düzenlemesine olanak tanır. Oluşturulan görseller, aracının yanıtında otomatik olarak medya ekleri olarak teslim edilir. +`image_generate` aracı, aracının yapılandırdığınız sağlayıcıları kullanarak görseller oluşturmasına ve düzenlemesine olanak tanır. Oluşturulan görseller, aracının yanıtında medya eki olarak otomatik şekilde teslim edilir. -Araç yalnızca en az bir görsel üretimi sağlayıcısı mevcut olduğunda görünür. Aracınızın araçlarında `image_generate` görmüyorsanız `agents.defaults.imageGenerationModel` yapılandırın veya bir sağlayıcı API anahtarı ayarlayın. +Araç yalnızca en az bir görsel oluşturma sağlayıcısı kullanılabilir olduğunda görünür. Aracınızın araçlarında `image_generate` seçeneğini görmüyorsanız, `agents.defaults.imageGenerationModel` yapılandırın veya bir sağlayıcı API anahtarı ayarlayın. ## Hızlı başlangıç @@ -39,22 +39,22 @@ Araç yalnızca en az bir görsel üretimi sağlayıcısı mevcut olduğunda gö } ``` -3. Aracıya şunu sorun: _"Dost canlısı bir ıstakoz maskotunun görselini oluştur."_ +3. Aracıya şunu söyleyin: _"Dost canlısı bir ıstakoz maskotunun görselini oluştur."_ -Aracı `image_generate` aracını otomatik olarak çağırır. Araç izin listesine eklemeye gerek yoktur — bir sağlayıcı mevcut olduğunda varsayılan olarak etkindir. +Aracı `image_generate` aracını otomatik olarak çağırır. Araç izin listesine ekleme gerekmez — bir sağlayıcı kullanılabilir olduğunda varsayılan olarak etkindir. ## Desteklenen sağlayıcılar -| Sağlayıcı | Varsayılan model | Düzenleme desteği | API anahtarı | -| --------- | ------------------------------ | ---------------------------------- | ----------------------------------------------------- | -| OpenAI | `gpt-image-1` | Evet (en fazla 5 görsel) | `OPENAI_API_KEY` | -| Google | `gemini-3.1-flash-image-preview` | Evet | `GEMINI_API_KEY` veya `GOOGLE_API_KEY` | -| fal | `fal-ai/flux/dev` | Evet | `FAL_KEY` | -| MiniMax | `image-01` | Evet (özne referansı) | `MINIMAX_API_KEY` veya MiniMax OAuth (`minimax-portal`) | -| ComfyUI | `workflow` | Evet (1 görsel, iş akışı yapılandırmalı) | Bulut için `COMFY_API_KEY` veya `COMFY_CLOUD_API_KEY` | -| Vydra | `grok-imagine` | Hayır | `VYDRA_API_KEY` | +| Sağlayıcı | Varsayılan model | Düzenleme desteği | API anahtarı | +| --------- | ------------------------------- | ----------------------------------- | ----------------------------------------------------- | +| OpenAI | `gpt-image-1` | Evet (en fazla 5 görsel) | `OPENAI_API_KEY` | +| Google | `gemini-3.1-flash-image-preview` | Evet | `GEMINI_API_KEY` veya `GOOGLE_API_KEY` | +| fal | `fal-ai/flux/dev` | Evet | `FAL_KEY` | +| MiniMax | `image-01` | Evet (özne referansı) | `MINIMAX_API_KEY` veya MiniMax OAuth (`minimax-portal`) | +| ComfyUI | `workflow` | Evet (1 görsel, iş akışı yapılandırmalı) | bulut için `COMFY_API_KEY` veya `COMFY_CLOUD_API_KEY` | +| Vydra | `grok-imagine` | Hayır | `VYDRA_API_KEY` | -Çalışma zamanında mevcut sağlayıcıları ve modelleri incelemek için `action: "list"` kullanın: +Çalışma zamanında kullanılabilir sağlayıcıları ve modelleri incelemek için `action: "list"` kullanın: ``` /tool image_generate action=list @@ -62,20 +62,20 @@ Aracı `image_generate` aracını otomatik olarak çağırır. Araç izin listes ## Araç parametreleri -| Parametre | Tür | Açıklama | -| ------------ | -------- | ----------------------------------------------------------------------------------- | -| `prompt` | string | Görsel üretimi promptu (`action: "generate"` için gereklidir) | +| Parametre | Tür | Açıklama | +| ------------ | -------- | ------------------------------------------------------------------------------------ | +| `prompt` | string | Görsel oluşturma istemi (`action: "generate"` için zorunlu) | | `action` | string | Sağlayıcıları incelemek için `"generate"` (varsayılan) veya `"list"` | -| `model` | string | Sağlayıcı/model geçersiz kılması, örn. `openai/gpt-image-1` | -| `image` | string | Düzenleme kipi için tek referans görsel yolu veya URL'si | -| `images` | string[] | Düzenleme kipi için birden çok referans görsel (en fazla 5) | -| `size` | string | Boyut ipucu: `1024x1024`, `1536x1024`, `1024x1536`, `1024x1792`, `1792x1024` | -| `aspectRatio` | string | En-boy oranı: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` | -| `resolution` | string | Çözünürlük ipucu: `1K`, `2K` veya `4K` | -| `count` | number | Oluşturulacak görsel sayısı (1–4) | -| `filename` | string | Çıktı dosya adı ipucu | +| `model` | string | Sağlayıcı/model geçersiz kılması, ör. `openai/gpt-image-1` | +| `image` | string | Düzenleme modu için tek referans görsel yolu veya URL’si | +| `images` | string[] | Düzenleme modu için birden fazla referans görsel (en fazla 5) | +| `size` | string | Boyut ipucu: `1024x1024`, `1536x1024`, `1024x1536`, `1024x1792`, `1792x1024` | +| `aspectRatio`| string | En-boy oranı: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` | +| `resolution` | string | Çözünürlük ipucu: `1K`, `2K` veya `4K` | +| `count` | number | Oluşturulacak görsel sayısı (1–4) | +| `filename` | string | Çıktı dosya adı ipucu | -Tüm sağlayıcılar tüm parametreleri desteklemez. Araç, her sağlayıcının desteklediğini geçirir, geri kalanını yok sayar ve düşürülen geçersiz kılmaları araç sonucunda bildirir. +Tüm sağlayıcılar tüm parametreleri desteklemez. Araç, her sağlayıcının desteklediği parametreleri iletir, kalanları yok sayar ve bırakılan geçersiz kılmaları araç sonucunda bildirir. ## Yapılandırma @@ -96,57 +96,55 @@ Tüm sağlayıcılar tüm parametreleri desteklemez. Araç, her sağlayıcının ### Sağlayıcı seçim sırası -Bir görsel oluşturulurken OpenClaw, sağlayıcıları şu sırayla dener: +Bir görsel oluşturulurken OpenClaw sağlayıcıları şu sırayla dener: -1. Araç çağrısından gelen **`model` parametresi** (aracı bir model belirtirse) -2. Yapılandırmadan gelen **`imageGenerationModel.primary`** +1. Araç çağrısındaki **`model` parametresi** (aracı bir model belirtirse) +2. Yapılandırmadaki **`imageGenerationModel.primary`** 3. Sırayla **`imageGenerationModel.fallbacks`** 4. **Otomatik algılama** — yalnızca kimlik doğrulama destekli sağlayıcı varsayılanlarını kullanır: - - önce geçerli varsayılan sağlayıcı - - ardından sağlayıcı kimliği sırasına göre kalan kayıtlı görsel üretimi sağlayıcıları + - önce mevcut varsayılan sağlayıcı + - ardından sağlayıcı kimliği sırasına göre kalan kayıtlı görsel oluşturma sağlayıcıları -Bir sağlayıcı başarısız olursa (kimlik doğrulama hatası, hız sınırı vb.), bir sonraki aday otomatik olarak denenir. Hepsi başarısız olursa hata her denemedeki ayrıntıları içerir. +Bir sağlayıcı başarısız olursa (kimlik doğrulama hatası, hız sınırı vb.), bir sonraki aday otomatik olarak denenir. Hepsi başarısız olursa, hata her denemeden ayrıntılar içerir. Notlar: -- Otomatik algılama kimlik doğrulama farkındadır. Bir sağlayıcı varsayılanı, yalnızca - OpenClaw bu sağlayıcı için gerçekten kimlik doğrulaması yapabiliyorsa aday listesine girer. -- Şu anda kayıtlı sağlayıcıları, bunların - varsayılan modellerini ve kimlik doğrulama ortam değişkeni ipuçlarını incelemek için `action: "list"` kullanın. +- Otomatik algılama kimlik doğrulama farkındadır. Bir sağlayıcı varsayılanı yalnızca OpenClaw o sağlayıcıda gerçekten kimlik doğrulaması yapabildiğinde aday listesine girer. +- Geçerli olarak kayıtlı sağlayıcıları, varsayılan modellerini ve kimlik doğrulama ortam değişkeni ipuçlarını incelemek için `action: "list"` kullanın. ### Görsel düzenleme -OpenAI, Google, fal, MiniMax ve ComfyUI referans görsellerin düzenlenmesini destekler. Bir referans görsel yolu veya URL'si geçin: +OpenAI, Google, fal, MiniMax ve ComfyUI referans görselleri düzenlemeyi destekler. Bir referans görsel yolu veya URL’si geçin: ``` -"Bu fotoğrafın suluboya sürümünü oluştur" + image: "/path/to/photo.jpg" +"Bu fotoğrafın sulu boya sürümünü oluştur" + image: "/path/to/photo.jpg" ``` -OpenAI ve Google, `images` parametresi aracılığıyla en fazla 5 referans görseli destekler. fal, MiniMax ve ComfyUI 1 görsel destekler. +OpenAI ve Google, `images` parametresiyle en fazla 5 referans görseli destekler. fal, MiniMax ve ComfyUI 1 görsel destekler. -MiniMax görsel üretimi, her iki paketlenmiş MiniMax kimlik doğrulama yolu üzerinden kullanılabilir: +MiniMax görsel oluşturma, paketlenmiş iki MiniMax kimlik doğrulama yolu üzerinden de kullanılabilir: -- API anahtarlı kurulumlar için `minimax/image-01` +- API anahtarı kurulumları için `minimax/image-01` - OAuth kurulumları için `minimax-portal/image-01` ## Sağlayıcı yetenekleri -| Yetenek | OpenAI | Google | fal | MiniMax | ComfyUI | Vydra | -| --------------------- | ------------------- | -------------------- | -------------------- | -------------------------- | ---------------------------------- | ----- | -| Üretme | Evet (en fazla 4) | Evet (en fazla 4) | Evet (en fazla 4) | Evet (en fazla 9) | Evet (iş akışı tanımlı çıktılar) | Evet (1) | -| Düzenleme/referans | Evet (en fazla 5 görsel) | Evet (en fazla 5 görsel) | Evet (1 görsel) | Evet (1 görsel, özne ref) | Evet (1 görsel, iş akışı yapılandırmalı) | Hayır | -| Boyut denetimi | Evet | Evet | Evet | Hayır | Hayır | Hayır | -| En-boy oranı | Hayır | Evet | Evet (yalnızca üretme) | Evet | Hayır | Hayır | -| Çözünürlük (1K/2K/4K) | Hayır | Evet | Evet | Hayır | Hayır | Hayır | +| Yetenek | OpenAI | Google | fal | MiniMax | ComfyUI | Vydra | +| --------------------- | -------------------- | -------------------- | ------------------- | -------------------------- | ---------------------------------- | -------- | +| Oluşturma | Evet (en fazla 4) | Evet (en fazla 4) | Evet (en fazla 4) | Evet (en fazla 9) | Evet (iş akışı tanımlı çıktılar) | Evet (1) | +| Düzenleme/referans | Evet (en fazla 5 görsel) | Evet (en fazla 5 görsel) | Evet (1 görsel) | Evet (1 görsel, özne referansı) | Evet (1 görsel, iş akışı yapılandırmalı) | Hayır | +| Boyut denetimi | Evet | Evet | Evet | Hayır | Hayır | Hayır | +| En-boy oranı | Hayır | Evet | Evet (yalnızca oluşturma) | Evet | Hayır | Hayır | +| Çözünürlük (1K/2K/4K) | Hayır | Evet | Evet | Hayır | Hayır | Hayır | ## İlgili -- [Araçlara Genel Bakış](/tr/tools) — mevcut tüm aracı araçları -- [fal](/providers/fal) — fal görsel ve video sağlayıcısı kurulumu -- [ComfyUI](/providers/comfy) — yerel ComfyUI ve Comfy Cloud iş akışı kurulumu +- [Araçlara Genel Bakış](/tr/tools) — kullanılabilir tüm aracı araçları +- [fal](/tr/providers/fal) — fal görsel ve video sağlayıcısı kurulumu +- [ComfyUI](/tr/providers/comfy) — yerel ComfyUI ve Comfy Cloud iş akışı kurulumu - [Google (Gemini)](/tr/providers/google) — Gemini görsel sağlayıcısı kurulumu - [MiniMax](/tr/providers/minimax) — MiniMax görsel sağlayıcısı kurulumu - [OpenAI](/tr/providers/openai) — OpenAI Images sağlayıcısı kurulumu -- [Vydra](/providers/vydra) — Vydra görsel, video ve konuşma kurulumu +- [Vydra](/tr/providers/vydra) — Vydra görsel, video ve konuşma kurulumu - [Yapılandırma Başvurusu](/tr/gateway/configuration-reference#agent-defaults) — `imageGenerationModel` yapılandırması -- [Models](/tr/concepts/models) — model yapılandırması ve geri dönüş +- [Modeller](/tr/concepts/models) — model yapılandırması ve yük devretme diff --git a/docs/tr/tools/video-generation.md b/docs/tr/tools/video-generation.md index 2065cc976..ce9c93951 100644 --- a/docs/tr/tools/video-generation.md +++ b/docs/tr/tools/video-generation.md @@ -1,25 +1,25 @@ --- read_when: - - Ajan aracılığıyla video üretiyorsunuz - - Video üretim sağlayıcılarını ve modellerini yapılandırıyorsunuz - - video_generate araç parametrelerini anlamanız gerekiyor -summary: 12 sağlayıcı arka ucu kullanarak metinden, görsellerden veya mevcut videolardan video oluşturun -title: Video Üretimi + - Aracı üzerinden video oluştururken + - Video oluşturma sağlayıcılarını ve modellerini yapılandırırken + - '`video_generate` araç parametrelerini anlamak için' +summary: 12 sağlayıcı arka ucunu kullanarak metinden, görsellerden veya mevcut videolardan video oluşturun +title: Video Oluşturma x-i18n: - generated_at: "2026-04-06T03:14:20Z" + generated_at: "2026-04-06T08:49:21Z" model: gpt-5.4 provider: openai - source_hash: 4afec87368232221db1aa5a3980254093d6a961b17271b2dcbf724e6bd455b16 + source_hash: 90d8a392b35adbd899232b02c55c10895b9d7ffc9858d6ca448f2e4e4a57f12f source_path: tools/video-generation.md workflow: 15 --- -# Video Üretimi +# Video Oluşturma -OpenClaw ajanları metin prompt'larından, referans görsellerden veya mevcut videolardan video üretebilir. On iki sağlayıcı arka ucu desteklenir; her biri farklı model seçenekleri, girdi modları ve özellik kümeleri sunar. Ajan, yapılandırmanıza ve kullanılabilir API anahtarlarına göre doğru sağlayıcıyı otomatik olarak seçer. +OpenClaw aracıları metin istemlerinden, referans görsellerden veya mevcut videolardan video oluşturabilir. On iki sağlayıcı arka ucu desteklenir; her birinin farklı model seçenekleri, giriş modları ve özellik setleri vardır. Aracı, yapılandırmanıza ve kullanılabilir API anahtarlarına göre doğru sağlayıcıyı otomatik olarak seçer. -`video_generate` aracı yalnızca en az bir video üretim sağlayıcısı mevcut olduğunda görünür. Ajan araçlarınızda bunu görmüyorsanız bir sağlayıcı API anahtarı ayarlayın veya `agents.defaults.videoGenerationModel` yapılandırın. +`video_generate` aracı yalnızca en az bir video oluşturma sağlayıcısı kullanılabilir olduğunda görünür. Aracı araçlarınızda görmüyorsanız bir sağlayıcı API anahtarı ayarlayın veya `agents.defaults.videoGenerationModel` yapılandırın. ## Hızlı başlangıç @@ -30,47 +30,47 @@ OpenClaw ajanları metin prompt'larından, referans görsellerden veya mevcut vi export GEMINI_API_KEY="your-key" ``` -2. İsteğe bağlı olarak varsayılan bir modeli sabitleyin: +2. İsteğe bağlı olarak bir varsayılan model sabitleyin: ```bash openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1-fast-generate-preview" ``` -3. Ajana sorun: +3. Aracıya sorun: > Gün batımında sörf yapan dost canlısı bir ıstakozun 5 saniyelik sinematik bir videosunu oluştur. -Ajan `video_generate` aracını otomatik olarak çağırır. Araç allowlist yapılandırması gerekmez. +Aracı `video_generate` aracını otomatik olarak çağırır. Araç izin listesi gerekmez. -## Video oluşturduğunuzda ne olur +## Bir video oluşturduğunuzda ne olur -Video üretimi eşzamansızdır. Ajan bir oturumda `video_generate` çağırdığında: +Video oluşturma eşzamansızdır. Aracı bir oturumda `video_generate` çağırdığında: 1. OpenClaw isteği sağlayıcıya gönderir ve hemen bir görev kimliği döndürür. -2. Sağlayıcı işi arka planda işler (genellikle sağlayıcıya ve çözünürlüğe bağlı olarak 30 saniye ile 5 dakika arası). -3. Video hazır olduğunda OpenClaw aynı oturumu dahili bir tamamlama olayıyla uyandırır. -4. Ajan tamamlanan videoyu özgün konuşmaya geri gönderir. +2. Sağlayıcı işi arka planda işler (genellikle sağlayıcıya ve çözünürlüğe bağlı olarak 30 saniye ile 5 dakika arasında). +3. Video hazır olduğunda OpenClaw aynı oturumu dahili bir tamamlanma olayıyla uyandırır. +4. Aracı tamamlanan videoyu özgün konuşmaya geri gönderir. -Bir iş sürerken, aynı oturumdaki yinelenen `video_generate` çağrıları yeni bir üretim başlatmak yerine mevcut görev durumunu döndürür. İlerlemeyi CLI'dan kontrol etmek için `openclaw tasks list` veya `openclaw tasks show ` kullanın. +Bir iş devam ederken, aynı oturumdaki yinelenen `video_generate` çağrıları başka bir oluşturma başlatmak yerine mevcut görev durumunu döndürür. İlerlemeyi CLI üzerinden kontrol etmek için `openclaw tasks list` veya `openclaw tasks show ` kullanın. -Oturum destekli ajan çalıştırmalarının dışında (örneğin doğrudan araç çağrıları), araç satır içi üretime geri döner ve son medya yolunu aynı turda döndürür. +Oturum destekli aracı çalıştırmaları dışında (örneğin doğrudan araç çağrıları), araç satır içi oluşturmaya geri döner ve son medya yolunu aynı turda döndürür. ## Desteklenen sağlayıcılar -| Sağlayıcı | Varsayılan model | Metin | Görsel ref | Video ref | API anahtarı | -| --------- | ------------------------------- | ----- | ---------------- | ---------------- | ---------------------------------------- | -| Alibaba | `wan2.6-t2v` | Evet | Evet (uzak URL) | Evet (uzak URL) | `MODELSTUDIO_API_KEY` | -| BytePlus | `seedance-1-0-lite-t2v-250428` | Evet | 1 görsel | Hayır | `BYTEPLUS_API_KEY` | -| ComfyUI | `workflow` | Evet | 1 görsel | Hayır | `COMFY_API_KEY` veya `COMFY_CLOUD_API_KEY` | -| fal | `fal-ai/minimax/video-01-live` | Evet | 1 görsel | Hayır | `FAL_KEY` | -| Google | `veo-3.1-fast-generate-preview` | Evet | 1 görsel | 1 video | `GEMINI_API_KEY` | -| MiniMax | `MiniMax-Hailuo-2.3` | Evet | 1 görsel | Hayır | `MINIMAX_API_KEY` | -| OpenAI | `sora-2` | Evet | 1 görsel | 1 video | `OPENAI_API_KEY` | -| Qwen | `wan2.6-t2v` | Evet | Evet (uzak URL) | Evet (uzak URL) | `QWEN_API_KEY` | -| Runway | `gen4.5` | Evet | 1 görsel | 1 video | `RUNWAYML_API_SECRET` | -| Together | `Wan-AI/Wan2.2-T2V-A14B` | Evet | 1 görsel | Hayır | `TOGETHER_API_KEY` | -| Vydra | `veo3` | Evet | 1 görsel (`kling`) | Hayır | `VYDRA_API_KEY` | -| xAI | `grok-imagine-video` | Evet | 1 görsel | 1 video | `XAI_API_KEY` | +| Sağlayıcı | Varsayılan model | Metin | Görsel ref | Video ref | API anahtarı | +| --------- | ------------------------------- | ----- | ------------------ | ---------------- | ---------------------------------------- | +| Alibaba | `wan2.6-t2v` | Evet | Evet (uzak URL) | Evet (uzak URL) | `MODELSTUDIO_API_KEY` | +| BytePlus | `seedance-1-0-lite-t2v-250428` | Evet | 1 görsel | Hayır | `BYTEPLUS_API_KEY` | +| ComfyUI | `workflow` | Evet | 1 görsel | Hayır | `COMFY_API_KEY` veya `COMFY_CLOUD_API_KEY` | +| fal | `fal-ai/minimax/video-01-live` | Evet | 1 görsel | Hayır | `FAL_KEY` | +| Google | `veo-3.1-fast-generate-preview` | Evet | 1 görsel | 1 video | `GEMINI_API_KEY` | +| MiniMax | `MiniMax-Hailuo-2.3` | Evet | 1 görsel | Hayır | `MINIMAX_API_KEY` | +| OpenAI | `sora-2` | Evet | 1 görsel | 1 video | `OPENAI_API_KEY` | +| Qwen | `wan2.6-t2v` | Evet | Evet (uzak URL) | Evet (uzak URL) | `QWEN_API_KEY` | +| Runway | `gen4.5` | Evet | 1 görsel | 1 video | `RUNWAYML_API_SECRET` | +| Together | `Wan-AI/Wan2.2-T2V-A14B` | Evet | 1 görsel | Hayır | `TOGETHER_API_KEY` | +| Vydra | `veo3` | Evet | 1 görsel (`kling`) | Hayır | `VYDRA_API_KEY` | +| xAI | `grok-imagine-video` | Evet | 1 görsel | 1 video | `XAI_API_KEY` | Bazı sağlayıcılar ek veya alternatif API anahtarı ortam değişkenlerini kabul eder. Ayrıntılar için ilgili [sağlayıcı sayfalarına](#related) bakın. @@ -80,56 +80,56 @@ Bazı sağlayıcılar ek veya alternatif API anahtarı ortam değişkenlerini ka ### Zorunlu -| Parametre | Tür | Açıklama | -| --------- | ------ | ------------------------------------------------------------------------- | -| `prompt` | string | Oluşturulacak videonun metin açıklaması (`action: "generate"` için zorunlu) | +| Parametre | Tür | Açıklama | +| --------- | ------ | --------------------------------------------------------------------------- | +| `prompt` | string | Oluşturulacak videonun metin açıklaması (`action: "generate"` için zorunludur) | ### İçerik girdileri -| Parametre | Tür | Açıklama | -| --------- | -------- | ----------------------------------- | -| `image` | string | Tek referans görseli (yol veya URL) | -| `images` | string[] | Birden çok referans görsel (en fazla 5) | -| `video` | string | Tek referans videosu (yol veya URL) | -| `videos` | string[] | Birden çok referans video (en fazla 4) | +| Parametre | Tür | Açıklama | +| --------- | -------- | ------------------------------------ | +| `image` | string | Tek referans görseli (yol veya URL) | +| `images` | string[] | Birden çok referans görseli (en fazla 5) | +| `video` | string | Tek referans videosu (yol veya URL) | +| `videos` | string[] | Birden çok referans videosu (en fazla 4) | ### Stil denetimleri -| Parametre | Tür | Açıklama | -| ---------------- | ------- | ---------------------------------------------------------------------- | +| Parametre | Tür | Açıklama | +| ---------------- | ------- | ------------------------------------------------------------------------ | | `aspectRatio` | string | `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` | -| `resolution` | string | `480P`, `720P` veya `1080P` | -| `durationSeconds`| number | Saniye cinsinden hedef süre (sağlayıcının desteklediği en yakın değere yuvarlanır) | -| `size` | string | Sağlayıcı destekliyorsa boyut ipucu | -| `audio` | boolean | Destekleniyorsa üretilmiş sesi etkinleştirir | -| `watermark` | boolean | Destekleniyorsa sağlayıcı filigranını açıp kapatır | +| `resolution` | string | `480P`, `720P` veya `1080P` | +| `durationSeconds`| number | Hedef süre saniye cinsinden (sağlayıcının desteklediği en yakın değere yuvarlanır) | +| `size` | string | Sağlayıcı desteklediğinde boyut ipucu | +| `audio` | boolean | Desteklendiğinde oluşturulan sesi etkinleştirir | +| `watermark` | boolean | Desteklendiğinde sağlayıcı filigranını açıp kapatır | ### Gelişmiş -| Parametre | Tür | Açıklama | -| --------- | ------ | ----------------------------------------------------- | -| `action` | string | `"generate"` (varsayılan), `"status"` veya `"list"` | +| Parametre | Tür | Açıklama | +| --------- | ------ | ----------------------------------------------- | +| `action` | string | `"generate"` (varsayılan), `"status"` veya `"list"` | | `model` | string | Sağlayıcı/model geçersiz kılması (ör. `runway/gen4.5`) | -| `filename`| string | Çıktı dosya adı ipucu | +| `filename`| string | Çıktı dosya adı ipucu | -Tüm sağlayıcılar tüm parametreleri desteklemez. Desteklenmeyen geçersiz kılmalar en iyi çaba esasına göre yok sayılır ve araç sonucunda uyarı olarak bildirilir. Sert yetenek sınırları (örneğin çok fazla referans girdisi) gönderimden önce başarısız olur. +Tüm sağlayıcılar tüm parametreleri desteklemez. Desteklenmeyen geçersiz kılmalar mümkün olan en iyi şekilde yok sayılır ve araç sonucunda uyarı olarak bildirilir. Sert yetenek sınırları (örneğin çok fazla referans girdisi) gönderimden önce başarısız olur. ## Eylemler -- **generate** (varsayılan) -- verilen prompt ve isteğe bağlı referans girdilerinden bir video oluşturur. -- **status** -- yeni üretim başlatmadan geçerli oturum için devam eden video görevinin durumunu kontrol eder. -- **list** -- kullanılabilir sağlayıcıları, modelleri ve bunların yeteneklerini gösterir. +- **generate** (varsayılan) -- verilen istem ve isteğe bağlı referans girdilerinden bir video oluşturur. +- **status** -- başka bir oluşturma başlatmadan mevcut oturum için devam eden video görevinin durumunu denetler. +- **list** -- kullanılabilir sağlayıcıları, modelleri ve yeteneklerini gösterir. ## Model seçimi -Video oluştururken OpenClaw modeli şu sırayla çözer: +Bir video oluşturulurken OpenClaw modeli şu sırayla çözümler: -1. **`model` araç parametresi** -- ajan çağrıda bir model belirtirse. +1. **`model` araç parametresi** -- aracı çağrıda bir tane belirtirse. 2. **`videoGenerationModel.primary`** -- yapılandırmadan. 3. **`videoGenerationModel.fallbacks`** -- sırayla denenir. -4. **Otomatik algılama** -- geçerli kimlik doğrulamaya sahip sağlayıcıları kullanır; önce geçerli varsayılan sağlayıcıdan, sonra kalan sağlayıcılardan alfabetik sırayla başlar. +4. **Otomatik algılama** -- geçerli kimlik doğrulaması olan sağlayıcıları kullanır; önce geçerli varsayılan sağlayıcıdan, ardından kalan sağlayıcılardan alfabetik sırayla başlar. -Bir sağlayıcı başarısız olursa sonraki aday otomatik olarak denenir. Tüm adaylar başarısız olursa hata, her denemeden ayrıntılar içerir. +Bir sağlayıcı başarısız olursa sıradaki aday otomatik olarak denenir. Tüm adaylar başarısız olursa hata her denemeden ayrıntılar içerir. ```json5 { @@ -146,24 +146,24 @@ Bir sağlayıcı başarısız olursa sonraki aday otomatik olarak denenir. Tüm ## Sağlayıcı notları -| Sağlayıcı | Notlar | -| --------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -| Alibaba | DashScope/Model Studio eşzamansız uç noktasını kullanır. Referans görseller ve videolar uzak `http(s)` URL'leri olmalıdır. | -| BytePlus | Yalnızca tek görsel referansı. | -| ComfyUI | İş akışı odaklı yerel veya bulut yürütme. Yapılandırılmış grafik üzerinden metinden videoya ve görselden videoya desteği sunar. | -| fal | Uzun süren işler için kuyruk destekli akış kullanır. Yalnızca tek görsel referansı. | -| Google | Gemini/Veo kullanır. Bir görsel veya bir video referansını destekler. | -| MiniMax | Yalnızca tek görsel referansı. | -| OpenAI | Yalnızca `size` geçersiz kılması iletilir. Diğer stil geçersiz kılmaları (`aspectRatio`, `resolution`, `audio`, `watermark`) uyarıyla yok sayılır. | -| Qwen | Alibaba ile aynı DashScope arka ucunu kullanır. Referans girdileri uzak `http(s)` URL'leri olmalıdır; yerel dosyalar en baştan reddedilir. | -| Runway | Data URI'ler üzerinden yerel dosyaları destekler. Videodan videoya için `runway/gen4_aleph` gerekir. Yalnızca metin çalıştırmalarında `16:9` ve `9:16` en-boy oranları sunulur. | -| Together | Yalnızca tek görsel referansı. | -| Vydra | Kimlik doğrulamasını düşüren yönlendirmeleri önlemek için doğrudan `https://www.vydra.ai/api/v1` kullanır. `veo3` paketli olarak yalnızca metinden videoya gelir; `kling` uzak bir görsel URL'si gerektirir. | -| xAI | Metinden videoya, görselden videoya ve uzak video düzenleme/uzatma akışlarını destekler. | +| Sağlayıcı | Notlar | +| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Alibaba | DashScope/Model Studio eşzamansız uç noktasını kullanır. Referans görseller ve videolar uzak `http(s)` URL'leri olmalıdır. | +| BytePlus | Yalnızca tek görsel referansı. | +| ComfyUI | İş akışı odaklı yerel veya bulut yürütme. Yapılandırılmış grafik üzerinden metinden videoya ve görselden videoya desteği sunar. | +| fal | Uzun süreli işler için kuyruk destekli akış kullanır. Yalnızca tek görsel referansı. | +| Google | Gemini/Veo kullanır. Bir görsel veya bir video referansını destekler. | +| MiniMax | Yalnızca tek görsel referansı. | +| OpenAI | Yalnızca `size` geçersiz kılması iletilir. Diğer stil geçersiz kılmaları (`aspectRatio`, `resolution`, `audio`, `watermark`) uyarıyla yok sayılır. | +| Qwen | Alibaba ile aynı DashScope arka ucunu kullanır. Referans girdileri uzak `http(s)` URL'leri olmalıdır; yerel dosyalar peşinen reddedilir. | +| Runway | Data URI'leri üzerinden yerel dosyaları destekler. Videodan videoya için `runway/gen4_aleph` gerekir. Yalnızca metinli çalıştırmalar `16:9` ve `9:16` en-boy oranlarını sunar. | +| Together | Yalnızca tek görsel referansı. | +| Vydra | Kimlik doğrulamayı düşüren yönlendirmeleri önlemek için doğrudan `https://www.vydra.ai/api/v1` kullanır. `veo3` yalnızca metinden videoya olarak paketlenir; `kling` uzak bir görsel URL'si gerektirir. | +| xAI | Metinden videoya, görselden videoya ve uzak video düzenleme/uzatma akışlarını destekler. | ## Yapılandırma -Varsayılan video üretim modelini OpenClaw yapılandırmanızda ayarlayın: +Varsayılan video oluşturma modelini OpenClaw yapılandırmanızda ayarlayın: ```json5 { @@ -178,7 +178,7 @@ Varsayılan video üretim modelini OpenClaw yapılandırmanızda ayarlayın: } ``` -Veya CLI üzerinden: +Veya CLI aracılığıyla: ```bash openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2v" @@ -187,18 +187,18 @@ openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2 ## İlgili - [Araçlara Genel Bakış](/tr/tools) -- [Arka Plan Görevleri](/tr/automation/tasks) -- eşzamansız video üretimi için görev izleme -- [Alibaba Model Studio](/providers/alibaba) -- [BytePlus](/providers/byteplus) -- [ComfyUI](/providers/comfy) -- [fal](/providers/fal) +- [Arka Plan Görevleri](/tr/automation/tasks) -- eşzamansız video oluşturma için görev izleme +- [Alibaba Model Studio](/tr/providers/alibaba) +- [BytePlus](/tr/concepts/model-providers#byteplus-international) +- [ComfyUI](/tr/providers/comfy) +- [fal](/tr/providers/fal) - [Google (Gemini)](/tr/providers/google) - [MiniMax](/tr/providers/minimax) - [OpenAI](/tr/providers/openai) - [Qwen](/tr/providers/qwen) -- [Runway](/providers/runway) +- [Runway](/tr/providers/runway) - [Together AI](/tr/providers/together) -- [Vydra](/providers/vydra) +- [Vydra](/tr/providers/vydra) - [xAI](/tr/providers/xai) -- [Yapılandırma Başvurusu](/tr/gateway/configuration-reference#agent-defaults) +- [Yapılandırma Referansı](/tr/gateway/configuration-reference#agent-defaults) - [Modeller](/tr/concepts/models)