Gateway - Neotask by Neotask Documentation | Neotask

Gateway

Gateway Nedir?

Gateway, Open Claw'ın kalbidir — tüm ajan oturumlarını, mesajlaşma kanallarını, araç yürütmesini ve cihaz bağlantılarını yöneten tek, uzun süreli çalışan bir hizmettir. Her şey Gateway üzerinden akar.

İstemcilerden (masaüstü uygulama, mobil uygulamalar, web gösterge paneli) bağlantıları kabul eden ve tüm yapay zeka asistanı yaşam döngüsünü yöneten bir WebSocket sunucusudur.

Mimari

Bileşenler

WebSocket Sunucusu — İstemci bağlantılarını kabul eder (varsayılan port 18789)

HTTP Sunucusu — Kontrol Arayüzüne, tuval ana bilgisayarına ve sağlık uç noktalarına hizmet eder

Kanal Adaptörleri — Mesajlaşma platformlarına bağlantıları korur (WhatsApp, Telegram, Discord vb.)

Oturum Yöneticisi — Ajan konuşma durumunu kalıcı kılar ve yönetir

Cron Zamanlayıcısı — Zamanlanmış işleri ve kalp atışı uyanmalarını çalıştırır

Eklenti Çalışma Zamanı — Eklenti yaşam döngüsünü yükler ve yönetir

Tarayıcı Hizmeti — Web otomasyonu için Chromium örneklerini kontrol eder

Bağlama Modları

| Mod | Açıklama | |------|-------------| | Geri Döngü | Varsayılan. Yalnızca localhost'tan erişilebilir (127.0.0.1) | | LAN | Yerel ağınızda erişilebilir. Bonjour/mDNS aracılığıyla otomatik keşfedilebilir | | Tailnet | MagicDNS ile Tailscale VPN üzerinden erişilebilir | | Özel | Belirli bir adrese bağlanın |

Kimlik Doğrulama

| Yöntem | Açıklama | |--------|-------------| | Token | WebSocket taşıyıcı token'ı (UUID veya özel dize) | | Şifre | Şifre tabanlı kimlik doğrulama (bcrypt karma) | | Güvenilir Proxy | Ön kimlik doğrulama başlıklı ters proxy'ler için | | Yerel Güven | Geri döngü bağlantıları otomatik olarak onaylanır |

Yapılandırma

Gateway, openclaw.json (JSON5 formatı) aracılığıyla yapılandırılır. Temel bölümler:

| Bölüm | Kontroller | |---------|----------| | agents | Ajan listesi, varsayılanlar, çalışma alanları | | gateway | Port, bağlama modu, kimlik doğrulama, yeniden yükleme davranışı | | channels | Kanal başına yapılandırma ve kimlik bilgileri | | tools | Araç izinleri, profiller, güvenlik | | plugins | Eklenti yükleme, etkinleştirme, eklenti başına yapılandırma | | models | Sağlayıcı kimlik doğrulama, yedekler, sağlayıcı ayarları | | skills | Beceri dizinleri, beceri başına yapılandırma | | browser | Tarayıcı profilleri, portlar, başsız mod | | cron | Zamanlayıcı yapılandırması | | session | Sıfırlama kuralları, sıkıştırma eşikleri | | messages | TTS ayarları, medya politikaları | | memory | Bellek dizinleme yapılandırması | | security | Sanal alan, yükseltilmiş mod, onaylar |

Sıcak Yeniden Yükleme

Yapılandırma değişiklikleri yeniden başlatma olmadan uygulanabilir:

| Mod | Davranış | |------|----------| | Karma (varsayılan) | Güvenli değişiklikleri sıcak uygula, diğerleri için yeniden başlat | | Sıcak | Yalnızca sıcak güvenli değişiklikleri uygula, diğerlerini yoksay | | Yeniden Başlat | Herhangi bir yeniden yükleme gerektiren değişiklikte yeniden başlat | | Kapalı | Otomatik yeniden yükleme yok |

Uzaktan Erişim

Tailscale (Önerilen)

Tailscale güvenli, sıfır yapılandırmalı uzaktan erişim sağlar:

Gateway'i Tailnet'inize bağlayın

Aynı Tailscale ağındaki herhangi bir cihazdan erişin

MagicDNS üzerinden otomatik DNS

Tailscale Serve, gösterge panelini HTTPS ile açığa çıkarabilir

SSH Tüneli

Gateway portunu SSH üzerinden iletin:

Basit, güvenli, yapılandırma değişikliği gerekmez

Herhangi bir SSH özellikli makineyle çalışır

Tam WebSocket protokolünü ve Kontrol Arayüzünü destekler

Güvenlik Kuralları

Geri döngü + SSH/Tailscale en güvenli kombinasyondur

Geri döngü dışı bağlama, kimlik doğrulama token yapılandırması gerektirir

Ekstra güvenlik için TLS parmak izi sabitleme mevcuttur

Tarayıcı kontrolü varsayılan olarak uzak bağlantılar için devre dışıdır

Sağlık İzleme

Sağlık Uç Noktası

/health HTTP uç noktası şunları döndürür:

Gateway durumu

RPC canlılığı

Kanal başına sağlık (bağlı, kimlik doğrulama durumu, hesap sayısı)

Tarayıcı hazırlığı

Etkin ajanlar ve bağlı düğümler

Çalışma süresi

Yoklamalar

RPC canlılığı — WebSocket bağlantısı + yankı testi

Kanal sağlığı — Kanal başına kimlik doğrulama kontrolü + API ping'i

Tarayıcı hazırlığı — Port kontrolü, süreç kontrolü

Düğüm bağlantısı — Son kalp atışı zaman damgası

Keşif

Bonjour/mDNS

LAN'a bağlandığında Gateway, kendisini çok noktaya yayın DNS aracılığıyla reklamlar:

Hizmet türü: _openclaw-gw._tcp

Port, taşıma, TLS durumu ve Tailscale DNS bilgisini içerir

Eşlik eden uygulamalar Gateway'i otomatik olarak keşfeder

Geniş Alan Keşfi

Yapılandırılabilir zaman aşımlarıyla ağınız genelinde gateway'leri keşfedin. Hem yerel Bonjour hem de Tailscale DNS keşfini destekler.

Çoklu Gateway'ler

Profiller kullanarak aynı makinede birden fazla Gateway örneği çalıştırabilirsiniz:

Her profilin ayrı yapılandırması, çalışma alanı, oturumları ve durumu vardır

Her Gateway için farklı portlar

Yalıtım (kişisel ve iş) veya test için kullanışlıdır

Tanılama

Doktor

Yerleşik tanılama aracı şunları kontrol eder:

Yapılandırma geçerliliği

Dosya izinleri

Kanal bağlantısı

Model kimlik doğrulama durumu

Node.js sürüm uyumluluğu

Yaygın yanlış yapılandırmalar

İzin verildiğinde birçok sorunu otomatik olarak düzeltebilir.

Günlük Kaydı

Gateway günlükleri günlük JSONL dosyalarına yazılır:

Tamamlama başına token kullanımı takibi

Kanal olay günlükleri

Yapılandırılmış bağlamla hata günlüğü

Yapılandırılabilir günlük seviyeleri

View full documentation