Bulut Çalışanları

Bulut çalışanları, oturumla ilgili her şey her zaman bulunduğu yerde kalırken bir oturumun ajan döngüsünü tek kullanımlık bir bulut makinesinde çalıştırmasına olanak tanır: kenar çubuğunda görünür, canlı olarak akışa devam eder ve transkript Gateway'e ait olur. Gateway bir makine kiralar, üzerine sabitlenmiş bir OpenClaw kopyası kurar, oturumun çalışma alanını makineye eşitler ve tur döngüsünü kısıtlı bir openclaw worker sürecine devreder. Model çağrıları Gateway üzerinden geri vekillenir; böylece sağlayıcı kimlik bilgileri makinenizden hiç ayrılmaz ve sağlayıcı kesintisiz tek bir akış gördüğü için istem önbelleğe alma çalışmaya devam eder.

İş tamamlandığında (veya makine çöktüğünde) makine atılır. Kalıcı durum — transkript, çalışma alanı commit'leri, yerleşim kayıtları — Gateway ile birlikte tutulur.

Nerede ne çalışır?

Makine, sshd dışında gelen bağlantılar için hiçbir porta ihtiyaç duymaz: Gateway sabitlenmiş SSH üzerinden dışarıya bağlanır ve ters tünel, çalışanın WebSocket bağlantısını geri taşır. Paketle gelen Crabbox sağlayıcısı genel SSH yolunu zorunlu kılar ve yönetilen Tailscale kaydını devre dışı bırakır. Giden internet erişimi sağlayıcı politikasına bağlıdır; varsayılan AWS profili, ağı veya güvenlik grubu kısıtlanmadığı sürece internete erişebilir.

Gereksinimler

• Bir çalışan sağlayıcı plugini. Paketle gelen crabbox plugini, bulut arka uçları (AWS, Hetzner ve diğerleri) arasında kiralamalara aracılık eden Crabbox CLI'ını çalıştırır. crabbox ikili dosyası, sağlayıcı kimlik bilgileri önceden yapılandırılmış olarak PATH üzerinde bulunmalıdır (veya settings.binary ayarlanmalıdır). AWS kabulü için Crabbox 0.38.1 veya daha yeni bir sürüm gerekir.
• Crabbox AWS çalışanlarında geçerli aws.instanceProfile boş olmalıdır. Sağlayıcı, tahsisten önce crabbox config show --json değerini denetler; ardından crabbox inspect --json komutunun EC2 DescribeInstances kaynağından providerMetadata.instanceProfileAttached: false bildirmesini zorunlu kılar. Örnek rolü bulunan veya yetkili meta verisi olmayan kiralamalar durdurulur ve reddedilir.
• Kiralanan makinede Node.js. Temel bulut imajlarında genellikle bulunmaz; profilin setup komutuyla kurun.
• Oturuma ait yönetilen bir çalışma ağacına sahip oturum (worktree: true ile oluşturun). Gönderim bu çalışma ağacının içeriğini taşır; sıradan dizinler bildirim aynası olarak eşitlenir.

Yapılandırma

openclaw.json içindeki cloudWorkers.profiles altına bir profil ekleyin:

{  "cloudWorkers": {    "profiles": {      "aws": {        "provider": "crabbox",        "install": "bundle",        "settings": {          "provider": "aws",          "class": "standard",          "ttl": "8h",          "idleTimeout": "45m",          "setup": "test -x /usr/bin/node || (curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs)"        }      }    }  }}

Profil alanları:

Kurulum komutu

settings.setup, kiralanan makine SSH için hazır olduktan sonra ve OpenClaw kurulmadan önce çalışır. Her hazırlama girişiminde (kesintiye uğrayan bir gönderimden sonraki yeniden oynatmalar dâhil) çalıştığından eş etkili olmalıdır; örnekteki gibi kurulumları bir command -v/test -x denetimiyle koruyun. Kurulum başarısız olursa sağlayıcı kiralamayı durdurur ve gönderim güvenli biçimde başarısız olur; yarı yapılandırılmış hiçbir makine çalışır durumda bırakılmaz.

Kurulum kanalları

• bundle, çalışan Gateway'in dist öğesini, budanmış bir package.json öğesini ve derlemenin başvurduğu tüm çalışma alanı paketlerini, tamamı bir içerik karmasıyla kapsanacak şekilde paketler. Makine, değiştirilmemiş paketi bu karmaya göre doğrular ve ardından üretim npm bağımlılıklarını kurar (betikler devre dışıdır). Bir geliştirme derlemesi çalışanda bu şekilde çalıştırılır.
• npm, sürümün genel kayıt defterinde bulunduğunu kanıtlar, SHA-512 bütünlük değerini sabitler ve Gateway ile tam olarak eşleşen openclaw@<version> öğesini kurar.

Oturum gönderme

Control UI'da New Session öğesini açın, yapılandırılmış çalışma zamanı OpenClaw olan bir ajan seçin, Where menüsünden yapılandırılmış bir Cloud · profile hedefi seçin ve görevi başlatın. Bulut seçimi, gerekli yönetilen çalışma ağacını otomatik olarak etkinleştirir; Gateway oturumu oluşturur, gönderimi tamamlar ve ilk turu ancak bundan sonra gönderir. Oturum kenar çubuğundaki sunucu rozeti, kalıcı yerleşim durumunu gösterir. Bulut hedefleri, harici CLI oturum katalogları için sunulmaz.

Eşdeğer RPC akışı şöyledir:

Yönetilen çalışma ağacına sahip bir oturum oluşturun ve ardından gönderin (RPC, operator.admin gerektirir ve yalnızca profiller yapılandırıldığında bulunur):

Bulut çalışanları OpenClaw ajan çalışma zamanını çalıştırır. Bu çalışma zamanına çözümlenen bir openai/* veya başka bir model seçin; claude-cli gibi harici bir CLI çalışma zamanı için yapılandırılan oturumlar gönderilemez.

openclaw gateway call sessions.create \  --params '{"key":"agent:main:big-refactor","worktree":true,"cwd":"/path/to/repo","worktreeName":"big-refactor"}' openclaw gateway call sessions.dispatch \  --timeout 1500000 \  --params '{"key":"agent:main:big-refactor","profileId":"aws"}'

sessions.dispatch, yerel tur kabulünü kapatır, etkin işleri tamamlanana kadar boşaltır, kiralamayı hazırlar, kurulumu çalıştırır, OpenClaw'ı önyükler, çalışma alanını eşitler ve yerleşim active çalışan sahipliğine ulaştığında döner. İlk gönderim için birkaç dakika ayırın; sağlayıcı desteklediğinde kiralamalar ve kurulumlar önbelleğe alınır. Ardından oturumla her zamanki gibi konuşun; turlar otomatik olarak çalışana yönlendirilir.

Tamamlanan çalışan turları, tur talebi serbest bırakılmadan önce uygun ve boyutu sınırlandırılmış çalışma alanı dosyalarını oturumun yönetilen çalışma ağacına geri uzlaştırır. Son çalışan olayı, onaylanmadan önce kalıcı bir bekleyen sonuç engeli oluşturur; böylece Gateway yeniden başlatma kurtarması, eski tur temizliğinin sahibini yok etmesinden önce uzak çalışma alanını geri çeker. Uzlaştırma, çalışan bildirimini doğrular ve taraflardan birinin üzerine yazmak yerine yerel ayrışma durumunda durur. Gateway, dosyaları değiştirmeden önce SQLite durum veritabanında boyutu sınırlandırılmış bir geri alma günlüğü saklar; yeniden deneme, kesintiye uğramış bir Gateway sürecinden sonra bu günlüğü kurtarır. Çalışma alanı sonuçları Git dosya semantiğini kullanır: normal dosyalar, çalıştırılabilir bitleri, sembolik bağlantılar, eklemeler, değişiklikler ve silmeler korunurken boş dizinler ve diğer dizin kipleri korunmaz. Uzak commit nesneleri korunmaz; ortaya çıkan dosya değişiklikleri normal inceleme ve commit işlemleri için yönetilen çalışma ağacında kalır.

İş tamamlandığında ve çalışan hiçbir tur yokken oturum menüsünü açıp Stop cloud worker… öğesini seçin. Gateway, ortamı yok etmeden önce son bir çalışma alanı uzlaştırması gerçekleştirir. Zaten draining veya reconciling durumunda olan bir yerleşim, kapatma işlemini tamamlıyordur; oturumu silmeden önce rozetinin reclaimed olmasını bekleyin.

Bozuk veya kontrolden çıkmış bağlı bir çalışan için operatör, son çare olarak { "force": true } ile environments.destroy çağrısı yapabilir. Zorunlu kapatma, ortamı yok etmeden önce yerleşimi kalıcı olarak başarısız şeklinde işaretler ve uzlaştırılmamış tüm uzak sonuçlardan vazgeçer.

Eşdeğer yönetimsel RPC şöyledir:

openclaw gateway call sessions.reclaim \  --timeout 600000 \  --params '{"key":"agent:main:big-refactor"}'

Yerleşim, kalıcı bir durum makinesinden (local → requested → provisioning → syncing → starting → active) geçer; böylece gönderimin ortasında Gateway yeniden başlatıldığında makineler sızdırılmak yerine uzlaştırılır. Başarısız bir model turu, etkin yerleşimi yeniden deneme için kullanılabilir durumda tutar. Gelen çalışma alanı uzlaştırması başarısız olursa çalışan da etkin kalır; böylece operatör yerel çakışmayı çözebilir ve uzak sonucu kaybetmeden yeniden deneyebilir. Yaşam döngüsü hataları ise yerleşimi hata veya geri alınmış durumuna taşır ve tanılama son bölümünü korur.

Güvenlik modeli

• Kapalı çalışan girişi. Çalışanlar, kapalı bir yöntem izin listesine sahip tünellenmiş soket üzerinde özel bir protokolle iletişim kurar; bir çalışan operatör RPC'lerini çağıramaz.
• Üretilen kimlik bilgileri, bekleme durumunda karma olarak saklanır. Her gönderim bir çalışan kimlik bilgisi üretir; Gateway yalnızca bunun karmasını saklar. Kimlik bilgisi rotasyonu ve sahip dönemi engellemesi, oturum başına en fazla bir canlı sahip bulunmasını garanti eder; yeniden bağlanan eski bir çalışan birleştirilmez, engellenir.
• Ana makine anahtarı sabitleme. Sağlayıcı, hazırlama sırasında makinenin SSH ana makine anahtarını sunmalıdır; önyükleme sıkı sabitlemeyle bağlanır ve anahtar olmadan güvenli biçimde başarısız olur.
• Makinede kalıcı model, forge veya bulut kimlik bilgileri bulunmaz. Model kimlik doğrulaması Gateway'de kalır (çıkarım {provider, model} referansıyla taşınır), çalışma alanı git commit'leri forge kimlik bilgileri olmadan oluşturulur ve Crabbox AWS kiralama meta verileri, kurulumdan önce örnek rolü açısından yetkili olarak denetlenir. Kurulum komutlarını da kimlik bilgisi içermeyecek şekilde tutun.
• Sağlayıcıya ait giden trafik. Ters tünel, OpenClaw'ın doğrudan model erişimi ihtiyacını ortadan kaldırır; ancak OpenClaw sağlayıcı güvenlik duvarlarını yeniden yazmaz. Görev gerektiriyorsa çalışan sağlayıcısındaki giden trafiği kısıtlayın.
• Kalıcı, tam olarak bir kez yazılan transkriptler. Çalışan, transkript gruplarını oturumun yaprağına karşı karşılaştır ve değiştir protokolüyle commit eder; eski bir taban, ücretli çıktıyı çoğaltmak veya yeniden temellendirmek yerine çalışmayı hata vererek durdurur.

Sorun giderme

• sessions.dispatch bilinmeyen bir yöntem — hiçbir cloudWorkers.profiles yapılandırılmamış veya çağıran operator.admin yetkisine sahip değil.
• "Bulut çalışanı turları OpenClaw çalışma zamanını gerektirir" — yapılandırılmış çalışma zamanı OpenClaw olan bir model seçin. claude-cli gibi harici CLI çalışma zamanları çalışan çıkarımını desteklemez.
• "Çalışan önyüklemesi, kiralanan ana makinede Node.js gerektirir" — settings.setup içine bir Node kurulumu ekleyin (yukarıya bakın).
• AWS örnek rolü doğrulaması başarısız oluyor — aws.instanceProfile değerini (ve ayarlanmışsa CRABBOX_AWS_INSTANCE_PROFILE değerini) temizleyin. Crabbox 0.38.1 veya daha yeni bir sürümünü kurun; eski ikili dosyalar, AWS kabulü için gereken yetkili providerMetadata.instanceProfileAttached sözleşmesini sunmaz.
• Dağıtım bir sağlayıcı hatasıyla başarısız oluyor — yerleştirme kaydı ve environments.list, kurulum/önyükleme stderr çıktısının son kısmı dâhil olmak üzere son hatayı saklar. Kutular başarısızlık durumunda imha edildiğinden, bu son kısım birincil adli inceleme kaynağıdır.
• Dağıtım sırasında istemci zaman aşımı — openclaw gateway call varsayılan olarak 10s zaman aşımına sahiptir; --timeout için yeterince yüksek bir değer iletin (her iki durumda da dağıtım sunucu tarafında çalışmaya devam eder ve sağlama sırasında yapılan yeniden deneme session cannot dispatch from placement provisioning ile reddedilir).
• Kiralama bakımı — crabbox list --provider <backend> etkin kiralamaları gösterir; crabbox stop --provider <backend> --id <lease> birini manuel olarak serbest bırakır. Boştaki kiralamaların süresi, profilin idleTimeout değerine göre dolar.

İlgili

• Korumalı alan — yerel araç yürütmenin etki alanını azaltma
• Oturumlar CLI'si — saklanan oturumları inceleme
• Yapılandırma referansı