​

Kontrol Arayüzü (tarayıcı)

• varsayılan: http://<host>:18789/
• isteğe bağlı önek: gateway.controlUi.basePath ayarlayın (ör. /openclaw)

​

Hızlı açılış (yerel)

• http://127.0.0.1:18789/ (veya http://localhost:18789/)

• connect.params.auth.token
• connect.params.auth.password
• gateway.auth.allowTailscale: true olduğunda Tailscale Serve kimlik başlıkları
• gateway.auth.mode: "trusted-proxy" olduğunda güvenilir proxy kimlik başlıkları

​

Cihaz eşleştirme (ilk bağlantı)

# Bekleyen istekleri listeleyin
openclaw devices list

# İstek kimliğine göre onaylayın
openclaw devices approve <requestId>

• Doğrudan yerel local loopback tarayıcı bağlantıları (127.0.0.1 / localhost) otomatik olarak onaylanır.
• Tailnet ve LAN tarayıcı bağlantıları, aynı makineden gelseler bile yine açık onay gerektirir.
• Her tarayıcı profili benzersiz bir cihaz kimliği üretir; bu nedenle tarayıcı değiştirmek veya tarayıcı verilerini temizlemek yeniden eşleştirme gerektirir.

​

Dil desteği

• Desteklenen yerel ayarlar: en, zh-CN, zh-TW, pt-BR, de, es
• İngilizce dışındaki çeviriler tarayıcıda tembel yüklenir.
• Seçilen yerel ayar tarayıcı depolamasına kaydedilir ve sonraki ziyaretlerde yeniden kullanılır.
• Eksik çeviri anahtarları İngilizceye geri döner.

​

Neler yapabilir (bugün)

• Gateway WS üzerinden modelle sohbet (chat.history, chat.send, chat.abort, chat.inject)
• Sohbet içinde araç çağrılarını ve canlı araç çıktı kartlarını akış olarak gösterme (aracı olayları)
• Kanallar: yerleşik ve paketlenmiş/harici plugin kanalları için durum, QR girişi ve kanal başına config (channels.status, web.login.*, config.patch)
• Örnekler: durum listesi + yenileme (system-presence)
• Oturumlar: liste + oturum başına model/düşünme/hızlı/ayrıntılı/akıl yürütme geçersiz kılmaları (sessions.list, sessions.patch)
• Cron işleri: listeleme/ekleme/düzenleme/çalıştırma/etkinleştirme/devre dışı bırakma + çalıştırma geçmişi (cron.*)
• Skills: durum, etkinleştirme/devre dışı bırakma, kurulum, API anahtarı güncellemeleri (skills.*)
• Düğümler: liste + sınırlar (node.list)
• exec host=gateway/node için yürütme onayları: gateway veya düğüm izin listelerini düzenleme + ilke sorma (exec.approvals.*)
• Config: ~/.openclaw/openclaw.json görüntüleme/düzenleme (config.get, config.set)
• Config: doğrulamayla birlikte uygulama + yeniden başlatma (config.apply) ve son etkin oturumu uyandırma
• Config yazımları, eşzamanlı düzenlemelerin üzerine yazmayı önlemek için bir temel hash koruması içerir
• Config yazımları (config.set/config.apply/config.patch), gönderilen config yükündeki başvurular için etkin SecretRef çözümlemesini de ön kontrol olarak yapar; çözümlenmemiş etkin gönderilmiş başvurular yazmadan önce reddedilir
• Config şeması + form oluşturma (config.schema / config.schema.lookup, alan title / description, eşleşen arayüz ipuçları, doğrudan alt öğe özetleri, iç içe nesne/joker karakter/dizi/bileşim düğümlerinde doküman meta verileri ve mevcut olduğunda plugin + kanal şemaları dahil); Ham JSON düzenleyicisi yalnızca güvenli bir ham gidiş-dönüş mümkün olduğunda kullanılabilir
• Bir anlık görüntü ham metni güvenli şekilde gidiş-dönüş yapamıyorsa, Kontrol Arayüzü Form modunu zorunlu kılar ve o anlık görüntü için Ham modu devre dışı bırakır
• Yapılandırılmış SecretRef nesne değerleri, nesneden dizeye yanlışlıkla bozulmayı önlemek için form metin girişlerinde salt okunur olarak işlenir
• Hata ayıklama: durum/sağlık/model anlık görüntüleri + olay günlüğü + manuel RPC çağrıları (status, health, models.list)
• Günlükler: filtreleme/dışa aktarma ile gateway dosya günlüklerinin canlı takibi (logs.tail)
• Güncelleme: paket/git güncellemesi + yeniden başlatma çalıştırma (update.run) ve yeniden başlatma raporu

• Yalıtılmış işler için teslim varsayılan olarak duyuru özetidir. 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.mode = "webhook" kullanır ve delivery.to geçerli bir HTTP(S) webhook URL’si olarak ayarlanır.
• Ana oturum işleri için webhook ve none teslim modları kullanılabilir.
• Gelişmiş düzenleme denetimleri arasında çalıştırma sonrası silme, aracı geçersiz kılmasını temizleme, cron exact/stagger seçenekleri, aracı model/düşünme geçersiz kılmaları ve imkanlar dahilinde teslim anahtarları bulunur.
• Form doğrulaması alan düzeyi hatalarla satır içidir; geçersiz değerler düzeltilene kadar kaydet düğmesi devre dışı kalır.
• Ayrı 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ış yedek: notify: true içeren saklanan eski işler, taşınana kadar yine de cron.webhook kullanabilir.

​

Sohbet davranışı

• chat.send bloklamaz: hemen { runId, status: "started" } ile onay verir ve yanıt chat olayları üzerinden akış halinde gelir.
• Aynı idempotencyKey ile yeniden göndermek, çalışma sırasında { status: "in_flight" }, tamamlandıktan sonra ise { status: "ok" } döndürür.
• chat.history yanıtları, arayüz güvenliği için boyutla sınırlıdır. Döküm girdileri ç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 mesajları bir yer tutucuyla değiştirebilir ([chat.history omitted: message too large]).
• chat.history, görünür assistant metninden yalnızca görüntüleme amaçlı satır içi yönerge etiketlerini de kaldırır (örneğin [[reply_to_*]] ve [[audio_as_voice]]), düz metin tool-call XML yüklerini (<tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> ve kesilmiş tool-call blokları dahil) ve sızmış ASCII/tam genişlikli model kontrol belirteçlerini de kaldırır; ayrıca görünür metninin tamamı yalnızca tam sessiz belirteç NO_REPLY / no_reply olan assistant girdilerini atlar.
• chat.inject, oturum dökümüne bir assistant notu ekler ve yalnızca arayüz güncellemeleri için bir chat olayı yayınlar (aracı çalıştırması yok, kanal teslimi yok).
• Sohbet üstbilgisindeki model ve düşünme seçicileri etkin oturumu sessions.patch ile hemen yamar; bunlar tek dönüşlük gönderim seçenekleri değil, kalıcı oturum geçersiz kılmalarıdır.
• Durdurma:
  • Durdur düğmesine tıklayın (chat.abort çağırır)
  • Bant dışı iptal için /stop yazın (veya stop, stop action, stop run, stop openclaw, please stop gibi bağımsız iptal ifadeleri kullanın)
  • chat.abort, o oturum için tüm etkin çalıştırmaları iptal etmek üzere { sessionKey } desteği sunar (runId yok)
• İptal edilen kısmi içeriğin korunması:
  • Bir çalıştırma iptal edildiğinde, kısmi assistant metni yine de arayüzde gösterilebilir
  • Gateway, arabelleğe alınmış çıktı varsa iptal edilen kısmi assistant metnini döküm geçmişine kalıcı olarak yazar
  • Kalıcı girdiler, döküm tüketicilerinin iptal edilmiş kısmi içerikleri normal tamamlanma çıktısından ayırabilmesi için iptal meta verileri içerir

​

Tailnet erişimi (önerilir)

​

Tümleşik Tailscale Serve (tercih edilir)

openclaw gateway --tailscale serve

• https://<magicdns>/ (veya yapılandırılmış gateway.controlUi.basePath)

​

Tailnet’e bağlan + token

openclaw gateway --bind tailnet --token "$(openssl rand -hex 32)"

• http://<tailscale-ip>:18789/ (veya yapılandırılmış gateway.controlUi.basePath)

​

Güvensiz HTTP

• gateway.controlUi.allowInsecureAuth=true ile yalnızca localhost için güvensiz HTTP uyumluluğu
• gateway.auth.mode: "trusted-proxy" üzerinden başarılı operatör Kontrol Arayüzü kimlik doğrulaması
• acil durum için gateway.controlUi.dangerouslyDisableDeviceAuth=true

• https://<magicdns>/ (Serve)
• http://127.0.0.1:18789/ (gateway ana bilgisayarında)

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

• Güvenli olmayan HTTP bağlamlarında localhost Kontrol Arayüzü oturumlarının cihaz kimliği olmadan ilerlemesine izin verir.
• Eşleştirme denetimlerini atlamaz.
• Uzak (localhost dışı) cihaz kimliği gereksinimlerini gevşetmez.

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

• başarılı güvenilir proxy kimlik doğrulaması, cihaz kimliği olmadan operatör Kontrol Arayüzü oturumlarını kabul edebilir
• bu durum düğüm rolündeki Kontrol Arayüzü oturumlarına uzanmaz
• aynı ana bilgisayardaki loopback ters proxy’leri yine de güvenilir proxy kimlik doğrulamasını karşılamaz; bkz. Trusted Proxy Auth

​

Arayüzü derleme

pnpm ui:build # ilk çalıştırmada arayüz bağımlılıklarını otomatik kurar

OPENCLAW_CONTROL_UI_BASE_PATH=/openclaw/ pnpm ui:build

pnpm ui:dev # ilk çalıştırmada arayüz bağımlılıklarını otomatik kurar

​

Hata ayıklama/test etme: geliştirme sunucusu + uzak Gateway

1. Arayüz geliştirme sunucusunu başlatın: pnpm ui:dev
2. Şunun gibi bir URL açın:

http://localhost:5173/?gatewayUrl=ws://<gateway-host>:18789

http://localhost:5173/?gatewayUrl=wss://<gateway-host>:18789#token=<gateway-token>

• gatewayUrl yüklendikten sonra localStorage’da saklanır ve URL’den kaldırılır.
• token mümkün olduğunda URL parçası (#token=...) ile 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 yine bir kez içe aktarılır, ancak yalnızca yedek olarak ve önyüklemeden hemen sonra kaldırılır.
• password yalnızca bellekte tutulur.
• gatewayUrl ayarlandığında, arayüz config veya ortam kimlik bilgilerine geri dönmez. token (veya password) açıkça sağlanmalıdır. Açık kimlik bilgilerinin eksik olması bir hatadır.
• Gateway TLS arkasındaysa wss:// kullanın (Tailscale Serve, HTTPS proxy vb.).
• Tıklama sahtekarlığını önlemek için gatewayUrl yalnızca üst düzey pencerede kabul edilir (gömülü olarak değil).
• Loopback olmayan Kontrol Arayüzü dağıtımları gateway.controlUi.allowedOrigins değerini açıkça ayarlamalıdır (tam origin’ler). Buna uzak geliştirme kurulumları da dahildir.
• Sıkı denetimli yerel testler dışında gateway.controlUi.allowedOrigins: ["*"] kullanmayın. Bu, “kullandığım ana bilgisayarla eşleştir” değil, herhangi bir tarayıcı origin’ine izin ver anlamına gelir.
• gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true, Host başlığı origin geri dönüş modunu etkinleştirir, ancak bu tehlikeli bir güvenlik modudur.

{
  gateway: {
    controlUi: {
      allowedOrigins: ["http://localhost:5173"],
    },
  },
}

​

İlgili

• Dashboard — gateway gösterge paneli
• WebChat — tarayıcı tabanlı sohbet arayüzü
• TUI — terminal kullanıcı arayüzü
• Health Checks — gateway sağlık izleme