☰
29.04.2026

Быстрый деплой OpenClaw: руководство для начинающих

OpenClaw это персональный AI-ассистент, который вы устанавливаете на собственный сервер. Главная его особенность в том, что это не очередной чат-интерфейс в браузере, а возможность общаться с моделью прямо в тех мессенджерах, которыми вы и так пользуетесь каждый день: Telegram, WhatsApp, Slack, Discord и ещё больше десятка других каналов. Вместо того чтобы открывать вкладку браузера, вы пишете сообщение контакту в Telegram и получаете ответ модели ИИ.

Чтобы всё это работало 24 часа в сутки и не зависело от того, включён ли ваш ноутбук, OpenClaw должен крутиться где-то постоянно. Поэтому самый частый сценарий это поставить его на VPS под Linux. В этом руководстве мы устанавливаем OpenClaw на VPS, подключаем Telegram-бота и отправляем первое сообщение примерно за 15 минут. Гайд написан для начинающих, которые умеют подключаться по SSH и копировать команды в терминал.

Основные понятия OpenClaw

Прежде чем переходить к терминалу, разберём пять слов, которые будут встречаться постоянно. Gateway это главный процесс на сервере. Он слушает порт 18789, хранит состояние диалогов и направляет сообщения между каналами и моделью ИИ. Channels это подключённые приложения для обмена сообщениями: Telegram, WhatsApp, Slack, Discord. Каждый канал служит входной дверью к ассистенту.

Agents отвечают за личность бота, его системный промпт и индивидуальные настройки. Описание каждого агента лежит в файле SOUL.md, и можно держать несколько агентов параллельно (один для работы, второй для личных задач, третий заточен под программирование). Skills это модульные расширения, которые добавляют агенту новые умения: ходить в браузер, выполнять команды, обращаться к внешним API. Каждый скилл хранится в ~/.openclaw/workspace/skills/<skill>/SKILL.md. Наконец, Models это внешние LLM-провайдеры: Anthropic Claude, OpenAI, Google Gemini. Сама модель на вашем сервере не запускается, OpenClaw просто использует API этих провайдеров. Вся конфигурация системы живёт в ~/.openclaw/openclaw.json.

Как работает OpenClaw

Архитектура проще, чем может показаться. Gateway работает как центр управления. Он не общается с пользователем напрямую, а сидит между двумя мирами: с одной стороны мессенджеры вроде Telegram, с другой стороны API LLM-провайдера.

Когда вы пишете боту в Telegram, путь сообщения такой. Telegram передаёт сообщение в Gateway по long polling. Gateway определяет, к какой сессии относится этот диалог, собирает контекст (историю переписки, инструкции агента, доступные скиллы) и отправляет всё в API выбранной модели. Модель генерирует ответ, возвращает его в Gateway, а Gateway отдаёт ответ обратно в Telegram, где он появляется на экране телефона.

На сервере хранятся история диалогов, настройки агентов, установленные скиллы и файл конфигурации. Наружу уходит только текст, отправляемый в API LLM-провайдера. Это значит, что можно поменять модель (например, переключиться с Claude на GPT) без потери истории, и что сервер выступает источником правды. Поэтому полезно регулярно делать бэкап папки ~/.openclaw/.

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

Сценарии использования

Самые частые сценарии для деплоя OpenClaw на VPS выглядят так:

Требования к серверу и подготовка

OpenClaw сам по себе лёгкий, особенно по сравнению с решениями, где модель крутится локально, потому что LLM работает в облаке провайдера. Тем не менее, стоит иметь запас памяти для Gateway и для сборки демона при первом запуске.

Ресурс Минимум Рекомендуется
RAM 1 ГБ 2 ГБ
CPU 1 vCPU 2 vCPU
Диск 10 ГБ SSD 20 ГБ SSD
Система Ubuntu 22.04 / Debian 12 Ubuntu 24.04 LTS
Node.js 22.14+ 24 LTS
Доступ SSH с ключом SSH с ключом

В этом руководстве мы используем VPS под Linux с Ubuntu 24.04. Подойдёт любой провайдер, который выдаёт VPS минимум с 2 ГБ оперативной памяти. Если готового сервера ещё нет, можно арендовать VPS на Serverspace за пару минут и сразу идти по этому гайду. Перед установкой подключитесь к серверу по SSH и держите вкладку открытой для следующих шагов.

Установка пошагово

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

Подключитесь к VPS по SSH через привычный клиент. В терминале обновите список пакетов и применяйте свежие апдейты:

sudo apt update && sudo apt upgrade -y

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

Шаг 2. Установка OpenClaw

Самый быстрый путь это официальный скрипт. Он определяет систему, ставит Node.js 24, если его ещё нет, скачивает OpenClaw и готовит окружение:

curl -fsSL https://openclaw.ai/install.sh | bash

Если вы сами управляете Node.js на сервере, можно поставить напрямую через npm:

npm install -g openclaw@latest

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

Шаг 3. Запуск онбординга

Когда OpenClaw установлен, запускаем мастер настройки:

openclaw onboard --install-daemon

Опция --install-daemon настраивает Gateway как сервис systemd в пользовательском режиме. После этого Gateway будет автоматически подниматься после перезагрузки сервера. Мастер задаст три вопроса:

  1. Провайдер LLM. Выбираем между Anthropic, OpenAI, Google и другими.
  2. API-ключ. Вставляем ключ, сгенерированный в консоли выбранного провайдера. Без этого ключа бот ничего не ответит.
  3. Настройки Gateway. Можно соглашаться с дефолтами и идти дальше.

API-ключ создаётся в личном кабинете каждого провайдера (console.anthropic.com, platform.openai.com, ai.google.dev). Сделайте это до запуска онбординга, потому что мастер запросит ключ почти сразу.

Шаг 4. Проверка работы Gateway

Убедимся, что Gateway поднялся корректно:

openclaw gateway status

В выводе должно быть указано, что Gateway слушает на порту 18789. Для более полной проверки конфигурации используем:

openclaw doctor

Эта команда подсвечивает частые проблемы: пропущенный API-ключ, конфликт версий, неправильные права доступа. Если что-то всплыло, лучше разобраться до следующих шагов.

Шаг 5. Подключение Telegram

Telegram это самый простой канал для старта, потому что нужен только токен. Откройте Telegram и напишите @BotFather. Отправьте команду /newbot, выберите имя и юзернейм, оканчивающийся на bot. BotFather пришлёт токен в формате 123456:ABC-DEF.... Скопируйте его.

Затем откройте файл конфигурации OpenClaw:

nano ~/.openclaw/openclaw.json

И добавьте блок Telegram внутрь channels:

{

"channels": {

"telegram": {

"enabled": true,

"botToken": "ВАШ_ТОКЕН",

"dmPolicy": "pairing"

}

}

}

Сохраните файл и перезапустите Gateway, чтобы изменения применились:

openclaw gateway restart

Теперь откройте чат с ботом, которого создали, и отправьте любое сообщение. Gateway потребует пейринг при первом обращении. На сервере посмотрите список ожидающих запросов:

openclaw pairing list telegram

Подтвердите код, который появится:

openclaw pairing approve telegram <КОД>

Шаг 6. Отправка первого сообщения

Возвращаемся в Telegram и задаём боту любой вопрос. Ответ должен прийти за несколько секунд от модели, которую вы выбрали на третьем шаге. Готово: ассистент работает 24 часа в сутки на вашем сервере и отвечает прямо в мессенджере. Если ничего не происходит, переходите к разделу о частых ошибках ниже.

Частые ошибки и как их решить

Даже при чёткой пошаговой инструкции встречаются спотыкания. В таблице ниже собраны самые частые случаи.

Симптом Причина Решение
openclaw: command not found после установки Глобальный bin npm не прописан в $PATH Добавить $(npm prefix -g)/bin в ~/.bashrc и открыть новый терминал
Сборка падает с exit code 137 (OOM) На VPS меньше 2 ГБ оперативной памяти Поднять тариф до 2 ГБ или использовать официальный скрипт вместо сборки Docker
Бот не отвечает в группах Telegram У бота включён Privacy Mode по умолчанию В BotFather выполнить /setprivacy и выбрать Disable, затем убрать и заново добавить бота в группу
В логах конфликт getUpdates 409 Два экземпляра Gateway работают с одним токеном Остановить дубликат и перезапустить Gateway командой openclaw gateway restart
Бот не отвечает даже владельцу allowFrom пустой или отсутствует Добавить числовой Telegram user ID в channels.telegram.allowFrom и перезапустить Gateway

Чтобы разобраться с любой проблемой вне этого списка, смотрите логи в реальном времени:

openclaw logs --follow

Большинство ошибок видно в этом выводе с понятным сообщением.

Заключение

Примерно за 15 минут мы прошли путь от чистого VPS до AI-ассистента, доступного через Telegram, с памятью между диалогами и работой в режиме 24/7. Логичные следующие шаги: подключить ещё каналы (WhatsApp, Slack, Discord), добавить скиллы для расширения возможностей агента, создать второго агента с другой личностью и настроить автоматический бэкап папки ~/.openclaw/.

Ключевая деталь, на которой всё держится, это сервер. Поскольку Gateway хранит историю, настройки и состояние каналов, его имеет смысл крутить на стабильном VPS с фиксированным IP. Тем, кто хочет быстро поднять машину, тарифы VPS Serverspace покрывают конфигурации из этого гайда, с готовыми образами Ubuntu, на которых сразу работает apt install.