​

Kontrol Arayüzü (tarayıcı)

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

​

Hızlı açma (yerel)

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

• connect.params.auth.token
• connect.params.auth.password Gösterge paneli ayarlar bölümü bir belirteç saklamanıza izin verir; parolalar kalıcı olarak tutulmaz. Başlangıç sihirbazı varsayılan olarak bir gateway belirteci üretir; ilk bağlantıda bunu buraya yapıştırın.

​

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

# List pending requests
openclaw devices list

# Approve by request ID
openclaw devices approve <requestId>

• Yerel bağlantılar (127.0.0.1) otomatik olarak onaylanır.
• Uzak bağlantılar (LAN, Tailnet, vb.) 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.

​

Neler yapabilir (bugün)

• Gateway WS üzerinden modelle sohbet (chat.history, chat.send, chat.abort, chat.inject)
• Chat’te araç çağrılarını ve canlı araç çıktı kartlarını akış halinde yayınlama (ajan olayları)
• Kanallar: WhatsApp/Telegram/Discord/Slack + eklenti kanalları (Mattermost, vb.) durum + QR ile giriş + kanal başına yapılandırma (channels.status, web.login.*, config.patch)
• Örnekler: varlık listesi + yenileme (system-presence)
• Oturumlar: liste + oturum başına düşünme/ayrıntılı geçersiz kılmalar (sessions.list, sessions.patch)
• Cron işleri: listele/ekle/çalıştır/etkinleştir/devre dışı bırak + çalışma geçmişi (cron.*)
• Skills: durum, etkinleştir/devre dışı bırak, yükle, API anahtarı güncellemeleri (skills.*)
• Düğümler: liste + yetenekler (node.list)
• Çalıştırma onayları: gateway veya düğüm izin listelerini düzenleme + exec host=gateway/node için politika sorma (exec.approvals.*)
• Yapılandırma: ~/.openclaw/openclaw.json görüntüleme/düzenleme (config.get, config.set)
• Yapılandırma: doğrulama ile uygula + yeniden başlat (config.apply) ve son etkin oturumu uyandır
• Yapılandırma yazımları, eşzamanlı düzenlemelerin üzerine yazılmasını önlemek için bir temel karma (base-hash) koruması içerir
• Yapılandırma şeması + form oluşturma (config.schema, eklenti + kanal şemaları dahil); Ham JSON düzenleyici kullanılabilir durumda kalır
• 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)
• Günlükler: filtre/dışa aktarma ile gateway dosya günlüklerinin canlı takibi (logs.tail)
• Güncelleme: paket/git güncellemesi çalıştır + yeniden başlat (update.run) ve yeniden başlatma raporu

• İzole işler için teslimat varsayılan olarak duyuru özeti gönderir. Yalnızca dahili çalıştırmalar istiyorsanız “none” seçebilirsiniz.
• “announce” seçildiğinde kanal/hedef alanları görünür.

​

Sohbet davranışı

• chat.send engelleyici değildir: { runId, status: "started" } ile hemen onaylar ve yanıt chat olaylarıyla akış halinde gelir.
• Aynı idempotencyKey ile yeniden gönderme, çalışırken { status: "in_flight" }, tamamlandıktan sonra { status: "ok" } döndürür.
• chat.inject, oturum dökümüne bir asistan notu ekler ve yalnızca arayüz güncellemeleri için (ajan çalıştırma yok, kanal teslimi yok) bir chat olayı yayınlar.
• Durdur:
  • Stop’a tıklayın (chat.abort çağrılır)
  • Bant dışı iptal için /stop (veya stop|esc|abort|wait|exit|interrupt) yazın
  • chat.abort, bu oturum için tüm etkin çalıştırmaları iptal etmek üzere { sessionKey }’yı destekler (runId yok)

​

Tailnet erişimi (önerilir)

​

Entegre Tailscale Serve (tercih edilen)

openclaw gateway --tailscale serve

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

​

Tailnet’e bağla + belirteç

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

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

​

Güvensiz HTTP

• https://<magicdns>/ (Serve)
• http://127.0.0.1:18789/ (gateway ana makinesinde)

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

​

UI’yi derleme

pnpm ui:build # auto-installs UI deps on first run

OPENCLAW_CONTROL_UI_BASE_PATH=/openclaw/ pnpm ui:build

pnpm ui:dev # auto-installs UI deps on first run

​

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

1. Arayüz geliştirme sunucusunu başlatın: pnpm ui:dev
2. Şuna benzer 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üklemeden sonra localStorage’da saklanır ve URL’den kaldırılır.
• token localStorage’da saklanır; password yalnızca bellekte tutulur.
• gatewayUrl ayarlandığında, arayüz yapılandırma veya ortam kimlik bilgilerine geri dönmez. token’yi (veya password) açıkça sağlayın. Açık kimlik bilgileri olmaması hatadır.
• Gateway TLS arkasındayken (Tailscale Serve, HTTPS proxy, vb.) wss:// kullanın.
• Tıklama kaçırmayı önlemek için gatewayUrl yalnızca üst düzey pencerede kabul edilir (gömülü değil).
• Çapraz kaynaklı geliştirme kurulumları için (örn. pnpm ui:dev’dan uzak bir Gateway’e), arayüz kaynağını gateway.controlUi.allowedOrigins’ye ekleyin.

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