Bulut İşçileri

​

Nerede ne çalışır?

​

Gereksinimler

• Bir çalışan sağlayıcısı Plugin’i. Birlikte gelen crabbox Plugin’i, 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ı PATH üzerinde bulunmalı (veya settings.binary ayarlanmalı) ve sağlayıcı kimlik bilgileri önceden yapılandırılmış olmalıdır. AWS kabulü için Crabbox 0.38.1 veya üzeri gerekir.
• Crabbox AWS çalışanlarında geçerli aws.instanceProfile boş olmalıdır. Sağlayıcı, ayırmadan önce crabbox config show --json öğesini denetler ve ardından crabbox inspect --json öğesinin EC2 DescribeInstances üzerinden providerMetadata.instanceProfileAttached: false bildirmesini gerektirir. Örnek rolüne sahip veya yetkili meta verileri bulunmayan kiralamalar durdurulur ve reddedilir.
• Kiralanan makinede Node.js. Temel bulut imajlarında genellikle bulunmaz; profilin setup komutunda yükleyin.
• Oturuma ait yönetilen bir worktree içeren oturum (worktree: true ile oluşturun). Gönderim, bu worktree’nin içeriğini taşır; düz dizinler bildirim aynası olarak eşitlenir.

​

Yapılandırma

{
  "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)"
        }
      }
    }
  }
}

​

Kurulum komutu

​

Yükleme kanalları

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

​

Oturum gönderme

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"}'

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

​

Güvenlik modeli

• Kapalı çalışan girişi. Çalışanlar, tünellenmiş soket üzerinde kapalı bir yöntem izin listesine sahip özel bir protokol kullanır — bir çalışan, operatör RPC’lerini çağıramaz.
• Gateway’in sahip olduğu araç yetkisi. Gateway, her sıradan önce mevcut profil, sağlayıcı, ajan, grup, gönderen, sandbox, yetkilendirme, devralınan politika ve çalışma zamanı sınırı politikasını çalışanın sabit kodlama aracı kataloğuna yansıtır. Başlatma zarfı yalnızca bu nihai, kapalı söz dağarcığı alt kümesini taşır. Açıkça sınırlandırılmış zamanlanmış sıralar, bu kimliği kutuya göndermeden veya yeni bir gönderen katmanını yeniden uygulamadan güvenilir sahip grubu bağlamını yeniden kullanır. Çalışan kataloğunun dışındaki araçlar kullanılamaz durumda kalır; boş bir sonuç hiçbir araç olmadan çalışır.
• Oluşturulan kimlik bilgileri, beklemede karma hâlinde. Her dağıtım bir çalışan kimlik bilgisi oluşturur; Gateway yalnızca bunun karmasını saklar. Kimlik bilgisi döndürme ve sahip dönemi çitlemesi, oturum başına en fazla bir etkin sahip bulunmasını garanti eder — yeniden bağlanan eski bir çalışan çitlenir, hiçbir zaman birleştirilmez.
• Ana makine anahtarı sabitleme. Sağlayıcı, kutunun SSH ana makine anahtarını sağlama sırasında sunmalıdır; önyükleme katı sabitlemeyle bağlanır ve anahtar olmadan güvenli biçimde başarısız olur.
• Kutuda kalıcı model, forge veya bulut kimlik bilgisi bulunmaz. Model kimlik doğrulaması Gateway’de kalır (çıkarım, {provider, model} referansıyla aktarılır), çalışma alanı git commit’leri forge kimlik bilgileri olmadan oluşturulur ve Crabbox AWS kiralama meta verileri, kurulumdan önce bir örnek rolü açısından yetkili biçimde denetlenir. Kurulum komutlarını da kimlik bilgilerinden arındırılmış tutun.
• Sağlayıcının sahip olduğu çıkış trafiği. Ters tünel, OpenClaw’un doğrudan model erişimi gereksinimini ortadan kaldırır; ancak OpenClaw sağlayıcı güvenlik duvarlarını yeniden yazmaz. Görev gerektirdiğinde çalışan sağlayıcıdaki giden trafiği kısıtlayın.
• Kalıcı, tam olarak bir kez kaydedilen 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ı güvenli biçimde durdurur.

​

Sorun giderme

• sessions.dispatch bilinmeyen bir yöntem — hiçbir cloudWorkers.profiles yapılandırılmamış veya çağıranın operator.admin yetkisi yok.
• “Bulut çalışanı sıraları 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 öğesine bir Node kurulumu ekleyin (yukarıya bakın).
• AWS örnek rolü tasdiki başarısız oluyor — aws.instanceProfile değerini (ayarlanmışsa CRABBOX_AWS_INSTANCE_PROFILE değerini de) temizleyin. Crabbox 0.38.1 veya daha yeni bir sürümünü yükleyin; 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 sonu dâhil son hatayı saklar. Kutular hata durumunda yok edilir; bu nedenle bu son bölü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ı kullanır; --timeout değerini yeterince geniş verin (dağıtım her iki durumda da 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).
• 2026.7.2 beta sürümünden yükseltme sonrasında çalışan geri alındı — bu beta sürümleri eski çalışan başlatma sözleşmesini kullanıyordu. OpenClaw yeniden başlatıldığında boşta olan uyumsuz çalışanı yok eder, oturumu ve çalışma alanını korur, yerleştirmeyi geri alınmış olarak işaretler ve sonraki dağıtımda veya sırada güncel bir çalışan sağlar. Hâlâ başlatılırken kesintiye uğrayan bir beta çalışanı, temizlikten sonra başarısız olarak işaretlenir; güncel sözleşmeyle sağlamak için dağıtımı yeniden deneyin.
• Bulut çalışma alanı çakışma bildirimi — sıra tamamlandı ve listelenen her yolun yerel sürümünü korudu. Bulut sürümünü incelemek veya almak için bildirimdeki hazırlanmış ref komutlarını kullanın; zaten uygulanmış olan çakışmasız değişiklikler için yeniden deneme gerekmez.
• “Önceki bulut sırasının çalışma alanı sonucu hâlâ uzlaştırılıyor” — Gateway, önceki sonucun kalıcı çiti için kısa süre bekledi ve oturum talebini alamadı. Uzlaştırmanın tamamlanmasını bekleyin, ardından sırayı yeniden deneyin; Gateway’i yeniden başlatmak güvenlidir çünkü kurtarma, çalışmayan bir çalışanı geri almadan önce hazırlanmış sonuçları korur.
• 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şta olan kiralamaların süresi, profilin idleTimeout değerine göre dolar.

​

İlgili

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