--- read_when: - TUI için yeni başlayanlara uygun bir adım adım kılavuz istiyorsunuz - TUI özelliklerinin, komutlarının ve kısayollarının eksiksiz listesine ihtiyacınız var summary: 'Terminal kullanıcı arayüzü (TUI): Gateway''e bağlanın veya gömülü modda yerel olarak çalıştırın' title: TUI x-i18n: generated_at: "2026-05-05T09:02:46Z" model: gpt-5.5 provider: openai source_hash: 2b517ff434cc440aeffd8698df75d4d85c22a19e59b38a1f2383e58e1b4084ff source_path: web/tui.md workflow: 16 --- ## Hızlı başlangıç ### Gateway modu 1. Gateway'i başlatın. ```bash openclaw gateway ``` 2. TUI'yi açın. ```bash openclaw tui ``` 3. Bir mesaj yazın ve Enter'a basın. Uzak Gateway: ```bash openclaw tui --url ws://: --token ``` Gateway'iniz parola kimlik doğrulaması kullanıyorsa `--password` kullanın. ### Yerel mod TUI'yi Gateway olmadan çalıştırın: ```bash openclaw chat # or openclaw tui --local ``` Notlar: - `openclaw chat` ve `openclaw terminal`, `openclaw tui --local` için takma adlardır. - `--local`, `--url`, `--token` veya `--password` ile birleştirilemez. - Yerel mod, gömülü ajan çalışma zamanını doğrudan kullanır. Çoğu yerel araç çalışır, ancak yalnızca Gateway'e özgü özellikler kullanılamaz. - `openclaw` ve `openclaw crestodian` da bu TUI kabuğunu kullanır; Crestodian yerel kurulum ve onarım sohbet arka ucu olarak görev yapar. ## Gördükleriniz - Üst bilgi: bağlantı URL'si, geçerli ajan, geçerli oturum. - Sohbet günlüğü: kullanıcı mesajları, asistan yanıtları, sistem bildirimleri, araç kartları. - Durum satırı: bağlantı/çalıştırma durumu (bağlanıyor, çalışıyor, akış yapıyor, boşta, hata). - Alt bilgi: bağlantı durumu + ajan + oturum + model + think/fast/verbose/trace/reasoning + belirteç sayıları + iletim. - Giriş: otomatik tamamlama özellikli metin düzenleyici. ## Zihinsel model: ajanlar + oturumlar - Ajanlar benzersiz kısa adlardır (örn. `main`, `research`). Gateway listeyi sunar. - Oturumlar geçerli ajana aittir. - Oturum anahtarları `agent::` olarak saklanır. - `/session main` yazarsanız TUI bunu `agent::main` olarak genişletir. - `/session agent:other:main` yazarsanız açıkça o ajan oturumuna geçersiniz. - Oturum kapsamı: - `per-sender` (varsayılan): her ajanın birçok oturumu vardır. - `global`: TUI her zaman `global` oturumunu kullanır (seçici boş olabilir). - Geçerli ajan + oturum alt bilgide her zaman görünür. - `--session` olmadan başlatıldığında, Gateway modundaki TUI aynı gateway, ajan ve oturum kapsamı için son seçilen oturumu, bu oturum hâlâ varsa sürdürür. `--session`, `/session`, `/new` veya `/reset` geçirmek açık seçim olarak kalır. ## Gönderme + iletim - Mesajlar Gateway'e gönderilir; sağlayıcılara iletim varsayılan olarak kapalıdır. - İletimi açın: - `/deliver on` - veya Ayarlar paneli - veya `openclaw tui --deliver` ile başlatın ## Seçiciler + katmanlar - Model seçici: kullanılabilir modelleri listeleyin ve oturum geçersiz kılmasını ayarlayın. - Ajan seçici: farklı bir ajan seçin. - Oturum seçici: geçerli ajan için son 7 günde güncellenmiş en fazla 50 oturumu gösterir. Daha eski bilinen bir oturuma geçmek için `/session ` kullanın. - Ayarlar: iletimi, araç çıktısı genişletmeyi ve düşünme görünürlüğünü açıp kapatın. ## Klavye kısayolları - Enter: mesaj gönder - Esc: etkin çalıştırmayı iptal et - Ctrl+C: girişi temizle (çıkmak için iki kez basın) - Ctrl+D: çık - Ctrl+L: model seçici - Ctrl+G: ajan seçici - Ctrl+P: oturum seçici - Ctrl+O: araç çıktısı genişletmeyi aç/kapat - Ctrl+T: düşünme görünürlüğünü aç/kapat (geçmişi yeniden yükler) ## Slash komutları Çekirdek: - `/help` - `/status` - `/agent ` (veya `/agents`) - `/session ` (veya `/sessions`) - `/model ` (veya `/models`) Oturum denetimleri: - `/think ` - `/fast ` - `/verbose ` - `/trace ` - `/reasoning ` - `/usage ` - `/elevated ` (takma ad: `/elev`) - `/activation ` - `/deliver ` Oturum yaşam döngüsü: - `/new` veya `/reset` (oturumu sıfırla) - `/abort` (etkin çalıştırmayı iptal et) - `/settings` - `/exit` Yalnızca yerel mod: - `/auth [provider]`, sağlayıcı kimlik doğrulama/oturum açma akışını TUI içinde açar. Diğer Gateway Slash komutları (örneğin `/context`) Gateway'e iletilir ve sistem çıktısı olarak gösterilir. Bkz. [Slash komutları](/tr/tools/slash-commands). ## Yerel kabuk komutları - TUI ana makinesinde yerel bir kabuk komutu çalıştırmak için satırın başına `!` ekleyin. - TUI, yerel yürütmeye izin vermek için oturum başına bir kez sorar; reddedilirse `!` oturum boyunca devre dışı kalır. - Komutlar TUI çalışma dizininde yeni, etkileşimsiz bir kabukta çalışır (kalıcı `cd`/env yoktur). - Yerel kabuk komutları ortamlarında `OPENCLAW_SHELL=tui-local` alır. - Tek başına `!` normal mesaj olarak gönderilir; baştaki boşluklar yerel yürütmeyi tetiklemez. ## Yerel TUI'den yapılandırmaları onarma Geçerli yapılandırma zaten doğrulanıyorsa ve gömülü ajanın bunu aynı makinede incelemesini, belgelerle karşılaştırmasını ve çalışan bir Gateway'e bağlı kalmadan sapmayı onarmaya yardım etmesini istiyorsanız yerel modu kullanın. `openclaw config validate` zaten başarısız oluyorsa önce `openclaw configure` veya `openclaw doctor --fix` ile başlayın. `openclaw chat`, geçersiz yapılandırma korumasını atlamaz. Tipik döngü: 1. Yerel modu başlatın: ```bash openclaw chat ``` 2. Ajana neyin kontrol edilmesini istediğinizi sorun, örneğin: ```text Compare my gateway auth config with the docs and suggest the smallest fix. ``` 3. Kesin kanıt ve doğrulama için yerel kabuk komutlarını kullanın: ```text !openclaw config file !openclaw docs gateway auth token secretref !openclaw config validate !openclaw doctor ``` 4. `openclaw config set` veya `openclaw configure` ile dar kapsamlı değişiklikler uygulayın, ardından `!openclaw config validate` komutunu yeniden çalıştırın. 5. Doctor otomatik bir geçiş veya onarım önerirse bunu inceleyin ve `!openclaw doctor --fix` çalıştırın. İpuçları: - `openclaw.json` dosyasını elle düzenlemek yerine `openclaw config set` veya `openclaw configure` tercih edin. - `openclaw docs ""`, aynı makineden canlı belge dizininde arama yapar. - Yapılandırılmış şema ve SecretRef/çözülebilirlik hataları istediğinizde `openclaw config validate --json` yararlıdır. ## Araç çıktısı - Araç çağrıları, bağımsız değişkenler + sonuçlarla birlikte kart olarak gösterilir. - Ctrl+O daraltılmış/genişletilmiş görünümler arasında geçiş yapar. - Araçlar çalışırken kısmi güncellemeler aynı karta akar. ## Terminal renkleri - TUI, asistan gövde metnini terminalinizin varsayılan ön plan renginde tutar; böylece hem koyu hem açık terminaller okunabilir kalır. - Terminaliniz açık arka plan kullanıyorsa ve otomatik algılama yanlışsa, `openclaw tui` başlatmadan önce `OPENCLAW_THEME=light` ayarlayın. - Bunun yerine özgün koyu paleti zorlamak için `OPENCLAW_THEME=dark` ayarlayın. ## Geçmiş + akış - Bağlanıldığında TUI en son geçmişi yükler (varsayılan 200 mesaj). - Akış yanıtları sonlandırılana kadar yerinde güncellenir. - TUI ayrıca daha zengin araç kartları için ajan araç olaylarını dinler. ## Bağlantı ayrıntıları - TUI, Gateway'e `mode: "tui"` olarak kaydolur. - Yeniden bağlantılar bir sistem mesajı gösterir; olay boşlukları günlükte belirtilir. ## Seçenekler - `--local`: Yerel gömülü ajan çalışma zamanına karşı çalıştır - `--url `: Gateway WebSocket URL'si (varsayılan yapılandırma veya `ws://127.0.0.1:`) - `--token `: Gateway belirteci (gerekliyse) - `--password `: Gateway parolası (gerekliyse) - `--session `: Oturum anahtarı (varsayılan: `main`, kapsam global olduğunda `global`) - `--deliver`: Asistan yanıtlarını sağlayıcıya ilet (varsayılan kapalı) - `--thinking `: Gönderimler için düşünme düzeyini geçersiz kıl - `--message `: Bağlandıktan sonra ilk mesaj gönder - `--timeout-ms `: Ajan zaman aşımı, ms cinsinden (varsayılan `agents.defaults.timeoutSeconds`) - `--history-limit `: Yüklenecek geçmiş girdileri (varsayılan `200`) `--url` ayarladığınızda TUI, yapılandırmaya veya ortam kimlik bilgilerine geri dönmez. `--token` veya `--password` değerini açıkça geçirin. Açık kimlik bilgilerinin eksik olması hatadır. Yerel modda `--url`, `--token` veya `--password` geçirmeyin. ## Sorun giderme Mesaj gönderdikten sonra çıktı yok: - Gateway'in bağlı ve boşta/meşgul olduğunu doğrulamak için TUI içinde `/status` çalıştırın. - Gateway günlüklerini kontrol edin: `openclaw logs --follow`. - Ajanın çalışabildiğini doğrulayın: `openclaw status` ve `openclaw models status`. - Bir sohbet kanalında mesaj bekliyorsanız iletimi etkinleştirin (`/deliver on` veya `--deliver`). ## Bağlantı sorunlarını giderme - `disconnected`: Gateway'in çalıştığından ve `--url/--token/--password` değerlerinizin doğru olduğundan emin olun. - Seçicide ajan yok: `openclaw agents list` komutunu ve yönlendirme yapılandırmanızı kontrol edin. - Boş oturum seçici: global kapsamda olabilirsiniz veya henüz oturumunuz olmayabilir. ## İlgili - [Denetim Arayüzü](/tr/web/control-ui) — web tabanlı denetim arayüzü - [Yapılandırma](/tr/cli/config) — `openclaw.json` dosyasını inceleyin, doğrulayın ve düzenleyin - [Doctor](/tr/cli/doctor) — yönlendirmeli onarım ve geçiş kontrolleri - [CLI Başvurusu](/tr/cli) — tam CLI komut başvurusu