Kontrol Arayüzü

• Gateway WS üzerinden modelle sohbet edin (chat.history, chat.send, chat.abort, chat.inject).
• Sohbet geçmişi yenilemeleri, büyük oturumların sohbet kullanılabilir hale gelmeden önce tarayıcıyı tam transcript yükünü işlemeye zorlamaması için ileti başına metin sınırlarıyla sınırlı bir yakın geçmiş penceresi ister.
• Tarayıcı gerçek zamanlı oturumları üzerinden konuşun. OpenAI doğrudan WebRTC kullanır, Google Live WebSocket üzerinden kısıtlı tek kullanımlık tarayıcı token'ı kullanır ve yalnızca backend gerçek zamanlı ses Plugin'leri Gateway aktarma taşımasını kullanır. İstemciye ait sağlayıcı oturumları talk.client.create ile başlar; Gateway aktarma oturumları talk.session.create ile başlar. Aktarma, tarayıcı talk.session.appendAudio üzerinden mikrofon PCM akışı gönderirken sağlayıcı kimlik bilgilerini Gateway üzerinde tutar, openclaw_agent_consult sağlayıcı araç çağrılarını Gateway ilkesi ve daha büyük yapılandırılmış OpenClaw modeli için talk.client.toolCall üzerinden iletir ve etkin çalışma ses yönlendirmesini talk.client.steer veya talk.session.steer üzerinden yönlendirir.
• Araç çağrılarını ve canlı araç çıktı kartlarını Sohbet içinde akışla gösterin (ajan olayları).
• Mevcut session.tool / araç olay tesliminden canlı araç etkinliğinin tarayıcı yerelinde, önce redaksiyonlu özetlerini içeren Etkinlik sekmesi.

• Kanallar: yerleşik ve paketlenmiş/harici Plugin kanallarının durumu, QR oturum açma ve kanal başına yapılandırma (channels.status, web.login.*, config.patch).
• Kanal yoklama yenilemeleri, yavaş sağlayıcı kontrolleri tamamlanırken önceki anlık görüntüyü görünür tutar ve bir yoklama veya denetim UI bütçesini aştığında kısmi anlık görüntüler etiketlenir.
• Örnekler: varlık listesi + yenileme (system-presence).
• Oturumlar: varsayılan olarak yapılandırılmış ajan oturumlarını listeleyin, sık kullanılan oturumları sabitleyin, yeniden adlandırın, etkin olmayan oturumları arşivleyin veya geri yükleyin, eski yapılandırılmamış ajan oturum anahtarlarından geri dönün ve oturum başına model/düşünme/hızlı/ayrıntılı/izleme/akıl yürütme geçersiz kılmalarını uygulayın (sessions.list, sessions.patch). Sabitlenmiş oturumlar son sabitlenmemiş oturumların üstünde sıralanır; arşivlenmiş oturumlar Oturumlar sayfasının arşivlenmiş görünümünde bulunur ve transcript'lerini korur.
• Rüyalar: dreaming durumu, etkinleştirme/devre dışı bırakma anahtarı ve Dream Diary okuyucusu (doctor.memory.status, doctor.memory.dreamDiary, config.patch).

• Cron işleri: listele/ekle/düzenle/çalıştır/etkinleştir/devre dışı bırak + çalışma geçmişi (cron.*).
• Skills: durum, etkinleştirme/devre dışı bırakma, yükleme, API anahtarı güncellemeleri (skills.*).
• Düğümler: liste + yetenekler (node.list), mobil kurulum kodları oluşturma ve cihaz eşleştirmeyi onaylama (device.pair.*).
• Exec onayları: Gateway veya düğüm izin listelerini düzenleyin + exec host=gateway/node için sorma ilkesi (exec.approvals.*).

• ~/.openclaw/openclaw.json dosyasını görüntüleyin/düzenleyin (config.get, config.set).
• MCP, yapılandırılmış sunucular, etkinleştirme, OAuth/filtre/paralel özetleri, yaygın operatör komutları ve kapsamı belirlenmiş mcp yapılandırma düzenleyicisi için ayrılmış bir ayarlar sayfasına sahiptir.
• Doğrulamayla birlikte uygula + yeniden başlat (config.apply) ve son etkin oturumu uyandır.
• Yazma işlemleri, eşzamanlı düzenlemelerin üzerine yazılmasını önlemek için bir temel hash koruması içerir.
• Yazma işlemleri (config.set/config.apply/config.patch), gönderilen yapılandırma yükündeki ref’ler için etkin SecretRef çözümlemesini ön kontrolden geçirir; çözümlenemeyen etkin gönderilmiş ref’ler yazmadan önce reddedilir.
• Form kayıtları, kaydedilmiş yapılandırmadan geri yüklenemeyen eski maskelenmiş yer tutucuları atarken, hâlâ kayıtlı gizli değerlere eşleşen maskelenmiş değerleri korur.
• Şema + form işleme (config.schema / config.schema.lookup; alan title / description, eşleşen UI ipuçları, doğrudan alt özetler, iç içe nesne/joker karakter/dizi/bileşim düğümlerinde doküman meta verileri ve kullanılabildiğinde Plugin + kanal şemaları dahil); Raw JSON düzenleyicisi yalnızca anlık görüntü güvenli bir ham gidiş-dönüşe sahipse kullanılabilir.
• Bir anlık görüntü ham metni güvenli şekilde gidiş-dönüş yapamıyorsa, Control UI Form modunu zorunlu kılar ve bu anlık görüntü için Raw modunu devre dışı bırakır.
• Raw JSON düzenleyicisindeki "Kaydedilene sıfırla", düzleştirilmiş bir anlık görüntüyü yeniden işlemek yerine ham olarak yazılmış şekli (biçimlendirme, yorumlar, $include yerleşimi) korur; böylece anlık görüntü güvenli şekilde gidiş-dönüş yapabildiğinde dış düzenlemeler sıfırlama sonrasında da kalır.
• Yapılandırılmış SecretRef nesne değerleri, yanlışlıkla nesneden dizgeye bozulmayı önlemek için form metin girişlerinde salt okunur işlenir.

• Hata ayıklama: durum/sağlık/modeller anlık görüntüleri + olay günlüğü + manuel RPC çağrıları (status, health, models.list).
• Olay günlüğü; Control UI yenileme/RPC zamanlamalarını, yavaş sohbet/yapılandırma işleme zamanlamalarını ve tarayıcı bu PerformanceObserver giriş türlerini sunduğunda uzun animasyon kareleri veya uzun görevler için tarayıcı yanıt verebilirliği girişlerini içerir.
• Günlükler: filtre/dışa aktarma ile gateway dosya günlüklerinin canlı kuyruğu (logs.tail).
• Güncelleme: yeniden başlatma raporuyla birlikte paket/git güncellemesi + yeniden başlatma çalıştırın (update.run), ardından çalışan gateway sürümünü doğrulamak için yeniden bağlandıktan sonra update.status sorgulayın.

• Yalıtılmış işler için teslim varsayılanı özet duyurusudur. Yalnızca dahili çalıştırmalar istiyorsanız bunu hiçbiri olarak değiştirebilirsiniz.
• Duyuru seçildiğinde kanal/hedef alanları görünür.
• Webhook modu, delivery.to geçerli bir HTTP(S) webhook URL’sine ayarlanmışken delivery.mode = "webhook" kullanır.
• Ana oturum işleri için webhook ve hiçbiri teslim modları kullanılabilir.
• Gelişmiş düzenleme kontrolleri; çalıştırmadan sonra silme, ajan geçersiz kılmasını temizleme, cron kesin/kademeli seçenekleri, ajan model/düşünme geçersiz kılmaları ve en iyi çaba teslim anahtarlarını içerir.
• Form doğrulaması, alan düzeyi hatalarla satır içidir; geçersiz değerler düzeltilene kadar kaydet düğmesini devre dışı bırakır.
• Ayrılmış bir bearer token göndermek için cron.webhookToken ayarlayın; atlanırsa webhook kimlik doğrulama başlığı olmadan gönderilir.
• Kullanımdan kaldırılmış geri dönüş: notify: true içeren kayıtlı eski işleri cron.webhook üzerinden açık iş başına webhook veya tamamlama teslimine geçirmek için openclaw doctor --fix çalıştırın.

• chat.send engellemesizdir: hemen { runId, status: "started" } ile onay verir ve yanıt chat olayları üzerinden akar. Güvenilir Control UI istemcileri yerel tanılama için isteğe bağlı ACK zamanlama meta verileri de alabilir.
• Sohbet yüklemeleri görüntüleri ve video olmayan dosyaları kabul eder. Görüntüler yerel görüntü yolunu korur; diğer dosyalar yönetilen medya olarak saklanır ve geçmişte ek bağlantıları olarak gösterilir.
• Aynı idempotencyKey ile yeniden gönderme, çalışırken { status: "in_flight" }, tamamlandıktan sonra { status: "ok" } döndürür.
• chat.history yanıtları UI güvenliği için boyut sınırlıdır. Transkript girişleri çok büyük olduğunda Gateway uzun metin alanlarını kısaltabilir, ağır meta veri bloklarını atlayabilir ve aşırı büyük iletileri bir yer tutucuyla değiştirebilir ([chat.history omitted: message too large]).
• Görünür bir asistan iletisi chat.history içinde kısaltıldığında, yan okuyucu gerektiğinde sessionKey, gerekiyorsa etkin agentId ve transkript messageId ile chat.message.get üzerinden tam, görüntüleme-normalize edilmiş transkript girişini alabilir. Gateway hâlâ daha fazlasını döndüremiyorsa okuyucu, kısaltılmış önizlemeyi sessizce tekrarlamak yerine açık bir kullanılamaz durum gösterir.
• Asistan/oluşturulan görüntüler yönetilen medya referansları olarak kalıcılaştırılır ve kimliği doğrulanmış Gateway medya URL’leri üzerinden geri sunulur; bu nedenle yeniden yüklemeler ham base64 görüntü yüklerinin sohbet geçmişi yanıtında kalmasına bağlı değildir.
• chat.history işlenirken Control UI, görünür asistan metninden yalnızca görüntüleme amaçlı satır içi yönerge etiketlerini (örneğin [[reply_to_*]] ve [[audio_as_voice]]), düz metin araç çağrısı XML yüklerini (<tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> ve kısaltılmış araç çağrısı blokları dahil) ve sızmış ASCII/tam genişlikli model kontrol token’larını ayıklar; ayrıca tüm görünür metni yalnızca tam sessiz token NO_REPLY / no_reply veya Heartbeat onay token’ı HEARTBEAT_OK olan asistan girişlerini atlar.
• Etkin bir gönderim ve son geçmiş yenilemesi sırasında, chat.history kısa süreliğine daha eski bir anlık görüntü döndürürse sohbet görünümü yerel iyimser kullanıcı/asistan iletilerini görünür tutar; Gateway geçmişi yakaladığında kanonik transkript bu yerel iletilerin yerini alır.
• Canlı chat olayları teslim durumudur; chat.history ise kalıcı oturum transkriptinden yeniden oluşturulur. Araç-son olaylarından sonra Control UI geçmişi yeniden yükler ve yalnızca küçük bir iyimser kuyruğu birleştirir; transkript sınırı WebChat içinde belgelenmiştir.
• chat.inject, oturum transkriptine bir asistan notu ekler ve yalnızca UI güncellemeleri için bir chat olayı yayınlar (ajan çalıştırması yok, kanal teslimi yok).
• Kenar çubuğu, Yeni Oturum eylemi, Tüm Oturumlar bağlantısı ve tam oturum seçiciyi açan bir oturum arama düğmesiyle son oturumları listeler (seçilen ajana göre kapsamlı, arama ve sayfalandırma ile). Ajan değiştirmek yalnızca o ajana bağlı oturumları gösterir ve henüz kayıtlı pano oturumları yoksa o ajanın ana oturumuna geri döner.
• Her oturum seçici satırı oturumu yeniden adlandırabilir, sabitleyebilir veya arşivleyebilir. Etkin bir çalıştırma ve bir ajanın ana oturumu arşivlenemez. Geçerli seçili oturumu arşivlemek Sohbet’i o ajanın ana oturumuna geri geçirir.
• Masaüstü genişliklerinde sohbet kontrolleri tek bir kompakt satırda kalır ve transkriptte aşağı kaydırırken daralır; yukarı kaydırmak, üste dönmek veya en alta ulaşmak kontrolleri geri getirir.
• Ardışık yinelenen yalnızca metin iletileri, sayı rozetiyle tek balon olarak işlenir. Görüntü, ek, araç çıktısı veya canvas önizlemesi taşıyan iletiler daraltılmaz.
• Sohbet başlığı model ve düşünme seçicileri, etkin oturumu sessions.patch üzerinden hemen yamalar; bunlar tek turluk gönderim seçenekleri değil, kalıcı oturum geçersiz kılmalarıdır.
• Aynı oturum için bir model seçici değişikliği hâlâ kaydedilirken ileti gönderirseniz, besteci chat.send çağırmadan önce o oturum yamasını bekler; böylece gönderim seçilen modeli kullanır.
• Control UI içinde /new yazmak, session.dmScope: "main" yapılandırılmış ve geçerli üst öğe ajanın ana oturumu olmadıkça Yeni Sohbet ile aynı yeni pano oturumunu oluşturur ve ona geçer; bu durumda ana oturumu yerinde sıfırlar. /reset yazmak, geçerli oturum için Gateway’in açık yerinde sıfırlamasını korur.
• Sohbet model seçici, Gateway’in yapılandırılmış model görünümünü ister. agents.defaults.models varsa, seçiciyi bu izin listesi yönlendirir; sağlayıcı kapsamlı katalogları dinamik tutan provider/* girişleri dahil. Aksi halde seçici, açık models.providers.*.models girişlerini ve kullanılabilir kimlik doğrulaması olan sağlayıcıları gösterir. Tam katalog, view: "all" ile hata ayıklama models.list RPC’si üzerinden kullanılabilir kalır.
• Taze Gateway oturum kullanım raporları geçerli bağlam token’larını içerdiğinde, sohbet besteci araç çubuğu kullanılan yüzdeyle küçük bir bağlam kullanım halkası gösterir; tam token ayrıntısı ipucunda yer alır. Halka, yüksek bağlam baskısında uyarı stiline geçer ve önerilen Compaction düzeylerinde normal oturum Compaction yolunu çalıştıran kompakt bir düğme gösterir. Eski token anlık görüntüleri, Gateway yeniden taze kullanım bildirene kadar gizlenir.

Konuşma modu, kayıtlı bir gerçek zamanlı ses sağlayıcısı kullanır. OpenAI’yi talk.realtime.provider: "openai" ile birlikte bir openai API anahtarı kimlik doğrulama profili, talk.realtime.providers.openai.apiKey veya OPENAI_API_KEY ile yapılandırın; OpenAI OAuth profilleri Realtime sesi yapılandırmaz. Google’ı talk.realtime.provider: "google" ile birlikte talk.realtime.providers.google.apiKey ile yapılandırın. Tarayıcı hiçbir zaman standart bir sağlayıcı API anahtarı almaz. OpenAI, WebRTC için geçici bir Realtime istemci sırrı alır. Google Live, Gateway tarafından token içine kilitlenmiş talimatlar ve araç bildirimleriyle, tarayıcı WebSocket oturumu için tek kullanımlık kısıtlı bir Live API kimlik doğrulama token’ı alır. Yalnızca backend gerçek zamanlı köprüsü sunan sağlayıcılar Gateway relay aktarımı üzerinden çalışır; böylece tarayıcı sesi kimliği doğrulanmış Gateway RPC’leri üzerinden taşınırken kimlik bilgileri ve satıcı soketleri sunucu tarafında kalır. Realtime oturum istemi Gateway tarafından birleştirilir; talk.client.create çağıran tarafından sağlanan talimat geçersiz kılmalarını kabul etmez.

Chat oluşturucusunda, Talk başlat/durdur düğmesinin yanında bir Talk seçenekleri düğmesi bulunur. Seçenekler bir sonraki Talk oturumu için geçerlidir ve sağlayıcıyı, aktarımı, modeli, sesi, akıl yürütme çabasını, VAD eşiğini, sessizlik süresini ve önek dolgusunu geçersiz kılabilir. Bir seçenek boş olduğunda, Gateway varsa yapılandırılmış varsayılanları veya sağlayıcı varsayılanını kullanır. Gateway relay seçildiğinde arka uç relay yolu zorlanır; WebRTC seçildiğinde oturum istemci sahipliğinde kalır ve sağlayıcı bir tarayıcı oturumu oluşturamazsa sessizce relay'e geri dönmek yerine başarısız olur.

Chat oluşturucusunda Talk kontrolü, mikrofon dikte düğmesinin yanındaki dalgalar düğmesidir. Talk başladığında, oluşturucu durum satırı önce Connecting Talk..., ardından ses bağlıyken Talk live veya gerçek zamanlı bir araç çağrısı talk.client.toolCall üzerinden yapılandırılmış daha büyük modele danışırken Asking OpenClaw... gösterir.

Maintainer canlı smoke: OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts, OpenAI arka uç WebSocket köprüsünü, OpenAI tarayıcı WebRTC SDP değişimini, Google Live kısıtlı token tarayıcı WebSocket kurulumunu ve sahte mikrofon medyasıyla Gateway relay tarayıcı adaptörünü doğrular. Komut yalnızca sağlayıcı durumunu yazdırır ve gizli bilgileri günlüğe kaydetmez.

• Stop'a tıklayın (chat.abort çağırır).
• Bir çalıştırma etkinken normal takip iletileri kuyruğa alınır. Bu takibi çalışan tura enjekte etmek için kuyruğa alınmış bir iletide Steer'e tıklayın.
• Bant dışı iptal etmek için /stop yazın (veya stop, stop action, stop run, stop openclaw, please stop gibi tek başına iptal ifadeleri).
• chat.abort, o oturumdaki tüm etkin çalıştırmaları iptal etmek için { sessionKey } desteği sunar (runId olmadan).

• Bir çalıştırma iptal edildiğinde, kısmi assistant metni UI'da hâlâ gösterilebilir.
• Gateway, tamponlanmış çıktı varsa iptal edilen kısmi assistant metnini transkript geçmişine kalıcı olarak yazar.
• Kalıcı girdiler iptal meta verisi içerir; böylece transkript tüketicileri iptal kısımlarını normal tamamlama çıktısından ayırt edebilir.

{  gateway: {    controlUi: { allowInsecureAuth: true },    bind: "tailnet",    auth: { mode: "token", token: "replace-me" },  },}

allowInsecureAuth yalnızca yerel bir uyumluluk toggle'ıdır:

• Localhost Control UI oturumlarının güvenli olmayan HTTP bağlamlarında cihaz kimliği olmadan devam etmesine izin verir.
• Eşleştirme kontrollerini atlamaz.
• Uzak (localhost olmayan) cihaz kimliği gereksinimlerini gevşetmez.

• Başarılı trusted-proxy auth, cihaz kimliği olmadan operatör Control UI oturumlarını kabul edebilir.
• Bu, node-role Control UI oturumlarına genişletilmez.
• Aynı host loopback reverse proxy'leri yine de trusted-proxy auth gereksinimini karşılamaz; bkz. Trusted proxy auth.

• gatewayUrl yüklemeden sonra localStorage içinde saklanır ve URL'den kaldırılır.
• gatewayUrl üzerinden tam bir ws:// veya wss:// uç noktası geçirirseniz tarayıcının sorgu dizesini doğru ayrıştırması için gatewayUrl değerini URL ile kodlayın.
• Mümkün olduğunda token, URL parçası (#token=...) üzerinden geçirilmelidir. Parçalar sunucuya gönderilmez; bu da istek günlüğü ve Referer sızıntısını önler. Eski ?token= sorgu parametreleri uyumluluk için hâlâ bir kez içe aktarılır, ancak yalnızca yedek olarak kullanılır ve bootstrap sonrasında hemen kaldırılır.
• password yalnızca bellekte tutulur.
• gatewayUrl ayarlandığında UI, yapılandırma veya ortam kimlik bilgilerine geri dönmez. token (veya password) açıkça sağlayın. Açık kimlik bilgilerinin eksik olması bir hatadır.
• Gateway TLS arkasındayken (Tailscale Serve, HTTPS proxy vb.) wss:// kullanın.
• gatewayUrl, clickjacking'i önlemek için yalnızca üst düzey bir pencerede kabul edilir (gömülü değil).
• Genel non-loopback Control UI dağıtımları gateway.controlUi.allowedOrigins değerini açıkça ayarlamalıdır (tam kaynaklar). Loopback, RFC1918/link-local, .local, .ts.net veya Tailscale CGNAT ana makinelerinden gelen özel same-origin LAN/Tailnet yüklemeleri, Host üst bilgisi yedeği etkinleştirilmeden kabul edilir.
• Gateway başlangıcı etkin çalışma zamanı bağlama ve bağlantı noktasından http://localhost:<port> ve http://127.0.0.1:<port> gibi yerel kaynakları tohumlayabilir, ancak uzak tarayıcı kaynakları yine de açık girdiler gerektirir.
• Sıkı denetimli yerel testler dışında gateway.controlUi.allowedOrigins: ["*"] kullanmayın. Bu, "kullandığım ana makine neyse onunla eşleş" değil, herhangi bir tarayıcı kaynağına izin ver anlamına gelir.
• gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true Host üst bilgisi kaynak yedeği modunu etkinleştirir, ancak bu tehlikeli bir güvenlik modudur.