Worker Cloud

​

Apa yang berjalan di mana

​

Persyaratan

• Plugin penyedia worker. Plugin crabbox bawaan mengendalikan CLI Crabbox, yang menjadi perantara penyewaan di berbagai backend cloud (AWS, Hetzner, dan lainnya). Biner crabbox harus berada di PATH (atau tetapkan settings.binary) dengan kredensial penyedia yang sudah dikonfigurasi. Penerimaan AWS memerlukan Crabbox 0.38.1 atau yang lebih baru.
• Untuk worker AWS Crabbox, aws.instanceProfile efektif harus kosong. Penyedia memeriksa crabbox config show --json sebelum alokasi, lalu mengharuskan crabbox inspect --json melaporkan providerMetadata.instanceProfileAttached: false dari DescribeInstances EC2. Penyewaan dengan peran instans atau tanpa metadata otoritatif dihentikan dan ditolak.
• Node.js pada mesin yang disewa. Image cloud dasar biasanya tidak menyertakannya — pasang Node.js dalam perintah setup profil.
• Sesi dengan worktree terkelola milik sesi (buat dengan worktree: true). Pengiriman memindahkan isi worktree tersebut; direktori biasa disinkronkan sebagai cerminan manifes.

​

Konfigurasi

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

​

Perintah penyiapan

​

Saluran instalasi

• bundle mengemas dist milik Gateway yang sedang berjalan, package.json yang telah dipangkas, dan paket ruang kerja apa pun yang dirujuk build, semuanya tercakup oleh hash konten. Mesin memverifikasi bundel asli berdasarkan hash tersebut, lalu memasang dependensi npm produksi (skrip dinonaktifkan). Beginilah cara menjalankan build pengembangan pada worker.
• npm membuktikan bahwa rilis tersedia di registry publik, mematok integritas SHA-512-nya, dan memasang openclaw@<version> yang sama persis dengan Gateway.

​

Mengirim sesi

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

​

Model keamanan

• Ingress pekerja tertutup. Pekerja berkomunikasi menggunakan protokol khusus pada soket yang disalurkan melalui terowongan dengan daftar izin metode yang tertutup — pekerja tidak dapat memanggil RPC operator.
• Kredensial yang diterbitkan, di-hash saat disimpan. Setiap pengiriman menerbitkan kredensial pekerja; Gateway hanya menyimpan hash-nya. Rotasi kredensial dan pemagaran epoch pemilik menjamin bahwa paling banyak hanya ada satu pemilik aktif per sesi — pekerja usang yang terhubung kembali akan dipagari, tidak pernah digabungkan.
• Penyematan kunci host. Penyedia harus menyediakan kunci host SSH milik box saat penyediaan; bootstrap terhubung dengan penyematan ketat dan gagal secara tertutup jika kunci tersebut tidak tersedia.
• Tidak ada kredensial model, forge, atau cloud yang tersimpan permanen di box. Autentikasi model tetap berada di Gateway (inferensi dikirim melalui referensi {provider, model}), commit git ruang kerja dibuat tanpa kredensial forge, dan metadata sewa AWS Crabbox diperiksa secara otoritatif untuk memastikan keberadaan peran instans sebelum penyiapan. Pastikan juga perintah penyiapan bebas dari kredensial.
• Egress yang dimiliki penyedia. Terowongan balik menghilangkan kebutuhan OpenClaw untuk mengakses model secara langsung, tetapi OpenClaw tidak menulis ulang firewall penyedia. Batasi lalu lintas keluar di penyedia pekerja saat tugas mengharuskannya.
• Transkrip yang tahan lama dan tepat satu kali. Pekerja melakukan commit batch transkrip melalui protokol bandingkan-dan-tukar terhadap leaf sesi; basis usang akan menghentikan proses secara paksa alih-alih menduplikasi atau melakukan rebase pada keluaran berbayar.

​

Pemecahan masalah

• sessions.dispatch adalah metode yang tidak dikenal — tidak ada cloudWorkers.profiles yang dikonfigurasi, atau pemanggil tidak memiliki operator.admin.
• “Giliran pekerja cloud memerlukan runtime OpenClaw” — pilih model dengan runtime yang dikonfigurasi sebagai OpenClaw. Runtime CLI eksternal seperti claude-cli tidak mendukung inferensi pekerja.
• “Bootstrap pekerja memerlukan Node.js pada host yang disewa” — tambahkan instalasi Node ke settings.setup (lihat di atas).
• Atestasi peran instans AWS gagal — hapus aws.instanceProfile (dan CRABBOX_AWS_INSTANCE_PROFILE, jika ditetapkan). Instal Crabbox 0.38.1 atau yang lebih baru; biner lama tidak menyediakan kontrak providerMetadata.instanceProfileAttached otoritatif yang diperlukan untuk penerimaan AWS.
• Pengiriman gagal dengan kesalahan penyedia — catatan penempatan dan environments.list menyimpan kesalahan terakhir, termasuk bagian akhir stderr penyiapan/bootstrap. Box dimusnahkan saat terjadi kegagalan, sehingga bagian akhir tersebut menjadi sumber forensik utama.
• Waktu tunggu klien habis saat melakukan pengiriman — openclaw gateway call secara default memiliki batas waktu 10s; berikan --timeout dengan nilai yang cukup besar (pengiriman tetap berjalan di sisi server dalam kedua kondisi tersebut, dan percobaan ulang selama penyediaan ditolak dengan session cannot dispatch from placement provisioning).
• Pemberitahuan konflik ruang kerja cloud — giliran telah selesai dan mempertahankan versi lokal dari setiap jalur yang tercantum. Gunakan perintah ref yang telah disiapkan dalam pemberitahuan untuk memeriksa atau mengambil versi cloud; perubahan yang tidak berkonflik tidak perlu dicoba ulang karena sudah diterapkan.
• “Hasil ruang kerja dari giliran cloud sebelumnya masih direkonsiliasi” — Gateway menunggu sebentar hingga pagar tahan lama hasil sebelumnya tersedia dan tidak dapat memperoleh klaim sesi. Tunggu hingga rekonsiliasi selesai, lalu coba kembali giliran tersebut; memulai ulang Gateway aman karena pemulihan mempertahankan hasil yang telah disiapkan sebelum mengambil alih pekerja yang mati.
• Pemeliharaan sewa — crabbox list --provider <backend> menampilkan sewa aktif; crabbox stop --provider <backend> --id <lease> melepaskan satu sewa secara manual. Sewa menganggur kedaluwarsa berdasarkan idleTimeout milik profil.

​

Terkait

• Sandboxing — mengurangi radius dampak untuk eksekusi alat lokal
• CLI sesi — memeriksa sesi yang tersimpan
• Referensi konfigurasi