chore(i18n): refresh tr translations
This commit is contained in:
parent
b95a4493de
commit
07cbfee8c6
@ -1,33 +1,33 @@
|
||||
---
|
||||
read_when:
|
||||
- Bellek yükseltmenin otomatik olarak çalışmasını istiyorsunuz
|
||||
- Her bir rüya görme evresinin ne yaptığını anlamak istiyorsunuz
|
||||
- Pekiştirmeyi `MEMORY.md` dosyasını kirletmeden ayarlamak istiyorsunuz
|
||||
summary: Hafif, derin ve REM evreleri ile rüya günlüğü içeren arka plan bellek pekiştirmesi
|
||||
title: Dreaming (deneysel)
|
||||
- Her Dreaming evresinin ne yaptığını anlamak istiyorsunuz
|
||||
- Pekiştirmeyi, `MEMORY.md` dosyasını kirletmeden ayarlamak istiyorsunuz
|
||||
summary: Hafif, derin ve REM evreleri ile bir Rüya Günlüğü eşliğinde arka plan bellek pekiştirme
|
||||
title: Dreaming
|
||||
x-i18n:
|
||||
generated_at: "2026-04-15T08:53:15Z"
|
||||
generated_at: "2026-04-15T14:40:31Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 5882a5068f2eabe54ca9893184e5385330a432b921870c38626399ce11c31e25
|
||||
source_hash: a5bcaec80f62e7611ed533094ef1917bd72c885f57252824db910e1f0496adc6
|
||||
source_path: concepts/dreaming.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Dreaming (deneysel)
|
||||
# Dreaming
|
||||
|
||||
Dreaming, `memory-core` içindeki arka plan bellek pekiştirme sistemidir.
|
||||
OpenClaw’un güçlü kısa süreli sinyalleri kalıcı belleğe taşımasına yardımcı olurken
|
||||
süreci açıklanabilir ve incelenebilir halde tutar.
|
||||
süreci açıklanabilir ve gözden geçirilebilir tutar.
|
||||
|
||||
Dreaming **isteğe bağlıdır** ve varsayılan olarak devre dışıdır.
|
||||
|
||||
## Dreaming’in yazdıkları
|
||||
## Dreaming ne yazar
|
||||
|
||||
Dreaming 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 isteğe bağlı olarak `memory/dreaming/<phase>/YYYY-MM-DD.md` altındaki evre raporu dosyaları.
|
||||
- `memory/.dreams/` içinde **makine durumu** (geri çağırma deposu, evre sinyalleri, içe aktarma denetim noktaları, kilitler).
|
||||
- `DREAMS.md` (veya mevcut `dreams.md`) içinde **insan tarafından okunabilir çıktı** ve `memory/dreaming/<phase>/YYYY-MM-DD.md` altında isteğe bağlı evre raporu dosyaları.
|
||||
|
||||
Uzun vadeli yükseltme yine yalnızca `MEMORY.md` dosyasına yazar.
|
||||
|
||||
@ -35,101 +35,99 @@ Uzun vadeli yükseltme yine yalnızca `MEMORY.md` dosyasına yazar.
|
||||
|
||||
Dreaming üç işbirlikçi evre kullanır:
|
||||
|
||||
| Evre | Amaç | Kalıcı yazma |
|
||||
| ----- | ---- | ------------ |
|
||||
| Light | Son kısa süreli materyali sıralamak ve hazırlamak | Hayır |
|
||||
| Deep | Kalıcı adayları puanlamak ve yükseltmek | Evet (`MEMORY.md`) |
|
||||
| REM | Temalar ve yinelenen fikirler üzerine düşünmek | Hayır |
|
||||
| Evre | Amaç | Kalıcı yazım |
|
||||
| ----- | ---------------------------------------- | ----------------- |
|
||||
| Hafif | Son kısa süreli materyali sıralamak ve hazırlamak | Hayır |
|
||||
| Derin | Kalıcı adayları puanlamak ve yükseltmek | Evet (`MEMORY.md`) |
|
||||
| REM | Temalar ve tekrar eden fikirler üzerine düşünmek | Hayır |
|
||||
|
||||
Bu evreler, kullanıcı tarafından ayrı ayrı yapılandırılan "modlar" değil,
|
||||
dahili uygulama ayrıntılarıdır.
|
||||
Bu evreler, kullanıcı tarafından ayrı ayrı yapılandırılan
|
||||
"modlar" değil, dahili uygulama ayrıntılarıdır.
|
||||
|
||||
### Light evresi
|
||||
### Hafif evre
|
||||
|
||||
Light evresi son günlük bellek sinyallerini ve geri çağırma izlerini alır,
|
||||
yinelenenleri ayıklar ve aday satırları hazırlar.
|
||||
Hafif evre, son günlük bellek sinyallerini ve geri çağırma izlerini içe aktarır,
|
||||
bunları tekilleştirir ve aday satırları hazırlar.
|
||||
|
||||
- Uygun olduğunda kısa süreli geri çağırma durumundan, son günlük bellek dosyalarından ve sansürlenmiş oturum dökümlerinden okur.
|
||||
- Kısa süreli geri çağırma durumundan, son günlük bellek dosyalarından ve mevcut olduğunda sansürlenmiş oturum dökümlerinden okur.
|
||||
- Depolama satır içi çıktı içerdiğinde yönetilen bir `## Light Sleep` bloğu yazar.
|
||||
- Daha sonraki deep sıralaması için pekiştirme sinyalleri kaydeder.
|
||||
- `MEMORY.md` dosyasına asla yazmaz.
|
||||
- Daha sonra derin sıralama için pekiştirme sinyallerini kaydeder.
|
||||
- Asla `MEMORY.md` dosyasına yazmaz.
|
||||
|
||||
### Deep evresi
|
||||
### Derin evre
|
||||
|
||||
Deep evresi, neyin uzun vadeli belleğe dönüşeceğine karar verir.
|
||||
Derin evre, 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` koşullarının geçilmesini gerektirir.
|
||||
- Yazmadan önce parçacıkları canlı günlük dosyalardan yeniden alır; böylece eski/silinmiş parçacıklar atlanır.
|
||||
- `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.
|
||||
- Yükseltilen girdileri `MEMORY.md` dosyasına ekler.
|
||||
- `DREAMS.md` içine bir `## Deep Sleep` özeti yazar ve isteğe bağlı olarak `memory/dreaming/deep/YYYY-MM-DD.md` dosyasına 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 evresi örüntüleri ve yansıtıcı sinyalleri çıkarır.
|
||||
REM evresi, örüntüleri ve yansıtıcı sinyalleri çıkarır.
|
||||
|
||||
- Son kısa süreli izlerden tema ve yansıma özetleri oluşturur.
|
||||
- Depolama satır içi çıktı içerdiğinde yönetilen bir `## REM Sleep` bloğu yazar.
|
||||
- Deep sıralamasında kullanılan REM pekiştirme sinyallerini kaydeder.
|
||||
- `MEMORY.md` dosyasına asla yazmaz.
|
||||
- Derin sıralamada kullanılan REM pekiştirme sinyallerini kaydeder.
|
||||
- Asla `MEMORY.md` dosyasına yazmaz.
|
||||
|
||||
## Oturum dökümü alımı
|
||||
## Oturum dökümü içe aktarma
|
||||
|
||||
Dreaming, sansürlenmiş oturum dökümlerini Dreaming derlemine alabilir. Dökümler
|
||||
mevcut olduğunda, günlük bellek sinyalleri ve geri çağırma izleriyle birlikte
|
||||
light evresine beslenir. Kişisel ve hassas içerik alımdan önce sansürlenir.
|
||||
Dreaming, sansürlenmiş oturum dökümlerini dreaming külliyatına içe aktarabilir. Dökümler
|
||||
mevcut olduğunda, günlük bellek sinyalleri ve geri çağırma izlerinin yanında hafif evreye
|
||||
beslenir. Kişisel ve hassas içerikler içe aktarmadan önce sansürlenir.
|
||||
|
||||
## Dream Diary
|
||||
## Rüya Günlüğü
|
||||
|
||||
Dreaming ayrıca `DREAMS.md` içinde anlatı biçiminde bir **Dream Diary** tutar.
|
||||
Her evrede yeterli materyal oluştuğunda, `memory-core` en iyi çaba esaslı bir arka plan
|
||||
alt ajan turu çalıştırır (varsayılan çalışma zamanı modeli kullanılarak) ve kısa
|
||||
bir günlük girdisi ekler.
|
||||
Dreaming ayrıca `DREAMS.md` içinde anlatı niteliğinde bir **Rüya Günlüğü** tutar.
|
||||
Her evre yeterli malzemeye sahip olduktan sonra `memory-core`, en iyi çaba esaslı bir arka plan
|
||||
alt aracı dönüşü çalıştırır (varsayılan çalışma zamanı modelini kullanarak) 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 UI içinde insan tarafından okunmak içindir.
|
||||
Dreaming tarafından üretilen günlük/rapor yapıtları kısa süreli
|
||||
yükseltmeden hariç tutulur. Yalnızca temellendirilmiş bellek parçacıkları
|
||||
`MEMORY.md` içine yükseltilebilir.
|
||||
yükseltmeden hariç tutulur. `MEMORY.md` içine yükseltme için yalnızca temellendirilmiş
|
||||
bellek parçaları uygundur.
|
||||
|
||||
İnceleme ve kurtarma işleri için temellendirilmiş bir geçmiş doldurma hattı da vardır:
|
||||
İnceleme ve kurtarma çalışmaları için ayrıca temellendirilmiş bir geçmişi doldurma hattı vardır:
|
||||
|
||||
- `memory rem-harness --path ... --grounded`, geçmiş `YYYY-MM-DD.md` notlarından temellendirilmiş günlük çıktısını önizler.
|
||||
- `memory rem-backfill --path ...`, geri alınabilir temellendirilmiş günlük girdilerini `DREAMS.md` dosyasına yazar.
|
||||
- `memory rem-backfill --path ... --stage-short-term`, temellendirilmiş kalıcı adayları normal deep evresinin zaten kullandığı aynı kısa süreli kanıt deposuna hazırlık olarak koyar.
|
||||
- `memory rem-backfill --path ...`, geri alınabilir temellendirilmiş günlük girdilerini `DREAMS.md` içine yazar.
|
||||
- `memory rem-backfill --path ... --stage-short-term`, temellendirilmiş kalıcı adayları normal derin evrenin zaten kullandığı aynı kısa süreli kanıt deposuna hazırlar.
|
||||
- `memory rem-backfill --rollback` ve `--rollback-short-term`, sıradan günlük girdilerine veya canlı kısa süreli geri çağırmaya dokunmadan bu hazırlanmış geçmiş doldurma yapıtlarını kaldırır.
|
||||
|
||||
Control UI, aynı günlük geçmiş doldurma/sıfırlama akışını sunar; böylece sonuçları,
|
||||
temellendirilmiş adayların yükseltilmeyi hak edip etmediğine karar vermeden önce
|
||||
Dreams sahnesinde inceleyebilirsiniz. Sahne ayrıca belirgin bir temellendirilmiş hat da gösterir; böylece
|
||||
hangi hazırlanmış kısa süreli girdilerin geçmiş tekrar oynatmadan geldiğini,
|
||||
hangi yükseltilmiş öğelerin temellendirme kaynaklı olduğunu görebilir ve sıradan canlı kısa süreli duruma
|
||||
dokunmadan yalnızca temellendirilmiş hazırlanmış girdileri temizleyebilirsiniz.
|
||||
Control UI aynı günlük geçmiş doldurma/sıfırlama akışını sunar; böylece temellendirilmiş adayların
|
||||
yükseltmeyi hak edip etmediğine karar vermeden önce sonuçları Dreams sahnesinde inceleyebilirsiniz.
|
||||
Sahne ayrıca ayrı bir temellendirilmiş hat gösterir; böylece hangi hazırlanmış kısa süreli girdilerin
|
||||
geçmiş tekrar oynatımından geldiğini, hangi yükseltilmiş öğelerin temellendirilmiş odaklı olduğunu
|
||||
görebilir ve sıradan canlı kısa süreli duruma dokunmadan yalnızca temellendirilmiş hazırlanmış girdileri temizleyebilirsiniz.
|
||||
|
||||
## Deep sıralama sinyalleri
|
||||
## Derin sıralama sinyalleri
|
||||
|
||||
Deep sıralaması altı ağırlıklı temel sinyal ile evre pekiştirmesini kullanır:
|
||||
Derin sıralama, evre pekiştirmesine ek olarak altı ağırlıklı temel sinyal kullanır:
|
||||
|
||||
| Sinyal | Ağırlık | Açıklama |
|
||||
| ------ | ------- | -------- |
|
||||
| Sıklık | 0.24 | Girdinin kaç kısa süreli sinyal biriktirdiği |
|
||||
| İlgililik | 0.30 | Girdi için ortalama geri getirme kalitesi |
|
||||
| Sorgu çeşitliliği | 0.15 | Onu ortaya çıkaran farklı sorgu/gün bağlamları |
|
||||
| Yakınlık | 0.15 | Zamana bağlı olarak azalan tazelik puanı |
|
||||
| Pekiştirme | 0.10 | Çok günlük yineleme gücü |
|
||||
| Kavramsal zenginlik | 0.06 | Parçacık/yol üzerindeki kavram etiketi yoğunluğu |
|
||||
| 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 |
|
||||
| Sorgu çeşitliliği | 0.15 | Onu ortaya çıkaran farklı sorgu/gün bağlamları |
|
||||
| Güncellik | 0.15 | Zamana bağlı azalan tazelik puanı |
|
||||
| Pekiştirme | 0.10 | Çok günlü tekrar gücü |
|
||||
| Kavramsal zenginlik| 0.06 | Parça/yoldan kavram etiketi yoğunluğu |
|
||||
|
||||
Light ve REM evresi isabetleri,
|
||||
`memory/.dreams/phase-signals.json` dosyasından gelen zamana bağlı olarak azalan küçük bir artış ekler.
|
||||
Hafif ve REM evresi isabetleri,
|
||||
`memory/.dreams/phase-signals.json` dosyasından güncelliğe bağlı küçük bir azalan artış ekler.
|
||||
|
||||
## Zamanlama
|
||||
|
||||
Etkinleştirildiğinde `memory-core`, tam bir Dreaming taraması için tek bir Cron
|
||||
işini otomatik olarak yönetir. Her tarama evreleri sırayla çalıştırır: light -> REM -> deep.
|
||||
Etkinleştirildiğinde `memory-core`, tam bir dreaming
|
||||
taraması için tek bir Cron işi otomatik olarak yönetir. Her tarama evreleri sırayla çalıştırır: hafif -> REM -> derin.
|
||||
|
||||
Varsayılan sıklık davranışı:
|
||||
|
||||
| Ayar | Varsayılan |
|
||||
| ---- | ---------- |
|
||||
| Ayar | Varsayılan |
|
||||
| -------------------- | ---------- |
|
||||
| `dreaming.frequency` | `0 3 * * *` |
|
||||
|
||||
## Hızlı başlangıç
|
||||
@ -152,7 +150,7 @@ Dreaming’i etkinleştirin:
|
||||
}
|
||||
```
|
||||
|
||||
Özel bir tarama sıklığıyla Dreaming’i etkinleştirin:
|
||||
Özel bir tarama sıklığı ile Dreaming’i etkinleştirin:
|
||||
|
||||
```json
|
||||
{
|
||||
@ -192,8 +190,8 @@ openclaw memory promote --limit 5
|
||||
openclaw memory status --deep
|
||||
```
|
||||
|
||||
Elle çalıştırılan `memory promote`, CLI bayraklarıyla geçersiz kılınmadıkça
|
||||
varsayılan olarak deep evresi eşiklerini kullanır.
|
||||
Elle `memory promote`, CLI bayraklarıyla geçersiz kılınmadığı sürece varsayılan olarak
|
||||
derin evre eşiklerini kullanır.
|
||||
|
||||
Belirli bir adayın neden yükseltileceğini veya yükseltilmeyeceğini açıklayın:
|
||||
|
||||
@ -202,7 +200,7 @@ openclaw memory promote-explain "router vlan"
|
||||
openclaw memory promote-explain "router vlan" --json
|
||||
```
|
||||
|
||||
Herhangi bir şey yazmadan REM yansımalarını, aday gerçekleri ve deep yükseltme çıktısını önizleyin:
|
||||
Hiçbir şey yazmadan REM yansımalarını, aday gerçekleri ve derin yükseltme çıktısını önizleyin:
|
||||
|
||||
```bash
|
||||
openclaw memory rem-harness
|
||||
@ -213,30 +211,32 @@ openclaw memory rem-harness --json
|
||||
|
||||
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 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)
|
||||
sayfasına bakın.
|
||||
|
||||
## Dreams UI
|
||||
|
||||
Etkinleştirildiğinde Gateway **Dreams** sekmesi şunları gösterir:
|
||||
|
||||
- geçerli Dreaming etkin durumunu
|
||||
- evre düzeyinde durumu ve yönetilen tarama varlığını
|
||||
- dreaming’in mevcut etkinlik durumu
|
||||
- evre düzeyinde durum ve yönetilen tarama varlığı
|
||||
- kısa süreli, temellendirilmiş, sinyal ve bugün yükseltilen sayıları
|
||||
- bir sonraki zamanlanmış çalıştırmanın zamanlamasını
|
||||
- hazırlık aşamasındaki geçmiş tekrar oynatma girdileri için ayrı bir temellendirilmiş Sahne hattını
|
||||
- `doctor.memory.dreamDiary` tarafından desteklenen genişletilebilir bir Dream Diary okuyucusunu
|
||||
- bir sonraki zamanlanmış çalıştırmanın zamanı
|
||||
- hazırlanmış geçmiş tekrar oynatım girdileri için ayrı bir temellendirilmiş Sahne hattı
|
||||
- `doctor.memory.dreamDiary` tarafından desteklenen genişletilebilir bir Rüya Günlüğü okuyucusu
|
||||
|
||||
## İ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)
|
||||
|
||||
54
docs/tr/concepts/experimental-features.md
Normal file
54
docs/tr/concepts/experimental-features.md
Normal file
@ -0,0 +1,54 @@
|
||||
---
|
||||
read_when:
|
||||
- Bir ``.experimental`` yapılandırma anahtarı görüyorsunuz ve bunun kararlı olup olmadığını öğrenmek istiyorsunuz
|
||||
- Önizleme çalışma zamanı özelliklerini, bunları normal varsayılanlarla karıştırmadan denemek istiyorsunuz
|
||||
- Şu anda belgelenmiş deneysel bayrakları bulmak için tek bir yer istiyorsunuz
|
||||
summary: OpenClaw'da deneysel bayraklar ne anlama gelir ve hangileri şu anda belgelenmiştir
|
||||
title: Deneysel Özellikler
|
||||
x-i18n:
|
||||
generated_at: "2026-04-15T14:40:39Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 2d1c7b3d4cd56ef8a0bdab1deb9918e9b2c9a33f956d63193246087f8633dcf3
|
||||
source_path: concepts/experimental-features.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Deneysel özellikler
|
||||
|
||||
OpenClaw'daki deneysel özellikler **isteğe bağlı önizleme yüzeyleridir**. Bunlar
|
||||
açık bayrakların arkasındadır çünkü kararlı bir varsayılanı ya da uzun ömürlü bir
|
||||
genel sözleşmeyi hak etmeden önce hâlâ gerçek dünyada yeterince denenmeleri gerekir.
|
||||
|
||||
Bunlara normal yapılandırmadan farklı yaklaşın:
|
||||
|
||||
- İlgili belgede birini denemeniz söylenmedikçe bunları varsayılan olarak **kapalı tutun**.
|
||||
- Kararlı yapılandırmaya göre **biçim ve davranışın** daha hızlı değişmesini bekleyin.
|
||||
- Zaten mevcutsa önce kararlı yolu tercih edin.
|
||||
- OpenClaw'ı geniş ölçekte devreye alıyorsanız, deneysel bayrakları paylaşılan bir
|
||||
temele yerleştirmeden önce daha küçük bir ortamda test edin.
|
||||
|
||||
## Şu anda belgelenmiş bayraklar
|
||||
|
||||
| Yüzey | Anahtar | Bunu şu durumda kullanın | Daha fazla |
|
||||
| ------------------------ | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
|
||||
| Yerel model çalışma zamanı | `agents.defaults.experimental.localModelLean` | Daha küçük veya daha katı bir yerel arka uç, OpenClaw'ın tam varsayılan araç yüzeyini kaldıramıyorsa | [Yerel Modeller](/tr/gateway/local-models) |
|
||||
| Bellek araması | `agents.defaults.memorySearch.experimental.sessionMemory` | `memory_search`'ün önceki oturum dökümlerini dizine eklemesini istiyorsanız ve ek depolama/dizinleme maliyetini kabul ediyorsanız | [Bellek yapılandırma başvurusu](/tr/reference/memory-config#session-memory-search-experimental) |
|
||||
| Yapılandırılmış planlama aracı | `tools.experimental.planTool` | Uyumlu çalışma zamanlarında ve kullanıcı arayüzlerinde, çok adımlı iş takibi için yapılandırılmış `update_plan` aracının sunulmasını istiyorsanız | [Gateway yapılandırma başvurusu](/tr/gateway/configuration-reference#toolsexperimental) |
|
||||
|
||||
## Yerel model yalın modu
|
||||
|
||||
`agents.defaults.experimental.localModelLean: true`, daha zayıf yerel model kurulumları için
|
||||
bir rahatlatma supabıdır. `browser`, `cron` ve `message` gibi ağır varsayılan araçları
|
||||
budar; böylece istem biçimi daha küçük olur ve küçük bağlamlı veya daha katı
|
||||
OpenAI uyumlu arka uçlar için daha az kırılgan hale gelir.
|
||||
|
||||
Bu kasıtlı olarak normal yol **değildir**. Arka ucunuz tam çalışma zamanını sorunsuz
|
||||
şekilde yönetiyorsa bunu kapalı bırakın.
|
||||
|
||||
## Deneysel, gizli demek değildir
|
||||
|
||||
Bir özellik deneysel ise, OpenClaw bunu belgelerde ve yapılandırma yolunun kendisinde
|
||||
açıkça belirtmelidir. Yapmaması gereken şey ise önizleme davranışını kararlı gibi
|
||||
görünen bir varsayılan düğmenin içine gizlice sokup bunun normalmiş gibi davranmaktır.
|
||||
Yapılandırma yüzeyleri böyle karmaşık hale gelir.
|
||||
@ -1,26 +1,26 @@
|
||||
---
|
||||
read_when:
|
||||
- '`memory_search` öğesinin nasıl çalıştığını anlamak istiyorsunuz'
|
||||
- Bir gömü sağlayıcısı seçmek istiyorsunuz
|
||||
- '`memory_search`''ün nasıl çalıştığını anlamak istiyorsunuz'
|
||||
- Bir gömme sağlayıcısı seçmek istiyorsunuz
|
||||
- Arama kalitesini ayarlamak istiyorsunuz
|
||||
summary: Bellek araması, gömüler ve hibrit erişim kullanarak ilgili notları nasıl bulur
|
||||
summary: Bellek araması, gömmeler ve hibrit erişim kullanarak ilgili notları nasıl bulur
|
||||
title: Bellek Araması
|
||||
x-i18n:
|
||||
generated_at: "2026-04-12T23:28:05Z"
|
||||
generated_at: "2026-04-15T14:40:33Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 71fde251b7d2dc455574aa458e7e09136f30613609ad8dafeafd53b2729a0310
|
||||
source_hash: f5757aa8fe8f7fec30ef5c826f72230f591ce4cad591d81a091189d50d4262ed
|
||||
source_path: concepts/memory-search.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Bellek Araması
|
||||
|
||||
`memory_search`, ifade biçimi özgün metinden farklı olsa bile bellek dosyalarınızdan ilgili notları bulur. Bunu, belleği küçük parçalara ayırarak dizinleyip gömüler, anahtar sözcükler veya her ikisini kullanarak arayarak yapar.
|
||||
`memory_search`, ifade biçimi özgün metinden farklı olsa bile bellek dosyalarınızdan ilgili notları bulur. Bunu, belleği küçük parçalara ayırıp dizinleyerek ve bu parçaları gömmeler, anahtar kelimeler ya da her ikisini kullanarak arayarak yapar.
|
||||
|
||||
## Hızlı başlangıç
|
||||
|
||||
Yapılandırılmış bir OpenAI, Gemini, Voyage veya Mistral API anahtarınız varsa, bellek araması otomatik olarak çalışır. Bir sağlayıcıyı açıkça ayarlamak için:
|
||||
GitHub Copilot aboneliğiniz ya da yapılandırılmış bir OpenAI, Gemini, Voyage veya Mistral API anahtarınız varsa, bellek araması otomatik olarak çalışır. Bir sağlayıcıyı açıkça ayarlamak için:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -34,23 +34,24 @@ Yapılandırılmış bir OpenAI, Gemini, Voyage veya Mistral API anahtarınız v
|
||||
}
|
||||
```
|
||||
|
||||
API anahtarı olmadan yerel gömüler için `provider: "local"` kullanın (`node-llama-cpp` gerektirir).
|
||||
API anahtarı olmadan yerel gömmeler için `provider: "local"` kullanın (`node-llama-cpp` gerektirir).
|
||||
|
||||
## Desteklenen sağlayıcılar
|
||||
|
||||
| Sağlayıcı | ID | API anahtarı gerekir | Notlar |
|
||||
| --------- | --------- | -------------------- | ---------------------------------------------------- |
|
||||
| OpenAI | `openai` | Evet | Otomatik algılanır, hızlı |
|
||||
| Gemini | `gemini` | Evet | Görüntü/ses dizinlemeyi destekler |
|
||||
| Voyage | `voyage` | Evet | Otomatik algılanır |
|
||||
| Mistral | `mistral` | Evet | Otomatik algılanır |
|
||||
| Bedrock | `bedrock` | Hayır | AWS kimlik bilgisi zinciri çözümlendiğinde otomatik algılanır |
|
||||
| Ollama | `ollama` | Hayır | Yerel, açıkça ayarlanmalıdır |
|
||||
| Local | `local` | Hayır | GGUF modeli, ~0.6 GB indirme |
|
||||
| Sağlayıcı | Kimlik | API anahtarı gerekir | Notlar |
|
||||
| --------------- | ---------------- | -------------------- | ---------------------------------------------------- |
|
||||
| Bedrock | `bedrock` | Hayır | AWS kimlik bilgisi zinciri çözüldüğünde otomatik algılanır |
|
||||
| Gemini | `gemini` | Evet | Görüntü/ses dizinlemeyi destekler |
|
||||
| GitHub Copilot | `github-copilot` | Hayır | Otomatik algılanır, Copilot aboneliğini kullanır |
|
||||
| Local | `local` | Hayır | GGUF modeli, ~0.6 GB indirme |
|
||||
| Mistral | `mistral` | Evet | Otomatik algılanır |
|
||||
| Ollama | `ollama` | Hayır | Yerel, açıkça ayarlanmalıdır |
|
||||
| OpenAI | `openai` | Evet | Otomatik algılanır, hızlıdır |
|
||||
| Voyage | `voyage` | Evet | Otomatik algılanır |
|
||||
|
||||
## Arama nasıl çalışır
|
||||
|
||||
OpenClaw iki erişim yolunu paralel olarak çalıştırır ve sonuçları birleştirir:
|
||||
OpenClaw, iki erişim yolunu paralel olarak çalıştırır ve sonuçları birleştirir:
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
@ -63,31 +64,31 @@ flowchart LR
|
||||
M --> R["Top Results"]
|
||||
```
|
||||
|
||||
- **Vektör araması**, anlam olarak benzer notları bulur (`"gateway host"`, `"the machine running OpenClaw"` ile eşleşir).
|
||||
- **BM25 anahtar sözcük araması**, tam eşleşmeleri bulur (kimlikler, hata dizeleri, yapılandırma anahtarları).
|
||||
- **Vektör araması**, benzer anlama sahip notları bulur ("gateway host", "OpenClaw'ı çalıştıran makine" ile eşleşir).
|
||||
- **BM25 anahtar kelime araması**, tam eşleşmeleri bulur (kimlikler, hata dizeleri, yapılandırma anahtarları).
|
||||
|
||||
Yalnızca bir yol kullanılabiliyorsa (gömü yoksa veya FTS yoksa), yalnızca diğeri çalışır.
|
||||
Yalnızca bir yol kullanılabiliyorsa (gömme yoksa veya FTS yoksa), diğeri tek başına çalışır.
|
||||
|
||||
Gömüler kullanılamadığında, OpenClaw yalnızca ham tam eşleşme sıralamasına geri dönmek yerine yine de FTS sonuçları üzerinde sözcüksel sıralama kullanır. Bu düşük özellikli kip, sorgu terimlerini daha güçlü kapsayan ve ilgili dosya yollarına sahip parçaları öne çıkarır; bu da `sqlite-vec` veya bir gömü sağlayıcısı olmadan da geri çağırmayı kullanışlı tutar.
|
||||
Gömmeler kullanılamadığında, OpenClaw yalnızca ham tam eşleşme sıralamasına geri dönmek yerine yine de FTS sonuçları üzerinde sözcüksel sıralama kullanır. Bu düşük özellikli mod, sorgu terimlerini daha güçlü kapsayan ve ilgili dosya yollarına sahip parçaları öne çıkarır; bu da `sqlite-vec` veya bir gömme sağlayıcısı olmadan bile geri çağırmayı kullanışlı tutar.
|
||||
|
||||
## Arama kalitesini iyileştirme
|
||||
|
||||
Not geçmişiniz büyük olduğunda iki isteğe bağlı özellik yardımcı olur:
|
||||
Büyük bir not geçmişiniz varsa, iki isteğe bağlı özellik yardımcı olur:
|
||||
|
||||
### Zamansal azalma
|
||||
|
||||
Eski notlar sıralama ağırlığını zamanla kademeli olarak kaybeder, böylece güncel bilgiler önce görünür. Varsayılan 30 günlük yarı ömürle, geçen aydan bir not özgün ağırlığının %50'siyle puanlanır. `MEMORY.md` gibi kalıcı dosyalara hiçbir zaman azalma uygulanmaz.
|
||||
Eski notlar zamanla sıralama ağırlığını kademeli olarak kaybeder; böylece yeni bilgiler önce görünür. Varsayılan 30 günlük yarı ömürle, geçen aydan bir not özgün ağırlığının %50'si kadar puan alır. `MEMORY.md` gibi kalıcı dosyalara hiçbir zaman azalma uygulanmaz.
|
||||
|
||||
<Tip>
|
||||
Aracınızın aylarca günlük notları varsa ve eski bilgiler sürekli daha yeni bağlamın önüne geçiyorsa zamansal azalmayı etkinleştirin.
|
||||
Ajanınızın aylarca birikmiş günlük notları varsa ve eski bilgiler sürekli daha yeni bağlamın önüne geçiyorsa zamansal azalmayı etkinleştirin.
|
||||
</Tip>
|
||||
|
||||
### MMR (çeşitlilik)
|
||||
|
||||
Tekrarlayan sonuçları azaltır. Beş notun da aynı yönlendirici yapılandırmasından bahsetmesi durumunda MMR, en üstteki sonuçların tekrar etmek yerine farklı konuları kapsamasını sağlar.
|
||||
Yinelenen sonuçları azaltır. Beş notun da aynı yönlendirici yapılandırmasından bahsetmesi durumunda, MMR en üstteki sonuçların tekrar etmek yerine farklı konuları kapsamasını sağlar.
|
||||
|
||||
<Tip>
|
||||
`memory_search` farklı günlük notlardan birbirine çok benzeyen parçaları döndürmeye devam ediyorsa MMR'yi etkinleştirin.
|
||||
`memory_search` farklı günlük notlardan birbirine çok benzeyen parçaları sürekli döndürüyorsa MMR'yi etkinleştirin.
|
||||
</Tip>
|
||||
|
||||
### Her ikisini de etkinleştirme
|
||||
@ -111,22 +112,22 @@ Tekrarlayan sonuçları azaltır. Beş notun da aynı yönlendirici yapılandır
|
||||
|
||||
## Çok modlu bellek
|
||||
|
||||
Gemini Embedding 2 ile görüntüleri ve ses dosyalarını Markdown ile birlikte dizinleyebilirsiniz. Arama sorguları metin olarak kalır, ancak görsel ve ses içeriğiyle eşleşir. Kurulum için [Bellek yapılandırma başvurusu](/tr/reference/memory-config) bölümüne bakın.
|
||||
Gemini Embedding 2 ile, Markdown'un yanında görüntüleri ve ses dosyalarını da dizinleyebilirsiniz. Arama sorguları metin olarak kalır, ancak görsel ve ses içeriğiyle eşleşir. Kurulum için [Bellek yapılandırma başvurusu](/tr/reference/memory-config) bölümüne bakın.
|
||||
|
||||
## Oturum belleği araması
|
||||
|
||||
`memory_search` öğesinin önceki konuşmaları hatırlayabilmesi için oturum dökümlerini isteğe bağlı olarak dizinleyebilirsiniz. Bu, `memorySearch.experimental.sessionMemory` üzerinden isteğe bağlı olarak etkinleştirilir. Ayrıntılar için [yapılandırma başvurusu](/tr/reference/memory-config) bölümüne bakın.
|
||||
İsterseniz oturum dökümlerini dizinleyebilirsiniz; böylece `memory_search` önceki konuşmaları hatırlayabilir. Bu özellik `memorySearch.experimental.sessionMemory` üzerinden isteğe bağlı olarak etkinleştirilir. Ayrıntılar için [yapılandırma başvurusu](/tr/reference/memory-config) bölümüne bakın.
|
||||
|
||||
## Sorun giderme
|
||||
|
||||
**Sonuç yok mu?** Dizini kontrol etmek için `openclaw memory status` çalıştırın. Boşsa `openclaw memory index --force` çalıştırın.
|
||||
|
||||
**Yalnızca anahtar sözcük eşleşmeleri mi var?** Gömü sağlayıcınız yapılandırılmamış olabilir. `openclaw memory status --deep` ile kontrol edin.
|
||||
**Yalnızca anahtar kelime eşleşmeleri mi var?** Gömme sağlayıcınız yapılandırılmamış olabilir. `openclaw memory status --deep` ile kontrol edin.
|
||||
|
||||
**CJK metni bulunamıyor mu?** FTS dizinini `openclaw memory index --force` ile yeniden oluşturun.
|
||||
|
||||
## Ek okuma
|
||||
## Daha fazla bilgi
|
||||
|
||||
- [Active Memory](/tr/concepts/active-memory) -- etkileşimli sohbet oturumları için alt aracı belleği
|
||||
- [Active Memory](/tr/concepts/active-memory) -- etkileşimli sohbet oturumları için alt ajan belleği
|
||||
- [Bellek](/tr/concepts/memory) -- dosya düzeni, arka uçlar, araçlar
|
||||
- [Bellek yapılandırma başvurusu](/tr/reference/memory-config) -- tüm yapılandırma ayarları
|
||||
- [Bellek yapılandırma başvurusu](/tr/reference/memory-config) -- tüm yapılandırma seçenekleri
|
||||
|
||||
@ -1,83 +1,85 @@
|
||||
---
|
||||
read_when:
|
||||
- Belleğin nasıl çalıştığını anlamak istiyorsunuz
|
||||
- Hangi bellek dosyalarına yazılması gerektiğini bilmek istiyorsunuz
|
||||
- Hangi bellek dosyalarını yazmanız gerektiğini bilmek istiyorsunuz
|
||||
summary: OpenClaw'ın oturumlar arasında şeyleri nasıl hatırladığı
|
||||
title: Belleğe Genel Bakış
|
||||
x-i18n:
|
||||
generated_at: "2026-04-09T01:27:49Z"
|
||||
generated_at: "2026-04-15T14:40:29Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 2fe47910f5bf1c44be379e971c605f1cb3a29befcf2a7ee11fb3833cbe3b9059
|
||||
source_hash: ad1adafe1d81f1703d24f48a9c9da2b25a0ebbd4aad4f65d8bde5df78195d55b
|
||||
source_path: concepts/memory.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Belleğe Genel Bakış
|
||||
|
||||
OpenClaw, ajanınızın çalışma alanında **düz Markdown dosyaları** yazarak bir şeyleri hatırlar. Model yalnızca diske kaydedilenleri "hatırlar" -- gizli bir durum yoktur.
|
||||
OpenClaw, ajanınızın çalışma alanına **düz Markdown dosyaları** yazarak şeyleri hatırlar. Model yalnızca diske kaydedilenleri "hatırlar" -- gizli bir durum yoktur.
|
||||
|
||||
## Nasıl çalışır
|
||||
|
||||
Ajanınızın bellekle ilgili üç dosyası vardır:
|
||||
|
||||
- **`MEMORY.md`** -- uzun vadeli bellek. Kalıcı gerçekler, tercihler ve kararlar. Her DM oturumunun başında yüklenir.
|
||||
- **`memory/YYYY-MM-DD.md`** -- günlük notlar. Süreğen bağlam ve gözlemler. Bugünün ve dünün notları otomatik olarak yüklenir.
|
||||
- **`DREAMS.md`** (deneysel, isteğe bağlı) -- insan incelemesi için Düş Günlüğü ve rüya taraması özetleri; buna temellendirilmiş geçmişe dönük doldurma girdileri de dahildir.
|
||||
- **`memory/YYYY-MM-DD.md`** -- günlük notlar. Devam eden bağlam ve gözlemler. Bugünün ve dünün notları otomatik olarak yüklenir.
|
||||
- **`DREAMS.md`** (isteğe bağlı) -- insan incelemesi için Rüya Günlüğü ve Dreaming taraması özetleri; buna temellendirilmiş geçmişe dönük doldurma girdileri de dahildir.
|
||||
|
||||
Bu dosyalar ajan çalışma alanında bulunur (varsayılan `~/.openclaw/workspace`).
|
||||
|
||||
<Tip>
|
||||
Ajanınızın bir şeyi hatırlamasını istiyorsanız, ona söylemeniz yeterlidir: "TypeScript tercih ettiğimi hatırla." Uygun dosyaya bunu yazacaktır.
|
||||
Ajanınızın bir şeyi hatırlamasını istiyorsanız, ona söylemeniz yeterlidir: "Remember that I
|
||||
prefer TypeScript." Uygun dosyaya yazacaktır.
|
||||
</Tip>
|
||||
|
||||
## Bellek araçları
|
||||
|
||||
Ajanın bellekle çalışmak için iki aracı vardır:
|
||||
|
||||
- **`memory_search`** -- ifade biçimi asıldan farklı olsa bile, anlamsal aramayı kullanarak ilgili notları bulur.
|
||||
- **`memory_search`** -- ifade biçimi özgün metinden farklı olsa bile anlamsal aramayı kullanarak ilgili notları bulur.
|
||||
- **`memory_get`** -- belirli bir bellek dosyasını veya satır aralığını okur.
|
||||
|
||||
Her iki araç da etkin bellek plugin'i tarafından sağlanır (varsayılan: `memory-core`).
|
||||
Her iki araç da etkin bellek Plugin'i tarafından sağlanır (varsayılan: `memory-core`).
|
||||
|
||||
## Memory Wiki yardımcı plugin'i
|
||||
## Memory Wiki yardımcı Plugin'i
|
||||
|
||||
Kalıcı belleğin yalnızca ham notlar gibi değil, bakımı yapılan bir bilgi tabanı gibi davranmasını istiyorsanız, birlikte gelen `memory-wiki` plugin'ini kullanın.
|
||||
Kalıcı belleğin yalnızca ham notlar yerine bakımı yapılan bir bilgi tabanı gibi davranmasını istiyorsanız, paketle gelen `memory-wiki` Plugin'ini kullanın.
|
||||
|
||||
`memory-wiki`, kalıcı bilgiyi şu özelliklere sahip bir wiki kasasına derler:
|
||||
`memory-wiki`, kalıcı bilgileri şu özelliklere sahip bir wiki kasasına derler:
|
||||
|
||||
- deterministik sayfa yapısı
|
||||
- yapılandırılmış iddialar ve kanıtlar
|
||||
- çelişki ve güncellik takibi
|
||||
- oluşturulmuş panolar
|
||||
- ajan/çalışma zamanı tüketicileri için derlenmiş özetler
|
||||
- `wiki_search`, `wiki_get`, `wiki_apply` ve `wiki_lint` gibi wiki'ye özgü araçlar
|
||||
- `wiki_search`, `wiki_get`, `wiki_apply` ve `wiki_lint` gibi wiki-yerel araçlar
|
||||
|
||||
Etkin bellek plugin'inin yerini almaz. Geri çağırma, yükseltme ve rüya görme süreçlerinin sahibi olmaya etkin bellek plugin'i devam eder. `memory-wiki`, bunun yanına kaynak geçmişi açısından zengin bir bilgi katmanı ekler.
|
||||
Etkin bellek Plugin'inin yerini almaz. Geri çağırma, yükseltme ve Dreaming süreçlerinin sahibi olmaya etkin bellek Plugin'i devam eder. `memory-wiki`, bunun yanına kaynak geçmişi açısından zengin bir bilgi katmanı ekler.
|
||||
|
||||
Bkz. [Memory Wiki](/tr/plugins/memory-wiki).
|
||||
|
||||
## Bellek araması
|
||||
|
||||
Bir embedding sağlayıcısı yapılandırıldığında, `memory_search` **hibrit arama** kullanır -- vektör benzerliğini (anlamsal anlam) anahtar sözcük eşleştirmeyle (kimlikler ve kod sembolleri gibi tam terimler) birleştirir. Desteklenen herhangi bir sağlayıcı için bir API anahtarınız olduğunda bu ek yapılandırma olmadan çalışır.
|
||||
Bir embedding sağlayıcısı yapılandırıldığında, `memory_search` **hibrit arama** kullanır -- vektör benzerliğini (anlamsal anlam) anahtar sözcük eşleştirmesiyle (kimlikler ve kod sembolleri gibi tam terimler) birleştirir. Desteklenen herhangi bir sağlayıcı için bir API anahtarınız olduğunda bu özellik kutudan çıktığı gibi çalışır.
|
||||
|
||||
<Info>
|
||||
OpenClaw, mevcut API anahtarlarından embedding sağlayıcınızı otomatik olarak algılar. OpenAI, Gemini, Voyage veya Mistral anahtarınız yapılandırılmışsa bellek araması otomatik olarak etkinleştirilir.
|
||||
OpenClaw, kullanılabilir API anahtarlarından embedding sağlayıcınızı otomatik olarak algılar. OpenAI, Gemini, Voyage veya Mistral anahtarınız yapılandırılmışsa bellek araması otomatik olarak etkinleştirilir.
|
||||
</Info>
|
||||
|
||||
Aramanın nasıl çalıştığı, ayarlama seçenekleri ve sağlayıcı kurulumu hakkında ayrıntılar için bkz. [Memory Search](/tr/concepts/memory-search).
|
||||
Aramanın nasıl çalıştığı, ayar seçenekleri ve sağlayıcı kurulumu hakkında ayrıntılar için bkz.
|
||||
[Memory Search](/tr/concepts/memory-search).
|
||||
|
||||
## Bellek arka uçları
|
||||
|
||||
<CardGroup cols={3}>
|
||||
<Card title="Yerleşik (varsayılan)" icon="database" href="/tr/concepts/memory-builtin">
|
||||
SQLite tabanlıdır. Anahtar sözcük araması, vektör benzerliği ve hibrit arama ile ek yapılandırma olmadan çalışır. Ek bağımlılık yoktur.
|
||||
SQLite tabanlıdır. Anahtar sözcük araması, vektör benzerliği ve hibrit arama ile kutudan çıktığı gibi çalışır. Ek bağımlılık gerekmez.
|
||||
</Card>
|
||||
<Card title="QMD" icon="search" href="/tr/concepts/memory-qmd">
|
||||
Yeniden sıralama, sorgu genişletme ve çalışma alanı dışındaki dizinleri indeksleme yeteneğine sahip yerel öncelikli yan hizmet.
|
||||
Yeniden sıralama, sorgu genişletme ve çalışma alanı dışındaki dizinleri dizine ekleme yeteneğine sahip local loopback öncelikli yardımcı süreç.
|
||||
</Card>
|
||||
<Card title="Honcho" icon="brain" href="/tr/concepts/memory-honcho">
|
||||
Kullanıcı modelleme, anlamsal arama ve çoklu ajan farkındalığı ile AI-native oturumlar arası bellek. Plugin kurulumu gerekir.
|
||||
Kullanıcı modelleme, anlamsal arama ve çoklu ajan farkındalığına sahip yapay zeka yerel oturumlar arası bellek. Plugin kurulumu.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
@ -85,39 +87,40 @@ Kullanıcı modelleme, anlamsal arama ve çoklu ajan farkındalığı ile AI-nat
|
||||
|
||||
<CardGroup cols={1}>
|
||||
<Card title="Memory Wiki" icon="book" href="/tr/plugins/memory-wiki">
|
||||
Kalıcı belleği iddialar, panolar, köprü modu ve Obsidian dostu iş akışlarıyla kaynak geçmişi açısından zengin bir wiki kasasına derler.
|
||||
Kalıcı belleği; iddialar, panolar, köprü modu ve Obsidian dostu iş akışları içeren, kaynak geçmişi açısından zengin bir wiki kasasına derler.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
## Otomatik bellek boşaltma
|
||||
|
||||
[Compaction](/tr/concepts/compaction) konuşmanızı özetlemeden önce OpenClaw, ajana önemli bağlamı bellek dosyalarına kaydetmesini hatırlatan sessiz bir tur çalıştırır. Bu varsayılan olarak açıktır -- herhangi bir şeyi yapılandırmanız gerekmez.
|
||||
[Compaction](/tr/concepts/compaction), konuşmanızı özetlemeden önce OpenClaw, ajana önemli bağlamı bellek dosyalarına kaydetmesini hatırlatan sessiz bir tur çalıştırır. Bu varsayılan olarak açıktır -- herhangi bir şey yapılandırmanız gerekmez.
|
||||
|
||||
<Tip>
|
||||
Bellek boşaltma, compaction sırasında bağlam kaybını önler. Ajanınızın konuşmada bulunan ancak henüz bir dosyaya yazılmamış önemli bilgileri varsa, özetleme gerçekleşmeden önce bunlar otomatik olarak kaydedilir.
|
||||
Bellek boşaltma, Compaction sırasında bağlam kaybını önler. Ajanınızın konuşmada bulunan ancak henüz bir dosyaya yazılmamış önemli gerçekleri varsa, özetleme gerçekleşmeden önce bunlar otomatik olarak kaydedilir.
|
||||
</Tip>
|
||||
|
||||
## Rüya görme (deneysel)
|
||||
## Dreaming
|
||||
|
||||
Rüya görme, bellek için isteğe bağlı bir arka plan pekiştirme geçişidir. Kısa vadeli sinyalleri toplar, adayları puanlar ve yalnızca uygun öğeleri uzun vadeli belleğe (`MEMORY.md`) yükseltir.
|
||||
Dreaming, bellek için isteğe bağlı bir arka plan pekiştirme geçişidir. Kısa vadeli sinyalleri toplar, adayları puanlar ve yalnızca uygun öğeleri uzun vadeli belleğe (`MEMORY.md`) yükseltir.
|
||||
|
||||
Uzun vadeli belleği yüksek sinyalli tutacak şekilde tasarlanmıştır:
|
||||
Uzun vadeli belleği yüksek sinyal düzeyinde tutmak için tasarlanmıştır:
|
||||
|
||||
- **İsteğe bağlı**: varsayılan olarak devre dışıdır.
|
||||
- **Zamanlanmış**: etkinleştirildiğinde `memory-core`, tam bir rüya taraması için yinelenen tek bir cron işini otomatik olarak yönetir.
|
||||
- **Eşikli**: yükseltmeler puan, geri çağırma sıklığı ve sorgu çeşitliliği geçitlerini geçmelidir.
|
||||
- **İsteğe bağlı katılım**: varsayılan olarak devre dışıdır.
|
||||
- **Zamanlanmış**: etkinleştirildiğinde `memory-core`, tam bir Dreaming taraması için yinelenen tek bir Cron işini otomatik olarak yönetir.
|
||||
- **Eşikli**: yükseltmelerin puan, geri çağırma sıklığı ve sorgu çeşitliliği kapılarından geçmesi gerekir.
|
||||
- **İncelenebilir**: aşama özetleri ve günlük girdileri, insan incelemesi için `DREAMS.md` dosyasına yazılır.
|
||||
|
||||
Aşama davranışı, puanlama sinyalleri ve Düş Günlüğü ayrıntıları için bkz. [Dreaming (experimental)](/tr/concepts/dreaming).
|
||||
Aşama davranışı, puanlama sinyalleri ve Rüya Günlüğü ayrıntıları için bkz.
|
||||
[Dreaming](/tr/concepts/dreaming).
|
||||
|
||||
## Temellendirilmiş geçmişe dönük doldurma ve canlı yükseltme
|
||||
|
||||
Rüya görme sisteminin artık birbirine yakın iki inceleme hattı vardır:
|
||||
Dreaming sistemi artık birbiriyle yakından ilişkili iki inceleme hattına sahiptir:
|
||||
|
||||
- **Canlı rüya görme**, `memory/.dreams/` altındaki kısa vadeli rüya görme deposundan çalışır ve bir şeyin `MEMORY.md` içine yükselip yükselemeyeceğine karar verirken normal derin aşamanın kullandığı şeydir.
|
||||
- **Temellendirilmiş geçmişe dönük doldurma**, geçmiş `memory/YYYY-MM-DD.md` notlarını bağımsız günlük dosyaları olarak okur ve yapılandırılmış inceleme çıktısını `DREAMS.md` dosyasına yazar.
|
||||
- **Canlı Dreaming**, `memory/.dreams/` altındaki kısa vadeli Dreaming deposundan çalışır ve bir şeyin `MEMORY.md` içine yükselip yükselemeyeceğine karar verirken normal derin aşamanın kullandığı şeydir.
|
||||
- **Temellendirilmiş geçmişe dönük doldurma**, geçmiş `memory/YYYY-MM-DD.md` notlarını bağımsız gün dosyaları olarak okur ve yapılandırılmış inceleme çıktısını `DREAMS.md` dosyasına yazar.
|
||||
|
||||
Temellendirilmiş geçmişe dönük doldurma, eski notları yeniden oynatmak ve sistemin `MEMORY.md` dosyasını elle düzenlemeden neyin kalıcı olduğunu düşündüğünü incelemek istediğinizde kullanışlıdır.
|
||||
Temellendirilmiş geçmişe dönük doldurma, eski notları yeniden oynatmak ve sistemin dayanıklı olarak gördüğü şeyleri `MEMORY.md` dosyasını elle düzenlemeden incelemek istediğinizde yararlıdır.
|
||||
|
||||
Şunu kullandığınızda:
|
||||
|
||||
@ -125,13 +128,13 @@ Temellendirilmiş geçmişe dönük doldurma, eski notları yeniden oynatmak ve
|
||||
openclaw memory rem-backfill --path ./memory --stage-short-term
|
||||
```
|
||||
|
||||
temellendirilmiş kalıcı adaylar doğrudan yükseltilmez. Bunun yerine, normal derin aşamanın zaten kullandığı aynı kısa vadeli rüya görme deposuna hazırlanırlar. Bu şu anlama gelir:
|
||||
temellendirilmiş kalıcı adaylar doğrudan yükseltilmez. Bunun yerine, normal derin aşamanın zaten kullandığı aynı kısa vadeli Dreaming deposuna aşamalı olarak alınırlar. Bu şu anlama gelir:
|
||||
|
||||
- `DREAMS.md`, insan inceleme yüzeyi olarak kalır.
|
||||
- kısa vadeli depo, makineye dönük sıralama yüzeyi olarak kalır.
|
||||
- `DREAMS.md` insan inceleme yüzeyi olarak kalır.
|
||||
- kısa vadeli depo makineye yönelik sıralama yüzeyi olarak kalır.
|
||||
- `MEMORY.md` hâlâ yalnızca derin yükseltme tarafından yazılır.
|
||||
|
||||
Yeniden oynatmanın yararlı olmadığına karar verirseniz, hazırlanan yapıtları sıradan günlük girdilerine veya normal geri çağırma durumuna dokunmadan kaldırabilirsiniz:
|
||||
Yeniden oynatmanın yararlı olmadığına karar verirseniz, sıradan günlük girdilerine veya normal geri çağırma durumuna dokunmadan aşamalı olarak alınmış yapıtları kaldırabilirsiniz:
|
||||
|
||||
```bash
|
||||
openclaw memory rem-backfill --rollback
|
||||
@ -146,13 +149,13 @@ openclaw memory search "query" # Komut satırından ara
|
||||
openclaw memory index --force # Dizini yeniden oluştur
|
||||
```
|
||||
|
||||
## Daha fazla okuma
|
||||
## Daha fazla bilgi
|
||||
|
||||
- [Builtin Memory Engine](/tr/concepts/memory-builtin) -- varsayılan SQLite arka ucu
|
||||
- [QMD Memory Engine](/tr/concepts/memory-qmd) -- gelişmiş yerel öncelikli yan hizmet
|
||||
- [Honcho Memory](/tr/concepts/memory-honcho) -- AI-native oturumlar arası bellek
|
||||
- [Memory Wiki](/tr/plugins/memory-wiki) -- derlenmiş bilgi kasası ve wiki'ye özgü araçlar
|
||||
- [Memory Search](/tr/concepts/memory-search) -- arama hattı, sağlayıcılar ve ayarlama
|
||||
- [Dreaming (experimental)](/tr/concepts/dreaming) -- kısa vadeli geri çağırmadan uzun vadeli belleğe arka plan yükseltmesi
|
||||
- [Memory configuration reference](/tr/reference/memory-config) -- tüm yapılandırma ayarları
|
||||
- [Compaction](/tr/concepts/compaction) -- compaction'ın bellekle nasıl etkileştiği
|
||||
- [QMD Memory Engine](/tr/concepts/memory-qmd) -- gelişmiş local loopback öncelikli yardımcı süreç
|
||||
- [Honcho Memory](/tr/concepts/memory-honcho) -- yapay zeka yerel oturumlar arası bellek
|
||||
- [Memory Wiki](/tr/plugins/memory-wiki) -- derlenmiş bilgi kasası ve wiki-yerel araçlar
|
||||
- [Memory Search](/tr/concepts/memory-search) -- arama ardışık düzeni, sağlayıcılar ve ayarlama
|
||||
- [Dreaming](/tr/concepts/dreaming) -- kısa vadeli geri çağırmadan uzun vadeli belleğe arka plan yükseltmesi
|
||||
- [Memory configuration reference](/tr/reference/memory-config) -- tüm yapılandırma seçenekleri
|
||||
- [Compaction](/tr/concepts/compaction) -- Compaction'ın bellekle nasıl etkileşime girdiği
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,28 +1,28 @@
|
||||
---
|
||||
read_when:
|
||||
- Modelleri kendi GPU makinenizden sunmak istiyorsunuz
|
||||
- LM Studio’yu veya OpenAI uyumlu bir proxy’yi yapılandırıyorsunuz
|
||||
- En güvenli yerel model rehberliğine ihtiyacınız var
|
||||
summary: OpenClaw’ı yerel LLM’lerde çalıştırın (LM Studio, vLLM, LiteLLM, özel OpenAI uç noktaları)
|
||||
- LM Studio'yu veya OpenAI uyumlu bir proxy'yi yapılandırıyorsunuz
|
||||
- En güvenli yerel model yönlendirmesine ihtiyacınız var
|
||||
summary: OpenClaw'ı yerel LLM'lerde çalıştırın (LM Studio, vLLM, LiteLLM, özel OpenAI uç noktaları)
|
||||
title: Yerel Modeller
|
||||
x-i18n:
|
||||
generated_at: "2026-04-15T08:53:16Z"
|
||||
generated_at: "2026-04-15T14:40:33Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 8778cc1c623a356ff3cf306c494c046887f9417a70ec71e659e4a8aae912a780
|
||||
source_hash: 7a506ff83e4c2870d3878339f646c906584454a156ecd618c360f592cf3b0011
|
||||
source_path: gateway/local-models.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Yerel modeller
|
||||
|
||||
Yerelde kullanım mümkündür, ancak OpenClaw geniş bağlam + prompt injection’a karşı güçlü savunmalar bekler. Küçük kartlar bağlamı kırpar ve güvenliği sızdırır. Yüksek hedefleyin: **en az 2 tam donanımlı Mac Studio veya eşdeğer GPU sistemi (~30 bin $+)**. Tek bir **24 GB** GPU yalnızca daha hafif prompt’larda ve daha yüksek gecikmeyle işe yarar. Çalıştırabildiğiniz **en büyük / tam boyutlu model varyantını kullanın**; agresif biçimde quantize edilmiş veya “small” checkpoint’ler prompt injection riskini artırır ([Güvenlik](/tr/gateway/security) bölümüne bakın).
|
||||
Yerel kullanım mümkün, ancak OpenClaw büyük bağlam + istem enjeksiyonuna karşı güçlü savunmalar bekler. Küçük kartlar bağlamı kısaltır ve güvenliği zayıflatır. Hedefi yüksek tutun: **en az 2 tam donanımlı Mac Studio veya eşdeğer GPU sistemi (~30 bin $+)**. Tek bir **24 GB** GPU yalnızca daha hafif istemlerde ve daha yüksek gecikmeyle çalışır. Çalıştırabildiğiniz **en büyük / tam boyutlu model varyantını kullanın**; agresif şekilde kuantize edilmiş veya “küçük” checkpoint'ler istem enjeksiyonu riskini artırır (bkz. [Güvenlik](/tr/gateway/security)).
|
||||
|
||||
En az sürtünmeli yerel kurulumu istiyorsanız [LM Studio](/tr/providers/lmstudio) veya [Ollama](/tr/providers/ollama) ile başlayın ve `openclaw onboard` çalıştırın. Bu sayfa, daha üst düzey yerel yığınlar ve özel OpenAI uyumlu yerel sunucular için görüş odaklı rehberdir.
|
||||
En az sürtünmeli yerel kurulum istiyorsanız, [LM Studio](/tr/providers/lmstudio) veya [Ollama](/tr/providers/ollama) ile başlayın ve `openclaw onboard` çalıştırın. Bu sayfa, daha üst düzey yerel yığınlar ve özel OpenAI uyumlu yerel sunucular için görüş odaklı kılavuzdur.
|
||||
|
||||
## Önerilen: LM Studio + büyük yerel model (Responses API)
|
||||
|
||||
Şu anda en iyi yerel yığın. LM Studio’da büyük bir model yükleyin (örneğin tam boyutlu bir Qwen, DeepSeek veya Llama derlemesi), yerel sunucuyu etkinleştirin (varsayılan `http://127.0.0.1:1234`) ve muhakemeyi nihai metinden ayrı tutmak için Responses API kullanın.
|
||||
Şu anda en iyi yerel yığın. LM Studio'da büyük bir model yükleyin (örneğin tam boyutlu bir Qwen, DeepSeek veya Llama derlemesi), yerel sunucuyu etkinleştirin (varsayılan `http://127.0.0.1:1234`) ve akıl yürütmeyi nihai metinden ayrı tutmak için Responses API kullanın.
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -61,14 +61,14 @@ En az sürtünmeli yerel kurulumu istiyorsanız [LM Studio](/tr/providers/lmstud
|
||||
|
||||
**Kurulum kontrol listesi**
|
||||
|
||||
- LM Studio’yu yükleyin: [https://lmstudio.ai](https://lmstudio.ai)
|
||||
- LM Studio’da mevcut **en büyük model derlemesini** indirin (“small”/ağır quantize edilmiş varyantlardan kaçının), sunucuyu başlatın, `http://127.0.0.1:1234/v1/models` adresinin modeli listelediğini doğrulayın.
|
||||
- `my-local-model` değerini, LM Studio’da gösterilen gerçek model kimliğiyle değiştirin.
|
||||
- LM Studio'yu yükleyin: [https://lmstudio.ai](https://lmstudio.ai)
|
||||
- LM Studio'da, **mevcut en büyük model derlemesini** indirin (“small”/yoğun şekilde kuantize edilmiş varyantlardan kaçının), sunucuyu başlatın, `http://127.0.0.1:1234/v1/models` çıktısında listelendiğini doğrulayın.
|
||||
- `my-local-model` değerini, LM Studio'da görünen gerçek model kimliğiyle değiştirin.
|
||||
- Modeli yüklü tutun; soğuk yükleme başlangıç gecikmesi ekler.
|
||||
- LM Studio derlemeniz farklıysa `contextWindow`/`maxTokens` değerlerini ayarlayın.
|
||||
- WhatsApp için yalnızca nihai metnin gönderilmesi amacıyla Responses API kullanın.
|
||||
|
||||
Yerelde çalıştırıyor olsanız bile barındırılan modelleri yapılandırılmış halde tutun; yedeklerin kullanılabilir kalması için `models.mode: "merge"` kullanın.
|
||||
Yerelde çalışırken bile barındırılan modelleri yapılandırılmış halde tutun; yedekler kullanılabilir kalsın diye `models.mode: "merge"` kullanın.
|
||||
|
||||
### Hibrit yapılandırma: barındırılan birincil, yerel yedek
|
||||
|
||||
@ -113,16 +113,16 @@ Yerelde çalıştırıyor olsanız bile barındırılan modelleri yapılandırı
|
||||
|
||||
### Önce yerel, barındırılan güvenlik ağıyla
|
||||
|
||||
Birincil ve yedek sırasını değiştirin; yerel makine kapalıyken Sonnet veya Opus’a geri düşebilmek için aynı provider bloğunu ve `models.mode: "merge"` ayarını koruyun.
|
||||
Birincil ve yedek sırasını değiştirin; yerel makine kapalıyken Sonnet veya Opus'a geri dönebilmek için aynı provider bloğunu ve `models.mode: "merge"` ayarını koruyun.
|
||||
|
||||
### Bölgesel barındırma / veri yönlendirme
|
||||
|
||||
- Barındırılan MiniMax/Kimi/GLM varyantları, bölgeye sabitlenmiş uç noktalarla OpenRouter üzerinde de bulunur (örneğin ABD’de barındırılan). Trafiği seçtiğiniz yargı alanında tutmak için oradaki bölgesel varyantı seçin ve yine Anthropic/OpenAI yedekleri için `models.mode: "merge"` kullanın.
|
||||
- Yalnızca yerel kullanım en güçlü gizlilik yoludur; barındırılan bölgesel yönlendirme ise sağlayıcı özelliklerine ihtiyaç duyduğunuz ama veri akışı üzerinde denetim istediğiniz durumda orta yoldur.
|
||||
- Barındırılan MiniMax/Kimi/GLM varyantları OpenRouter üzerinde de bölgeye sabitlenmiş uç noktalarla bulunur (ör. ABD'de barındırılan). Trafiği seçtiğiniz yargı alanında tutarken Anthropic/OpenAI yedeklerini kullanmaya devam etmek için oradaki bölgesel varyantı seçin ve yine `models.mode: "merge"` kullanın.
|
||||
- Yalnızca yerel kullanım en güçlü gizlilik yoludur; provider özelliklerine ihtiyaç duyup veri akışı üzerinde kontrol istediğinizde barındırılan bölgesel yönlendirme orta yoldur.
|
||||
|
||||
## Diğer OpenAI uyumlu yerel proxy’ler
|
||||
## Diğer OpenAI uyumlu yerel proxy'ler
|
||||
|
||||
vLLM, LiteLLM, OAI-proxy veya özel Gateway’ler, OpenAI tarzı bir `/v1` uç noktası sundukları sürece çalışır. Yukarıdaki provider bloğunu kendi uç noktanız ve model kimliğinizle değiştirin:
|
||||
vLLM, LiteLLM, OAI-proxy veya özel Gateway'ler, OpenAI tarzı bir `/v1` uç noktası sundukları sürece çalışır. Yukarıdaki provider bloğunu kendi uç noktanız ve model kimliğinizle değiştirin:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -150,26 +150,26 @@ vLLM, LiteLLM, OAI-proxy veya özel Gateway’ler, OpenAI tarzı bir `/v1` uç n
|
||||
}
|
||||
```
|
||||
|
||||
Barındırılan modellerin yedek olarak kullanılabilir kalması için `models.mode: "merge"` kullanın.
|
||||
Barındırılan modeller yedek olarak kullanılabilir kalsın diye `models.mode: "merge"` kullanın.
|
||||
|
||||
Yerel/proxy’lenmiş `/v1` arka uçları için davranış notu:
|
||||
Yerel/proxy'lenmiş `/v1` arka uçları için davranış notu:
|
||||
|
||||
- OpenClaw bunları yerel OpenAI uç noktaları olarak değil, proxy tarzı OpenAI uyumlu yollar olarak ele alır
|
||||
- yerel OpenAI’ye özgü istek şekillendirme burada uygulanmaz: `service_tier` yoktur, Responses `store` yoktur, OpenAI reasoning uyumluluk payload şekillendirmesi yoktur ve prompt-cache ipuçları yoktur
|
||||
- gizli OpenClaw atıf başlıkları (`originator`, `version`, `User-Agent`) bu özel proxy URL’lerine eklenmez
|
||||
- OpenClaw bunları yerel OpenAI uç noktaları değil, proxy tarzı OpenAI uyumlu rotalar olarak ele alır
|
||||
- buraya yerel OpenAI'ye özgü istek şekillendirmesi uygulanmaz: `service_tier` yok, Responses `store` yok, OpenAI akıl yürütme uyumluluğu yük şekillendirmesi yok ve istem önbelleği ipuçları yok
|
||||
- gizli OpenClaw ilişkilendirme üstbilgileri (`originator`, `version`, `User-Agent`) bu özel proxy URL'lerine eklenmez
|
||||
|
||||
Daha katı OpenAI uyumlu arka uçlar için uyumluluk notları:
|
||||
|
||||
- Bazı sunucular Chat Completions için yapılandırılmış içerik-parçası dizileri yerine yalnızca string `messages[].content` kabul eder. Bu uç noktalar için `models.providers.<provider>.models[].compat.requiresStringContent: true` ayarlayın.
|
||||
- Bazı daha küçük veya daha katı yerel arka uçlar, özellikle araç şemaları dahil edildiğinde, OpenClaw’ın tam agent-runtime prompt yapısıyla kararsız çalışır. Arka uç küçük doğrudan `/v1/chat/completions` çağrılarında çalışıyor ama normal OpenClaw agent dönüşlerinde başarısız oluyorsa önce `browser`, `cron` ve `message` gibi ağır varsayılan araçları bırakmak için `agents.defaults.localModelMode: "lean"` deneyin; bu da işe yaramazsa `models.providers.<provider>.models[].compat.supportsTools: false` deneyin.
|
||||
- Arka uç yalnızca daha büyük OpenClaw çalıştırmalarında hâlâ başarısız oluyorsa, kalan sorun genellikle OpenClaw’ın taşıma katmanı değil, yukarı akış model/sunucu kapasitesi veya bir arka uç hatasıdır.
|
||||
- Bazı sunucular Chat Completions içinde yapılandırılmış içerik bölümü dizileri yerine yalnızca dize `messages[].content` kabul eder. Bu uç noktalar için `models.providers.<provider>.models[].compat.requiresStringContent: true` ayarlayın.
|
||||
- Daha küçük veya daha katı bazı yerel arka uçlar, özellikle araç şemaları dahil edildiğinde, OpenClaw'ın tam agent-runtime istem biçimiyle kararsız çalışır. Arka uç küçük doğrudan `/v1/chat/completions` çağrılarında çalışıyor ama normal OpenClaw agent dönüşlerinde başarısız oluyorsa, önce `browser`, `cron` ve `message` gibi ağır varsayılan araçları kaldırmak için `agents.defaults.experimental.localModelLean: true` deneyin; bu deneysel bir işarettir, kararlı varsayılan mod ayarı değildir. Bkz. [Deneysel Özellikler](/tr/concepts/experimental-features). Bu da işe yaramazsa `models.providers.<provider>.models[].compat.supportsTools: false` deneyin.
|
||||
- Arka uç yine yalnızca daha büyük OpenClaw çalıştırmalarında başarısız oluyorsa, kalan sorun genellikle OpenClaw'ın taşıma katmanı değil, yukarı akış model/sunucu kapasitesi veya bir arka uç hatasıdır.
|
||||
|
||||
## Sorun giderme
|
||||
|
||||
- Gateway proxy’ye ulaşabiliyor mu? `curl http://127.0.0.1:1234/v1/models`.
|
||||
- LM Studio modeli yüklenmemiş mi? Yeniden yükleyin; soğuk başlangıç yaygın bir “takılı kalma” nedenidir.
|
||||
- OpenClaw, algılanan bağlam penceresi **32k**’nin altındaysa uyarır ve **16k**’nin altındaysa engeller. Bu ön kontrolde takılırsanız, sunucu/model bağlam sınırını yükseltin veya daha büyük bir model seçin.
|
||||
- Gateway proxy'ye ulaşabiliyor mu? `curl http://127.0.0.1:1234/v1/models`.
|
||||
- LM Studio modeli yükten çıkarılmış mı? Yeniden yükleyin; soğuk başlangıç yaygın bir “takılma” nedenidir.
|
||||
- OpenClaw, algılanan bağlam penceresi **32k**'nin altındaysa uyarır ve **16k**'nin altında engeller. Bu ön kontrolde takılırsanız, sunucu/model bağlam sınırını yükseltin veya daha büyük bir model seçin.
|
||||
- Bağlam hataları mı alıyorsunuz? `contextWindow` değerini düşürün veya sunucu sınırınızı yükseltin.
|
||||
- OpenAI uyumlu sunucu `messages[].content ... expected a string` döndürüyor mu? O model girdisine `compat.requiresStringContent: true` ekleyin.
|
||||
- Doğrudan küçük `/v1/chat/completions` çağrıları çalışıyor ama `openclaw infer model run` Gemma’da veya başka bir yerel modelde başarısız mı oluyor? Önce `compat.supportsTools: false` ile araç şemalarını kapatın, sonra yeniden test edin. Sunucu yalnızca daha büyük OpenClaw prompt’larında hâlâ çöküyorsa, bunu yukarı akış sunucu/model sınırlaması olarak değerlendirin.
|
||||
- Güvenlik: yerel modeller sağlayıcı tarafı filtreleri atlar; prompt injection etki alanını sınırlamak için agent’ları dar tutun ve Compaction’ı açık tutun.
|
||||
- Doğrudan küçük `/v1/chat/completions` çağrıları çalışıyor ama `openclaw infer model run` Gemma'da veya başka bir yerel modelde başarısız mı oluyor? Önce `compat.supportsTools: false` ile araç şemalarını devre dışı bırakın, sonra yeniden test edin. Sunucu yine yalnızca daha büyük OpenClaw istemlerinde çöküyorsa, bunu yukarı akış sunucu/model sınırlaması olarak değerlendirin.
|
||||
- Güvenlik: yerel modeller provider tarafı filtreleri atlar; istem enjeksiyonu etki alanını sınırlamak için agent'ları dar tutun ve Compaction açık olsun.
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,40 +1,35 @@
|
||||
---
|
||||
read_when:
|
||||
- GitHub Copilot'u model sağlayıcısı olarak kullanmak istiyorsunuz
|
||||
- GitHub Copilot’u bir model sağlayıcısı olarak kullanmak istiyorsunuz
|
||||
- '`openclaw models auth login-github-copilot` akışına ihtiyacınız var'
|
||||
summary: Cihaz akışını kullanarak OpenClaw içinden GitHub Copilot'ta oturum açın
|
||||
title: GitHub Copilot
|
||||
x-i18n:
|
||||
generated_at: "2026-04-12T23:30:37Z"
|
||||
generated_at: "2026-04-15T14:40:31Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 51fee006e7d4e78e37b0c29356b0090b132de727d99b603441767d3fb642140b
|
||||
source_hash: b8258fecff22fb73b057de878462941f6eb86d0c5f775c5eac4840e95ba5eccf
|
||||
source_path: providers/github-copilot.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# GitHub Copilot
|
||||
|
||||
GitHub Copilot, GitHub'ın AI kodlama yardımcısıdır. GitHub hesabınız ve planınız için Copilot
|
||||
modellerine erişim sağlar. OpenClaw, Copilot'u iki farklı şekilde model
|
||||
sağlayıcısı olarak kullanabilir.
|
||||
GitHub Copilot, GitHub'ın yapay zeka destekli kodlama yardımcısıdır. GitHub hesabınız ve planınız için Copilot modellerine erişim sağlar. OpenClaw, Copilot’u iki farklı şekilde bir model sağlayıcısı olarak kullanabilir.
|
||||
|
||||
## OpenClaw içinde Copilot kullanmanın iki yolu
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Yerleşik sağlayıcı (github-copilot)">
|
||||
Yerel cihaz giriş akışını kullanarak bir GitHub token alın, ardından OpenClaw çalışırken bunu
|
||||
Copilot API token'larıyla değiş tokuş edin. Bu, **varsayılan** ve en basit yoldur
|
||||
çünkü VS Code gerektirmez.
|
||||
Bir GitHub token’ı almak için yerel cihaz oturum açma akışını kullanın, ardından OpenClaw çalıştığında bunu Copilot API token’larıyla değiştirin. Bu **varsayılan** ve en basit yoldur çünkü VS Code gerektirmez.
|
||||
|
||||
<Steps>
|
||||
<Step title="Giriş komutunu çalıştırın">
|
||||
<Step title="Oturum açma komutunu çalıştırın">
|
||||
```bash
|
||||
openclaw models auth login-github-copilot
|
||||
```
|
||||
|
||||
Sizden bir URL'yi ziyaret etmeniz ve tek kullanımlık bir kod girmeniz istenir. Tamamlanana kadar
|
||||
terminali açık tutun.
|
||||
Bir URL’yi ziyaret etmeniz ve tek kullanımlık bir kod girmeniz istenir. İşlem tamamlanana kadar terminali açık tutun.
|
||||
</Step>
|
||||
<Step title="Varsayılan bir model ayarlayın">
|
||||
```bash
|
||||
@ -54,12 +49,10 @@ sağlayıcısı olarak kullanabilir.
|
||||
</Tab>
|
||||
|
||||
<Tab title="Copilot Proxy Plugin (copilot-proxy)">
|
||||
**Copilot Proxy** VS Code uzantısını yerel bir köprü olarak kullanın. OpenClaw,
|
||||
proxy'nin `/v1` uç noktasıyla konuşur ve orada yapılandırdığınız model listesini kullanır.
|
||||
Yerel bir köprü olarak **Copilot Proxy** VS Code uzantısını kullanın. OpenClaw, proxy’nin `/v1` uç noktasıyla konuşur ve orada yapılandırdığınız model listesini kullanır.
|
||||
|
||||
<Note>
|
||||
Bunu, VS Code içinde zaten Copilot Proxy çalıştırıyorsanız veya trafiği onun
|
||||
üzerinden yönlendirmeniz gerekiyorsa seçin. Plugin'i etkinleştirmeniz ve VS Code uzantısını çalışır durumda tutmanız gerekir.
|
||||
Bunu, VS Code içinde zaten Copilot Proxy çalıştırıyorsanız veya trafiği onun üzerinden yönlendirmeniz gerekiyorsa seçin. Plugin’i etkinleştirmeniz ve VS Code uzantısını çalışır durumda tutmanız gerekir.
|
||||
</Note>
|
||||
|
||||
</Tab>
|
||||
@ -67,72 +60,96 @@ sağlayıcısı olarak kullanabilir.
|
||||
|
||||
## İsteğe bağlı bayraklar
|
||||
|
||||
| Bayrak | Açıklama |
|
||||
| -------------- | ---------------------------------------------------- |
|
||||
| `--yes` | Onay istemini atlar |
|
||||
| `--set-default` | Sağlayıcının önerilen varsayılan modelini de uygular |
|
||||
| Bayrak | Açıklama |
|
||||
| --------------- | ------------------------------------------------- |
|
||||
| `--yes` | Onay istemini atla |
|
||||
| `--set-default` | Sağlayıcının önerilen varsayılan modelini de uygula |
|
||||
|
||||
```bash
|
||||
# Onayı atla
|
||||
openclaw models auth login-github-copilot --yes
|
||||
|
||||
# Tek adımda giriş yap ve varsayılan modeli ayarla
|
||||
# Oturum aç ve varsayılan modeli tek adımda ayarla
|
||||
openclaw models auth login --provider github-copilot --method device --set-default
|
||||
```
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Etkileşimli TTY gerekli">
|
||||
Cihaz giriş akışı etkileşimli bir TTY gerektirir. Bunu etkileşimsiz bir betikte veya CI işlem hattında değil,
|
||||
doğrudan bir terminalde çalıştırın.
|
||||
<Accordion title="Etkileşimli TTY gerekir">
|
||||
Cihazla oturum açma akışı etkileşimli bir TTY gerektirir. Bunu etkileşimsiz bir betikte veya CI işlem hattında değil, doğrudan bir terminalde çalıştırın.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Model kullanılabilirliği planınıza bağlıdır">
|
||||
Copilot model kullanılabilirliği GitHub planınıza bağlıdır. Bir model
|
||||
reddedilirse başka bir kimlik deneyin (örneğin `github-copilot/gpt-4.1`).
|
||||
Copilot model kullanılabilirliği GitHub planınıza bağlıdır. Bir model reddedilirse başka bir kimlik deneyin (örneğin `github-copilot/gpt-4.1`).
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Taşıma seçimi">
|
||||
Claude model kimlikleri Anthropic Messages taşımasını otomatik olarak kullanır. GPT,
|
||||
o-serisi ve Gemini modelleri OpenAI Responses taşımasını korur. OpenClaw,
|
||||
model başvurusuna göre doğru taşımayı seçer.
|
||||
Claude model kimlikleri Anthropic Messages taşımasını otomatik olarak kullanır. GPT, o-series ve Gemini modelleri OpenAI Responses taşımasını kullanmaya devam eder. OpenClaw, model başvurusuna göre doğru taşıma türünü seçer.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Ortam değişkeni çözümleme sırası">
|
||||
OpenClaw, Copilot kimlik doğrulamasını ortam değişkenlerinden şu
|
||||
öncelik sırasıyla çözümler:
|
||||
OpenClaw, Copilot kimlik doğrulamasını aşağıdaki öncelik sırasına göre ortam değişkenlerinden çözümler:
|
||||
|
||||
| Öncelik | Değişken | Notlar |
|
||||
| -------- | --------------------- | ---------------------------------- |
|
||||
| 1 | `COPILOT_GITHUB_TOKEN` | En yüksek öncelik, Copilot'a özgü |
|
||||
| 2 | `GH_TOKEN` | GitHub CLI token'ı (yedek) |
|
||||
| 3 | `GITHUB_TOKEN` | Standart GitHub token'ı (en düşük) |
|
||||
| 1 | `COPILOT_GITHUB_TOKEN` | En yüksek öncelik, Copilot’a özel |
|
||||
| 2 | `GH_TOKEN` | GitHub CLI token’ı (yedek) |
|
||||
| 3 | `GITHUB_TOKEN` | Standart GitHub token’ı (en düşük) |
|
||||
|
||||
Birden fazla değişken ayarlandığında OpenClaw en yüksek öncelikli olanı kullanır.
|
||||
Cihaz giriş akışı (`openclaw models auth login-github-copilot`),
|
||||
token'ını kimlik doğrulama profil deposunda saklar ve tüm ortam
|
||||
değişkenlerinden önceliklidir.
|
||||
Cihazla oturum açma akışı (`openclaw models auth login-github-copilot`), token’ını auth profil deposunda saklar ve tüm ortam değişkenlerinden önceliklidir.
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Token depolama">
|
||||
Giriş, bir GitHub token'ını kimlik doğrulama profil deposunda saklar ve OpenClaw çalışırken bunu
|
||||
bir Copilot API token'ıyla değiş tokuş eder. Token'ı
|
||||
elle yönetmeniz gerekmez.
|
||||
Oturum açma işlemi bir GitHub token’ını auth profil deposunda saklar ve OpenClaw çalıştığında bunu bir Copilot API token’ı ile değiştirir. Token’ı elle yönetmeniz gerekmez.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
<Warning>
|
||||
Etkileşimli bir TTY gerektirir. Giriş komutunu __OC_I18N_900000__ doğrudan bir terminalde çalıştırın,
|
||||
headless bir betik veya CI işi içinde değil.
|
||||
Etkileşimli bir TTY gerekir. Oturum açma komutunu headless bir betik veya CI işi içinde değil, doğrudan bir terminalde çalıştırın.
|
||||
</Warning>
|
||||
|
||||
## Bellek arama gömmeleri
|
||||
|
||||
GitHub Copilot, [bellek araması](/tr/concepts/memory-search) için bir gömme sağlayıcısı olarak da kullanılabilir. Bir Copilot aboneliğiniz varsa ve oturum açtıysanız OpenClaw, ayrı bir API anahtarı olmadan bunu gömmeler için kullanabilir.
|
||||
|
||||
### Otomatik algılama
|
||||
|
||||
`memorySearch.provider` değeri `"auto"` olduğunda (varsayılan), GitHub Copilot öncelik 15 ile denenir -- yerel gömmelerden sonra, ancak OpenAI ve diğer ücretli sağlayıcılardan önce. Bir GitHub token’ı mevcutsa OpenClaw, Copilot API’sinden kullanılabilir gömme modellerini keşfeder ve en iyisini otomatik olarak seçer.
|
||||
|
||||
### Açık yapılandırma
|
||||
|
||||
```json5
|
||||
{
|
||||
agents: {
|
||||
defaults: {
|
||||
memorySearch: {
|
||||
provider: "github-copilot",
|
||||
// İsteğe bağlı: otomatik keşfedilen modeli geçersiz kıl
|
||||
model: "text-embedding-3-small",
|
||||
},
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
### Nasıl çalışır
|
||||
|
||||
1. OpenClaw GitHub token’ınızı çözümler (ortam değişkenlerinden veya auth profilinden).
|
||||
2. Bunu kısa ömürlü bir Copilot API token’ı ile değiştirir.
|
||||
3. Kullanılabilir gömme modellerini keşfetmek için Copilot `/models` uç noktasını sorgular.
|
||||
4. En iyi modeli seçer (`text-embedding-3-small` tercih edilir).
|
||||
5. Gömme isteklerini Copilot `/embeddings` uç noktasına gönderir.
|
||||
|
||||
Model kullanılabilirliği GitHub planınıza bağlıdır. Hiç gömme modeli yoksa OpenClaw, Copilot’u atlar ve bir sonraki sağlayıcıyı dener.
|
||||
|
||||
## İlgili
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Model seçimi" href="/tr/concepts/model-providers" icon="layers">
|
||||
Sağlayıcıları, model başvurularını ve devralma davranışını seçme.
|
||||
Sağlayıcıları, model başvurularını ve yük devretme davranışını seçme.
|
||||
</Card>
|
||||
<Card title="OAuth ve kimlik doğrulama" href="/tr/gateway/authentication" icon="key">
|
||||
Kimlik doğrulama ayrıntıları ve kimlik bilgisi yeniden kullanma kuralları.
|
||||
Kimlik doğrulama ayrıntıları ve kimlik bilgisi yeniden kullanım kuralları.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
@ -1,24 +1,24 @@
|
||||
---
|
||||
read_when:
|
||||
- OpenClaw’ı Ollama üzerinden cloud veya yerel modellerle çalıştırmak istiyorsunuz
|
||||
- Ollama kurulumu ve yapılandırma rehberine ihtiyacınız var
|
||||
summary: OpenClaw’ı Ollama ile çalıştırın (cloud ve yerel modeller)
|
||||
- OpenClaw’ı Ollama üzerinden bulut veya yerel modellerle çalıştırmak istiyorsunuz
|
||||
- Ollama kurulum ve yapılandırma rehberine ihtiyacınız var
|
||||
summary: OpenClaw’ı Ollama ile çalıştırın (bulut ve yerel modeller)
|
||||
title: Ollama
|
||||
x-i18n:
|
||||
generated_at: "2026-04-12T23:31:57Z"
|
||||
generated_at: "2026-04-15T14:40:56Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: ec796241b884ca16ec7077df4f3f1910e2850487bb3ea94f8fdb37c77e02b219
|
||||
source_hash: 098e083e0fc484bddb5270eb630c55d7832039b462d1710372b6afece5cefcdf
|
||||
source_path: providers/ollama.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Ollama
|
||||
|
||||
Ollama, makinenizde açık kaynak modelleri çalıştırmayı kolaylaştıran yerel bir LLM çalışma zamanıdır. OpenClaw, Ollama’nın yerel API’siyle (`/api/chat`) bütünleşir, akışı ve araç çağırmayı destekler ve `OLLAMA_API_KEY` (veya bir kimlik doğrulama profili) ile açıkça bir `models.providers.ollama` girdisi tanımlamadığınızda yerel Ollama modellerini otomatik keşfedebilir.
|
||||
OpenClaw, barındırılan bulut modelleri ve yerel/kendi barındırdığınız Ollama sunucuları için Ollama’nın yerel API’si (`/api/chat`) ile entegre olur. Ollama’yı üç modda kullanabilirsiniz: erişilebilir bir Ollama ana makinesi üzerinden `Bulut + Yerel`, `https://ollama.com` karşısında `Yalnızca Bulut` veya erişilebilir bir Ollama ana makinesi karşısında `Yalnızca Yerel`.
|
||||
|
||||
<Warning>
|
||||
**Uzak Ollama kullanıcıları**: OpenClaw ile `/v1` OpenAI uyumlu URL’yi (`http://host:11434/v1`) kullanmayın. Bu, araç çağırmayı bozar ve modeller düz metin olarak ham araç JSON’u üretebilir. Bunun yerine yerel Ollama API URL’sini kullanın: `baseUrl: "http://host:11434"` (`/v1` olmadan).
|
||||
**Uzak Ollama kullanıcıları**: OpenClaw ile `/v1` OpenAI uyumlu URL’yi (`http://host:11434/v1`) kullanmayın. Bu, araç çağırmayı bozar ve modeller ham araç JSON’unu düz metin olarak çıkarabilir. Bunun yerine yerel Ollama API URL’sini kullanın: `baseUrl: "http://host:11434"` (`/v1` olmadan).
|
||||
</Warning>
|
||||
|
||||
## Başlarken
|
||||
@ -26,27 +26,26 @@ Ollama, makinenizde açık kaynak modelleri çalıştırmayı kolaylaştıran ye
|
||||
Tercih ettiğiniz kurulum yöntemini ve modu seçin.
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Onboarding (önerilir)">
|
||||
**En uygunu:** otomatik model keşfiyle çalışan bir Ollama kurulumu için en hızlı yol.
|
||||
<Tab title="İlk kurulum (önerilen)">
|
||||
**Şunun için en iyisi:** çalışan bir Ollama bulut veya yerel kurulumuna en hızlı yol.
|
||||
|
||||
<Steps>
|
||||
<Step title="Onboarding'i çalıştırın">
|
||||
<Step title="İlk kurulumu çalıştırın">
|
||||
```bash
|
||||
openclaw onboard
|
||||
```
|
||||
|
||||
Provider listesinden **Ollama** seçin.
|
||||
Sağlayıcı listesinden **Ollama** seçin.
|
||||
</Step>
|
||||
<Step title="Modunuzu seçin">
|
||||
- **Cloud + Local** — cloud barındırılan modeller ve yerel modeller birlikte
|
||||
- **Local** — yalnızca yerel modeller
|
||||
|
||||
**Cloud + Local** seçerseniz ve ollama.com üzerinde oturum açmamışsanız, onboarding tarayıcıda bir oturum açma akışı açar.
|
||||
- **Bulut + Yerel** — yerel Ollama ana makinesi artı bu ana makine üzerinden yönlendirilen bulut modelleri
|
||||
- **Yalnızca Bulut** — `https://ollama.com` üzerinden barındırılan Ollama modelleri
|
||||
- **Yalnızca Yerel** — yalnızca yerel modeller
|
||||
</Step>
|
||||
<Step title="Bir model seçin">
|
||||
Onboarding, kullanılabilir modelleri keşfeder ve varsayılanlar önerir. Seçilen model yerelde mevcut değilse otomatik olarak çeker.
|
||||
`Yalnızca Bulut`, `OLLAMA_API_KEY` ister ve barındırılan bulut varsayılanlarını önerir. `Bulut + Yerel` ve `Yalnızca Yerel`, bir Ollama temel URL’si ister, kullanılabilir modelleri keşfeder ve seçilen yerel model henüz mevcut değilse bunu otomatik olarak çeker. `Bulut + Yerel`, ayrıca o Ollama ana makinesinin bulut erişimi için oturum açıp açmadığını da denetler.
|
||||
</Step>
|
||||
<Step title="Modelin kullanılabildiğini doğrulayın">
|
||||
<Step title="Modelin kullanılabilir olduğunu doğrulayın">
|
||||
```bash
|
||||
openclaw models list --provider ollama
|
||||
```
|
||||
@ -61,7 +60,7 @@ Tercih ettiğiniz kurulum yöntemini ve modu seçin.
|
||||
--accept-risk
|
||||
```
|
||||
|
||||
İsteğe bağlı olarak özel bir base URL veya model belirtebilirsiniz:
|
||||
İsteğe bağlı olarak özel bir temel URL veya model belirtebilirsiniz:
|
||||
|
||||
```bash
|
||||
openclaw onboard --non-interactive \
|
||||
@ -74,13 +73,15 @@ Tercih ettiğiniz kurulum yöntemini ve modu seçin.
|
||||
</Tab>
|
||||
|
||||
<Tab title="Elle kurulum">
|
||||
**En uygunu:** kurulum, model çekme ve yapılandırma üzerinde tam kontrol.
|
||||
**Şunun için en iyisi:** bulut veya yerel kurulum üzerinde tam denetim.
|
||||
|
||||
<Steps>
|
||||
<Step title="Ollama'yı kurun">
|
||||
[ollama.com/download](https://ollama.com/download) adresinden indirin.
|
||||
<Step title="Bulut veya yereli seçin">
|
||||
- **Bulut + Yerel**: Ollama’yı kurun, `ollama signin` ile oturum açın ve bulut isteklerini bu ana makine üzerinden yönlendirin
|
||||
- **Yalnızca Bulut**: `https://ollama.com` adresini bir `OLLAMA_API_KEY` ile kullanın
|
||||
- **Yalnızca Yerel**: Ollama’yı [ollama.com/download](https://ollama.com/download) adresinden kurun
|
||||
</Step>
|
||||
<Step title="Yerel bir model çekin">
|
||||
<Step title="Yerel bir modeli çekin (yalnızca yerel)">
|
||||
```bash
|
||||
ollama pull gemma4
|
||||
# veya
|
||||
@ -89,22 +90,18 @@ Tercih ettiğiniz kurulum yöntemini ve modu seçin.
|
||||
ollama pull llama3.3
|
||||
```
|
||||
</Step>
|
||||
<Step title="Cloud modeller için oturum açın (isteğe bağlı)">
|
||||
Cloud modelleri de istiyorsanız:
|
||||
<Step title="OpenClaw için Ollama’yı etkinleştirin">
|
||||
`Yalnızca Bulut` için gerçek `OLLAMA_API_KEY` değerinizi kullanın. Ana makine destekli kurulumlarda herhangi bir yer tutucu değer işe yarar:
|
||||
|
||||
```bash
|
||||
ollama signin
|
||||
```
|
||||
</Step>
|
||||
<Step title="OpenClaw için Ollama'yı etkinleştirin">
|
||||
API anahtarı için herhangi bir değer ayarlayın (Ollama gerçek bir anahtar gerektirmez):
|
||||
# Bulut
|
||||
export OLLAMA_API_KEY="your-ollama-api-key"
|
||||
|
||||
```bash
|
||||
# Ortam değişkeni ayarlayın
|
||||
# Yalnızca yerel
|
||||
export OLLAMA_API_KEY="ollama-local"
|
||||
|
||||
# Veya yapılandırma dosyanızda ayarlayın
|
||||
openclaw config set models.providers.ollama.apiKey "ollama-local"
|
||||
# Veya yapılandırma dosyanızda yapılandırın
|
||||
openclaw config set models.providers.ollama.apiKey "OLLAMA_API_KEY"
|
||||
```
|
||||
</Step>
|
||||
<Step title="Modelinizi inceleyin ve ayarlayın">
|
||||
@ -130,56 +127,61 @@ Tercih ettiğiniz kurulum yöntemini ve modu seçin.
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
## Cloud modeller
|
||||
## Bulut modelleri
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Cloud + Local">
|
||||
Cloud modeller, yerel modellerinizin yanında cloud barındırılan modelleri çalıştırmanıza olanak tanır. Örnekler arasında `kimi-k2.5:cloud`, `minimax-m2.7:cloud` ve `glm-5.1:cloud` bulunur -- bunlar yerel bir `ollama pull` gerektirmez.
|
||||
<Tab title="Bulut + Yerel">
|
||||
`Bulut + Yerel`, hem yerel hem de bulut modelleri için denetim noktası olarak erişilebilir bir Ollama ana makinesi kullanır. Bu, Ollama’nın tercih ettiği hibrit akıştır.
|
||||
|
||||
Kurulum sırasında **Cloud + Local** modunu seçin. Sihirbaz, oturum açıp açmadığınızı denetler ve gerektiğinde tarayıcıda bir oturum açma akışı açar. Kimlik doğrulama doğrulanamazsa sihirbaz yerel model varsayılanlarına geri döner.
|
||||
Kurulum sırasında **Bulut + Yerel** seçeneğini kullanın. OpenClaw, Ollama temel URL’sini ister, o ana makineden yerel modelleri keşfeder ve ana makinenin `ollama signin` ile bulut erişimi için oturum açıp açmadığını denetler. Ana makine oturum açmışsa OpenClaw ayrıca `kimi-k2.5:cloud`, `minimax-m2.7:cloud` ve `glm-5.1:cloud` gibi barındırılan bulut varsayılanlarını da önerir.
|
||||
|
||||
Doğrudan [ollama.com/signin](https://ollama.com/signin) adresinden de oturum açabilirsiniz.
|
||||
|
||||
OpenClaw şu anda şu cloud varsayılanlarını önerir: `kimi-k2.5:cloud`, `minimax-m2.7:cloud`, `glm-5.1:cloud`.
|
||||
Ana makine henüz oturum açmadıysa OpenClaw, siz `ollama signin` çalıştırana kadar kurulumu yalnızca yerel olarak tutar.
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Yalnızca yerel">
|
||||
Yalnızca yerel modda OpenClaw, modelleri yerel Ollama örneğinden keşfeder. Cloud oturum açma gerekmez.
|
||||
<Tab title="Yalnızca Bulut">
|
||||
`Yalnızca Bulut`, Ollama’nın `https://ollama.com` adresindeki barındırılan API’sine karşı çalışır.
|
||||
|
||||
Kurulum sırasında **Yalnızca Bulut** seçeneğini kullanın. OpenClaw, `OLLAMA_API_KEY` ister, `baseUrl: "https://ollama.com"` ayarlar ve barındırılan bulut model listesini tohumlar. Bu yol, yerel bir Ollama sunucusu veya `ollama signin` gerektirmez.
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Yalnızca Yerel">
|
||||
Yalnızca yerel modda OpenClaw, yapılandırılmış Ollama örneğinden modelleri keşfeder. Bu yol, yerel veya kendi barındırdığınız Ollama sunucuları içindir.
|
||||
|
||||
OpenClaw şu anda yerel varsayılan olarak `gemma4` önerir.
|
||||
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
## Model keşfi (örtük provider)
|
||||
## Model keşfi (örtük sağlayıcı)
|
||||
|
||||
`OLLAMA_API_KEY` (veya bir kimlik doğrulama profili) ayarladığınızda ve **`models.providers.ollama` tanımlamadığınızda**, OpenClaw modelleri `http://127.0.0.1:11434` adresindeki yerel Ollama örneğinden keşfeder.
|
||||
`OLLAMA_API_KEY` (veya bir auth profili) ayarladığınızda ve `models.providers.ollama` tanımlamadığınızda, OpenClaw modelleri `http://127.0.0.1:11434` adresindeki yerel Ollama örneğinden keşfeder.
|
||||
|
||||
| Davranış | Ayrıntı |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| Katalog sorgusu | `/api/tags` sorgular |
|
||||
| Yetenek algılama | `contextWindow` değerini okumak ve yetenekleri (görsel dahil) algılamak için en iyi çaba ile `/api/show` aramaları kullanır |
|
||||
| Görsel modeller | `/api/show` tarafından bildirilen `vision` yeteneğine sahip modeller, görsel destekli (`input: ["text", "image"]`) olarak işaretlenir; böylece OpenClaw görselleri prompt’a otomatik enjekte eder |
|
||||
| Akıl yürütme algılama | `reasoning` özelliğini bir model adı sezgisiyle (`r1`, `reasoning`, `think`) işaretler |
|
||||
| Token sınırları | `maxTokens` değerini, OpenClaw’ın kullandığı varsayılan Ollama maksimum token sınırına ayarlar |
|
||||
| Maliyetler | Tüm maliyetleri `0` olarak ayarlar |
|
||||
| Davranış | Ayrıntı |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Katalog sorgusu | `/api/tags` sorgulanır |
|
||||
| Yetenek algılama | `contextWindow` değerini okumak ve yetenekleri (vision dahil) algılamak için en iyi çabayla `/api/show` aramaları kullanır |
|
||||
| Vision modelleri | `/api/show` tarafından bildirilen `vision` yeteneğine sahip modeller görüntü destekli olarak işaretlenir (`input: ["text", "image"]`), böylece OpenClaw görüntüleri isteme otomatik ekler |
|
||||
| Akıl yürütme algılama | Model adı kestirimiyle `reasoning` işaretlenir (`r1`, `reasoning`, `think`) |
|
||||
| Token sınırları | `maxTokens`, OpenClaw tarafından kullanılan varsayılan Ollama en yüksek token sınırına ayarlanır |
|
||||
| Maliyetler | Tüm maliyetler `0` olarak ayarlanır |
|
||||
|
||||
Bu, kataloğu yerel Ollama örneğiyle uyumlu tutarken manuel model girdilerinden kaçınmanızı sağlar.
|
||||
Bu, kataloğu yerel Ollama örneğiyle uyumlu tutarken elle model girişi yapmaktan kaçınır.
|
||||
|
||||
```bash
|
||||
# Hangi modellerin kullanılabildiğini görün
|
||||
# Hangi modellerin kullanılabilir olduğunu görün
|
||||
ollama list
|
||||
openclaw models list
|
||||
```
|
||||
|
||||
Yeni bir model eklemek için onu Ollama ile çekmeniz yeterlidir:
|
||||
Yeni bir model eklemek için bunu Ollama ile çekmeniz yeterlidir:
|
||||
|
||||
```bash
|
||||
ollama pull mistral
|
||||
```
|
||||
|
||||
Yeni model otomatik olarak keşfedilecek ve kullanılabilir olacaktır.
|
||||
Yeni model otomatik olarak keşfedilir ve kullanıma sunulur.
|
||||
|
||||
<Note>
|
||||
`models.providers.ollama` değerini açıkça ayarlarsanız otomatik keşif atlanır ve modelleri elle tanımlamanız gerekir. Aşağıdaki açık yapılandırma bölümüne bakın.
|
||||
@ -189,38 +191,38 @@ Yeni model otomatik olarak keşfedilecek ve kullanılabilir olacaktır.
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Temel (örtük keşif)">
|
||||
Ollama’yı etkinleştirmenin en basit yolu ortam değişkenidir:
|
||||
En basit yalnızca yerel etkinleştirme yolu ortam değişkeni kullanmaktır:
|
||||
|
||||
```bash
|
||||
export OLLAMA_API_KEY="ollama-local"
|
||||
```
|
||||
|
||||
<Tip>
|
||||
`OLLAMA_API_KEY` ayarlanmışsa provider girdisinde `apiKey` alanını atlayabilirsiniz; OpenClaw bunu kullanılabilirlik kontrolleri için doldurur.
|
||||
`OLLAMA_API_KEY` ayarlıysa, sağlayıcı girişinde `apiKey` değerini atlayabilirsiniz ve OpenClaw bunu kullanılabilirlik denetimleri için doldurur.
|
||||
</Tip>
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Açık (elle modeller)">
|
||||
Ollama başka bir host/port üzerinde çalışıyorsa, belirli bağlam pencerelerini veya model listelerini zorlamak istiyorsanız ya da tamamen manuel model tanımları istiyorsanız açık yapılandırma kullanın.
|
||||
Barındırılan bulut kurulumu istediğinizde, Ollama başka bir ana makinede/bağlantı noktasında çalıştığında, belirli bağlam pencerelerini veya model listelerini zorlamak istediğinizde ya da tamamen elle model tanımları istediğinizde açık yapılandırmayı kullanın.
|
||||
|
||||
```json5
|
||||
{
|
||||
models: {
|
||||
providers: {
|
||||
ollama: {
|
||||
baseUrl: "http://ollama-host:11434",
|
||||
apiKey: "ollama-local",
|
||||
baseUrl: "https://ollama.com",
|
||||
apiKey: "OLLAMA_API_KEY",
|
||||
api: "ollama",
|
||||
models: [
|
||||
{
|
||||
id: "gpt-oss:20b",
|
||||
name: "GPT-OSS 20B",
|
||||
id: "kimi-k2.5:cloud",
|
||||
name: "kimi-k2.5:cloud",
|
||||
reasoning: false,
|
||||
input: ["text"],
|
||||
input: ["text", "image"],
|
||||
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
|
||||
contextWindow: 8192,
|
||||
maxTokens: 8192 * 10
|
||||
contextWindow: 128000,
|
||||
maxTokens: 8192
|
||||
}
|
||||
]
|
||||
}
|
||||
@ -231,8 +233,8 @@ Yeni model otomatik olarak keşfedilecek ve kullanılabilir olacaktır.
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Özel base URL">
|
||||
Ollama farklı bir host veya portta çalışıyorsa (açık yapılandırma otomatik keşfi devre dışı bırakır, bu nedenle modelleri elle tanımlayın):
|
||||
<Tab title="Özel temel URL">
|
||||
Ollama farklı bir ana makinede veya bağlantı noktasında çalışıyorsa (açık yapılandırma otomatik keşfi devre dışı bırakır, bu yüzden modelleri elle tanımlayın):
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -240,7 +242,7 @@ Yeni model otomatik olarak keşfedilecek ve kullanılabilir olacaktır.
|
||||
providers: {
|
||||
ollama: {
|
||||
apiKey: "ollama-local",
|
||||
baseUrl: "http://ollama-host:11434", // /v1 yok - yerel Ollama API URL'sini kullanın
|
||||
baseUrl: "http://ollama-host:11434", // /v1 yok - yerel Ollama API URL’sini kullanın
|
||||
api: "ollama", // Yerel araç çağırma davranışını garanti etmek için açıkça ayarlayın
|
||||
},
|
||||
},
|
||||
@ -249,7 +251,7 @@ Yeni model otomatik olarak keşfedilecek ve kullanılabilir olacaktır.
|
||||
```
|
||||
|
||||
<Warning>
|
||||
URL’ye `/v1` eklemeyin. `/v1` yolu, araç çağırmanın güvenilir olmadığı OpenAI uyumlu modu kullanır. Yol son eki olmayan temel Ollama URL’sini kullanın.
|
||||
URL’ye `/v1` eklemeyin. `/v1` yolu, araç çağırmanın güvenilir olmadığı OpenAI uyumlu modu kullanır. Yol son eki olmadan temel Ollama URL’sini kullanın.
|
||||
</Warning>
|
||||
|
||||
</Tab>
|
||||
@ -274,13 +276,13 @@ Yapılandırıldıktan sonra tüm Ollama modelleriniz kullanılabilir olur:
|
||||
|
||||
## Ollama Web Search
|
||||
|
||||
OpenClaw, paketli bir `web_search` provider olarak **Ollama Web Search** destekler.
|
||||
OpenClaw, paketlenmiş bir `web_search` sağlayıcısı olarak **Ollama Web Search** destekler.
|
||||
|
||||
| Özellik | Ayrıntı |
|
||||
| ----------- | ------------------------------------------------------------------------------------------------------------------ |
|
||||
| Host | Yapılandırılmış Ollama host’unuzu kullanır (`models.providers.ollama.baseUrl` ayarlıysa onu, aksi halde `http://127.0.0.1:11434`) |
|
||||
| Kimlik doğrulama | Anahtarsız |
|
||||
| Gereksinim | Ollama çalışıyor olmalı ve `ollama signin` ile oturum açılmış olmalı |
|
||||
| Özellik | Ayrıntı |
|
||||
| ----------- | ----------------------------------------------------------------------------------------------------------------- |
|
||||
| Ana makine | Yapılandırılmış Ollama ana makinenizi kullanır (`models.providers.ollama.baseUrl` ayarlıysa o, aksi takdirde `http://127.0.0.1:11434`) |
|
||||
| Kimlik doğrulama | Anahtarsız |
|
||||
| Gereksinim | Ollama çalışıyor olmalı ve `ollama signin` ile oturum açılmış olmalı |
|
||||
|
||||
`openclaw onboard` veya `openclaw configure --section web` sırasında **Ollama Web Search** seçin ya da şunu ayarlayın:
|
||||
|
||||
@ -297,7 +299,7 @@ OpenClaw, paketli bir `web_search` provider olarak **Ollama Web Search** destekl
|
||||
```
|
||||
|
||||
<Note>
|
||||
Tam kurulum ve davranış ayrıntıları için bkz. [Ollama Web Search](/tr/tools/ollama-search).
|
||||
Tam kurulum ve davranış ayrıntıları için [Ollama Web Search](/tr/tools/ollama-search) bölümüne bakın.
|
||||
</Note>
|
||||
|
||||
## Gelişmiş yapılandırma
|
||||
@ -305,10 +307,10 @@ Tam kurulum ve davranış ayrıntıları için bkz. [Ollama Web Search](/tr/tool
|
||||
<AccordionGroup>
|
||||
<Accordion title="Eski OpenAI uyumlu mod">
|
||||
<Warning>
|
||||
**Araç çağırma, OpenAI uyumlu modda güvenilir değildir.** Bu modu yalnızca bir proxy için OpenAI biçimine ihtiyacınız varsa ve yerel araç çağırma davranışına bağımlı değilseniz kullanın.
|
||||
**Araç çağırma, OpenAI uyumlu modda güvenilir değildir.** Bu modu yalnızca bir proxy için OpenAI biçimine ihtiyaç duyuyorsanız ve yerel araç çağırma davranışına bağımlı değilseniz kullanın.
|
||||
</Warning>
|
||||
|
||||
Bunun yerine OpenAI uyumlu uç noktayı kullanmanız gerekiyorsa (örneğin yalnızca OpenAI biçimini destekleyen bir proxy arkasında), `api: "openai-completions"` değerini açıkça ayarlayın:
|
||||
Bunun yerine OpenAI uyumlu uç noktayı kullanmanız gerekiyorsa (örneğin yalnızca OpenAI biçimini destekleyen bir proxy’nin arkasında), `api: "openai-completions"` değerini açıkça ayarlayın:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -326,9 +328,9 @@ Tam kurulum ve davranış ayrıntıları için bkz. [Ollama Web Search](/tr/tool
|
||||
}
|
||||
```
|
||||
|
||||
Bu mod, akışı ve araç çağırmayı aynı anda desteklemeyebilir. Model yapılandırmasında `params: { streaming: false }` ile akışı devre dışı bırakmanız gerekebilir.
|
||||
Bu mod akış ve araç çağırmayı aynı anda desteklemeyebilir. Model yapılandırmasında `params: { streaming: false }` ile akışı devre dışı bırakmanız gerekebilir.
|
||||
|
||||
`api: "openai-completions"` Ollama ile kullanıldığında OpenClaw varsayılan olarak `options.num_ctx` enjekte eder; böylece Ollama sessizce 4096 bağlam penceresine geri dönmez. Proxy/yukarı akış bilinmeyen `options` alanlarını reddediyorsa bu davranışı devre dışı bırakın:
|
||||
`api: "openai-completions"` Ollama ile kullanıldığında OpenClaw, Ollama’nın sessizce 4096 bağlam penceresine geri dönmemesi için varsayılan olarak `options.num_ctx` ekler. Proxy’niz/yukarı akışınız bilinmeyen `options` alanlarını reddediyorsa bu davranışı devre dışı bırakın:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -349,9 +351,9 @@ Tam kurulum ve davranış ayrıntıları için bkz. [Ollama Web Search](/tr/tool
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Bağlam pencereleri">
|
||||
Otomatik keşfedilen modeller için OpenClaw, mevcutsa Ollama tarafından bildirilen bağlam penceresini kullanır; aksi halde OpenClaw’ın kullandığı varsayılan Ollama bağlam penceresine geri döner.
|
||||
Otomatik olarak keşfedilen modeller için OpenClaw, varsa Ollama tarafından bildirilen bağlam penceresini kullanır; aksi takdirde OpenClaw tarafından kullanılan varsayılan Ollama bağlam penceresine geri döner.
|
||||
|
||||
Açık provider yapılandırmasında `contextWindow` ve `maxTokens` değerlerini geçersiz kılabilirsiniz:
|
||||
`contextWindow` ve `maxTokens` değerlerini açık sağlayıcı yapılandırmasında geçersiz kılabilirsiniz:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -374,7 +376,7 @@ Tam kurulum ve davranış ayrıntıları için bkz. [Ollama Web Search](/tr/tool
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Akıl yürütme modelleri">
|
||||
OpenClaw, `deepseek-r1`, `reasoning` veya `think` gibi adlara sahip modelleri varsayılan olarak akıl yürütme yetenekli kabul eder.
|
||||
OpenClaw, varsayılan olarak `deepseek-r1`, `reasoning` veya `think` gibi adlara sahip modelleri akıl yürütme yetenekli olarak kabul eder.
|
||||
|
||||
```bash
|
||||
ollama pull deepseek-r1:32b
|
||||
@ -385,20 +387,18 @@ Tam kurulum ve davranış ayrıntıları için bkz. [Ollama Web Search](/tr/tool
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Model maliyetleri">
|
||||
Ollama ücretsizdir ve yerelde çalışır; bu nedenle tüm model maliyetleri $0 olarak ayarlanır. Bu hem otomatik keşfedilen hem de elle tanımlanan modeller için geçerlidir.
|
||||
Ollama ücretsizdir ve yerelde çalışır, bu nedenle tüm model maliyetleri $0 olarak ayarlanır. Bu, hem otomatik olarak keşfedilen hem de elle tanımlanan modeller için geçerlidir.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Bellek embedding'leri">
|
||||
Paketli Ollama Plugin’i,
|
||||
[memory search](/tr/concepts/memory) için bir bellek embedding provider’ı kaydeder. Yapılandırılmış Ollama base URL’sini
|
||||
ve API anahtarını kullanır.
|
||||
<Accordion title="Bellek gömmeleri">
|
||||
Paketlenmiş Ollama Plugin, [bellek araması](/tr/concepts/memory) için bir bellek gömme sağlayıcısı kaydeder. Yapılandırılmış Ollama temel URL’sini ve API anahtarını kullanır.
|
||||
|
||||
| Özellik | Değer |
|
||||
| ------------- | ------------------- |
|
||||
| Varsayılan model | `nomic-embed-text` |
|
||||
| Otomatik çekme | Evet — embedding modeli yerelde yoksa otomatik olarak çekilir |
|
||||
| Otomatik çekme | Evet — gömme modeli yerelde mevcut değilse otomatik olarak çekilir |
|
||||
|
||||
Ollama’yı memory search embedding provider’ı olarak seçmek için:
|
||||
Ollama’yı bellek arama gömme sağlayıcısı olarak seçmek için:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -413,7 +413,7 @@ Tam kurulum ve davranış ayrıntıları için bkz. [Ollama Web Search](/tr/tool
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Akış yapılandırması">
|
||||
OpenClaw’ın Ollama bütünleşmesi varsayılan olarak **yerel Ollama API’sini** (`/api/chat`) kullanır; bu API aynı anda hem akışı hem de araç çağırmayı tam olarak destekler. Özel bir yapılandırma gerekmez.
|
||||
OpenClaw’ın Ollama entegrasyonu varsayılan olarak **yerel Ollama API’sini** (`/api/chat`) kullanır; bu, akış ve araç çağırmayı aynı anda tam olarak destekler. Özel bir yapılandırma gerekmez.
|
||||
|
||||
<Tip>
|
||||
OpenAI uyumlu uç noktayı kullanmanız gerekiyorsa yukarıdaki "Eski OpenAI uyumlu mod" bölümüne bakın. Bu modda akış ve araç çağırma aynı anda çalışmayabilir.
|
||||
@ -426,7 +426,7 @@ Tam kurulum ve davranış ayrıntıları için bkz. [Ollama Web Search](/tr/tool
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Ollama algılanmadı">
|
||||
Ollama’nın çalıştığından, `OLLAMA_API_KEY` (veya bir kimlik doğrulama profili) ayarladığınızdan ve açık bir `models.providers.ollama` girdisi tanımlamadığınızdan **emin olun**:
|
||||
Ollama’nın çalıştığından, `OLLAMA_API_KEY` (veya bir auth profili) ayarladığınızdan ve açık bir `models.providers.ollama` girdisi tanımlamadığınızdan emin olun:
|
||||
|
||||
```bash
|
||||
ollama serve
|
||||
@ -441,10 +441,10 @@ Tam kurulum ve davranış ayrıntıları için bkz. [Ollama Web Search](/tr/tool
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Kullanılabilir model yok">
|
||||
Modeliniz listelenmiyorsa, modeli ya yerelde çekin ya da `models.providers.ollama` içinde açıkça tanımlayın.
|
||||
Modeliniz listelenmiyorsa modeli ya yerelde çekin ya da `models.providers.ollama` içinde açıkça tanımlayın.
|
||||
|
||||
```bash
|
||||
ollama list # Nelerin kurulu olduğunu görün
|
||||
ollama list # Kurulu olanları görün
|
||||
ollama pull gemma4
|
||||
ollama pull gpt-oss:20b
|
||||
ollama pull llama3.3 # Veya başka bir model
|
||||
@ -453,13 +453,13 @@ Tam kurulum ve davranış ayrıntıları için bkz. [Ollama Web Search](/tr/tool
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Bağlantı reddedildi">
|
||||
Ollama’nın doğru portta çalıştığını kontrol edin:
|
||||
Ollama’nın doğru bağlantı noktasında çalıştığını denetleyin:
|
||||
|
||||
```bash
|
||||
# Ollama'nın çalışıp çalışmadığını kontrol edin
|
||||
# Ollama’nın çalışıp çalışmadığını denetleyin
|
||||
ps aux | grep ollama
|
||||
|
||||
# Veya Ollama'yı yeniden başlatın
|
||||
# Veya Ollama’yı yeniden başlatın
|
||||
ollama serve
|
||||
```
|
||||
|
||||
@ -467,17 +467,17 @@ Tam kurulum ve davranış ayrıntıları için bkz. [Ollama Web Search](/tr/tool
|
||||
</AccordionGroup>
|
||||
|
||||
<Note>
|
||||
Daha fazla yardım: [Sorun Giderme](/tr/help/troubleshooting) ve [SSS](/tr/help/faq).
|
||||
Daha fazla yardım: [Sorun giderme](/tr/help/troubleshooting) ve [SSS](/tr/help/faq).
|
||||
</Note>
|
||||
|
||||
## İlgili
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Model provider'ları" href="/tr/concepts/model-providers" icon="layers">
|
||||
Tüm provider’lara, model başvurularına ve failover davranışına genel bakış.
|
||||
<Card title="Model sağlayıcıları" href="/tr/concepts/model-providers" icon="layers">
|
||||
Tüm sağlayıcılara, model başvurularına ve yük devretme davranışına genel bakış.
|
||||
</Card>
|
||||
<Card title="Model seçimi" href="/tr/concepts/models" icon="brain">
|
||||
Modelleri nasıl seçeceğiniz ve yapılandıracağınız.
|
||||
Modellerin nasıl seçileceği ve yapılandırılacağı.
|
||||
</Card>
|
||||
<Card title="Ollama Web Search" href="/tr/tools/ollama-search" icon="magnifying-glass">
|
||||
Ollama destekli web araması için tam kurulum ve davranış ayrıntıları.
|
||||
|
||||
@ -1,97 +1,98 @@
|
||||
---
|
||||
read_when:
|
||||
- Bellek arama sağlayıcılarını veya embedding modellerini yapılandırmak istiyorsunuz
|
||||
- QMD backend'ini kurmak istiyorsunuz
|
||||
- Hibrit aramayı, MMR'yi veya zamansal çürümeyi ayarlamak istiyorsunuz
|
||||
- Çok modlu bellek indekslemeyi etkinleştirmek istiyorsunuz
|
||||
summary: Bellek arama, embedding sağlayıcıları, QMD, hibrit arama ve çok modlu indeksleme için tüm yapılandırma ayarları
|
||||
title: Bellek yapılandırma referansı
|
||||
- Bellek arama sağlayıcılarını veya gömme modellerini yapılandırmak istiyorsunuz
|
||||
- QMD arka ucunu kurmak istiyorsunuz
|
||||
- Hibrit aramayı, MMR'yi veya zamansal azalmayı ayarlamak istiyorsunuz
|
||||
- Çok modlu bellek dizinlemeyi etkinleştirmek istiyorsunuz
|
||||
summary: Bellek araması, gömme sağlayıcıları, QMD, hibrit arama ve çok modlu dizinleme için tüm yapılandırma seçenekleri
|
||||
title: Bellek yapılandırma başvurusu
|
||||
x-i18n:
|
||||
generated_at: "2026-04-12T23:33:58Z"
|
||||
generated_at: "2026-04-15T14:41:01Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 299ca9b69eea292ea557a2841232c637f5c1daf2bc0f73c0a42f7c0d8d566ce2
|
||||
source_hash: 334c3c4dac08e864487047d3822c75f96e9e7a97c38be4b4e0cd9e63c4489a53
|
||||
source_path: reference/memory-config.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Bellek yapılandırma referansı
|
||||
# Bellek yapılandırma başvurusu
|
||||
|
||||
Bu sayfa, OpenClaw bellek araması için tüm yapılandırma ayarlarını listeler. Kavramsal genel bakışlar için bkz.:
|
||||
Bu sayfa, OpenClaw bellek araması için her yapılandırma seçeneğini listeler. Kavramsal genel bakışlar için şunlara bakın:
|
||||
|
||||
- [Belleğe genel bakış](/tr/concepts/memory) -- belleğin nasıl çalıştığı
|
||||
- [Yerleşik motor](/tr/concepts/memory-builtin) -- varsayılan SQLite backend
|
||||
- [QMD motoru](/tr/concepts/memory-qmd) -- yerel öncelikli sidecar
|
||||
- [Bellek arama](/tr/concepts/memory-search) -- arama hattı ve ayarlama
|
||||
- [Active Memory](/tr/concepts/active-memory) -- etkileşimli oturumlar için bellek alt-agent'ını etkinleştirme
|
||||
- [Belleğe Genel Bakış](/tr/concepts/memory) -- belleğin nasıl çalıştığı
|
||||
- [Yerleşik Motor](/tr/concepts/memory-builtin) -- varsayılan SQLite arka ucu
|
||||
- [QMD Motoru](/tr/concepts/memory-qmd) -- önce yerel çalışan sidecar
|
||||
- [Bellek Araması](/tr/concepts/memory-search) -- arama hattı ve ayarlama
|
||||
- [Active Memory](/tr/concepts/active-memory) -- etkileşimli oturumlar için bellek alt ajanını etkinleştirme
|
||||
|
||||
Aksi belirtilmedikçe tüm bellek arama ayarları, `openclaw.json` içinde
|
||||
Aksi belirtilmedikçe tüm bellek araması ayarları `openclaw.json` içindeki
|
||||
`agents.defaults.memorySearch` altında bulunur.
|
||||
|
||||
**Active Memory** özellik anahtarını ve alt-agent yapılandırmasını arıyorsanız,
|
||||
bu ayarlar `memorySearch` yerine `plugins.entries.active-memory` altında bulunur.
|
||||
**Active Memory** özellik anahtarını ve alt ajan yapılandırmasını arıyorsanız,
|
||||
bu ayar `memorySearch` yerine `plugins.entries.active-memory` altında bulunur.
|
||||
|
||||
Active Memory iki kapılı bir model kullanır:
|
||||
|
||||
1. Plugin etkin olmalı ve geçerli agent kimliğini hedeflemelidir
|
||||
1. Plugin etkin olmalı ve geçerli ajan kimliğini hedeflemelidir
|
||||
2. İstek, uygun bir etkileşimli kalıcı sohbet oturumu olmalıdır
|
||||
|
||||
Etkinleştirme modeli,
|
||||
Plugin sahipliğindeki yapılandırma, transkript kalıcılığı ve güvenli devreye alma deseni için
|
||||
bkz. [Active Memory](/tr/concepts/active-memory).
|
||||
Etkinleştirme modeli, Plugin'e ait yapılandırma, döküm kalıcılığı ve güvenli
|
||||
yaygınlaştırma deseni için [Active Memory](/tr/concepts/active-memory) bölümüne bakın.
|
||||
|
||||
---
|
||||
|
||||
## Sağlayıcı seçimi
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| --------- | ---------- | --------------- | ------------------------------------------------------------------------------------------ |
|
||||
| `provider` | `string` | otomatik algılanır | Embedding adaptör kimliği: `openai`, `gemini`, `voyage`, `mistral`, `bedrock`, `ollama`, `local` |
|
||||
| `model` | `string` | sağlayıcı varsayılanı | Embedding model adı |
|
||||
| `fallback` | `string` | `"none"` | Birincil sağlayıcı başarısız olduğunda kullanılacak fallback adaptör kimliği |
|
||||
| `enabled` | `boolean` | `true` | Bellek aramayı etkinleştirir veya devre dışı bırakır |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| --------- | --------- | --------------- | ------------------------------------------------------------------------------------------------------------- |
|
||||
| `provider` | `string` | otomatik algılanır | Gömme bağdaştırıcısı kimliği: `bedrock`, `gemini`, `github-copilot`, `local`, `mistral`, `ollama`, `openai`, `voyage` |
|
||||
| `model` | `string` | sağlayıcı varsayılanı | Gömme modeli adı |
|
||||
| `fallback` | `string` | `"none"` | Birincil başarısız olduğunda geri dönüş bağdaştırıcısı kimliği |
|
||||
| `enabled` | `boolean` | `true` | Bellek aramasını etkinleştirir veya devre dışı bırakır |
|
||||
|
||||
### Otomatik algılama sırası
|
||||
|
||||
`provider` ayarlanmadığında OpenClaw, kullanılabilir ilk seçeneği seçer:
|
||||
`provider` ayarlanmadığında, OpenClaw kullanılabilir ilk seçeneği seçer:
|
||||
|
||||
1. `local` -- `memorySearch.local.modelPath` yapılandırılmışsa ve dosya mevcutsa.
|
||||
2. `openai` -- bir OpenAI anahtarı çözümlenebiliyorsa.
|
||||
3. `gemini` -- bir Gemini anahtarı çözümlenebiliyorsa.
|
||||
4. `voyage` -- bir Voyage anahtarı çözümlenebiliyorsa.
|
||||
5. `mistral` -- bir Mistral anahtarı çözümlenebiliyorsa.
|
||||
6. `bedrock` -- AWS SDK kimlik bilgisi zinciri çözümlenebiliyorsa (instance rolü, erişim anahtarları, profil, SSO, web kimliği veya paylaşılan yapılandırma).
|
||||
2. `github-copilot` -- bir GitHub Copilot belirteci çözümlenebiliyorsa (ortam değişkeni veya kimlik doğrulama profili).
|
||||
3. `openai` -- bir OpenAI anahtarı çözümlenebiliyorsa.
|
||||
4. `gemini` -- bir Gemini anahtarı çözümlenebiliyorsa.
|
||||
5. `voyage` -- bir Voyage anahtarı çözümlenebiliyorsa.
|
||||
6. `mistral` -- bir Mistral anahtarı çözümlenebiliyorsa.
|
||||
7. `bedrock` -- AWS SDK kimlik bilgisi zinciri çözümlenebiliyorsa (örnek rolü, erişim anahtarları, profil, SSO, web kimliği veya paylaşılan yapılandırma).
|
||||
|
||||
`ollama` desteklenir ancak otomatik algılanmaz (açıkça ayarlayın).
|
||||
|
||||
### API anahtarı çözümleme
|
||||
|
||||
Uzak embedding'ler bir API anahtarı gerektirir. Bedrock bunun yerine AWS SDK varsayılan
|
||||
kimlik bilgisi zincirini kullanır (instance rolleri, SSO, erişim anahtarları).
|
||||
Uzak gömmeler bir API anahtarı gerektirir. Bunun yerine Bedrock, AWS SDK’nin
|
||||
varsayılan kimlik bilgisi zincirini kullanır (örnek rolleri, SSO, erişim anahtarları).
|
||||
|
||||
| Sağlayıcı | Env değişkeni | Yapılandırma anahtarı |
|
||||
| --------- | ---------------------------- | -------------------------------- |
|
||||
| OpenAI | `OPENAI_API_KEY` | `models.providers.openai.apiKey` |
|
||||
| Gemini | `GEMINI_API_KEY` | `models.providers.google.apiKey` |
|
||||
| Voyage | `VOYAGE_API_KEY` | `models.providers.voyage.apiKey` |
|
||||
| Mistral | `MISTRAL_API_KEY` | `models.providers.mistral.apiKey` |
|
||||
| Bedrock | AWS kimlik bilgisi zinciri | API anahtarı gerekmez |
|
||||
| Ollama | `OLLAMA_API_KEY` (yer tutucu) | -- |
|
||||
| Sağlayıcı | Ortam değişkeni | Yapılandırma anahtarı |
|
||||
| -------------- | ------------------------------------------------ | -------------------------------- |
|
||||
| Bedrock | AWS kimlik bilgisi zinciri | API anahtarı gerekmez |
|
||||
| Gemini | `GEMINI_API_KEY` | `models.providers.google.apiKey` |
|
||||
| GitHub Copilot | `COPILOT_GITHUB_TOKEN`, `GH_TOKEN`, `GITHUB_TOKEN` | Cihaz oturumu açma yoluyla kimlik doğrulama profili |
|
||||
| Mistral | `MISTRAL_API_KEY` | `models.providers.mistral.apiKey` |
|
||||
| Ollama | `OLLAMA_API_KEY` (yer tutucu) | -- |
|
||||
| OpenAI | `OPENAI_API_KEY` | `models.providers.openai.apiKey` |
|
||||
| Voyage | `VOYAGE_API_KEY` | `models.providers.voyage.apiKey` |
|
||||
|
||||
Codex OAuth yalnızca chat/completions için geçerlidir ve embedding
|
||||
Codex OAuth yalnızca sohbet/completions isteklerini kapsar ve gömme
|
||||
isteklerini karşılamaz.
|
||||
|
||||
---
|
||||
|
||||
## Uzak uç nokta yapılandırması
|
||||
|
||||
Özel OpenAI uyumlu uç noktalar için veya sağlayıcı varsayılanlarını geçersiz kılmak için:
|
||||
Özel OpenAI uyumlu uç noktalar veya sağlayıcı varsayılanlarını geçersiz kılmak için:
|
||||
|
||||
| Anahtar | Tür | Açıklama |
|
||||
| ---------------- | -------- | ----------------------------------------------- |
|
||||
| `remote.baseUrl` | `string` | Özel API base URL |
|
||||
| `remote.apiKey` | `string` | API anahtarını geçersiz kılar |
|
||||
| `remote.headers` | `object` | Ek HTTP header'ları (sağlayıcı varsayılanlarıyla birleştirilir) |
|
||||
| Anahtar | Tür | Açıklama |
|
||||
| ----------------- | -------- | --------------------------------------- |
|
||||
| `remote.baseUrl` | `string` | Özel API temel URL’si |
|
||||
| `remote.apiKey` | `string` | API anahtarını geçersiz kılar |
|
||||
| `remote.headers` | `object` | Ek HTTP üstbilgileri (sağlayıcı varsayılanlarıyla birleştirilir) |
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -114,22 +115,22 @@ isteklerini karşılamaz.
|
||||
|
||||
## Gemini'ye özgü yapılandırma
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ---------------------- | -------- | ---------------------- | ---------------------------------------- |
|
||||
| `model` | `string` | `gemini-embedding-001` | `gemini-embedding-2-preview` de desteklenir |
|
||||
| `outputDimensionality` | `number` | `3072` | Embedding 2 için: 768, 1536 veya 3072 |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ---------------------- | -------- | ---------------------- | ------------------------------------------ |
|
||||
| `model` | `string` | `gemini-embedding-001` | Ayrıca `gemini-embedding-2-preview` desteklenir |
|
||||
| `outputDimensionality` | `number` | `3072` | Embedding 2 için: 768, 1536 veya 3072 |
|
||||
|
||||
<Warning>
|
||||
`model` veya `outputDimensionality` değiştirilmesi otomatik tam yeniden indeksleme tetikler.
|
||||
`model` veya `outputDimensionality` değerini değiştirmek otomatik olarak tam bir yeniden dizinlemeyi tetikler.
|
||||
</Warning>
|
||||
|
||||
---
|
||||
|
||||
## Bedrock embedding yapılandırması
|
||||
## Bedrock gömme yapılandırması
|
||||
|
||||
Bedrock, AWS SDK varsayılan kimlik bilgisi zincirini kullanır -- API anahtarı gerekmez.
|
||||
OpenClaw, Bedrock etkin bir instance rolüyle EC2 üzerinde çalışıyorsa yalnızca
|
||||
sağlayıcıyı ve modeli ayarlayın:
|
||||
Bedrock, AWS SDK’nin varsayılan kimlik bilgisi zincirini kullanır -- API anahtarı gerekmez.
|
||||
OpenClaw, Bedrock etkin örnek rolüne sahip bir EC2 üzerinde çalışıyorsa, yalnızca
|
||||
sağlayıcıyı ve modeli ayarlamanız yeterlidir:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -144,47 +145,47 @@ sağlayıcıyı ve modeli ayarlayın:
|
||||
}
|
||||
```
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ---------------------- | -------- | ------------------------------ | --------------------------------- |
|
||||
| `model` | `string` | `amazon.titan-embed-text-v2:0` | Herhangi bir Bedrock embedding model kimliği |
|
||||
| `outputDimensionality` | `number` | model varsayılanı | Titan V2 için: 256, 512 veya 1024 |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ---------------------- | -------- | ---------------------------- | -------------------------------- |
|
||||
| `model` | `string` | `amazon.titan-embed-text-v2:0` | Herhangi bir Bedrock gömme model kimliği |
|
||||
| `outputDimensionality` | `number` | model varsayılanı | Titan V2 için: 256, 512 veya 1024 |
|
||||
|
||||
### Desteklenen modeller
|
||||
|
||||
Aşağıdaki modeller desteklenir (aile algılama ve boyut
|
||||
varsayılanlarıyla birlikte):
|
||||
Aşağıdaki modeller desteklenir (aile algılama ve boyut varsayılanlarıyla birlikte):
|
||||
|
||||
| Model kimliği | Sağlayıcı | Varsayılan boyut | Yapılandırılabilir boyutlar |
|
||||
| ------------------------------------------- | ---------- | ---------------- | --------------------------- |
|
||||
| `amazon.titan-embed-text-v2:0` | Amazon | 1024 | 256, 512, 1024 |
|
||||
| `amazon.titan-embed-text-v1` | Amazon | 1536 | -- |
|
||||
| `amazon.titan-embed-g1-text-02` | Amazon | 1536 | -- |
|
||||
| `amazon.titan-embed-image-v1` | Amazon | 1024 | -- |
|
||||
| `amazon.nova-2-multimodal-embeddings-v1:0` | Amazon | 1024 | 256, 384, 1024, 3072 |
|
||||
| `cohere.embed-english-v3` | Cohere | 1024 | -- |
|
||||
| `cohere.embed-multilingual-v3` | Cohere | 1024 | -- |
|
||||
| `cohere.embed-v4:0` | Cohere | 1536 | 256-1536 |
|
||||
| `twelvelabs.marengo-embed-3-0-v1:0` | TwelveLabs | 512 | -- |
|
||||
| `twelvelabs.marengo-embed-2-7-v1:0` | TwelveLabs | 1024 | -- |
|
||||
| Model Kimliği | Sağlayıcı | Varsayılan Boyut | Yapılandırılabilir Boyut |
|
||||
| ------------------------------------------- | ---------- | ---------------- | ------------------------ |
|
||||
| `amazon.titan-embed-text-v2:0` | Amazon | 1024 | 256, 512, 1024 |
|
||||
| `amazon.titan-embed-text-v1` | Amazon | 1536 | -- |
|
||||
| `amazon.titan-embed-g1-text-02` | Amazon | 1536 | -- |
|
||||
| `amazon.titan-embed-image-v1` | Amazon | 1024 | -- |
|
||||
| `amazon.nova-2-multimodal-embeddings-v1:0` | Amazon | 1024 | 256, 384, 1024, 3072 |
|
||||
| `cohere.embed-english-v3` | Cohere | 1024 | -- |
|
||||
| `cohere.embed-multilingual-v3` | Cohere | 1024 | -- |
|
||||
| `cohere.embed-v4:0` | Cohere | 1536 | 256-1536 |
|
||||
| `twelvelabs.marengo-embed-3-0-v1:0` | TwelveLabs | 512 | -- |
|
||||
| `twelvelabs.marengo-embed-2-7-v1:0` | TwelveLabs | 1024 | -- |
|
||||
|
||||
İş hacmi son ekli varyantlar (örneğin `amazon.titan-embed-text-v1:2:8k`), temel modelin yapılandırmasını devralır.
|
||||
Verim eki alan varyantlar (ör. `amazon.titan-embed-text-v1:2:8k`) temel modelin
|
||||
yapılandırmasını devralır.
|
||||
|
||||
### Kimlik doğrulama
|
||||
|
||||
Bedrock auth, standart AWS SDK kimlik bilgisi çözümleme sırasını kullanır:
|
||||
Bedrock kimlik doğrulaması, standart AWS SDK kimlik bilgisi çözümleme sırasını kullanır:
|
||||
|
||||
1. Ortam değişkenleri (`AWS_ACCESS_KEY_ID` + `AWS_SECRET_ACCESS_KEY`)
|
||||
2. SSO token önbelleği
|
||||
3. Web kimliği token kimlik bilgileri
|
||||
4. Paylaşılan kimlik bilgisi ve yapılandırma dosyaları
|
||||
2. SSO belirteç önbelleği
|
||||
3. Web kimliği belirteci kimlik bilgileri
|
||||
4. Paylaşılan kimlik bilgileri ve yapılandırma dosyaları
|
||||
5. ECS veya EC2 meta veri kimlik bilgileri
|
||||
|
||||
Bölge, `AWS_REGION`, `AWS_DEFAULT_REGION`,
|
||||
`amazon-bedrock` sağlayıcısının `baseUrl` değeri üzerinden çözülür veya varsayılan olarak `us-east-1` kullanılır.
|
||||
Bölge, `AWS_REGION`, `AWS_DEFAULT_REGION`, `amazon-bedrock`
|
||||
sağlayıcısının `baseUrl` değeri üzerinden çözümlenir veya varsayılan olarak `us-east-1` kullanılır.
|
||||
|
||||
### IAM izinleri
|
||||
|
||||
IAM rolü veya kullanıcısının şuna ihtiyacı vardır:
|
||||
IAM rolü veya kullanıcısı şuna ihtiyaç duyar:
|
||||
|
||||
```json
|
||||
{
|
||||
@ -194,7 +195,7 @@ IAM rolü veya kullanıcısının şuna ihtiyacı vardır:
|
||||
}
|
||||
```
|
||||
|
||||
En az ayrıcalık için `InvokeModel` iznini belirli modele sınırlayın:
|
||||
En az ayrıcalık için `InvokeModel` yetkisini belirli modele daraltın:
|
||||
|
||||
```
|
||||
arn:aws:bedrock:*::foundation-model/amazon.titan-embed-text-v2:0
|
||||
@ -202,11 +203,11 @@ arn:aws:bedrock:*::foundation-model/amazon.titan-embed-text-v2:0
|
||||
|
||||
---
|
||||
|
||||
## Yerel embedding yapılandırması
|
||||
## Yerel gömme yapılandırması
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| -------------------- | -------- | ----------------------- | -------------------------------- |
|
||||
| `local.modelPath` | `string` | otomatik indirilir | GGUF model dosyasının yolu |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| --------------------- | -------- | ----------------------- | -------------------------------- |
|
||||
| `local.modelPath` | `string` | otomatik indirilir | GGUF model dosyasının yolu |
|
||||
| `local.modelCacheDir` | `string` | node-llama-cpp varsayılanı | İndirilen modeller için önbellek dizini |
|
||||
|
||||
Varsayılan model: `embeddinggemma-300m-qat-Q8_0.gguf` (~0.6 GB, otomatik indirilir).
|
||||
@ -216,30 +217,30 @@ Yerel derleme gerektirir: `pnpm approve-builds` ardından `pnpm rebuild node-lla
|
||||
|
||||
## Hibrit arama yapılandırması
|
||||
|
||||
Tümü `memorySearch.query.hybrid` altındadır:
|
||||
Tümü `memorySearch.query.hybrid` altında bulunur:
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| -------------------- | --------- | ---------- | --------------------------------- |
|
||||
| `enabled` | `boolean` | `true` | Hibrit BM25 + vektör aramayı etkinleştirir |
|
||||
| `vectorWeight` | `number` | `0.7` | Vektör skorları için ağırlık (0-1) |
|
||||
| `textWeight` | `number` | `0.3` | BM25 skorları için ağırlık (0-1) |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| -------------------- | --------- | ---------- | ---------------------------------- |
|
||||
| `enabled` | `boolean` | `true` | Hibrit BM25 + vektör aramasını etkinleştirir |
|
||||
| `vectorWeight` | `number` | `0.7` | Vektör puanları için ağırlık (0-1) |
|
||||
| `textWeight` | `number` | `0.3` | BM25 puanları için ağırlık (0-1) |
|
||||
| `candidateMultiplier` | `number` | `4` | Aday havuzu boyutu çarpanı |
|
||||
|
||||
### MMR (çeşitlilik)
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ------------- | --------- | ---------- | -------------------------------------- |
|
||||
| `mmr.enabled` | `boolean` | `false` | MMR yeniden sıralamasını etkinleştirir |
|
||||
| `mmr.lambda` | `number` | `0.7` | 0 = maksimum çeşitlilik, 1 = maksimum alaka |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ------------- | --------- | ---------- | ----------------------------------------- |
|
||||
| `mmr.enabled` | `boolean` | `false` | MMR yeniden sıralamasını etkinleştirir |
|
||||
| `mmr.lambda` | `number` | `0.7` | 0 = en yüksek çeşitlilik, 1 = en yüksek alaka |
|
||||
|
||||
### Zamansal çürüme (güncellik)
|
||||
### Zamansal azalma (güncellik)
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| --------------------------- | --------- | ---------- | --------------------------- |
|
||||
| `temporalDecay.enabled` | `boolean` | `false` | Güncellik artırmasını etkinleştirir |
|
||||
| `temporalDecay.halfLifeDays` | `number` | `30` | Skor her N günde yarıya iner |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| --------------------------- | --------- | ---------- | ---------------------------- |
|
||||
| `temporalDecay.enabled` | `boolean` | `false` | Güncellik artışını etkinleştirir |
|
||||
| `temporalDecay.halfLifeDays` | `number` | `30` | Puan her N günde yarıya iner |
|
||||
|
||||
Evergreen dosyalar (`MEMORY.md`, `memory/` içindeki tarih içermeyen dosyalar) asla çürütülmez.
|
||||
Kalıcı dosyalara (`MEMORY.md`, `memory/` içindeki tarihsiz dosyalar) hiçbir zaman azalma uygulanmaz.
|
||||
|
||||
### Tam örnek
|
||||
|
||||
@ -266,9 +267,9 @@ Evergreen dosyalar (`MEMORY.md`, `memory/` içindeki tarih içermeyen dosyalar)
|
||||
|
||||
## Ek bellek yolları
|
||||
|
||||
| Anahtar | Tür | Açıklama |
|
||||
| ----------- | ---------- | --------------------------------------- |
|
||||
| `extraPaths` | `string[]` | İndekslenecek ek dizinler veya dosyalar |
|
||||
| Anahtar | Tür | Açıklama |
|
||||
| ------------ | ---------- | ---------------------------------------- |
|
||||
| `extraPaths` | `string[]` | Dizinlenecek ek dizinler veya dosyalar |
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -282,15 +283,15 @@ Evergreen dosyalar (`MEMORY.md`, `memory/` içindeki tarih içermeyen dosyalar)
|
||||
}
|
||||
```
|
||||
|
||||
Yollar mutlak veya çalışma alanına göreli olabilir. Dizinler,
|
||||
`.md` dosyaları için özyinelemeli olarak taranır. Symlink işleme etkin backend'e bağlıdır:
|
||||
yerleşik motor symlink'leri yok sayar, QMD ise alttaki QMD
|
||||
tarayıcı davranışını izler.
|
||||
Yollar mutlak veya çalışma alanına göreli olabilir. Dizinler, `.md` dosyaları için
|
||||
özyinelemeli olarak taranır. Sembolik bağlantı işleme etkin arka uca bağlıdır:
|
||||
yerleşik motor sembolik bağlantıları yok sayar, QMD ise alttaki QMD
|
||||
tarayıcısının davranışını izler.
|
||||
|
||||
Agent kapsamlı agent'lar arası transkript araması için
|
||||
`memory.qmd.paths` yerine `agents.list[].memorySearch.qmd.extraCollections` kullanın.
|
||||
Bu ek koleksiyonlar da aynı `{ path, name, pattern? }` biçimini izler, ancak
|
||||
agent başına birleştirilir ve yol geçerli çalışma alanının dışına işaret ettiğinde
|
||||
Ajan kapsamlı, ajanlar arası döküm araması için
|
||||
`memory.qmd.paths` yerine `agents.list[].memorySearch.qmd.extraCollections`
|
||||
kullanın. Bu ek koleksiyonlar aynı `{ path, name, pattern? }` biçimini izler,
|
||||
ancak ajan başına birleştirilir ve yol geçerli çalışma alanının dışını gösterdiğinde
|
||||
açık paylaşılan adları koruyabilir.
|
||||
Aynı çözümlenmiş yol hem `memory.qmd.paths` hem de
|
||||
`memorySearch.qmd.extraCollections` içinde görünürse, QMD ilk girdiyi korur ve
|
||||
@ -300,136 +301,135 @@ yineleneni atlar.
|
||||
|
||||
## Çok modlu bellek (Gemini)
|
||||
|
||||
Gemini Embedding 2 kullanarak Markdown ile birlikte görselleri ve sesi indeksleyin:
|
||||
Gemini Embedding 2 kullanarak Markdown ile birlikte görüntüleri ve sesi dizinleyin:
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ------------------------ | ---------- | ---------- | -------------------------------------- |
|
||||
| `multimodal.enabled` | `boolean` | `false` | Çok modlu indekslemeyi etkinleştirir |
|
||||
| `multimodal.modalities` | `string[]` | -- | `["image"]`, `["audio"]` veya `["all"]` |
|
||||
| `multimodal.maxFileBytes` | `number` | `10000000` | İndeksleme için maksimum dosya boyutu |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ------------------------- | ---------- | ---------- | -------------------------------------- |
|
||||
| `multimodal.enabled` | `boolean` | `false` | Çok modlu dizinlemeyi etkinleştirir |
|
||||
| `multimodal.modalities` | `string[]` | -- | `["image"]`, `["audio"]` veya `["all"]` |
|
||||
| `multimodal.maxFileBytes` | `number` | `10000000` | Dizinleme için en büyük dosya boyutu |
|
||||
|
||||
Yalnızca `extraPaths` içindeki dosyalar için geçerlidir. Varsayılan bellek kökleri yalnızca Markdown'dur.
|
||||
`gemini-embedding-2-preview` gerektirir. `fallback`, `"none"` olmalıdır.
|
||||
Yalnızca `extraPaths` içindeki dosyalara uygulanır. Varsayılan bellek kökleri yalnızca Markdown olarak kalır.
|
||||
`gemini-embedding-2-preview` gerektirir. `fallback` değeri `"none"` olmalıdır.
|
||||
|
||||
Desteklenen biçimler: `.jpg`, `.jpeg`, `.png`, `.webp`, `.gif`, `.heic`, `.heif`
|
||||
(görseller); `.mp3`, `.wav`, `.ogg`, `.opus`, `.m4a`, `.aac`, `.flac` (ses).
|
||||
(görüntüler); `.mp3`, `.wav`, `.ogg`, `.opus`, `.m4a`, `.aac`, `.flac` (ses).
|
||||
|
||||
---
|
||||
|
||||
## Embedding önbelleği
|
||||
## Gömme önbelleği
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ----------------- | --------- | ---------- | ------------------------------------- |
|
||||
| `cache.enabled` | `boolean` | `false` | SQLite içinde chunk embedding'lerini önbelleğe alır |
|
||||
| `cache.maxEntries` | `number` | `50000` | Maksimum önbelleğe alınmış embedding sayısı |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ----------------- | --------- | ---------- | -------------------------------------- |
|
||||
| `cache.enabled` | `boolean` | `false` | Parça gömmelerini SQLite içinde önbelleğe alır |
|
||||
| `cache.maxEntries` | `number` | `50000` | En fazla önbelleğe alınan gömme sayısı |
|
||||
|
||||
Yeniden indeksleme veya transkript güncellemeleri sırasında değişmemiş metnin yeniden embedding işleminden geçmesini önler.
|
||||
Yeniden dizinleme veya döküm güncellemeleri sırasında değişmemiş metnin yeniden gömülmesini önler.
|
||||
|
||||
---
|
||||
|
||||
## Toplu indeksleme
|
||||
## Toplu dizinleme
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ---------------------------- | --------- | ---------- | ------------------------- |
|
||||
| `remote.batch.enabled` | `boolean` | `false` | Toplu embedding API'sini etkinleştirir |
|
||||
| `remote.batch.concurrency` | `number` | `2` | Paralel toplu işler |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ---------------------------- | --------- | ---------- | --------------------------- |
|
||||
| `remote.batch.enabled` | `boolean` | `false` | Toplu gömme API'sini etkinleştirir |
|
||||
| `remote.batch.concurrency` | `number` | `2` | Paralel toplu işler |
|
||||
| `remote.batch.wait` | `boolean` | `true` | Toplu işlemin tamamlanmasını bekler |
|
||||
| `remote.batch.pollIntervalMs` | `number` | -- | Yoklama aralığı |
|
||||
| `remote.batch.timeoutMinutes` | `number` | -- | Toplu işlem zaman aşımı |
|
||||
| `remote.batch.pollIntervalMs` | `number` | -- | Yoklama aralığı |
|
||||
| `remote.batch.timeoutMinutes` | `number` | -- | Toplu işlem zaman aşımı |
|
||||
|
||||
`openai`, `gemini` ve `voyage` için kullanılabilir. OpenAI toplu işlem genellikle
|
||||
büyük geri doldurmalar için en hızlı ve en ucuz seçenektir.
|
||||
`openai`, `gemini` ve `voyage` için kullanılabilir. OpenAI toplu işlem, büyük geriye dönük doldurmalarda genellikle
|
||||
en hızlı ve en ucuz seçenektir.
|
||||
|
||||
---
|
||||
|
||||
## Oturum bellek araması (deneysel)
|
||||
## Oturum belleği araması (deneysel)
|
||||
|
||||
Oturum transkriptlerini indeksleyin ve bunları `memory_search` üzerinden sunun:
|
||||
Oturum dökümlerini dizinleyin ve bunları `memory_search` üzerinden gösterin:
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ---------------------------- | ---------- | ------------ | ------------------------------------- |
|
||||
| `experimental.sessionMemory` | `boolean` | `false` | Oturum indekslemeyi etkinleştirir |
|
||||
| `sources` | `string[]` | `["memory"]` | Transkriptleri dahil etmek için `"sessions"` ekleyin |
|
||||
| `sync.sessions.deltaBytes` | `number` | `100000` | Yeniden indeksleme için bayt eşiği |
|
||||
| `sync.sessions.deltaMessages` | `number` | `50` | Yeniden indeksleme için mesaj eşiği |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| --------------------------- | ---------- | ------------ | ---------------------------------------- |
|
||||
| `experimental.sessionMemory` | `boolean` | `false` | Oturum dizinlemeyi etkinleştirir |
|
||||
| `sources` | `string[]` | `["memory"]` | Dökümleri dahil etmek için `"sessions"` ekleyin |
|
||||
| `sync.sessions.deltaBytes` | `number` | `100000` | Yeniden dizinleme için bayt eşiği |
|
||||
| `sync.sessions.deltaMessages` | `number` | `50` | Yeniden dizinleme için ileti eşiği |
|
||||
|
||||
Oturum indeksleme opt-in'dir ve async çalışır. Sonuçlar biraz eski
|
||||
olabilir. Oturum log'ları diskte tutulur, bu nedenle güven sınırı olarak
|
||||
dosya sistemi erişimini değerlendirin.
|
||||
Oturum dizinleme isteğe bağlıdır ve eşzamansız çalışır. Sonuçlar bir miktar eski olabilir.
|
||||
Oturum günlükleri diskte bulunduğundan, dosya sistemi erişimini güven
|
||||
sınırı olarak değerlendirin.
|
||||
|
||||
---
|
||||
|
||||
## SQLite vektör hızlandırma (`sqlite-vec`)
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| --------------------------- | --------- | ---------- | ------------------------------- |
|
||||
| `store.vector.enabled` | `boolean` | `true` | Vektör sorguları için `sqlite-vec` kullanır |
|
||||
| `store.vector.extensionPath` | `string` | paketlenmiş | `sqlite-vec` yolunu geçersiz kılar |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| -------------------------- | --------- | ---------- | ------------------------------------- |
|
||||
| `store.vector.enabled` | `boolean` | `true` | Vektör sorguları için `sqlite-vec` kullanır |
|
||||
| `store.vector.extensionPath` | `string` | bundled | `sqlite-vec` yolunu geçersiz kılar |
|
||||
|
||||
`sqlite-vec` kullanılamadığında OpenClaw otomatik olarak süreç içi cosine
|
||||
similarity yöntemine geri döner.
|
||||
`sqlite-vec` kullanılamadığında OpenClaw otomatik olarak süreç içi kosinüs
|
||||
benzerliğine geri döner.
|
||||
|
||||
---
|
||||
|
||||
## İndeks depolama
|
||||
## Dizin depolama
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| -------------------- | -------- | ------------------------------------- | ---------------------------------------- |
|
||||
| `store.path` | `string` | `~/.openclaw/memory/{agentId}.sqlite` | İndeks konumu (`{agentId}` token'ını destekler) |
|
||||
| `store.fts.tokenizer` | `string` | `unicode61` | FTS5 tokenizer (`unicode61` veya `trigram`) |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| -------------------- | -------- | ------------------------------------- | --------------------------------------------- |
|
||||
| `store.path` | `string` | `~/.openclaw/memory/{agentId}.sqlite` | Dizin konumu (`{agentId}` belirtecini destekler) |
|
||||
| `store.fts.tokenizer` | `string` | `unicode61` | FTS5 tokenizer'ı (`unicode61` veya `trigram`) |
|
||||
|
||||
---
|
||||
|
||||
## QMD backend yapılandırması
|
||||
## QMD arka uç yapılandırması
|
||||
|
||||
Etkinleştirmek için `memory.backend = "qmd"` ayarlayın. Tüm QMD ayarları
|
||||
`memory.qmd` altında bulunur:
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ----------------------- | --------- | ---------- | ------------------------------------------ |
|
||||
| `command` | `string` | `qmd` | QMD çalıştırılabilir dosya yolu |
|
||||
| `searchMode` | `string` | `search` | Arama komutu: `search`, `vsearch`, `query` |
|
||||
| `includeDefaultMemory` | `boolean` | `true` | `MEMORY.md` + `memory/**/*.md` dosyalarını otomatik indeksler |
|
||||
| `paths[]` | `array` | -- | Ek yollar: `{ name, path, pattern? }` |
|
||||
| `sessions.enabled` | `boolean` | `false` | Oturum transkriptlerini indeksler |
|
||||
| `sessions.retentionDays` | `number` | -- | Transkript saklama süresi |
|
||||
| `sessions.exportDir` | `string` | -- | Dışa aktarma dizini |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ----------------------- | --------- | ---------- | --------------------------------------------- |
|
||||
| `command` | `string` | `qmd` | QMD çalıştırılabilir dosya yolu |
|
||||
| `searchMode` | `string` | `search` | Arama komutu: `search`, `vsearch`, `query` |
|
||||
| `includeDefaultMemory` | `boolean` | `true` | `MEMORY.md` + `memory/**/*.md` otomatik dizinler |
|
||||
| `paths[]` | `array` | -- | Ek yollar: `{ name, path, pattern? }` |
|
||||
| `sessions.enabled` | `boolean` | `false` | Oturum dökümlerini dizinler |
|
||||
| `sessions.retentionDays` | `number` | -- | Döküm saklama süresi |
|
||||
| `sessions.exportDir` | `string` | -- | Dışa aktarma dizini |
|
||||
|
||||
OpenClaw, güncel QMD koleksiyonu ve MCP sorgu biçimlerini tercih eder, ancak
|
||||
gerektiğinde eski `--mask` koleksiyon bayraklarına
|
||||
ve eski MCP araç adlarına geri dönerek eski QMD sürümlerini de çalışır durumda tutar.
|
||||
OpenClaw, geçerli QMD koleksiyonu ve MCP sorgu biçimlerini tercih eder, ancak
|
||||
gerektiğinde eski `--mask` koleksiyon bayraklarına ve daha eski MCP araç adlarına geri dönerek
|
||||
eski QMD sürümlerini de çalışır durumda tutar.
|
||||
|
||||
QMD model geçersiz kılmaları OpenClaw yapılandırmasında değil, QMD tarafında kalır. QMD'nin
|
||||
modellerini genel olarak geçersiz kılmanız gerekiyorsa,
|
||||
Gateway çalışma zamanı ortamında `QMD_EMBED_MODEL`, `QMD_RERANK_MODEL` ve `QMD_GENERATE_MODEL`
|
||||
gibi ortam değişkenlerini ayarlayın.
|
||||
QMD model geçersiz kılmaları OpenClaw yapılandırmasında değil, QMD tarafında kalır. QMD'nin modellerini
|
||||
genel olarak geçersiz kılmanız gerekiyorsa, ağ geçidi çalışma zamanı ortamında
|
||||
`QMD_EMBED_MODEL`, `QMD_RERANK_MODEL` ve `QMD_GENERATE_MODEL` gibi ortam değişkenlerini ayarlayın.
|
||||
|
||||
### Güncelleme zamanlaması
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ------------------------ | --------- | ---------- | ---------------------------------- |
|
||||
| `update.interval` | `string` | `5m` | Yenileme aralığı |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ------------------------ | --------- | ---------- | ------------------------------------ |
|
||||
| `update.interval` | `string` | `5m` | Yenileme aralığı |
|
||||
| `update.debounceMs` | `number` | `15000` | Dosya değişikliklerini debounce eder |
|
||||
| `update.onBoot` | `boolean` | `true` | Başlangıçta yeniler |
|
||||
| `update.onBoot` | `boolean` | `true` | Başlangıçta yeniler |
|
||||
| `update.waitForBootSync` | `boolean` | `false` | Yenileme tamamlanana kadar başlangıcı engeller |
|
||||
| `update.embedInterval` | `string` | -- | Ayrı embedding sıklığı |
|
||||
| `update.commandTimeoutMs` | `number` | -- | QMD komutları için zaman aşımı |
|
||||
| `update.embedInterval` | `string` | -- | Ayrı gömme sıklığı |
|
||||
| `update.commandTimeoutMs` | `number` | -- | QMD komutları için zaman aşımı |
|
||||
| `update.updateTimeoutMs` | `number` | -- | QMD güncelleme işlemleri için zaman aşımı |
|
||||
| `update.embedTimeoutMs` | `number` | -- | QMD embedding işlemleri için zaman aşımı |
|
||||
| `update.embedTimeoutMs` | `number` | -- | QMD gömme işlemleri için zaman aşımı |
|
||||
|
||||
### Sınırlar
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ------------------------ | -------- | ---------- | ---------------------------- |
|
||||
| `limits.maxResults` | `number` | `6` | Maksimum arama sonucu |
|
||||
| `limits.maxSnippetChars` | `number` | -- | Snippet uzunluğunu sınırlar |
|
||||
| `limits.maxInjectedChars` | `number` | -- | Toplam enjekte edilen karakterleri sınırlar |
|
||||
| `limits.timeoutMs` | `number` | `4000` | Arama zaman aşımı |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ------------------------ | -------- | ---------- | -------------------------------- |
|
||||
| `limits.maxResults` | `number` | `6` | En fazla arama sonucu |
|
||||
| `limits.maxSnippetChars` | `number` | -- | Parça uzunluğunu sınırlar |
|
||||
| `limits.maxInjectedChars` | `number` | -- | Enjekte edilen toplam karakteri sınırlar |
|
||||
| `limits.timeoutMs` | `number` | `4000` | Arama zaman aşımı |
|
||||
|
||||
### Kapsam
|
||||
|
||||
Hangi oturumların QMD arama sonuçları alabileceğini denetler. Şema,
|
||||
[`session.sendPolicy`](/tr/gateway/configuration-reference#session) ile aynıdır:
|
||||
Hangi oturumların QMD arama sonuçları alabileceğini denetler. Şununla aynı şemayı kullanır:
|
||||
[`session.sendPolicy`](/tr/gateway/configuration-reference#session):
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -444,20 +444,20 @@ Hangi oturumların QMD arama sonuçları alabileceğini denetler. Şema,
|
||||
}
|
||||
```
|
||||
|
||||
Gönderilen varsayılan yapılandırma, grupları yine reddederken doğrudan ve kanal oturumlarına izin verir.
|
||||
Yayınlanan varsayılan, grupları yine reddederken doğrudan ve kanal oturumlarına izin verir.
|
||||
|
||||
Varsayılan yalnızca DM'dir. `match.keyPrefix`, normalize edilmiş session key ile eşleşir;
|
||||
`match.rawKeyPrefix`, `agent:<id>:` dahil ham anahtarla eşleşir.
|
||||
Varsayılan DM-only'dir. `match.keyPrefix` normalize edilmiş oturum anahtarıyla eşleşir;
|
||||
`match.rawKeyPrefix` ise `agent:<id>:` dahil ham anahtarla eşleşir.
|
||||
|
||||
### Atıflar
|
||||
### Alıntılar
|
||||
|
||||
`memory.citations` tüm backend'lere uygulanır:
|
||||
`memory.citations` tüm arka uçlara uygulanır:
|
||||
|
||||
| Değer | Davranış |
|
||||
| ---------------- | ------------------------------------------------ |
|
||||
| `auto` (varsayılan) | Snippet'lara `Source: <path#line>` alt bilgisini ekler |
|
||||
| `on` | Alt bilgiyi her zaman ekler |
|
||||
| `off` | Alt bilgiyi çıkarır (yol yine de dahili olarak agent'a aktarılır) |
|
||||
| Değer | Davranış |
|
||||
| ---------------- | ----------------------------------------------- |
|
||||
| `auto` (varsayılan) | Parçalara `Source: <path#line>` altbilgisini ekler |
|
||||
| `on` | Altbilgiyi her zaman ekler |
|
||||
| `off` | Altbilgiyi çıkarır (yol yine de içten içe ajana iletilir) |
|
||||
|
||||
### Tam QMD örneği
|
||||
|
||||
@ -482,20 +482,20 @@ Varsayılan yalnızca DM'dir. `match.keyPrefix`, normalize edilmiş session key
|
||||
|
||||
---
|
||||
|
||||
## Dreaming (deneysel)
|
||||
## Dreaming
|
||||
|
||||
Dreaming, `agents.defaults.memorySearch` altında değil,
|
||||
`plugins.entries.memory-core.config.dreaming` altında yapılandırılır.
|
||||
|
||||
Dreaming, tek bir zamanlanmış tarama olarak çalışır ve dahili light/deep/REM aşamalarını
|
||||
Dreaming, zamanlanmış tek bir tarama olarak çalışır ve dahili light/deep/REM aşamalarını
|
||||
uygulama ayrıntısı olarak kullanır.
|
||||
|
||||
Kavramsal davranış ve slash komutlar için bkz. [Dreaming](/tr/concepts/dreaming).
|
||||
Kavramsal davranış ve eğik çizgi komutları için [Dreaming](/tr/concepts/dreaming) bölümüne bakın.
|
||||
|
||||
### Kullanıcı ayarları
|
||||
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ---------- | --------- | ----------- | ---------------------------------------------- |
|
||||
| Anahtar | Tür | Varsayılan | Açıklama |
|
||||
| ---------- | --------- | ----------- | --------------------------------------------- |
|
||||
| `enabled` | `boolean` | `false` | Dreaming'i tamamen etkinleştirir veya devre dışı bırakır |
|
||||
| `frequency` | `string` | `0 3 * * *` | Tam Dreaming taraması için isteğe bağlı Cron sıklığı |
|
||||
|
||||
@ -520,6 +520,6 @@ Kavramsal davranış ve slash komutlar için bkz. [Dreaming](/tr/concepts/dreami
|
||||
|
||||
Notlar:
|
||||
|
||||
- Dreaming, makine durumunu `memory/.dreams/` içine yazar.
|
||||
- Dreaming, insan tarafından okunabilir anlatı çıktısını `DREAMS.md` (veya mevcut `dreams.md`) içine yazar.
|
||||
- Light/deep/REM aşama politikası ve eşikleri dahili davranıştır, kullanıcıya dönük yapılandırma değildir.
|
||||
- Dreaming makine durumunu `memory/.dreams/` içine yazar.
|
||||
- Dreaming insan tarafından okunabilir anlatı çıktısını `DREAMS.md` (veya mevcut `dreams.md`) dosyasına yazar.
|
||||
- light/deep/REM aşama politikası ve eşikler, kullanıcıya dönük yapılandırma değil, dahili davranıştır.
|
||||
|
||||
@ -1,155 +1,155 @@
|
||||
---
|
||||
read_when:
|
||||
- Belirli bir onboarding adımını veya işaretini arıyorsanız
|
||||
- Onboarding'i etkileşimsiz modla otomatikleştiriyorsanız
|
||||
- Onboarding davranışında hata ayıklıyorsanız
|
||||
- Belirli bir ilk kurulum adımını veya bayrağını arıyorsunuz
|
||||
- Etkileşimsiz mod ile ilk kurulumu otomatikleştirme
|
||||
- İlk kurulum davranışında hata ayıklama
|
||||
sidebarTitle: Onboarding Reference
|
||||
summary: 'CLI onboarding için tam başvuru: her adım, işaret ve yapılandırma alanı'
|
||||
title: Onboarding Başvurusu
|
||||
summary: 'CLI ile ilk kurulum için tam başvuru: her adım, bayrak ve yapılandırma alanı'
|
||||
title: İlk Kurulum Başvurusu
|
||||
x-i18n:
|
||||
generated_at: "2026-04-07T08:50:13Z"
|
||||
generated_at: "2026-04-15T14:41:02Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: a142b9ec4323fabb9982d05b64375d2b4a4007dffc910acbee3a38ff871a7236
|
||||
source_hash: 1db3ff789422617634e6624f9d12c18b6a6c573721226b9c0fa6f6b7956ef33d
|
||||
source_path: reference/wizard.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Onboarding Başvurusu
|
||||
# İlk Kurulum Başvurusu
|
||||
|
||||
Bu, `openclaw onboard` için tam başvurudur.
|
||||
Üst düzey bir genel bakış için bkz. [Onboarding (CLI)](/tr/start/wizard).
|
||||
Bu, `openclaw onboard` için tam başvuru kılavuzudur.
|
||||
Yüksek seviyeli bir genel bakış için bkz. [Onboarding (CLI)](/tr/start/wizard).
|
||||
|
||||
## Akış ayrıntıları (yerel mod)
|
||||
|
||||
<Steps>
|
||||
<Step title="Mevcut yapılandırma algılama">
|
||||
- `~/.openclaw/openclaw.json` varsa **Keep / Modify / Reset** seçeneklerinden birini seçin.
|
||||
- Onboarding'i yeniden çalıştırmak, açıkça **Reset** seçmediğiniz sürece
|
||||
(veya `--reset` geçmediğiniz sürece) hiçbir şeyi silmez.
|
||||
- `~/.openclaw/openclaw.json` varsa **Koru / Değiştir / Sıfırla** seçeneklerinden birini seçin.
|
||||
- İlk kurulumu yeniden çalıştırmak, açıkça **Sıfırla** seçmediğiniz sürece hiçbir şeyi silmez
|
||||
(veya `--reset` geçmediğiniz sürece).
|
||||
- CLI `--reset` varsayılan olarak `config+creds+sessions` kullanır; çalışma alanını da kaldırmak için `--reset-scope full`
|
||||
kullanın.
|
||||
- Yapılandırma geçersizse veya eski anahtarlar içeriyorsa wizard durur ve
|
||||
- Yapılandırma geçersizse veya eski anahtarlar içeriyorsa, sihirbaz durur ve
|
||||
devam etmeden önce `openclaw doctor` çalıştırmanızı ister.
|
||||
- Reset, `trash` kullanır (`rm` asla kullanılmaz) ve şu kapsamları sunar:
|
||||
- Sıfırlama, `trash` kullanır (`rm` asla kullanılmaz) ve şu kapsamları sunar:
|
||||
- Yalnızca yapılandırma
|
||||
- Yapılandırma + kimlik bilgileri + oturumlar
|
||||
- Tam sıfırlama (çalışma alanını da kaldırır)
|
||||
</Step>
|
||||
<Step title="Model/Auth">
|
||||
- **Anthropic API key**: varsa `ANTHROPIC_API_KEY` kullanır veya bir anahtar ister, ardından daemon kullanımı için kaydeder.
|
||||
- **Anthropic API key**: onboarding/configure içinde tercih edilen Anthropic asistan seçimi.
|
||||
- **Anthropic setup-token**: onboarding/configure içinde hâlâ kullanılabilir, ancak OpenClaw artık mümkün olduğunda Claude CLI yeniden kullanımını tercih eder.
|
||||
- **OpenAI Code (Codex) subscription (Codex CLI)**: `~/.codex/auth.json` varsa onboarding bunu yeniden kullanabilir. Yeniden kullanılan Codex CLI kimlik bilgileri Codex CLI tarafından yönetilmeye devam eder; süreleri dolduğunda OpenClaw önce bu kaynağı yeniden okur ve provider bunu yenileyebiliyorsa, sahipliğini almak yerine yenilenmiş kimlik bilgisini tekrar Codex depolamasına yazar.
|
||||
- **OpenAI Code (Codex) subscription (OAuth)**: tarayıcı akışı; `code#state` değerini yapıştırın.
|
||||
- Model ayarlanmamışsa veya `openai/*` ise `agents.defaults.model` değerini `openai-codex/gpt-5.4` olarak ayarlar.
|
||||
- **OpenAI API key**: varsa `OPENAI_API_KEY` kullanır veya bir anahtar ister, ardından bunu auth profillerinde saklar.
|
||||
- Model ayarlanmamışsa, `openai/*` veya `openai-codex/*` ise `agents.defaults.model` değerini `openai/gpt-5.4` olarak ayarlar.
|
||||
- **xAI (Grok) API key**: `XAI_API_KEY` ister ve xAI'ı model provider olarak yapılandırır.
|
||||
- **OpenCode**: `OPENCODE_API_KEY` (veya `OPENCODE_ZEN_API_KEY`, bunu https://opencode.ai/auth adresinden alın) ister ve Zen veya Go kataloğunu seçmenize izin verir.
|
||||
- **Ollama**: Ollama temel URL'sini ister, **Cloud + Local** veya **Local** modu sunar, kullanılabilir modelleri keşfeder ve gerektiğinde seçilen yerel modeli otomatik olarak çeker.
|
||||
<Step title="Model/Kimlik Doğrulama">
|
||||
- **Anthropic API anahtarı**: varsa `ANTHROPIC_API_KEY` kullanır veya bir anahtar ister, ardından daemon kullanımı için kaydeder.
|
||||
- **Anthropic API anahtarı**: ilk kurulum/yapılandırmada tercih edilen Anthropic asistan seçimidir.
|
||||
- **Anthropic setup-token**: ilk kurulum/yapılandırmada hâlâ kullanılabilir, ancak OpenClaw artık mevcut olduğunda Claude CLI yeniden kullanımını tercih eder.
|
||||
- **OpenAI Code (Codex) aboneliği (Codex CLI)**: `~/.codex/auth.json` varsa ilk kurulum bunu yeniden kullanabilir. Yeniden kullanılan Codex CLI kimlik bilgileri Codex CLI tarafından yönetilmeye devam eder; süresi dolduğunda OpenClaw önce bu kaynağı yeniden okur ve sağlayıcı bunu yenileyebiliyorsa, yenilenen kimlik bilgisini kendisi sahiplenmek yerine tekrar Codex depolamasına yazar.
|
||||
- **OpenAI Code (Codex) aboneliği (OAuth)**: tarayıcı akışı; `code#state` değerini yapıştırın.
|
||||
- Model ayarlanmamışsa veya `openai/*` ise `agents.defaults.model` alanını `openai-codex/gpt-5.4` olarak ayarlar.
|
||||
- **OpenAI API anahtarı**: varsa `OPENAI_API_KEY` kullanır veya bir anahtar ister, ardından bunu auth profillerinde saklar.
|
||||
- Model ayarlanmamışsa, `openai/*` ise veya `openai-codex/*` ise `agents.defaults.model` alanını `openai/gpt-5.4` olarak ayarlar.
|
||||
- **xAI (Grok) API anahtarı**: `XAI_API_KEY` ister ve xAI'ı model sağlayıcısı olarak yapılandırır.
|
||||
- **OpenCode**: `OPENCODE_API_KEY` (veya `OPENCODE_ZEN_API_KEY`, almak için https://opencode.ai/auth adresine gidin) ister ve Zen veya Go kataloğunu seçmenize olanak tanır.
|
||||
- **Ollama**: önce **Cloud + Local**, **Yalnızca Cloud** veya **Yalnızca Local** seçeneklerini sunar. `Yalnızca Cloud`, `OLLAMA_API_KEY` ister ve `https://ollama.com` kullanır; host destekli modlar Ollama temel URL'sini ister, kullanılabilir modelleri keşfeder ve gerektiğinde seçilen yerel modeli otomatik olarak çeker; `Cloud + Local` ayrıca bu Ollama hostunun Cloud erişimi için oturum açıp açmadığını da kontrol eder.
|
||||
- Daha fazla ayrıntı: [Ollama](/tr/providers/ollama)
|
||||
- **API key**: anahtarı sizin için saklar.
|
||||
- **API anahtarı**: anahtarı sizin için saklar.
|
||||
- **Vercel AI Gateway (çok modelli proxy)**: `AI_GATEWAY_API_KEY` ister.
|
||||
- Daha fazla ayrıntı: [Vercel AI Gateway](/tr/providers/vercel-ai-gateway)
|
||||
- **Cloudflare AI Gateway**: Account ID, Gateway ID ve `CLOUDFLARE_AI_GATEWAY_API_KEY` ister.
|
||||
- Daha fazla ayrıntı: [Cloudflare AI Gateway](/tr/providers/cloudflare-ai-gateway)
|
||||
- **MiniMax**: yapılandırma otomatik olarak yazılır; barındırılan varsayılan `MiniMax-M2.7` olur.
|
||||
API anahtarı kurulumu `minimax/...` kullanır, OAuth kurulumu ise
|
||||
- **MiniMax**: yapılandırma otomatik yazılır; barındırılan varsayılan `MiniMax-M2.7`'dir.
|
||||
API anahtarı kurulumu `minimax/...`, OAuth kurulumu ise
|
||||
`minimax-portal/...` kullanır.
|
||||
- Daha fazla ayrıntı: [MiniMax](/tr/providers/minimax)
|
||||
- **StepFun**: yapılandırma, Çin veya küresel uç noktalarda StepFun standard veya Step Plan için otomatik yazılır.
|
||||
- Standard şu anda `step-3.5-flash` içerir ve Step Plan ayrıca `step-3.5-flash-2603` içerir.
|
||||
- **StepFun**: yapılandırma, Çin veya küresel uç noktalardaki standart StepFun veya Step Plan için otomatik yazılır.
|
||||
- Standart şu anda `step-3.5-flash` içerir ve Step Plan ayrıca `step-3.5-flash-2603` içerir.
|
||||
- Daha fazla ayrıntı: [StepFun](/tr/providers/stepfun)
|
||||
- **Synthetic (Anthropic-compatible)**: `SYNTHETIC_API_KEY` ister.
|
||||
- **Synthetic (Anthropic uyumlu)**: `SYNTHETIC_API_KEY` ister.
|
||||
- Daha fazla ayrıntı: [Synthetic](/tr/providers/synthetic)
|
||||
- **Moonshot (Kimi K2)**: yapılandırma otomatik olarak yazılır.
|
||||
- **Kimi Coding**: yapılandırma otomatik olarak yazılır.
|
||||
- **Moonshot (Kimi K2)**: yapılandırma otomatik yazılır.
|
||||
- **Kimi Coding**: yapılandırma otomatik yazılır.
|
||||
- Daha fazla ayrıntı: [Moonshot AI (Kimi + Kimi Coding)](/tr/providers/moonshot)
|
||||
- **Skip**: henüz auth yapılandırılmaz.
|
||||
- Algılanan seçeneklerden varsayılan bir model seçin (veya provider/model'i elle girin). En iyi kalite ve daha düşük prompt injection riski için provider yığınınızda bulunan en güçlü yeni nesil modeli seçin.
|
||||
- Onboarding bir model denetimi çalıştırır ve yapılandırılan model bilinmiyorsa veya auth eksikse uyarı verir.
|
||||
- API anahtarı depolama modu varsayılan olarak düz metin auth-profile değerleri kullanır. Bunun yerine env destekli başvurular saklamak için `--secret-input-mode ref` kullanın (örneğin `keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" }`).
|
||||
- Auth profilleri `~/.openclaw/agents/<agentId>/agent/auth-profiles.json` içinde bulunur (API anahtarları + OAuth). `~/.openclaw/credentials/oauth.json` eski ve yalnızca içe aktarma içindir.
|
||||
- **Atla**: henüz kimlik doğrulama yapılandırılmaz.
|
||||
- Algılanan seçeneklerden varsayılan bir model seçin (veya sağlayıcı/model bilgisini elle girin). En iyi kalite ve daha düşük istem enjeksiyonu riski için, sağlayıcı yığınınızda bulunan en güçlü yeni nesil modeli seçin.
|
||||
- İlk kurulum bir model denetimi çalıştırır ve yapılandırılan model bilinmiyorsa veya kimlik doğrulama eksikse uyarı verir.
|
||||
- API anahtarı depolama modu varsayılan olarak düz metin auth-profile değerlerini kullanır. Bunun yerine env destekli referanslar depolamak için `--secret-input-mode ref` kullanın (örneğin `keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" }`).
|
||||
- Auth profilleri `~/.openclaw/agents/<agentId>/agent/auth-profiles.json` içinde bulunur (API anahtarları + OAuth). `~/.openclaw/credentials/oauth.json` yalnızca eski içe aktarma için kullanılır.
|
||||
- Daha fazla ayrıntı: [/concepts/oauth](/tr/concepts/oauth)
|
||||
<Note>
|
||||
Headless/sunucu ipucu: OAuth'u tarayıcısı olan bir makinede tamamlayın, sonra
|
||||
o ajanın `auth-profiles.json` dosyasını (örneğin
|
||||
Başsız/sunucu ipucu: OAuth'u tarayıcısı olan bir makinede tamamlayın, sonra
|
||||
bu ajanın `auth-profiles.json` dosyasını (örneğin
|
||||
`~/.openclaw/agents/<agentId>/agent/auth-profiles.json` veya eşleşen
|
||||
`$OPENCLAW_STATE_DIR/...` yolu) gateway ana makinesine kopyalayın. `credentials/oauth.json`
|
||||
`$OPENCLAW_STATE_DIR/...` yolu) Gateway hostuna kopyalayın. `credentials/oauth.json`
|
||||
yalnızca eski bir içe aktarma kaynağıdır.
|
||||
</Note>
|
||||
</Step>
|
||||
<Step title="Çalışma alanı">
|
||||
- Varsayılan `~/.openclaw/workspace` (yapılandırılabilir).
|
||||
- Ajan bootstrap ritüeli için gereken çalışma alanı dosyalarını yerleştirir.
|
||||
- Ajan önyükleme ritüeli için gereken çalışma alanı dosyalarını tohumlar.
|
||||
- Tam çalışma alanı düzeni + yedekleme kılavuzu: [Agent workspace](/tr/concepts/agent-workspace)
|
||||
</Step>
|
||||
<Step title="Gateway">
|
||||
- Port, bind, auth modu, Tailscale yayını.
|
||||
- Auth önerisi: yerel WS istemcilerinin kimlik doğrulaması yapması için loopback üzerinde bile **Token** kullanın.
|
||||
- Port, bind, auth modu, Tailscale görünürlüğü.
|
||||
- Kimlik doğrulama önerisi: yerel WS istemcilerinin kimlik doğrulaması yapması gereksin diye loopback için bile **Token** kullanın.
|
||||
- Token modunda etkileşimli kurulum şunları sunar:
|
||||
- **Generate/store plaintext token** (varsayılan)
|
||||
- **Use SecretRef** (isteğe bağlı)
|
||||
- Hızlı başlangıç, onboarding probe/dashboard bootstrap için `env`, `file` ve `exec` provider'ları genelinde mevcut `gateway.auth.token` SecretRef'lerini yeniden kullanır.
|
||||
- Bu SecretRef yapılandırılmışsa ancak çözümlenemiyorsa onboarding, çalışma zamanı auth'unu sessizce zayıflatmak yerine net bir düzeltme iletisiyle erken başarısız olur.
|
||||
- Parola modunda etkileşimli kurulum, düz metin veya SecretRef depolamayı da destekler.
|
||||
- **Düz metin token oluştur/sakla** (varsayılan)
|
||||
- **SecretRef kullan** (isteğe bağlı)
|
||||
- Hızlı başlangıç, ilk kurulum yoklaması/pano önyüklemesi için `env`, `file` ve `exec` sağlayıcıları genelinde mevcut `gateway.auth.token` SecretRef'lerini yeniden kullanır.
|
||||
- Bu SecretRef yapılandırılmışsa ancak çözümlenemiyorsa, ilk kurulum çalışma zamanı kimlik doğrulamasını sessizce zayıflatmak yerine açık bir düzeltme mesajıyla erkenden başarısız olur.
|
||||
- Parola modunda etkileşimli kurulum da düz metin veya SecretRef depolamayı destekler.
|
||||
- Etkileşimsiz token SecretRef yolu: `--gateway-token-ref-env <ENV_VAR>`.
|
||||
- Onboarding süreç ortamında boş olmayan bir env değişkeni gerektirir.
|
||||
- İlk kurulum işlem ortamında boş olmayan bir ortam değişkeni gerektirir.
|
||||
- `--gateway-token` ile birlikte kullanılamaz.
|
||||
- Auth'u yalnızca tüm yerel süreçlere tamamen güveniyorsanız devre dışı bırakın.
|
||||
- Loopback olmayan bind'ler yine de auth gerektirir.
|
||||
- Yalnızca her yerel sürece tamamen güveniyorsanız kimlik doğrulamayı devre dışı bırakın.
|
||||
- Loopback dışı bind'ler yine de kimlik doğrulama gerektirir.
|
||||
</Step>
|
||||
<Step title="Kanallar">
|
||||
- [WhatsApp](/tr/channels/whatsapp): isteğe bağlı QR oturumu açma.
|
||||
- [Telegram](/tr/channels/telegram): bot token.
|
||||
- [Discord](/tr/channels/discord): bot token.
|
||||
- [Google Chat](/tr/channels/googlechat): service account JSON + webhook audience.
|
||||
- [Mattermost](/tr/channels/mattermost) (plugin): bot token + temel URL.
|
||||
- [WhatsApp](/tr/channels/whatsapp): isteğe bağlı QR girişi.
|
||||
- [Telegram](/tr/channels/telegram): bot token'ı.
|
||||
- [Discord](/tr/channels/discord): bot token'ı.
|
||||
- [Google Chat](/tr/channels/googlechat): hizmet hesabı JSON'u + webhook audience.
|
||||
- [Mattermost](/tr/channels/mattermost) (Plugin): bot token'ı + temel URL.
|
||||
- [Signal](/tr/channels/signal): isteğe bağlı `signal-cli` kurulumu + hesap yapılandırması.
|
||||
- [BlueBubbles](/tr/channels/bluebubbles): **iMessage için önerilir**; sunucu URL'si + parola + webhook.
|
||||
- [iMessage](/tr/channels/imessage): eski `imsg` CLI yolu + DB erişimi.
|
||||
- DM güvenliği: varsayılan eşleştirmedir. İlk DM bir kod gönderir; bunu `openclaw pairing approve <channel> <code>` ile onaylayın veya izin listeleri kullanın.
|
||||
- [iMessage](/tr/channels/imessage): eski `imsg` CLI yolu + VT erişimi.
|
||||
- DM güvenliği: varsayılan eşleştirmedir. İlk DM bir kod gönderir; `openclaw pairing approve <channel> <code>` ile onaylayın veya izin listeleri kullanın.
|
||||
</Step>
|
||||
<Step title="Web arama">
|
||||
- Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Perplexity, SearXNG veya Tavily gibi desteklenen bir provider seçin (veya atlayın).
|
||||
- API destekli provider'lar hızlı kurulum için env değişkenleri veya mevcut yapılandırmayı kullanabilir; anahtarsız provider'lar bunun yerine provider'a özgü ön koşullarını kullanır.
|
||||
<Step title="Web araması">
|
||||
- Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Perplexity, SearXNG veya Tavily gibi desteklenen bir sağlayıcı seçin (veya atlayın).
|
||||
- API destekli sağlayıcılar hızlı kurulum için ortam değişkenlerini veya mevcut yapılandırmayı kullanabilir; anahtarsız sağlayıcılar bunun yerine sağlayıcıya özgü önkoşullarını kullanır.
|
||||
- `--skip-search` ile atlayın.
|
||||
- Daha sonra yapılandırın: `openclaw configure --section web`.
|
||||
</Step>
|
||||
<Step title="Daemon kurulumu">
|
||||
- macOS: LaunchAgent
|
||||
- Oturum açılmış bir kullanıcı oturumu gerektirir; headless için özel bir LaunchDaemon kullanın (gönderilmez).
|
||||
- Linux (ve Windows üzerinden WSL2): systemd user unit
|
||||
- Onboarding, Gateway'in oturum kapatıldıktan sonra da çalışmaya devam etmesi için `loginctl enable-linger <user>` komutuyla lingering'i etkinleştirmeye çalışır.
|
||||
- sudo isteyebilir (`/var/lib/systemd/linger` yazar); önce sudo olmadan dener.
|
||||
- Oturum açılmış bir kullanıcı oturumu gerektirir; başsız kullanım için özel bir LaunchDaemon gerekir (paketlenmez).
|
||||
- Linux (ve Windows üzerinden WSL2): systemd kullanıcı birimi
|
||||
- İlk kurulum, çıkış yaptıktan sonra da Gateway çalışmaya devam etsin diye `loginctl enable-linger <user>` komutunu etkinleştirmeyi dener.
|
||||
- Sudo isteyebilir (`/var/lib/systemd/linger` yazar); önce sudo olmadan dener.
|
||||
- **Çalışma zamanı seçimi:** Node (önerilir; WhatsApp/Telegram için gereklidir). Bun **önerilmez**.
|
||||
- Token auth bir token gerektiriyorsa ve `gateway.auth.token` SecretRef ile yönetiliyorsa daemon kurulumu bunu doğrular ancak çözümlenmiş düz metin token değerlerini supervisor hizmet ortam meta verisine kalıcı olarak yazmaz.
|
||||
- Token auth bir token gerektiriyorsa ve yapılandırılmış token SecretRef çözümlenmemişse daemon kurulumu eyleme geçirilebilir yönlendirmeyle engellenir.
|
||||
- Hem `gateway.auth.token` hem `gateway.auth.password` yapılandırılmışsa ve `gateway.auth.mode` ayarlanmamışsa, mod açıkça ayarlanana kadar daemon kurulumu engellenir.
|
||||
- Token kimlik doğrulaması bir token gerektiriyorsa ve `gateway.auth.token` SecretRef ile yönetiliyorsa, daemon kurulumu bunu doğrular ancak çözümlenen düz metin token değerlerini supervisor hizmet ortamı meta verisine kalıcı olarak yazmaz.
|
||||
- Token kimlik doğrulaması bir token gerektiriyorsa ve yapılandırılmış token SecretRef çözümlenmemişse, daemon kurulumu eyleme geçirilebilir yönlendirme ile engellenir.
|
||||
- Hem `gateway.auth.token` hem de `gateway.auth.password` yapılandırılmışsa ve `gateway.auth.mode` ayarlanmamışsa, mod açıkça ayarlanana kadar daemon kurulumu engellenir.
|
||||
</Step>
|
||||
<Step title="Sağlık denetimi">
|
||||
- Gateway'i başlatır (gerekiyorsa) ve `openclaw health` çalıştırır.
|
||||
- İpucu: `openclaw status --deep`, desteklendiğinde kanal probları dahil olmak üzere canlı gateway sağlık probunu durum çıktısına ekler (erişilebilir bir gateway gerektirir).
|
||||
- Gateway'i başlatır (gerekirse) ve `openclaw health` çalıştırır.
|
||||
- İpucu: `openclaw status --deep`, desteklendiğinde kanal yoklamaları da dahil olmak üzere canlı Gateway sağlık yoklamasını durum çıktısına ekler (erişilebilir bir Gateway gerektirir).
|
||||
</Step>
|
||||
<Step title="Skills (önerilir)">
|
||||
- Kullanılabilir skill'leri okur ve gereksinimleri denetler.
|
||||
- Bir node manager seçmenize izin verir: **npm / pnpm** (bun önerilmez).
|
||||
- İsteğe bağlı bağımlılıkları yükler (bazıları macOS'ta Homebrew kullanır).
|
||||
- Kullanılabilir Skills öğelerini okur ve gereksinimleri denetler.
|
||||
- Bir Node yöneticisi seçmenize olanak tanır: **npm / pnpm** (bun önerilmez).
|
||||
- İsteğe bağlı bağımlılıkları kurar (bazıları macOS'ta Homebrew kullanır).
|
||||
</Step>
|
||||
<Step title="Bitir">
|
||||
- Ek özellikler için iOS/Android/macOS uygulamaları dahil özet + sonraki adımlar.
|
||||
- Ek özellikler için iOS/Android/macOS uygulamaları da dahil olmak üzere özet + sonraki adımlar.
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
<Note>
|
||||
GUI algılanmazsa onboarding, tarayıcı açmak yerine Control UI için SSH port-forward yönergeleri yazdırır.
|
||||
Control UI varlıkları eksikse onboarding bunları derlemeye çalışır; geri dönüş komutu `pnpm ui:build` olur (UI bağımlılıklarını otomatik kurar).
|
||||
GUI algılanmazsa, ilk kurulum tarayıcı açmak yerine Control UI için SSH port yönlendirme talimatlarını yazdırır.
|
||||
Control UI varlıkları eksikse, ilk kurulum bunları oluşturmayı dener; geri dönüş komutu `pnpm ui:build` olur (UI bağımlılıklarını otomatik kurar).
|
||||
</Note>
|
||||
|
||||
## Etkileşimsiz mod
|
||||
|
||||
Onboarding'i otomatikleştirmek veya betiklemek için `--non-interactive` kullanın:
|
||||
İlk kurulumu otomatikleştirmek veya betik haline getirmek için `--non-interactive` kullanın:
|
||||
|
||||
```bash
|
||||
openclaw onboard --non-interactive \
|
||||
@ -165,7 +165,7 @@ openclaw onboard --non-interactive \
|
||||
|
||||
Makine tarafından okunabilir bir özet için `--json` ekleyin.
|
||||
|
||||
Etkileşimsiz modda gateway token SecretRef:
|
||||
Etkileşimsiz modda Gateway token SecretRef:
|
||||
|
||||
```bash
|
||||
export OPENCLAW_GATEWAY_TOKEN="your-token"
|
||||
@ -182,8 +182,8 @@ openclaw onboard --non-interactive \
|
||||
`--json`, etkileşimsiz modu **ima etmez**. Betikler için `--non-interactive` (ve `--workspace`) kullanın.
|
||||
</Note>
|
||||
|
||||
Provider'a özgü komut örnekleri [CLI Automation](/tr/start/wizard-cli-automation#provider-specific-examples) içinde bulunur.
|
||||
İşaret semantiği ve adım sıralaması için bu başvuru sayfasını kullanın.
|
||||
Sağlayıcıya özgü komut örnekleri [CLI Automation](/tr/start/wizard-cli-automation#provider-specific-examples) içinde bulunur.
|
||||
Bayrak anlamları ve adım sıralaması için bu başvuru sayfasını kullanın.
|
||||
|
||||
### Ajan ekle (etkileşimsiz)
|
||||
|
||||
@ -196,39 +196,39 @@ openclaw agents add work \
|
||||
--json
|
||||
```
|
||||
|
||||
## Gateway wizard RPC
|
||||
## Gateway sihirbazı RPC
|
||||
|
||||
Gateway, onboarding akışını RPC üzerinden sunar (`wizard.start`, `wizard.next`, `wizard.cancel`, `wizard.status`).
|
||||
İstemciler (macOS uygulaması, Control UI), onboarding mantığını yeniden uygulamadan adımları işleyebilir.
|
||||
Gateway, ilk kurulum akışını RPC üzerinden sunar (`wizard.start`, `wizard.next`, `wizard.cancel`, `wizard.status`).
|
||||
İstemciler (macOS uygulaması, Control UI), ilk kurulum mantığını yeniden uygulamadan adımları işleyebilir.
|
||||
|
||||
## Signal kurulumu (`signal-cli`)
|
||||
## Signal kurulumu (signal-cli)
|
||||
|
||||
Onboarding, `signal-cli` uygulamasını GitHub sürümlerinden kurabilir:
|
||||
İlk kurulum, `signal-cli` aracını GitHub sürümlerinden kurabilir:
|
||||
|
||||
- Uygun sürüm varlığını indirir.
|
||||
- Bunu `~/.openclaw/tools/signal-cli/<version>/` altında saklar.
|
||||
- Yapılandırmanıza `channels.signal.cliPath` yazar.
|
||||
- Bunu `~/.openclaw/tools/signal-cli/<version>/` altına kaydeder.
|
||||
- `channels.signal.cliPath` alanını yapılandırmanıza yazar.
|
||||
|
||||
Notlar:
|
||||
|
||||
- JVM derlemeleri **Java 21** gerektirir.
|
||||
- Mümkün olduğunda yerel derlemeler kullanılır.
|
||||
- Windows, WSL2 kullanır; `signal-cli` kurulumu WSL içindeki Linux akışını izler.
|
||||
- JVM yapıları **Java 21** gerektirir.
|
||||
- Mümkün olduğunda yerel yapılar kullanılır.
|
||||
- Windows WSL2 kullanır; signal-cli kurulumu WSL içindeki Linux akışını izler.
|
||||
|
||||
## Wizard'ın yazdığı şeyler
|
||||
## Sihirbazın yazdığı şeyler
|
||||
|
||||
`~/.openclaw/openclaw.json` içindeki tipik alanlar:
|
||||
|
||||
- `agents.defaults.workspace`
|
||||
- `agents.defaults.model` / `models.providers` (MiniMax seçildiyse)
|
||||
- `tools.profile` (yerel onboarding, ayarlanmamışsa varsayılan olarak `"coding"` kullanır; mevcut açık değerler korunur)
|
||||
- `tools.profile` (yerel ilk kurulum, ayarlanmamışsa varsayılan olarak `"coding"` kullanır; mevcut açık değerler korunur)
|
||||
- `gateway.*` (mod, bind, auth, tailscale)
|
||||
- `session.dmScope` (davranış ayrıntıları: [CLI Setup Reference](/tr/start/wizard-cli-reference#outputs-and-internals))
|
||||
- `channels.telegram.botToken`, `channels.discord.token`, `channels.matrix.*`, `channels.signal.*`, `channels.imessage.*`
|
||||
- İstemlerde katıldığınızda kanal izin listeleri (Slack/Discord/Matrix/Microsoft Teams) mümkün olduğunda adlardan kimliklere çözülür.
|
||||
- İstemler sırasında seçerek etkinleştirdiğinizde kanal izin listeleri (Slack/Discord/Matrix/Microsoft Teams) (adlar mümkün olduğunda kimliklere çözülür).
|
||||
- `skills.install.nodeManager`
|
||||
- `setup --node-manager`, `npm`, `pnpm` veya `bun` kabul eder.
|
||||
- El ile yapılandırma, `skills.install.nodeManager` doğrudan ayarlanarak yine de `yarn` kullanabilir.
|
||||
- Elle yapılandırma, `skills.install.nodeManager` alanını doğrudan ayarlayarak hâlâ `yarn` kullanabilir.
|
||||
- `wizard.lastRunAt`
|
||||
- `wizard.lastRunVersion`
|
||||
- `wizard.lastRunCommit`
|
||||
@ -240,13 +240,12 @@ Notlar:
|
||||
WhatsApp kimlik bilgileri `~/.openclaw/credentials/whatsapp/<accountId>/` altında bulunur.
|
||||
Oturumlar `~/.openclaw/agents/<agentId>/sessions/` altında saklanır.
|
||||
|
||||
Bazı kanallar plugin olarak sunulur. Kurulum sırasında birini seçtiğinizde onboarding,
|
||||
yapılandırılmadan önce onu kurmanızı ister (npm veya yerel bir yol).
|
||||
Bazı kanallar Plugin olarak sunulur. Kurulum sırasında bunlardan birini seçtiğinizde, yapılandırılabilmeden önce ilk kurulum onu yüklemenizi ister (npm veya yerel bir yol ile).
|
||||
|
||||
## İlgili belgeler
|
||||
|
||||
- Onboarding genel bakışı: [Onboarding (CLI)](/tr/start/wizard)
|
||||
- macOS uygulaması onboarding'i: [Onboarding](/tr/start/onboarding)
|
||||
- İlk kurulum genel bakışı: [Onboarding (CLI)](/tr/start/wizard)
|
||||
- macOS uygulamasıyla ilk kurulum: [Onboarding](/tr/start/onboarding)
|
||||
- Yapılandırma başvurusu: [Gateway configuration](/tr/gateway/configuration)
|
||||
- Provider'lar: [WhatsApp](/tr/channels/whatsapp), [Telegram](/tr/channels/telegram), [Discord](/tr/channels/discord), [Google Chat](/tr/channels/googlechat), [Signal](/tr/channels/signal), [BlueBubbles](/tr/channels/bluebubbles) (iMessage), [iMessage](/tr/channels/imessage) (eski)
|
||||
- Sağlayıcılar: [WhatsApp](/tr/channels/whatsapp), [Telegram](/tr/channels/telegram), [Discord](/tr/channels/discord), [Google Chat](/tr/channels/googlechat), [Signal](/tr/channels/signal), [BlueBubbles](/tr/channels/bluebubbles) (iMessage), [iMessage](/tr/channels/imessage) (eski)
|
||||
- Skills: [Skills](/tr/tools/skills), [Skills config](/tr/tools/skills-config)
|
||||
|
||||
@ -6,42 +6,42 @@ sidebarTitle: CLI reference
|
||||
summary: CLI kurulum akışı, kimlik doğrulama/model kurulumu, çıktılar ve iç yapılar için eksiksiz başvuru
|
||||
title: CLI Kurulum Başvurusu
|
||||
x-i18n:
|
||||
generated_at: "2026-04-06T03:13:27Z"
|
||||
generated_at: "2026-04-15T14:41:05Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 92f379b34a2b48c68335dae4f759117c770f018ec51b275f4f40421c6b3abb23
|
||||
source_hash: 61ca679caca3b43fa02388294007f89db22d343e49e10b61d8d118cd8fbb7369
|
||||
source_path: start/wizard-cli-reference.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# CLI Kurulum Başvurusu
|
||||
|
||||
Bu sayfa, `openclaw onboard` için tam başvurudur.
|
||||
Bu sayfa, `openclaw onboard` için eksiksiz başvurudur.
|
||||
Kısa kılavuz için bkz. [Onboarding (CLI)](/tr/start/wizard).
|
||||
|
||||
## Sihirbaz ne yapar
|
||||
|
||||
Yerel kip (varsayılan) sizi şu adımlardan geçirir:
|
||||
Yerel mod (varsayılan) size şu adımlarda rehberlik eder:
|
||||
|
||||
- Model ve kimlik doğrulama kurulumu (OpenAI Code abonelik OAuth, Anthropic Claude CLI veya API anahtarı, ayrıca MiniMax, GLM, Ollama, Moonshot, StepFun ve AI Gateway seçenekleri)
|
||||
- Çalışma alanı konumu ve bootstrap dosyaları
|
||||
- Model ve kimlik doğrulama kurulumu (OpenAI Code aboneliği OAuth’u, Anthropic Claude CLI veya API anahtarı, ayrıca MiniMax, GLM, Ollama, Moonshot, StepFun ve AI Gateway seçenekleri)
|
||||
- Çalışma alanı konumu ve önyükleme dosyaları
|
||||
- Gateway ayarları (port, bind, auth, tailscale)
|
||||
- Kanallar ve sağlayıcılar (Telegram, WhatsApp, Discord, Google Chat, Mattermost, Signal, BlueBubbles ve diğer paketlenmiş kanal plugin'leri)
|
||||
- Daemon kurulumu (LaunchAgent, systemd kullanıcı birimi veya Startup-folder geri dönüşü olan yerel Windows Scheduled Task)
|
||||
- Sağlık denetimi
|
||||
- Kanallar ve sağlayıcılar (Telegram, WhatsApp, Discord, Google Chat, Mattermost, Signal, BlueBubbles ve diğer paketlenmiş kanal Plugin’leri)
|
||||
- Artalan süreci kurulumu (LaunchAgent, systemd kullanıcı birimi veya Başlangıç klasörü geri dönüş seçeneği olan yerel Windows Scheduled Task)
|
||||
- Durum denetimi
|
||||
- Skills kurulumu
|
||||
|
||||
Uzak kip, bu makineyi başka bir yerdeki gateway'e bağlanacak şekilde yapılandırır.
|
||||
Uzak host üzerinde hiçbir şeyi kurmaz veya değiştirmez.
|
||||
Uzak mod, bu makineyi başka bir yerdeki bir Gateway’e bağlanacak şekilde yapılandırır.
|
||||
Uzak ana makinede hiçbir şey kurmaz veya değiştirmez.
|
||||
|
||||
## Yerel akış ayrıntıları
|
||||
|
||||
<Steps>
|
||||
<Step title="Mevcut yapılandırma algılama">
|
||||
- `~/.openclaw/openclaw.json` mevcutsa Keep, Modify veya Reset seçeneklerinden birini seçin.
|
||||
- Sihirbazı yeniden çalıştırmak, siz açıkça Reset seçmedikçe (veya `--reset` geçmedikçe) hiçbir şeyi silmez.
|
||||
- `~/.openclaw/openclaw.json` mevcutsa Keep, Modify veya Reset seçeneklerinden birini belirleyin.
|
||||
- Sihirbazı yeniden çalıştırmak, siz açıkça Reset seçmediğiniz sürece (veya `--reset` geçmediğiniz sürece) hiçbir şeyi silmez.
|
||||
- CLI `--reset` varsayılan olarak `config+creds+sessions` kullanır; çalışma alanını da kaldırmak için `--reset-scope full` kullanın.
|
||||
- Yapılandırma geçersizse veya eski anahtarlar içeriyorsa, sihirbaz devam etmeden önce `openclaw doctor` çalıştırmanızı isteyerek durur.
|
||||
- Yapılandırma geçersizse veya eski anahtarlar içeriyorsa, sihirbaz durur ve devam etmeden önce `openclaw doctor` çalıştırmanızı ister.
|
||||
- Reset, `trash` kullanır ve şu kapsamları sunar:
|
||||
- Yalnızca yapılandırma
|
||||
- Yapılandırma + kimlik bilgileri + oturumlar
|
||||
@ -52,53 +52,52 @@ Uzak host üzerinde hiçbir şeyi kurmaz veya değiştirmez.
|
||||
</Step>
|
||||
<Step title="Çalışma alanı">
|
||||
- Varsayılan `~/.openclaw/workspace` (yapılandırılabilir).
|
||||
- İlk çalıştırma bootstrap ritüeli için gereken çalışma alanı dosyalarını tohumlar.
|
||||
- Çalışma alanı düzeni: [Agent çalışma alanı](/tr/concepts/agent-workspace).
|
||||
- İlk çalıştırma önyükleme ritüeli için gereken çalışma alanı dosyalarını oluşturur.
|
||||
- Çalışma alanı düzeni: [Ajan çalışma alanı](/tr/concepts/agent-workspace).
|
||||
</Step>
|
||||
<Step title="Gateway">
|
||||
- Port, bind, auth kipi ve tailscale erişimi için istemde bulunur.
|
||||
- Önerilen: loopback için bile belirteç kimlik doğrulamasını etkin tutun; böylece yerel WS istemcileri kimlik doğrulaması yapmak zorunda kalır.
|
||||
- Belirteç kipinde, etkileşimli kurulum şunları sunar:
|
||||
- **Düz metin belirteç oluştur/depola** (varsayılan)
|
||||
- Port, bind, auth modu ve tailscale erişimi için istemde bulunur.
|
||||
- Önerilen: yerel WS istemcilerinin kimlik doğrulaması yapmasını zorunlu kılmak için loopback üzerinde bile token auth etkin kalsın.
|
||||
- Token modunda, etkileşimli kurulum şunları sunar:
|
||||
- **Düz metin token oluştur/sakla** (varsayılan)
|
||||
- **SecretRef kullan** (isteğe bağlı)
|
||||
- Parola kipinde, etkileşimli kurulum ayrıca düz metin veya SecretRef depolamayı destekler.
|
||||
- Etkileşimsiz belirteç SecretRef yolu: `--gateway-token-ref-env <ENV_VAR>`.
|
||||
- Onboarding süreci ortamında boş olmayan bir ortam değişkeni gerektirir.
|
||||
- Parola modunda, etkileşimli kurulum düz metin veya SecretRef depolamayı da destekler.
|
||||
- Etkileşimsiz token SecretRef yolu: `--gateway-token-ref-env <ENV_VAR>`.
|
||||
- Onboarding işlem ortamında boş olmayan bir ortam değişkeni gerektirir.
|
||||
- `--gateway-token` ile birlikte kullanılamaz.
|
||||
- Yalnızca tüm yerel süreçlere tamamen güveniyorsanız kimlik doğrulamayı devre dışı bırakın.
|
||||
- Loopback dışı bind işlemleri hâlâ kimlik doğrulama gerektirir.
|
||||
- Auth’u yalnızca her yerel sürece tamamen güveniyorsanız devre dışı bırakın.
|
||||
- Loopback dışı bind’lerde de auth gereklidir.
|
||||
</Step>
|
||||
<Step title="Kanallar">
|
||||
- [WhatsApp](/tr/channels/whatsapp): isteğe bağlı QR oturum açma
|
||||
- [Telegram](/tr/channels/telegram): bot belirteci
|
||||
- [Discord](/tr/channels/discord): bot belirteci
|
||||
- [Google Chat](/tr/channels/googlechat): hizmet hesabı JSON'u + webhook audience
|
||||
- [Mattermost](/tr/channels/mattermost): bot belirteci + temel URL
|
||||
- [WhatsApp](/tr/channels/whatsapp): isteğe bağlı QR girişi
|
||||
- [Telegram](/tr/channels/telegram): bot token’ı
|
||||
- [Discord](/tr/channels/discord): bot token’ı
|
||||
- [Google Chat](/tr/channels/googlechat): hizmet hesabı JSON’u + Webhook audience
|
||||
- [Mattermost](/tr/channels/mattermost): bot token’ı + temel URL
|
||||
- [Signal](/tr/channels/signal): isteğe bağlı `signal-cli` kurulumu + hesap yapılandırması
|
||||
- [BlueBubbles](/tr/channels/bluebubbles): iMessage için önerilir; sunucu URL'si + parola + webhook
|
||||
- [BlueBubbles](/tr/channels/bluebubbles): iMessage için önerilir; sunucu URL’si + parola + Webhook
|
||||
- [iMessage](/tr/channels/imessage): eski `imsg` CLI yolu + DB erişimi
|
||||
- DM güvenliği: varsayılan eşleştirmedir. İlk DM bir kod gönderir; bunu
|
||||
`openclaw pairing approve <channel> <code>` ile onaylayın veya allowlist kullanın.
|
||||
- DM güvenliği: varsayılan pairing’dir. İlk DM bir kod gönderir; `openclaw pairing approve <channel> <code>` ile onaylayın veya allowlist kullanın.
|
||||
</Step>
|
||||
<Step title="Daemon kurulumu">
|
||||
<Step title="Artalan süreci kurulumu">
|
||||
- macOS: LaunchAgent
|
||||
- Oturum açmış kullanıcı oturumu gerektirir; headless için özel bir LaunchDaemon kullanın (gönderilmez).
|
||||
- Linux ve WSL2 üzerinden Windows: systemd kullanıcı birimi
|
||||
- Gateway'in oturum kapatıldıktan sonra da çalışmaya devam etmesi için sihirbaz `loginctl enable-linger <user>` çalıştırmayı dener.
|
||||
- Oturum açmış kullanıcı oturumu gerektirir; başsız kullanım için özel bir LaunchDaemon kullanın (paketlenmez).
|
||||
- Linux ve Windows üzerinden WSL2: systemd kullanıcı birimi
|
||||
- Sihirbaz, çıkıştan sonra da Gateway’in çalışır kalması için `loginctl enable-linger <user>` komutunu denemeye çalışır.
|
||||
- sudo isteyebilir (`/var/lib/systemd/linger` yazar); önce sudo olmadan dener.
|
||||
- Yerel Windows: önce Scheduled Task
|
||||
- Görev oluşturma reddedilirse, OpenClaw kullanıcı başına Startup-folder oturum açma öğesine geri döner ve gateway'i hemen başlatır.
|
||||
- Scheduled Task'lar daha iyi supervisor durumu sağladıkları için tercih edilmeye devam eder.
|
||||
- Görev oluşturma reddedilirse OpenClaw, kullanıcı başına Başlangıç klasörü giriş öğesine geri döner ve Gateway’i hemen başlatır.
|
||||
- Scheduled Task tercih edilmeye devam edilir çünkü daha iyi supervisor durumu sağlarlar.
|
||||
- Çalışma zamanı seçimi: Node (önerilir; WhatsApp ve Telegram için gereklidir). Bun önerilmez.
|
||||
</Step>
|
||||
<Step title="Sağlık denetimi">
|
||||
- Gateway'i başlatır (gerekirse) ve `openclaw health` çalıştırır.
|
||||
- `openclaw status --deep`, desteklendiğinde kanal yoklamaları da dahil olmak üzere canlı gateway sağlık yoklamasını durum çıktısına ekler.
|
||||
<Step title="Durum denetimi">
|
||||
- Gateway’i başlatır (gerekiyorsa) ve `openclaw health` çalıştırır.
|
||||
- `openclaw status --deep`, desteklendiğinde kanal probları dahil olmak üzere canlı Gateway durum probunu durum çıktısına ekler.
|
||||
</Step>
|
||||
<Step title="Skills">
|
||||
- Kullanılabilir skills'leri okur ve gereksinimleri denetler.
|
||||
- Düğüm yöneticisini seçmenize izin verir: npm, pnpm veya bun.
|
||||
- İsteğe bağlı bağımlılıkları kurar (bazıları macOS'ta Homebrew kullanır).
|
||||
- Kullanılabilir Skills’i okur ve gereksinimleri denetler.
|
||||
- Node yöneticisini seçmenize izin verir: npm, pnpm veya bun.
|
||||
- İsteğe bağlı bağımlılıkları kurar (bazıları macOS üzerinde Homebrew kullanır).
|
||||
</Step>
|
||||
<Step title="Bitir">
|
||||
- iOS, Android ve macOS uygulama seçenekleri dahil özet ve sonraki adımlar.
|
||||
@ -106,22 +105,22 @@ Uzak host üzerinde hiçbir şeyi kurmaz veya değiştirmez.
|
||||
</Steps>
|
||||
|
||||
<Note>
|
||||
GUI algılanmazsa sihirbaz tarayıcı açmak yerine Control UI için SSH port-forward yönergelerini yazdırır.
|
||||
Control UI varlıkları eksikse sihirbaz bunları oluşturmayı dener; geri dönüş olarak `pnpm ui:build` kullanılır (UI bağımlılıklarını otomatik kurar).
|
||||
GUI algılanmazsa sihirbaz, bir tarayıcı açmak yerine Control UI için SSH port yönlendirme yönergelerini yazdırır.
|
||||
Control UI varlıkları eksikse sihirbaz bunları oluşturmaya çalışır; geri dönüş olarak `pnpm ui:build` kullanılır (UI bağımlılıklarını otomatik kurar).
|
||||
</Note>
|
||||
|
||||
## Uzak kip ayrıntıları
|
||||
## Uzak mod ayrıntıları
|
||||
|
||||
Uzak kip, bu makineyi başka bir yerdeki gateway'e bağlanacak şekilde yapılandırır.
|
||||
Uzak mod, bu makineyi başka bir yerdeki bir Gateway’e bağlanacak şekilde yapılandırır.
|
||||
|
||||
<Info>
|
||||
Uzak kip, uzak host üzerinde hiçbir şeyi kurmaz veya değiştirmez.
|
||||
Uzak mod, uzak ana makinede hiçbir şey kurmaz veya değiştirmez.
|
||||
</Info>
|
||||
|
||||
Ayarladığınız şeyler:
|
||||
Ayarladıklarınız:
|
||||
|
||||
- Uzak gateway URL'si (`ws://...`)
|
||||
- Uzak gateway auth gerekiyorsa belirteç (önerilir)
|
||||
- Uzak Gateway URL’si (`ws://...`)
|
||||
- Uzak Gateway auth gerektiriyorsa token (önerilir)
|
||||
|
||||
<Note>
|
||||
- Gateway yalnızca loopback ise SSH tünelleme veya bir tailnet kullanın.
|
||||
@ -134,13 +133,13 @@ Ayarladığınız şeyler:
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Anthropic API anahtarı">
|
||||
Varsa `ANTHROPIC_API_KEY` kullanır veya bir anahtar ister, ardından daemon kullanımı için kaydeder.
|
||||
Varsa `ANTHROPIC_API_KEY` kullanır veya bir anahtar ister, ardından artalan süreci kullanımı için bunu kaydeder.
|
||||
</Accordion>
|
||||
<Accordion title="OpenAI Code aboneliği (Codex CLI yeniden kullanımı)">
|
||||
`~/.codex/auth.json` mevcutsa sihirbaz bunu yeniden kullanabilir.
|
||||
Yeniden kullanılan Codex CLI kimlik bilgileri Codex CLI tarafından yönetilmeye devam eder; süre dolduğunda OpenClaw
|
||||
önce bu kaynağı yeniden okur ve sağlayıcı bunu yenileyebiliyorsa
|
||||
yenilenmiş kimlik bilgisini sahiplenmek yerine tekrar Codex depolamasına yazar.
|
||||
Yeniden kullanılan Codex CLI kimlik bilgileri, Codex CLI tarafından yönetilmeye devam eder; süre dolduğunda OpenClaw
|
||||
önce bu kaynağı yeniden okur ve sağlayıcı bunu yenileyebildiğinde
|
||||
kimlik bilgisini sahipliğini üstlenmek yerine yeniden Codex deposuna yazar.
|
||||
</Accordion>
|
||||
<Accordion title="OpenAI Code aboneliği (OAuth)">
|
||||
Tarayıcı akışı; `code#state` yapıştırın.
|
||||
@ -149,36 +148,36 @@ Ayarladığınız şeyler:
|
||||
|
||||
</Accordion>
|
||||
<Accordion title="OpenAI API anahtarı">
|
||||
Varsa `OPENAI_API_KEY` kullanır veya bir anahtar ister, ardından kimlik bilgisini auth profillerinde depolar.
|
||||
Varsa `OPENAI_API_KEY` kullanır veya bir anahtar ister, ardından kimlik bilgisini auth profillerinde saklar.
|
||||
|
||||
Model ayarlanmamışsa, `openai/*` ise veya `openai-codex/*` ise `agents.defaults.model` değerini `openai/gpt-5.4` olarak ayarlar.
|
||||
|
||||
</Accordion>
|
||||
<Accordion title="xAI (Grok) API anahtarı">
|
||||
`XAI_API_KEY` ister ve xAI'ı model sağlayıcısı olarak yapılandırır.
|
||||
`XAI_API_KEY` ister ve xAI’yi model sağlayıcısı olarak yapılandırır.
|
||||
</Accordion>
|
||||
<Accordion title="OpenCode">
|
||||
`OPENCODE_API_KEY` (veya `OPENCODE_ZEN_API_KEY`) ister ve Zen veya Go kataloğunu seçmenize izin verir.
|
||||
Kurulum URL'si: [opencode.ai/auth](https://opencode.ai/auth).
|
||||
`OPENCODE_API_KEY` (veya `OPENCODE_ZEN_API_KEY`) ister ve Zen ya da Go kataloğunu seçmenize izin verir.
|
||||
Kurulum URL’si: [opencode.ai/auth](https://opencode.ai/auth).
|
||||
</Accordion>
|
||||
<Accordion title="API anahtarı (genel)">
|
||||
Anahtarı sizin için depolar.
|
||||
Anahtarı sizin için saklar.
|
||||
</Accordion>
|
||||
<Accordion title="Vercel AI Gateway">
|
||||
`AI_GATEWAY_API_KEY` ister.
|
||||
Daha fazla ayrıntı: [Vercel AI Gateway](/tr/providers/vercel-ai-gateway).
|
||||
</Accordion>
|
||||
<Accordion title="Cloudflare AI Gateway">
|
||||
Hesap kimliği, gateway kimliği ve `CLOUDFLARE_AI_GATEWAY_API_KEY` ister.
|
||||
Hesap kimliği, Gateway kimliği ve `CLOUDFLARE_AI_GATEWAY_API_KEY` ister.
|
||||
Daha fazla ayrıntı: [Cloudflare AI Gateway](/tr/providers/cloudflare-ai-gateway).
|
||||
</Accordion>
|
||||
<Accordion title="MiniMax">
|
||||
Yapılandırma otomatik olarak yazılır. Barındırılan varsayılan `MiniMax-M2.7`'dir; API anahtarı kurulumu
|
||||
Yapılandırma otomatik yazılır. Barındırılan varsayılan `MiniMax-M2.7`’dir; API anahtarı kurulumu
|
||||
`minimax/...`, OAuth kurulumu ise `minimax-portal/...` kullanır.
|
||||
Daha fazla ayrıntı: [MiniMax](/tr/providers/minimax).
|
||||
</Accordion>
|
||||
<Accordion title="StepFun">
|
||||
Yapılandırma, Çin veya global uç noktalarda StepFun standard veya Step Plan için otomatik yazılır.
|
||||
Yapılandırma, Çin veya global uç noktalardaki StepFun standardı ya da Step Plan için otomatik yazılır.
|
||||
Standard şu anda `step-3.5-flash` içerir ve Step Plan ayrıca `step-3.5-flash-2603` içerir.
|
||||
Daha fazla ayrıntı: [StepFun](/tr/providers/stepfun).
|
||||
</Accordion>
|
||||
@ -186,9 +185,11 @@ Ayarladığınız şeyler:
|
||||
`SYNTHETIC_API_KEY` ister.
|
||||
Daha fazla ayrıntı: [Synthetic](/tr/providers/synthetic).
|
||||
</Accordion>
|
||||
<Accordion title="Ollama (Cloud ve yerel açık modeller)">
|
||||
Temel URL'yi ister (varsayılan `http://127.0.0.1:11434`), sonra Cloud + Local veya Local kipini sunar.
|
||||
Kullanılabilir modelleri keşfeder ve varsayılanlar önerir.
|
||||
<Accordion title="Ollama (Bulut ve yerel açık modeller)">
|
||||
Önce `Bulut + Yerel`, `Yalnızca Bulut` veya `Yalnızca Yerel` seçeneklerini ister.
|
||||
`Yalnızca Bulut`, `https://ollama.com` ile `OLLAMA_API_KEY` kullanır.
|
||||
Ana makine destekli modlar temel URL’yi ister (varsayılan `http://127.0.0.1:11434`), kullanılabilir modelleri keşfeder ve varsayılanlar önerir.
|
||||
`Bulut + Yerel`, ayrıca o Ollama ana makinesinin bulut erişimi için oturum açıp açmadığını da denetler.
|
||||
Daha fazla ayrıntı: [Ollama](/tr/providers/ollama).
|
||||
</Accordion>
|
||||
<Accordion title="Moonshot ve Kimi Coding">
|
||||
@ -200,64 +201,65 @@ Ayarladığınız şeyler:
|
||||
|
||||
Etkileşimli onboarding, diğer sağlayıcı API anahtarı akışlarıyla aynı API anahtarı depolama seçeneklerini destekler:
|
||||
- **API anahtarını şimdi yapıştır** (düz metin)
|
||||
- **Gizli başvuru kullan** (ortam başvurusu veya yapılandırılmış sağlayıcı başvurusu, ön denetim doğrulaması ile)
|
||||
- **Gizli başvurusu kullan** (ortam başvurusu veya yapılandırılmış sağlayıcı başvurusu, ön denetim doğrulaması ile)
|
||||
|
||||
Etkileşimsiz bayraklar:
|
||||
- `--auth-choice custom-api-key`
|
||||
- `--custom-base-url`
|
||||
- `--custom-model-id`
|
||||
- `--custom-api-key` (isteğe bağlı; `CUSTOM_API_KEY` değerine geri döner)
|
||||
- `--custom-api-key` (isteğe bağlı; varsayılan olarak `CUSTOM_API_KEY` kullanılır)
|
||||
- `--custom-provider-id` (isteğe bağlı)
|
||||
- `--custom-compatibility <openai|anthropic>` (isteğe bağlı; varsayılan `openai`)
|
||||
|
||||
</Accordion>
|
||||
<Accordion title="Atla">
|
||||
Kimlik doğrulamayı yapılandırılmamış bırakır.
|
||||
Auth yapılandırılmadan bırakır.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
Model davranışı:
|
||||
|
||||
- Algılanan seçeneklerden varsayılan modeli seçin veya sağlayıcı ve modeli elle girin.
|
||||
- Onboarding bir sağlayıcı kimlik doğrulama seçeneğinden başladığında model seçici
|
||||
o sağlayıcıyı otomatik olarak tercih eder. Volcengine ve BytePlus için aynı tercih
|
||||
kodlama planı varyantlarıyla da eşleşir (`volcengine-plan/*`,
|
||||
- Onboarding bir sağlayıcı auth seçeneğinden başladığında model seçici,
|
||||
o sağlayıcıyı otomatik olarak tercih eder. Volcengine ve BytePlus için bu tercih
|
||||
onların coding-plan varyantlarıyla da eşleşir (`volcengine-plan/*`,
|
||||
`byteplus-plan/*`).
|
||||
- Tercih edilen sağlayıcı filtresi boş kalacaksa, seçici hiç model göstermemek yerine tam kataloğa geri döner.
|
||||
- Sihirbaz bir model denetimi çalıştırır ve yapılandırılmış model bilinmiyorsa veya kimlik doğrulaması eksikse uyarır.
|
||||
- Tercih edilen sağlayıcı filtresi boş kalırsa seçici,
|
||||
hiç model göstermemek yerine tam kataloğa geri döner.
|
||||
- Sihirbaz bir model denetimi çalıştırır ve yapılandırılan model bilinmiyorsa veya auth eksikse uyarı verir.
|
||||
|
||||
Kimlik bilgisi ve profil yolları:
|
||||
|
||||
- Kimlik doğrulama profilleri (API anahtarları + OAuth): `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
|
||||
- Eski OAuth içe aktarma kaynağı: `~/.openclaw/credentials/oauth.json`
|
||||
- Auth profilleri (API anahtarları + OAuth): `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
|
||||
- Eski OAuth içe aktarma: `~/.openclaw/credentials/oauth.json`
|
||||
|
||||
Kimlik bilgisi depolama kipi:
|
||||
Kimlik bilgisi depolama modu:
|
||||
|
||||
- Varsayılan onboarding davranışı, API anahtarlarını auth profillerinde düz metin değerler olarak kalıcı yazar.
|
||||
- `--secret-input-mode ref`, düz metin anahtar depolama yerine başvuru kipini etkinleştirir.
|
||||
- Varsayılan onboarding davranışı, API anahtarlarını auth profillerinde düz metin değerler olarak kalıcılaştırır.
|
||||
- `--secret-input-mode ref`, düz metin anahtar depolaması yerine başvuru modunu etkinleştirir.
|
||||
Etkileşimli kurulumda şunlardan birini seçebilirsiniz:
|
||||
- ortam değişkeni başvurusu (örneğin `keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" }`)
|
||||
- sağlayıcı takma adı + kimlik ile yapılandırılmış sağlayıcı başvurusu (`file` veya `exec`)
|
||||
- Etkileşimli başvuru kipi kaydetmeden önce hızlı bir ön denetim doğrulaması çalıştırır.
|
||||
- Ortam başvuruları: mevcut onboarding ortamında değişken adını + boş olmayan değeri doğrular.
|
||||
- Etkileşimli başvuru modu, kaydetmeden önce hızlı bir ön denetim doğrulaması çalıştırır.
|
||||
- Ortam başvuruları: değişken adını ve mevcut onboarding ortamındaki boş olmayan değeri doğrular.
|
||||
- Sağlayıcı başvuruları: sağlayıcı yapılandırmasını doğrular ve istenen kimliği çözümler.
|
||||
- Ön denetim başarısız olursa onboarding hatayı gösterir ve yeniden denemenize izin verir.
|
||||
- Etkileşimsiz kipte `--secret-input-mode ref` yalnızca ortam desteklidir.
|
||||
- Sağlayıcı ortam değişkenini onboarding süreci ortamında ayarlayın.
|
||||
- Etkileşimsiz modda `--secret-input-mode ref` yalnızca ortam desteklidir.
|
||||
- Sağlayıcı ortam değişkenini onboarding işlem ortamında ayarlayın.
|
||||
- Satır içi anahtar bayrakları (örneğin `--openai-api-key`) bu ortam değişkeninin ayarlanmış olmasını gerektirir; aksi halde onboarding hızlıca başarısız olur.
|
||||
- Özel sağlayıcılar için etkileşimsiz `ref` kipi, `models.providers.<id>.apiKey` değerini `{ source: "env", provider: "default", id: "CUSTOM_API_KEY" }` olarak depolar.
|
||||
- Özel sağlayıcılar için etkileşimsiz `ref` modu, `models.providers.<id>.apiKey` değerini `{ source: "env", provider: "default", id: "CUSTOM_API_KEY" }` olarak saklar.
|
||||
- Bu özel sağlayıcı durumunda `--custom-api-key`, `CUSTOM_API_KEY` ayarlanmış olmasını gerektirir; aksi halde onboarding hızlıca başarısız olur.
|
||||
- Gateway kimlik doğrulama kimlik bilgileri, etkileşimli kurulumda düz metin ve SecretRef seçeneklerini destekler:
|
||||
- Belirteç kipi: **Düz metin belirteç oluştur/depola** (varsayılan) veya **SecretRef kullan**.
|
||||
- Parola kipi: düz metin veya SecretRef.
|
||||
- Etkileşimsiz belirteç SecretRef yolu: `--gateway-token-ref-env <ENV_VAR>`.
|
||||
- Mevcut düz metin kurulumları değişmeden çalışmaya devam eder.
|
||||
- Gateway auth kimlik bilgileri, etkileşimli kurulumda düz metin ve SecretRef seçeneklerini destekler:
|
||||
- Token modu: **Düz metin token oluştur/sakla** (varsayılan) veya **SecretRef kullan**.
|
||||
- Parola modu: düz metin veya SecretRef.
|
||||
- Etkileşimsiz token SecretRef yolu: `--gateway-token-ref-env <ENV_VAR>`.
|
||||
- Mevcut düz metin kurulumlar değişmeden çalışmaya devam eder.
|
||||
|
||||
<Note>
|
||||
Headless ve sunucu ipucu: OAuth'u tarayıcısı olan bir makinede tamamlayın, sonra
|
||||
o agent'in `auth-profiles.json` dosyasını (örneğin
|
||||
Başsız ve sunucu ipucu: OAuth’u tarayıcısı olan bir makinede tamamlayın, ardından
|
||||
o ajanın `auth-profiles.json` dosyasını (örneğin
|
||||
`~/.openclaw/agents/<agentId>/agent/auth-profiles.json` veya eşleşen
|
||||
`$OPENCLAW_STATE_DIR/...` yolu) gateway host'una kopyalayın. `credentials/oauth.json`
|
||||
`$OPENCLAW_STATE_DIR/...` yolu) Gateway ana makinesine kopyalayın. `credentials/oauth.json`
|
||||
yalnızca eski bir içe aktarma kaynağıdır.
|
||||
</Note>
|
||||
|
||||
@ -267,14 +269,14 @@ yalnızca eski bir içe aktarma kaynağıdır.
|
||||
|
||||
- `agents.defaults.workspace`
|
||||
- `agents.defaults.model` / `models.providers` (MiniMax seçildiyse)
|
||||
- `tools.profile` (yerel onboarding, ayarlanmamışsa bunu varsayılan olarak `"coding"` yapar; mevcut açık değerler korunur)
|
||||
- `tools.profile` (yerel onboarding, ayarlanmamışsa varsayılan olarak `"coding"` kullanır; mevcut açık değerler korunur)
|
||||
- `gateway.*` (mode, bind, auth, tailscale)
|
||||
- `session.dmScope` (yerel onboarding, ayarlanmamışsa bunu varsayılan olarak `per-channel-peer` yapar; mevcut açık değerler korunur)
|
||||
- `session.dmScope` (yerel onboarding, ayarlanmamışsa varsayılan olarak `per-channel-peer` yapar; mevcut açık değerler korunur)
|
||||
- `channels.telegram.botToken`, `channels.discord.token`, `channels.matrix.*`, `channels.signal.*`, `channels.imessage.*`
|
||||
- İstemler sırasında buna katıldığınızda kanal allowlist'leri (Slack, Discord, Matrix, Microsoft Teams) mümkün olduğunda adlar kimliklere çözümlenir
|
||||
- İstemlerde katıldığınızda kanal allowlist’leri (Slack, Discord, Matrix, Microsoft Teams) (adlar mümkün olduğunda kimliklere çözümlenir)
|
||||
- `skills.install.nodeManager`
|
||||
- `setup --node-manager` bayrağı `npm`, `pnpm` veya `bun` kabul eder.
|
||||
- El ile yapılandırma daha sonra yine de `skills.install.nodeManager: "yarn"` ayarlayabilir.
|
||||
- Elle yapılandırma daha sonra yine de `skills.install.nodeManager: "yarn"` ayarlayabilir.
|
||||
- `wizard.lastRunAt`
|
||||
- `wizard.lastRunVersion`
|
||||
- `wizard.lastRunCommit`
|
||||
@ -283,12 +285,12 @@ yalnızca eski bir içe aktarma kaynağıdır.
|
||||
|
||||
`openclaw agents add`, `agents.list[]` ve isteğe bağlı `bindings` yazar.
|
||||
|
||||
WhatsApp kimlik bilgileri `~/.openclaw/credentials/whatsapp/<accountId>/` altında bulunur.
|
||||
Oturumlar `~/.openclaw/agents/<agentId>/sessions/` altında depolanır.
|
||||
WhatsApp kimlik bilgileri `~/.openclaw/credentials/whatsapp/<accountId>/` altında tutulur.
|
||||
Oturumlar `~/.openclaw/agents/<agentId>/sessions/` altında saklanır.
|
||||
|
||||
<Note>
|
||||
Bazı kanallar plugin olarak sunulur. Kurulum sırasında seçildiklerinde sihirbaz,
|
||||
kanal yapılandırmasından önce plugin'i kurmanızı ister (npm veya yerel yol).
|
||||
Bazı kanallar Plugin olarak sunulur. Kurulum sırasında seçildiklerinde sihirbaz,
|
||||
kanal yapılandırmasından önce Plugin’i yüklemenizi ister (npm veya yerel yol).
|
||||
</Note>
|
||||
|
||||
Gateway sihirbazı RPC:
|
||||
@ -303,14 +305,14 @@ Gateway sihirbazı RPC:
|
||||
Signal kurulum davranışı:
|
||||
|
||||
- Uygun sürüm varlığını indirir
|
||||
- Bunu `~/.openclaw/tools/signal-cli/<version>/` altına depolar
|
||||
- Bunu `~/.openclaw/tools/signal-cli/<version>/` altında saklar
|
||||
- Yapılandırmaya `channels.signal.cliPath` yazar
|
||||
- JVM derlemeleri Java 21 gerektirir
|
||||
- Mevcut olduğunda yerel derlemeler kullanılır
|
||||
- Windows, WSL2 kullanır ve Linux signal-cli akışını WSL içinde izler
|
||||
- Kullanılabildiğinde yerel derlemeler kullanılır
|
||||
- Windows, WSL2 kullanır ve WSL içinde Linux signal-cli akışını izler
|
||||
|
||||
## İlgili belgeler
|
||||
|
||||
- Onboarding merkezi: [Onboarding (CLI)](/tr/start/wizard)
|
||||
- Otomasyon ve betikler: [CLI Automation](/tr/start/wizard-cli-automation)
|
||||
- Otomasyon ve betikler: [CLI Otomasyonu](/tr/start/wizard-cli-automation)
|
||||
- Komut başvurusu: [`openclaw onboard`](/cli/onboard)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user