chore(i18n): refresh tr translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-15 14:50:05 +00:00
parent b95a4493de
commit 07cbfee8c6
12 changed files with 1979 additions and 1877 deletions

View File

@ -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.
OpenClawun 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.
## Dreamingin 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ıı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ıırlıklı temel sinyal ile evre pekiştirmesini kullanır:
Derin sıralama, evre pekiştirmesine ek olarak altıı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 @@ Dreamingi etkinleştirin:
}
```
Özel bir tarama sıklığıyla Dreamingi etkinleştirin:
Özel bir tarama sıklığı ile Dreamingi 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ı
- dreamingin 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)

View 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
ı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
ı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.

View File

@ -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ıı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ıı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

View File

@ -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

View File

@ -1,28 +1,28 @@
---
read_when:
- Modelleri kendi GPU makinenizden sunmak istiyorsunuz
- LM Studioyu veya OpenAI uyumlu bir proxyyi yapılandırıyorsunuz
- En güvenli yerel model rehberliğine ihtiyacınız var
summary: OpenClawı yerel LLMlerde ç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 injectiona 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 promptlarda 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” checkpointler 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 Studioda 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 Studioyu yükleyin: [https://lmstudio.ai](https://lmstudio.ai)
- LM Studioda 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 Studioda 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 Opusa 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 ABDde 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 proxyler
## Diğer OpenAI uyumlu yerel proxy'ler
vLLM, LiteLLM, OAI-proxy veya özel Gatewayler, 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 Gatewayler, 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/proxylenmiş `/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 OpenAIye ö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 URLlerine 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 proxyye 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` Gemmada 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 promptları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 agentları dar tutun ve Compactionıı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

View File

@ -1,40 +1,35 @@
---
read_when:
- GitHub Copilot'u model sağlayıcısı olarak kullanmak istiyorsunuz
- GitHub Copilotu 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, Copilotu 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 tokenları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 URLyi 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, proxynin `/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. Plugini 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, Copilota ö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 APIsinden 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, Copilotu 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>

View File

@ -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, Ollamanın yerel APIsiyle (`/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 Ollamanın yerel APIsi (`/api/chat`) ile entegre olur. Ollamayı üç 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 URLyi (`http://host:11434/v1`) kullanmayın. Bu, araç çağırmayı bozar ve modeller düz metin olarak ham araç JSONu üretebilir. Bunun yerine yerel Ollama API URLsini kullanın: `baseUrl: "http://host:11434"` (`/v1` olmadan).
**Uzak Ollama kullanıcıları**: OpenClaw ile `/v1` OpenAI uyumlu URLyi (`http://host:11434/v1`) kullanmayın. Bu, araç çağırmayı bozar ve modeller ham araç JSONunu düz metin olarak çıkarabilir. Bunun yerine yerel Ollama API URLsini 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 URLsi 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**: Ollamayı 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**: Ollamayı [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 Ollamayı 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, Ollamanı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 URLsini 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`, Ollamanın `https://ollama.com` adresindeki barındırılan APIsine 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 prompta 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)">
Ollamayı 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 URLsini 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>
URLye `/v1` eklemeyin. `/v1` yolu, araç çağırmanın güvenilir olmadığı OpenAI uyumlu modu kullanır. Yol son eki olmayan temel Ollama URLsini kullanın.
URLye `/v1` eklemeyin. `/v1` yolu, araç çağırmanın güvenilir olmadığı OpenAI uyumlu modu kullanır. Yol son eki olmadan temel Ollama URLsini 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 hostunuzu 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 proxynin 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, Ollamanın sessizce 4096 bağlam penceresine geri dönmemesi için varsayılan olarak `options.num_ctx` ekler. Proxyniz/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.
ık provider yapılandırmasında `contextWindow` ve `maxTokens` değerlerini geçersiz kılabilirsiniz:
`contextWindow` ve `maxTokens` değerleriniı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 Plugini,
[memory search](/tr/concepts/memory) için bir bellek embedding providerı kaydeder. Yapılandırılmış Ollama base URLsini
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 URLsini 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 |
Ollamayı memory search embedding providerı olarak seçmek için:
Ollamayı 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 APIsini** (`/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 APIsini** (`/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ı">
Ollamanı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**:
Ollamanı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">
Ollamanın doğru portta çalıştığını kontrol edin:
Ollamanın doğru bağlantı noktasında çalıştığını denetleyin:
```bash
# Ollama'nın çalışıp çalışmadığını kontrol edin
# Ollamanın çalışıp çalışmadığını denetleyin
ps aux | grep ollama
# Veya Ollama'yı yeniden başlatın
# Veya Ollamayı 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 providerlara, 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ı.

View File

@ -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 SDKnin
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 URLsi |
| `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 SDKnin 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ü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
ı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.

View File

@ -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)

View File

@ -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 OAuthu, 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 Pluginleri)
- 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 Gatewaye 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.
- Authu yalnızca her yerel sürece tamamen güveniyorsanız devre dışı bırakın.
- Loopback dışı bindlerde 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ı JSONu + 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 URLsi + 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 pairingdir. İ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 Gatewayin ç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 Gatewayi 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">
- Gatewayi 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 Skillsi 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 Gatewaye 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 URLsi (`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 xAIyi 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 URLsi: [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 URLyi 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: OAuthu 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 allowlistleri (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 Plugini 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)