macOS companion app

WebChat (macOS)

macOS menü çubuğu uygulaması, WebChat kullanıcı arayüzünü yerel bir SwiftUI görünümü olarak içerir. Gateway'e bağlanır ve seçilen ajan için varsayılan olarak birincil oturumu kullanır (main; session.scope, global olduğunda ise global).

Tam sohbet penceresi, yerel bir bölünmüş görünümdür:

  • Oturumlar kenar çubuğu: Sabitlenmiş ve son kullanılanlar bölümlerini, okunmamış göstergelerini ve sabitleme/sabitlemeyi kaldırma, oturum anahtarını kopyalama ve silme bağlam menülerini içeren aranabilir oturum listesi. Bir araç çubuğu düğmesi (veya Cmd-N), sessions.create aracılığıyla gerçek bir yeni oturum oluşturur.
  • Pencere araç çubuğu: Bağlam kullanım halkası (belirteçler ve oturum maliyeti ile kompakt bir eylem), düşünme düzeyi seçici, model seçici ve oturum eylemleri menüsü (yeni oturum, yenileme, oturum anahtarını kopyalama, dökümü dışa aktarma, sıkıştırma, geçmişi temizleme).
  • Döküm ve oluşturucu: Asistan iletileri avatarla birlikte düz metin, kullanıcı iletileri ise vurgu renkli baloncuklar olarak görüntülenir. / yazıldığında, commands.list tarafından desteklenen eğik çizgi komutu otomatik tamamlama özelliği açılır ve ok/Tab/Return/Escape tuşlarıyla klavye gezintisi sunar. Bir iletiyi kopyalamak için sağ tıklayın.

Menü çubuğundaki sabitlenmiş hızlı sohbet paneli, satır içi seçicilerle kompakt tek sütunlu düzeni korur.

  • Yerel mod: Doğrudan yerel Gateway WebSocket'ine bağlanır.
  • Uzak mod: Gateway denetim portunu SSH üzerinden iletir ve bu tüneli veri düzlemi olarak kullanır.

Başlatma ve hata ayıklama

  • Elle: Lobster menüsü -> "Open Chat".

  • Test için otomatik açma:

    bash
    dist/OpenClaw.app/Contents/MacOS/OpenClaw --chat

    (--webchat, eski bir diğer ad olarak kabul edilir.)

  • Günlükler: ./scripts/clawlog.sh (alt sistem ai.openclaw, kategori WebChatSwiftUI).

Bağlantı yapısı

  • Veri düzlemi: Gateway WS yöntemleri chat.history, chat.send, chat.abort, chat.inject ve chat, agent, presence, tick, health olayları.
  • chat.history, görüntüleme için normalleştirilmiş bir döküm döndürür: satır içi yönerge etiketleri görünür metinden çıkarılır; düz metin araç çağrısı XML yükleri (<tool_call>, <function_call>, <tool_calls>, <function_calls>, kesilmiş bloklar dâhil) ve açığa çıkmış model denetim belirteçleri kaldırılır; tam olarak NO_REPLY/no_reply gibi yalnızca sessizlik belirtecinden oluşan asistan satırları atlanır ve aşırı büyük satırlar kesilmiş bir yer tutucuyla değiştirilebilir.
  • Oturum: Yukarıda belirtildiği gibi varsayılan olarak birincil oturumu kullanır; kullanıcı arayüzü oturumlar arasında geçiş yapabilir.
  • İlk katılım, ilk çalıştırma kurulumunu ayrı tutmak için özel bir oturum kullanır.
  • Çevrimdışı önbellek: Uygulama, Gateway başına son sohbet oturumlarının ve dökümlerin küçük, salt okunur bir önbelleğini tutar (~/Library/Application Support/OpenClaw/chat-cache.sqlite): soğuk açılışlarda son bilinen döküm hemen görüntülenir ve Gateway yanıt verdiğinde yenilenir; ayrıca bağlantı kesikken son sohbetlere göz atılabilir (bağlantı geri gelene kadar gönderme devre dışı kalır).

Güvenlik yüzeyi

  • Uzak mod, yalnızca Gateway WebSocket denetim portunu SSH üzerinden iletir.

Bilinen sınırlamalar

  • Kullanıcı arayüzü, tam kapsamlı bir tarayıcı korumalı alanı için değil, sohbet oturumları için optimize edilmiştir.

İlgili içerikler

Was this useful?
On this page

On this page