Web

• varsayılan: http://<host>:18789/
• gateway.tls.enabled: true ile: https://<host>:18789/
• isteğe bağlı ön ek: gateway.controlUi.basePath değerini ayarlayın (ör. /openclaw)

​

Yapılandırma (varsayılan olarak açık)

{
  gateway: {
    controlUi: { enabled: true, basePath: "/openclaw" }, // basePath isteğe bağlıdır
  },
}

​

Webhook’lar

​

Yönetici HTTP RPC

​

Tailscale erişimi

{
  gateway: {
    bind: "loopback",
    tailscale: { mode: "serve" },
  },
}

openclaw gateway

{
  gateway: {
    bind: "tailnet",
    controlUi: { enabled: true },
    auth: { mode: "token", token: "your-token" },
  },
}

openclaw gateway

{
  gateway: {
    bind: "loopback",
    tailscale: { mode: "funnel" },
    auth: { mode: "password" }, // veya OPENCLAW_GATEWAY_PASSWORD
  },
}

​

Güvenlik notları

• Gateway kimlik doğrulaması varsayılan olarak gereklidir: etkinleştirildiğinde belirteç, parola, güvenilir proxy veya Tailscale Serve kimlik üstbilgileri.
• Geri döngü dışı bağlamalar da gateway kimlik doğrulamasını gerektirir: belirteç/parola kimlik doğrulaması veya gateway.auth.mode: "trusted-proxy" kullanan kimlik farkındalıklı bir ters proxy.
• İlk katılım sihirbazı varsayılan olarak paylaşılan gizli kimlik doğrulaması oluşturur ve geri döngüde bile genellikle bir gateway belirteci üretir.
• Paylaşılan gizli modunda UI, WebSocket el sıkışması sırasında connect.params.auth.token veya connect.params.auth.password gönderir.
• gateway.tls.enabled: true ile yerel pano/durum yardımcıları https:// URL’lerini ve wss:// WebSocket URL’lerini oluşturur.
• Kimlik taşıyan modlarda (Tailscale Serve, trusted-proxy) WebSocket kimlik doğrulama denetimi, paylaşılan bir gizli yerine istek üstbilgileriyle karşılanır.
• Genel, geri döngü dışı Control UI dağıtımlarında gateway.controlUi.allowedOrigins değerini açıkça ayarlayın (tam kaynaklar). Geri döngü, RFC1918/bağlantı-yerel, .local, .ts.net ve Tailscale CGNAT ana makinelerinde özel aynı kaynak yüklemeleri bu değer olmadan kabul edilir.
• gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback: true, Host üstbilgisi kaynak geri dönüşünü etkinleştirir; bu, güvenliği tehlikeli biçimde düşürür.
• Serve ile gateway.auth.allowTailscale: true olduğunda Tailscale kimlik üstbilgileri Control UI/WebSocket kimlik doğrulamasını karşılar (belirteç/parola gerekmez). HTTP API uç noktaları Tailscale kimlik üstbilgilerini kullanmaz; her zaman gateway’in normal HTTP kimlik doğrulama modunu izler. Serve üzerinden bile açık kimlik bilgileri gerektirmek için gateway.auth.allowTailscale: false değerini ayarlayın. Bu belirteçsiz akış, gateway ana makinesinin kendisinin güvenilir olduğunu varsayar. Tailscale ve Güvenlik bölümlerine bakın.

​

UI’yi derleme

pnpm ui:build