Skip to main content

​
Gateway hizmeti çalıştırma kılavuzu

Gateway hizmetinin ilk gün başlatma ve ikinci gün operasyonları için bu sayfayı kullanın.

Deep troubleshooting

Belirti odaklı tanılama; tam komut adımları ve günlük (log) imzaları ile.

Configuration

Görev odaklı kurulum kılavuzu + tam yapılandırma referansı.

​
5 dakikalık yerel başlatma

1

Start the Gateway

2

Verify service health

Sağlıklı temel durum: Runtime: running ve RPC probe: ok.
3

Validate channel readiness

Gateway yapılandırma yeniden yükleme, etkin yapılandırma dosyası yolunu izler (profil/durum varsayılanlarından çözülür veya ayarlandığında OPENCLAW_CONFIG_PATH). Varsayılan mod: gateway.reload.mode="hybrid" (güvenli değişiklikleri anında uygular, kritiklerde yeniden başlatır).

​
Runtime modeli

  • Yönlendirme, kontrol düzlemi ve kanal bağlantıları için her zaman açık tek bir süreç.
  • Tek port çoklama.
    • WebSocket kontrol/RPC
    • OpenResponses (HTTP): /v1/responses.
    • Kontrol UI ve kancalar
  • Varsayılan bağlama modu: loopback.
  • Gateway kimlik doğrulaması varsayılan olarak gereklidir: gateway.auth.token (veya OPENCLAW_GATEWAY_TOKEN) ya da gateway.auth.password ayarlayın.

​
Port ve bağlama önceliği

​
Hot reload modları

​
Operatör komut seti

​
Uzaktan erişim

Tailscale/VPN tercih edilir; aksi halde SSH tüneli: Yedek seçenek: SSH tüneli.
Ardından istemcileri yerel olarak ws://127.0.0.1:18789 adresine bağlayın.
Gateway kimlik doğrulaması yapılandırılmışsa, istemciler SSH tünelleri üzerinden bile kimlik doğrulama (token/password) göndermelidir.
Bkz.: Remote Gateway, Authentication, Tailscale.

​
Denetim ve servis yaşam döngüsü

Üretim benzeri güvenilirlik için denetimli çalıştırmaları kullanın.
OpenClaw.app, Node tabanlı bir gateway rölesi paketleyebilir ve kullanıcı başına bir LaunchAgent kurar; etiketi bot.molt.gateway (veya bot.molt.<profile> (adlandırılmış profil). openclaw doctor servis yapılandırma sapmalarını denetler ve onarır.

​
Birden fazla gateway (aynı ana makine)

Genellikle gereksizdir: tek bir Gateway birden fazla mesajlaşma kanalını ve ajanı sunabilir. Birden fazla Gateway’i yalnızca yedeklilik veya katı yalıtım için kullanın (örn: kurtarma botu). Örnek başına kontrol listesi:
  • benzersiz gateway.port
  • benzersiz OPENCLAW_CONFIG_PATH
  • benzersiz OPENCLAW_STATE_DIR
  • benzersiz agents.defaults.workspace
Örnek:
Birden fazla gateway.

​
Dev profili hızlı yol

Varsayılanlar, izole durum/yapılandırma ve temel gateway portu 19001 içerir.

​
Protokol (operatör görünümü)

  • İlk istemci çerçevesi connect olmalıdır.
  • Gateway, hello-ok anlık görüntüsünü (presence, health, stateVersion, uptimeMs, limits/policy) döndürür.
  • İstekler: {type:"req", id, method, params} → {type:"res", id, ok, payload|error}
  • Yaygın olaylar: connect.challenge, agent, chat, presence, tick, health, heartbeat, shutdown.
Agent çalıştırmaları iki aşamalıdır:
  1. Anında kabul onayı (status:"accepted")
  2. agent yanıtları iki aşamalıdır: önce res onayı {runId,status:"accepted"}, ardından çalışma bittikten sonra nihai res {runId,status:"ok"|"error",summary}; akışlanan çıktı event:"agent" olarak gelir.
Tam belgeler: Gateway protokolü ve Köprü protokolü (eski).

​
Operasyonel kontroller

​
Canlılık

  • WS’yi açın ve connect gönderin.
  • Anlık görüntü ile birlikte hello-ok yanıtını bekleyin.

​
Hazır olma durumu

​
Boşluk kurtarma

Olaylar tekrar oynatılmaz. İstemciler sıra boşluklarını algılar ve devam etmeden önce yenilemelidir (health + system-presence).

​
Yaygın hata imzaları

Tam teşhis adımları için Gateway Troubleshooting bölümünü kullanın.

​
Güvenlik garantileri

  • Doğrudan Baileys bağlantılarına geri dönüş yoktur; Gateway kapalıysa gönderimler hızlıca başarısız olur.
  • Bağlanma dışı ilk çerçeveler veya hatalı JSON reddedilir ve soket kapatılır.
  • Zarif kapatma, soket kapanmadan önce shutdown olayı yayar.
İlgili: