TUI

# Hızlı başlangıç

# Gateway modu

1. Gateway'i başlatın.

openclaw gateway

2. TUI'yi açın.

openclaw tui

3. Bir mesaj yazın ve Enter'a basın.

Uzak Gateway:

openclaw tui --url ws://<host>:<port> --token <gateway-token>

Gateway'iniz parola kimlik doğrulaması kullanıyorsa --password kullanın.

# Yerel mod

TUI'yi Gateway olmadan çalıştırın:

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:<agentId>:<sessionKey> olarak saklanır.
  • /session main yazarsanız TUI bunu agent:<currentAgent>: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 <key> 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 <id> (veya /agents)
• /session <key> (veya /sessions)
• /model <provider/model> (veya /models)

Oturum denetimleri:

• /think <off|minimal|low|medium|high>
• /fast <status|on|off>
• /verbose <on|full|off>
• /trace <on|off>
• /reasoning <on|off|stream>
• /usage <off|tokens|full>
• /elevated <on|off|ask|full> (takma ad: /elev)
• /activation <mention|always>
• /deliver <on|off>

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

# 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:

openclaw chat

2. Ajana neyin kontrol edilmesini istediğinizi sorun, örneğin:

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:

!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 "<query>", 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 <url>: Gateway WebSocket URL'si (varsayılan yapılandırma veya ws://127.0.0.1:<port>)
• --token <token>: Gateway belirteci (gerekliyse)
• --password <password>: Gateway parolası (gerekliyse)
• --session <key>: Oturum anahtarı (varsayılan: main, kapsam global olduğunda global)
• --deliver: Asistan yanıtlarını sağlayıcıya ilet (varsayılan kapalı)
• --thinking <level>: Gönderimler için düşünme düzeyini geçersiz kıl
• --message <text>: Bağlandıktan sonra ilk mesaj gönder
• --timeout-ms <ms>: Ajan zaman aşımı, ms cinsinden (varsayılan agents.defaults.timeoutSeconds)
• --history-limit <n>: Yüklenecek geçmiş girdileri (varsayılan 200)

# 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ü — web tabanlı denetim arayüzü
• Yapılandırma — openclaw.json dosyasını inceleyin, doğrulayın ve düzenleyin
• Doctor — yönlendirmeli onarım ve geçiş kontrolleri
• CLI Başvurusu — tam CLI komut başvurusu