Хмарні воркери

​

Що де виконується

​

Вимоги

• Plugin провайдера робочого середовища. Вбудований Plugin crabbox керує CLI Crabbox, який розподіляє оренди між хмарними бекендами (AWS, Hetzner та іншими). Виконуваний файл crabbox має бути в PATH (або задайте settings.binary), а облікові дані провайдера мають бути вже налаштовані. Для допуску до AWS потрібен Crabbox 0.38.1 або новіший.
• Для робочих середовищ Crabbox AWS фактичне значення aws.instanceProfile має бути порожнім. Перед виділенням ресурсів провайдер перевіряє crabbox config show --json, а потім вимагає, щоб crabbox inspect --json повідомляв providerMetadata.instanceProfileAttached: false із EC2 DescribeInstances. Оренди з роллю екземпляра або без авторитетних метаданих зупиняються й відхиляються.
• Node.js на орендованій машині. У базових хмарних образах його зазвичай немає — установіть його командою setup профілю.
• Сеанс із керованим робочим деревом, що належить сеансу (створіть його за допомогою worktree: true). Під час надсилання переміщується вміст цього робочого дерева; звичайні каталоги синхронізуються як дзеркало маніфесту.

​

Конфігурація

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

​

Команда налаштування

​

Канали встановлення

• bundle пакує dist запущеного Gateway, скорочений package.json і всі пакети робочого простору, на які посилається збірка; усе це захищається хешем вмісту. Машина перевіряє незмінений пакет за цим хешем, а потім установлює виробничі залежності npm (сценарії вимкнено). Так запускається збірка для розробки в робочому середовищі.
• npm перевіряє наявність випуску в загальнодоступному реєстрі, фіксує його цілісність SHA-512 та встановлює openclaw@<version>, що точно відповідає Gateway.

​

Надсилання сеансу

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

​

Модель безпеки

• Закритий вхідний доступ до робочого середовища. Робочі середовища взаємодіють через спеціальний протокол у тунельованому сокеті із закритим списком дозволених методів — робоче середовище не може викликати операторські RPC.
• Створені облікові дані, хешовані під час зберігання. Кожне надсилання створює облікові дані робочого середовища; Gateway зберігає лише їхній хеш. Ротація облікових даних і відсікання за епохою власника гарантують не більше одного активного власника на сеанс — застаріле робоче середовище, що повторно підключається, відсікається й ніколи не об’єднується.
• Фіксація ключа хоста. Провайдер має надати ключ SSH-хоста машини під час підготовки; початкове завантаження підключається зі строгою фіксацією ключа й безпечно завершується помилкою за його відсутності.
• На машині немає постійних облікових даних моделі, платформи розробки чи хмари. Автентифікація моделі залишається в Gateway (виведення передається за посиланням {provider, model}), Git-коміти робочого простору створюються без облікових даних платформи розробки, а метадані оренди Crabbox AWS авторитетно перевіряються на наявність ролі екземпляра до налаштування. Команди налаштування також не повинні містити облікових даних.
• Вихідний трафік під керуванням провайдера. Зворотний тунель усуває потребу OpenClaw у прямому доступі до моделі, але OpenClaw не змінює правила брандмауера провайдера. Обмежуйте вихідний трафік у провайдері робочого середовища, коли цього потребує завдання.
• Стійкі транскрипти з рівно одноразовим записом. Робоче середовище фіксує пакети транскрипту через протокол порівняння й заміни відносно кінцевого вузла сеансу; застаріла база аварійно зупиняє виконання замість дублювання або перебазування оплачуваного виводу.

​

Усунення несправностей

• sessions.dispatch — невідомий метод — не налаштовано жодного cloudWorkers.profiles або викликач не має operator.admin.
• «Хмарні запуски воркера потребують середовища виконання OpenClaw» — виберіть модель, налаштованим середовищем виконання якої є OpenClaw. Зовнішні середовища виконання CLI, як-от claude-cli, не підтримують інференс воркера.
• «Для початкового завантаження воркера потрібен Node.js на орендованому хості» — додайте встановлення Node до settings.setup (див. вище).
• Атестація ролі екземпляра AWS завершується помилкою — очистьте aws.instanceProfile (і CRABBOX_AWS_INSTANCE_PROFILE, якщо задано). Установіть Crabbox 0.38.1 або новішої версії; старіші двійкові файли не надають авторитетного контракту providerMetadata.instanceProfileAttached, потрібного для допуску AWS.
• Диспетчеризація завершується помилкою постачальника — запис розміщення та environments.list зберігають останню помилку, зокрема кінцеву частину stderr налаштування/початкового завантаження. У разі помилки бокси знищуються, тому ця кінцева частина є основним джерелом для розслідування.
• Час очікування клієнта спливає під час диспетчеризації — openclaw gateway call типово має час очікування 10s; задавайте --timeout із достатнім запасом (диспетчеризація в будь-якому разі продовжує виконуватися на сервері, а повторна спроба під час підготовки відхиляється з session cannot dispatch from placement provisioning).
• Обслуговування оренд — crabbox list --provider <backend> показує активні оренди; crabbox stop --provider <backend> --id <lease> вивільняє одну з них вручну. Неактивні оренди завершуються після закінчення визначеного в профілі idleTimeout.

​

Пов’язані матеріали

• Ізоляція — зменшення радіуса ураження під час локального виконання інструментів
• CLI сеансів — перевірка збережених сеансів
• Довідник із конфігурації