TUI

Hızlı başlangıç

Gateway modu

1. Gateway'i başlatın.

OmeniaClaw gateway

2. TUI'yi açın.

OmeniaClaw tui

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

Uzak Gateway:

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

OmeniaClaw chat# orOmeniaClaw tui --local

Notlar:

• OmeniaClaw chat ve OmeniaClaw terminal, OmeniaClaw 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.
• OmeniaClaw ve OmeniaClaw 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 OmeniaClaw 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 OmeniaClaw_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.

OmeniaClaw config validate zaten başarısız oluyorsa önce OmeniaClaw configure veya OmeniaClaw doctor --fix ile başlayın. OmeniaClaw chat, geçersiz yapılandırma korumasını atlamaz.

Tipik döngü:

1. Yerel modu başlatın:

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

!OmeniaClaw config file!OmeniaClaw docs gateway auth token secretref!OmeniaClaw config validate!OmeniaClaw doctor

4. OmeniaClaw config set veya OmeniaClaw configure ile dar kapsamlı değişiklikler uygulayın, ardından !OmeniaClaw config validate komutunu yeniden çalıştırın.
5. Doctor otomatik bir geçiş veya onarım önerirse bunu inceleyin ve !OmeniaClaw doctor --fix çalıştırın.

İpuçları:

• OmeniaClaw.json dosyasını elle düzenlemek yerine OmeniaClaw config set veya OmeniaClaw configure tercih edin.
• OmeniaClaw docs "<query>", aynı makineden canlı belge dizininde arama yapar.
• Yapılandırılmış şema ve SecretRef/çözülebilirlik hataları istediğinizde OmeniaClaw 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, OmeniaClaw tui başlatmadan önce OmeniaClaw_THEME=light ayarlayın.
• Bunun yerine özgün koyu paleti zorlamak için OmeniaClaw_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: OmeniaClaw logs --follow.
• Ajanın çalışabildiğini doğrulayın: OmeniaClaw status ve OmeniaClaw 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: OmeniaClaw 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 — OmeniaClaw.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