Настройка NanoClaw на VPS с Docker: пошаговое руководство для быстрого запуска

Ключевые моменты 

• Узнайте, как развернуть приложение NanoClaw на виртуальном частном сервере с помощью Docker для большего контроля и производительности.
• Ознакомьтесь с пошаговым процессом: от подключения к серверу до запуска первого контейнеризированного приложения.
• Изучите преимущества использования VPS от Bluehost, включая NVMe-накопители и безлимитный трафик для масштабирования.

• Сравните различные тарифные планы VPS, чтобы подобрать оптимальный для ваших одно- или многоконтейнерных приложений.

• Поймите, как поддерживать и защищать ваше новое развертывание NanoClaw для долгосрочной стабильности.

NanoClaw — это легковесный AI-агент с открытым исходным кодом, созданный непосредственно на SDK Anthropic Claude Agent. В отличие от многих самоуправляемых AI-агентов, каждый агент в NanoClaw работает внутри собственного Docker-контейнера на вашем Linux VPS. Это изолирует рабочие нагрузки и ограничивает доступ только теми файловыми системами, которые вы явно монтируете. Команды Bash выполняются внутри контейнера, а не на вашем хосте. Именно такое архитектурное решение делает предоставление AI-агенту доступа к оболочке безопасным.

Здесь Docker — не просто инструмент развертывания. Это граница изоляции NanoClaw. Каждая группа агентов получает собственный контейнер, собственную область файловой системы и собственный процесс. Хостовая машина остается нетронутой независимо от того, что делает агент внутри своей песочницы.

Какие требования необходимы для установки NanoClaw?

Перед началом убедитесь, что ваш сервер соответствует требованиям этого руководства. Шаги ниже написаны для VPS на основе Enterprise Linux, использующего менеджер пакетов dnf. Если вы используете Ubuntu или Debian, некоторые команды установки пакетов будут отличаться, хотя общий процесс развертывания остается тем же.

Вам потребуется:

• Самоуправляемый VPS от Bluehost с доступом по SSH

• Права root или sudo

• Поддерживаемая дистрибуция Enterprise Linux с использованием dnf

• Базовое понимание командной строки Linux

• Стабильное интернет-соединение для загрузки пакетов Docker и образа контейнера NanoClaw

Самое важное требование — Claude Code. Весь процесс настройки NanoClaw выполняется через навык /setup в Claude Code. Если Claude Code не установлен, не аутентифицирован и не работает до начала, настройка не завершится корректно. Убедитесь, что команда claude работает в вашем терминале, прежде чем переходить к следующему шагу.

Как настроить NanoClaw на VPS с Docker?

Настройка NanoClaw с Docker включает несколько ключевых шагов. Этот процесс начинается с подключения к вашему серверу и заканчивается работающим приложением.

Внимательно следуйте этим инструкциям для успешного развертывания.

Шаг 1: Подключитесь к вашему VPS

Откройте терминал и подключитесь к вашему VPS от Bluehost по SSH, заменив username и your_server_ip на ваши реальные учетные данные.

ssh username@your_server_ip

После подключения обновите системные пакеты перед установкой любых зависимостей.

sudo apt update && sudo apt upgrade -y

После подключения вы готовы к установке необходимого программного обеспечения.

Шаг 2: Установите Node.js, Docker и Claude Code

NanoClaw требует Node.js версии 20 или новее и Docker Engine в качестве среды выполнения контейнеров. Установите оба компонента, затем установите Claude Code глобально через npm.

# Install Node.js 20 
curl -fsSL https://deb.nodesource.com/setup_20.x | bash - 
sudo apt install -y nodejs 
 
# Install Docker Engine 
curl -fsSL https://get.docker.com | sh 
sudo usermod -aG docker $USER 
 
# Start Docker and enable it on boot 
sudo systemctl start docker 
sudo systemctl enable docker 
 
# Install Claude Code 
npm install -g @anthropic-ai/claude-code 

После добавления вашего пользователя в группу Docker выйдите и войдите снова, чтобы изменение прав вступило в силу. Прежде чем продолжить, убедитесь, что Docker запущен, с помощью команды docker info.

Шаг 3: Клонируйте репозиторий NanoClaw

Сделайте форк и клонируйте репозиторий NanoClaw с GitHub, затем перейдите в каталог проекта. Форк гарантирует, что вы сможете отправлять свои собственные настройки и одновременно загружать обновления из вышестоящего репозитория.

git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw 

Кодовая база NanoClaw намеренно мала — один процесс, несколько исходных файлов, никаких микросервисов. Это упрощает чтение, аудит и модификацию. При необходимости Claude Code может провести вас по всей кодовой базе.

Шаг 4: Запустите настройку ClaudeCode

Это ключевой шаг, который отличает NanoClaw от традиционной ручной установки. Настройка NanoClaw — это не файл конфигурации, а управляемый, нативный для AI процесс, выполняемый через навык /setup в Claude Code.

Из каталога NanoClaw запустите Claude Code:

claude

После запуска Claude Code введите следующее внутри сессии Claude, а не в вашем терминале:

/setup

Claude Code автоматизирует большую часть процесса настройки. Он проверяет ваше окружение, устанавливает необходимые зависимости, собирает средство запуска контейнеров, настраивает Docker для изоляции агентов, создает файл .env с вашим API-ключом Anthropic и регистрирует службу systemd для поддержания работы агента после перезагрузок.

Во время установки вам будет предложено:

• Подтвердить или предоставить ваш API-ключ Anthropic

• Выбрать канал обмена сообщениями — аутентификация WhatsApp использует сканирование QR-кода или код сопряжения; Telegram, Discord и Slack используют токены API

• Подтвердить обнаружение среды выполнения контейнеров (Docker на Linux VPS)

Если что-то сломается во время установки, Claude Code попытается исправить это автоматически. Для проблем, которые он не может решить, выполните /debug внутри сессии Claude.

Шаг 5: Проверьте работу агента

После завершения установки убедитесь, что служба NanoClaw активна и контейнер агента запущен.

# Check the systemd service status 
sudo systemctl status nanoclaw 
 
# List running Docker containers 
docker ps 

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

Чтобы проверить полную установку от начала до конца, отправьте сообщение на ваш подключенный канал. Агент должен ответить в течение нескольких секунд.

Почему стоит размещать NanoClaw на VPS от Bluehost?

Запуск NanoClaw в рабочей среде требует инфраструктуры, которая обеспечивает стабильную производительность, безопасные контейнеризированные среды и гибкость для масштабирования по мере роста ваших AI-нагрузок. VPS от Bluehost предоставляет выделенные ресурсы, полный root-доступ и высокоскоростные NVMe-накопители, давая разработчикам необходимый контроль для уверенного развертывания, управления и оптимизации NanoClaw.

Выделенные ресурсы для постоянного процесса. NanoClaw работает как служба Node.js с накладными расходами Docker-контейнера для каждого активного агента. Выделенный CPU и RAM гарантируют стабильную производительность ваших агентов NanoClaw без конкуренции за ресурсы с другими арендаторами.

NVMe-накопители для быстрого ввода-вывода контейнеров. Сборка контейнеров, операции чтения и записи в SQLite, а также доступ к файлам сессий выигрывают от высокой скорости ввода-вывода, которую обеспечивают NVMe-накопители.

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

Полный root-доступ для управления средой выполнения контейнеров. NanoClaw требует Docker Engine и возможности управлять разрешениями контейнеров на уровне ОС. Root-доступ дает вам этот контроль без ограничений.

Круглосуточная экспертная поддержка по проблемам уровня сервера. Если Docker перестает работать, системный сервис выходит из строя или сетевая проблема прерывает работу агента, наша команда поддержки доступна 24 часа в сутки. Сам NanoClaw поддерживается сообществом, но ваша VPS-инфраструктура — нет. 

Также читайте: Bluehost занял первое место в рейтинге лучших VPS апреля 2026 года по версии VPSBenchmarks.

Каковы итоговые выводы об этой конфигурации?

Запуск NanoClaw на VPS от Bluehost дает вам личного ИИ-агента, который всегда доступен, полностью под вашим контролем и изолирован от среды хоста по задумке.

После завершения начальной настройки вы можете расширять NanoClaw по мере изменения ваших требований. Добавляйте каналы обмена сообщениями с помощью навыков, таких как /add-telegram или /add-gmail, чтобы подключить агента к внешним коммуникационным платформам. Вы также можете автоматизировать повторяющиеся задачи, настроив HEARTBEAT.md для запланированного выполнения. Для более сложных рабочих процессов включите Agent Swarms, чтобы распределить работу между несколькими специализированными под-агентами, работающими параллельно.

Вся кодовая база остается достаточно маленькой для понимания и аудита. Это важно, когда вы строите на ее основе.

Готовы к развертыванию? Стандартный тарифный план VPS от Bluehost включает 8 виртуальных ядер, 32 ГБ ОЗУ и NVMe-накопитель — достаточно для запуска NanoClaw с несколькими активными группами агентов и запасом на рост.

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