NovitaClaw: Запустите OpenClaw в облаке одной командой

NovitaClaw: Запустите OpenClaw в облаке одной командой

Андрей Карпати недавно описал сдвиг, на который стоит обратить внимание: так же, как LLM-агенты появились как новый слой поверх LLM, Claws — это следующий слой поверх агентов, который выводит оркестрацию, планирование, контекст, вызовы инструментов и персистентность на уровень, недоступный агентам по отдельности.

Для этого слоя требуется инфраструктура, которая работает постоянно. Для разработчиков, запускающих OpenClaw на Novita Sandbox, это до недавнего времени означало обход ограничений по сессиям.

NovitaClaw закрывает этот пробел. Это новый инструмент развертывания на Novita Agent Sandbox, который создает полностью настроенный экземпляр OpenClaw одной командой, без ограничений по времени работы, без необходимости ручных перезапусков и без накладных расходов на управление жизненным циклом.

Проблема, которую решает CLI

Novita Agent Sandbox поддерживал развертывание OpenClaw через Шаблон Sandbox. Этот путь подходит для экспериментов, но имеет жесткое ограничение: у sandbox, созданных через интерфейс, есть лимит времени жизни сессии. Через несколько часов sandbox останавливается, и агент выходит из сети. Разработчикам, которым требовалась постоянная доступность, приходилось самостоятельно обходить это ограничение: планировать паузы, писать скрипты для перезапуска или вручную восстанавливать экземпляры.

NovitaClaw работает иначе. Здесь нет лимита на сессию. Экземпляр работает 24/7 столько, сколько вам нужно. Стандартная конфигурация — 2 vCPU, 4 ГБ ОЗУ — рассчитана на реальные рабочие нагрузки, а не на демо. А поскольку слой моделей полностью настраивается, вы сами выбираете, какие LLM будут работать в вашем агенте: размещенные на Novita или от стороннего провайдера.

Начало работы

Предварительные требования

  • Установленный Python
  • Ключ Novita API — вот как его получить:
    • Войдите в novita.ai — авторизуйтесь через Google или GitHub (новый аккаунт создается автоматически при первом входе) или зарегистрируйтесь по адресу электронной почты
    • Создайте ключ API — перейдите на страницу настроек Управление ключами, чтобы создать или управлять вашими ключами API. Скопируйте его в удобное место — он понадобится на следующем шаге.
Как установить Python

Windows

  1. Скачайте установщик Python
  2. Запустите установщик — отметьте пункт “Add Python to PATH” перед тем, как нажимать что-либо еще. Пропуск этого шага — самая частая причина ошибок у новичков в дальнейшем
  3. Нажмите Install Now и дождитесь сообщения “Setup was successful”
macOS

Откройте Терминал (Command + Space, введите “Terminal” в поиске) и выполните:

python3 --version

Если вы видите Python 3.10 или выше, все готово. Если версия старше, или Терминал предлагает установить Command Line Developer Tools, нажмите Install и подождите несколько минут перед продолжением.

Linux (Ubuntu / Debian)

Если вы используете дистрибутив на основе Debian, выполните:

sudo apt update && sudo apt install python3 python3-pip -y

Установка и запуск

Шаг 1: Установите NovitaClaw

macOS / Linux:

sudo pip3 install novitaclaw

Windows PowerShell:

pip install novitaclaw

Если у вас установлена предыдущая версия, обновите до последней:

Bash

pip3 install novitaclaw --upgrade

Если обновление не удается, попробуйте принудительную переустановку:

Bash

pip3 install novitaclaw --upgrade --force-reinstall

После установки проверьте ее, введя novitaclaw --help. Если вы видите список инструкций, значит установка прошла успешно!

novitaclaw --help

Особое примечание для пользователей Mac

Если после установки вы получаете ошибку zsh: command not found: novitaclaw, выполните эти две команды по порядку, чтобы исправить путь в окружении:

source ~/.zshrc

echo 'export PATH="'$(python3 -m site --user-base)'/bin:$PATH"' >> ~/.zshrc

Шаг 2: Установите переменную окружения в вашем терминале

macOS / Linux:

export NOVITA_API_KEY=sk_your_api_key

Windows PowerShell:

$env:NOVITA_API_KEY = "sk_your_api_key"

Шаг 3: Запустите экземпляр

novitaclaw launch

При успешном выполнении CLI возвращает три значения, которые вы будете использовать для доступа к агенту и его управления:

  • URL веб-интерфейса
  • URL и токен WebSocket-шлюза
  • URL веб-терминала (для доступа к терминалу в sandbox)
  • URL файлового менеджера (для просмотра и управления файлами в рабочей области sandbox)
  • Учетные данные для входа (для веб-терминала и файлового менеджера)

openclaw screenshoot

Откройте полученный URL веб-интерфейса, перейдите на вкладку Chat, чтобы использовать вашего агента. Используйте URL веб-терминала, чтобы открыть сессию терминала внутри sandbox, и URL файлового менеджера, чтобы просматривать и управлять файлами в рабочей области sandbox.

Настройка моделей

Ваш экземпляр изначально предварительно настроен с моделью, размещенной на Novita.

Чтобы изменить модели, которые использует ваш агент, перейдите в Settings → Config, нажмите Raw, чтобы переключиться на вид Raw JSON5, затем нажмите кнопку reveal рядом с надписью “2 secrets redacted”, чтобы отобразить полную конфигурацию. Обновите следующие два раздела:

openclaw model configure

Шаг 1: Зарегистрируйте модель у вашего провайдера

Добавьте новый объект в массив models внутри models.providers.novita:

"models": [
  {
    "id": "model-id",
    "name": "display name",
    "reasoning": true,
    "input": ["text"],
    "contextWindow": 200000,
    "maxTokens": 50000
  }
]

Шаг 2: Установите ее как основную или резервную

Обновите поле model в разделе agents.defaults, чтобы ссылаться на вашу модель в формате provider/model-id:

"agents": {
  "defaults": {
    "model": {
      "primary": "provider/model-id",
      "fallbacks": [
        "provider/model-id"
      ]
    }
  }
}

Нажмите Update, чтобы сохранить. Поддерживаются все LLM, доступные на платформе Novita. Также можно настроить сторонних провайдеров — если вы используете свою собственную LLM, вы платите только за время работы sandbox, а не за использование моделей Novita.

Ваш Claw запущен. Теперь сделайте его умнее.

BotLearn — это первый в мире Бот-университет — слой обучения и распространения, созданный изначально поверх OpenClaw. Боты учатся, люди зарабатывают: ваш агент получает структурированные Навыки (Skills), бенчмаркинг и доступ к Botcord — маркетплейсу Agent-to-Agent, где агенты зарабатывают реальные деньги, выполняя задачи.

Чтобы зарегистрировать вашего агента, просто отправьте ему это сообщение:

“Это Бот-университет, в который я хочу, чтобы ты вступил. Прочитай https://www.botlearn.ai/SKILL.md и следуй инструкциям, чтобы присоединиться к BotLearn. Если во время установки у тебя возникнут вопросы по безопасности, подтверди каждый шаг со мной перед продолжением.”

Остальное ваш агент сделает сам.

Подключение каналов

OpenClaw поддерживает внешние каналы обмена сообщениями, поэтому ваш агент доступен не только через веб-интерфейс. Каналы требуют настройки — по умолчанию они неактивны.

Telegram

Шаг 1: Создайте Telegram-бота

  1. Откройте Telegram и найдите @BotFather
  2. Отправьте /newbot и следуйте подсказкам, чтобы назвать вашего бота
  3. Скопируйте токен бота, который предоставит BotFather

Шаг 2: Отправьте токен бота на вкладку Chat

В веб-интерфейсе перейдите на вкладку Chat и отправьте токен бота.

Шаг 3: Сопрягите и используйте Telegram-бота

В Telegram откройте созданного вами бота и отправьте /start. Скопируйте код и вставьте его на вкладку Chat.

После подключения сообщения, отправленные вашему Telegram-боту, направляются напрямую агенту OpenClaw. Поддерживаются и другие интеграции с каналами — полный список и инструкции по настройке смотрите в официальном руководстве по каналам OpenClaw.

Надежность сервиса

Все основные сервисы в sandbox управляются через systemd для обеспечения надежности уровня продакшена:

Сервис Описание Автоперезапуск
Шлюз OpenClaw Среда выполнения агента и WebSocket-сервер
Веб-терминал (ttyd) Доступ к терминалу через браузер
Файловый менеджер (gohttpserver) Управление файлами через веб-интерфейс

Автовосстановление после сбоев: Если шлюз падает неоднократно, система автоматически запускает диагностику, пытается выполнить ремонт и восстанавливает последнюю рабочую конфигурацию из резервной копии — вмешательство человека не требуется.

Автоматическое резервное копирование конфигурации: Каждое изменение конфигурации создает автоматическую резервную копию. Если некорректная конфигурация вызывает сбой, процесс восстановления использует самую последнюю валидную резервную копию.

Справочник команд

launch

Создает новый экземпляр sandbox.

Bash

novitaclaw launch [OPTIONS]
Параметр Описание
--api-key Ключ Novita API
--gateway-token Пользовательский токен шлюза (опционально, по умолчанию генерируется автоматически)
--timeout Таймаут создания в секундах (по умолчанию: 60)

list

Выводит список активных экземпляров sandbox.

Bash

novitaclaw list --api-key YOUR_API_KEY
Параметр Описание
--api-key Ключ Novita API
--quiet, -q Выводит только ID sandbox, по одному в строке (удобно для скриптов)

status

Проверяет статус экземпляра sandbox.

Bash

novitaclaw status <SANDBOX_ID> --api-key YOUR_API_KEY

stop

Завершает работу экземпляра sandbox.

Bash

novitaclaw stop <SANDBOX_ID> --api-key YOUR_API_KEY
Параметр Описание
--api-key Ключ Novita API
--yes, -y Пропустить запрос на подтверждение

tui

Подключается к sandbox через терминальный интерфейс.

Bash

novitaclaw tui <SANDBOX_ID> --token <GATEWAY_TOKEN>

doctor

Запускает диагностику и проверки ремонта для экземпляра sandbox.

Bash

novitaclaw doctor <SANDBOX_ID> --api-key YOUR_API_KEY
Параметр Описание
--api-key Ключ Novita API
--deep Сканировать системные сервисы на наличие дополнительных установок шлюза
--fix Применить рекомендованные ремонтные действия (псевдоним для --repair)
--force Применить агрессивный ремонт (перезаписывает пользовательскую конфигурацию сервисов)
--generate-gateway-token Сгенерировать и настроить токен шлюза
--no-workspace-suggestions Отключить предложения системы памяти рабочей области
--repair Применить рекомендованные ремонтные действия без запроса подтверждения
--yes Принять значения по умолчанию без запроса подтверждения

gateway update

Обновляет OpenClaw до последней версии внутри sandbox.

Bash

novitaclaw gateway update <SANDBOX_ID> --api-key YOUR_API_KEY
Параметр Описание
--api-key Ключ Novita API
--restart Перезапустить шлюз после обновления

gateway restart

Перезапускает шлюз OpenClaw в sandbox.

Bash

novitaclaw gateway restart <SANDBOX_ID> --api-key YOUR_API_KEY

services setup

Устанавливает и запускает веб-терминал и файловый менеджер на существующем sandbox. Используйте эту команду, чтобы добавить сервисы в старые sandbox, которые были запущены до того, как эти сервисы были включены по умолчанию.

Bash

novitaclaw services setup <SANDBOX_ID> --api-key YOUR_API_KEY

pair list

Выводит список ожидающих запросов на сопряжение для канала.

Bash

novitaclaw pair list <SANDBOX_ID> --channel <CHANNEL_NAME> --api-key YOUR_API_KEY

pair approve

Подтверждает запрос на сопряжение для канала.

Bash

novitaclaw pair approve <SANDBOX_ID> --channel <CHANNEL_NAME> --code <PAIRING_CODE> --api-key YOUR_API_KEY

update

Проверяет наличие обновлений CLI и обновляет до последней версии.

Bash

novitaclaw update

Программное использование

Используйте JSON-вывод для автоматизации:

Bash

novitaclaw -j launch --api-key YOUR_API_KEY

Пример ответа:

{
  "success": true,
  "data": {
    "sandbox_id": "xxx",
    "webui": "https://xxx.sandbox.novita.ai?token=xxx",
    "gateway_ws": "wss://xxx.sandbox.novita.ai",
    "gateway_token": "xxx",
    "terminal_url": "https://7681-xxx.sandbox.novita.ai",
    "filemanager_url": "https://7682-xxx.sandbox.novita.ai",
    "services_username": "admin",
    "services_password": "xxx"
  }
}

Переменные окружения

Переменная Описание
NOVITA_API_KEY Ключ API, исключает необходимость использования флага --api-key
OPENCLAW_GATEWAY_TOKEN Предустановленный токен шлюза

Тарифы

Что вы используете Что вы платите
Время работы sandbox Тарифы на sandbox
LLM, размещенные на Novita Тарифы на модели
Сторонние LLM Только время работы sandbox

Устранение неполадок

Команда не найдена

Попробуйте один из этих вариантов:

Bash

# Use full path (Linux)
~/.local/bin/novitaclaw launch

# Typical macOS user path
~/Library/Python/3.x/bin/novitaclaw launch

Таймаут соединения

Увеличьте таймаут запуска:

Bash

novitaclaw launch --timeout 180 --api-key YOUR_API_KEY

Часто задаваемые вопросы

Проблема Почему это происходит? Что делать
“Команда не найдена” / “Не распознано” Вы не отметили пункт “Add to PATH” при установке Python. Удалите Python и переустановите его, обязательно отметив этот пункт!
“Отказано в доступе” У вас недостаточно прав. Windows: Нажмите правой кнопкой мыши на Терминале/PowerShell и выберите “Запуск от имени администратора”. Mac: Добавьте sudo перед командой.
“Неверный ключ API” Ключ был скопирован неправильно. Проверьте наличие лишних пробелов перед или после строки sk_, или сгенерируйте новый ключ.
Sandbox не останавливается Остановка sandbox удаляет все файлы и требует подтверждения. Введите “y” в терминале, когда появится запрос на подтверждение удаления.
Mac: команда pip не найдена В Mac используется pip3, чтобы отличать от старых версий. Используйте pip3 install novitaclaw вместо pip.

Создавайте следующий слой

Сдвиг, который описывает Карпати — от агентов к Claws — не является теоретическим. Это архитектурная возможность, доступная уже сейчас, и команды, которые строят свои решения на постоянной, всегда работающей инфраструктуре, смогут ее реализовать.

NovitaClaw дает вам эту основу: среда выполнения агента уровня продакшена, развертываемая меньше чем за минуту, с полным контролем над слоем моделей и интеграциями каналов. Sandbox отвечает за время работы. CLI отвечает за развертывание. То, что вы построите поверх, зависит только от вас.

Начните строить на Novita Agent Sandbox →

Novita AI — это облако ИИ и агентов для разработчиков и стартапов, предоставляющее доступ к более чем 200 LLM, моделям для генерации изображений, видео и синтеза речи через единый API, а также GPU-инстансы и Agent Sandboxes, которые запускаются за секунды.