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 выглядят так:
- Личный ассистент в Telegram или WhatsApp. Бот отвечает как обычный контакт, помнит контекст между диалогами, всегда под рукой в телефоне.
- Бот для команды в Slack или Discord. Ассистент отвечает на вопросы внутри канала, помогает с внутренней документацией, автоматизирует ответы поддержки.
- Автоматизация рутины. Напоминания, разбор почты, мониторинг репозиториев на GitHub, отслеживание задач, и всё это через сообщения.
- Помощник по коду в кармане. Вы кидаете в Telegram вопрос про кусок кода в дороге и получаете объяснение прямо там.
- Триаж сообщений. Краткое содержание длинных обсуждений в группах, сортировка уведомлений по приоритету, выделение пунктов к действию.
Требования к серверу и подготовка
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 через привычный клиент. В терминале обновите список пакетов и применяйте свежие апдейты:
Это гарантирует, что система стартует с актуальной базы и помогает избежать сюрпризов с устаревшими библиотеками во время установки.
Шаг 2. Установка OpenClaw
Самый быстрый путь это официальный скрипт. Он определяет систему, ставит Node.js 24, если его ещё нет, скачивает OpenClaw и готовит окружение:
Если вы сами управляете Node.js на сервере, можно поставить напрямую через npm:
Выбор между двумя способами это вопрос вкуса. Для начинающих официальный скрипт безопаснее, потому что он сам разбирается с версией Node.
Шаг 3. Запуск онбординга
Когда OpenClaw установлен, запускаем мастер настройки:
Опция --install-daemon настраивает Gateway как сервис systemd в пользовательском режиме. После этого Gateway будет автоматически подниматься после перезагрузки сервера. Мастер задаст три вопроса:
- Провайдер LLM. Выбираем между Anthropic, OpenAI, Google и другими.
- API-ключ. Вставляем ключ, сгенерированный в консоли выбранного провайдера. Без этого ключа бот ничего не ответит.
- Настройки Gateway. Можно соглашаться с дефолтами и идти дальше.
API-ключ создаётся в личном кабинете каждого провайдера (console.anthropic.com, platform.openai.com, ai.google.dev). Сделайте это до запуска онбординга, потому что мастер запросит ключ почти сразу.
Шаг 4. Проверка работы Gateway
Убедимся, что Gateway поднялся корректно:
В выводе должно быть указано, что Gateway слушает на порту 18789. Для более полной проверки конфигурации используем:
Эта команда подсвечивает частые проблемы: пропущенный API-ключ, конфликт версий, неправильные права доступа. Если что-то всплыло, лучше разобраться до следующих шагов.
Шаг 5. Подключение Telegram
Telegram это самый простой канал для старта, потому что нужен только токен. Откройте Telegram и напишите @BotFather. Отправьте команду /newbot, выберите имя и юзернейм, оканчивающийся на bot. BotFather пришлёт токен в формате 123456:ABC-DEF.... Скопируйте его.
Затем откройте файл конфигурации OpenClaw:
И добавьте блок Telegram внутрь channels:
"channels": {
"telegram": {
"enabled": true,
"botToken": "ВАШ_ТОКЕН",
"dmPolicy": "pairing"
}
}
}
Сохраните файл и перезапустите Gateway, чтобы изменения применились:
Теперь откройте чат с ботом, которого создали, и отправьте любое сообщение. Gateway потребует пейринг при первом обращении. На сервере посмотрите список ожидающих запросов:
Подтвердите код, который появится:
Шаг 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 |
Чтобы разобраться с любой проблемой вне этого списка, смотрите логи в реальном времени:
Большинство ошибок видно в этом выводе с понятным сообщением.
Заключение
Примерно за 15 минут мы прошли путь от чистого VPS до AI-ассистента, доступного через Telegram, с памятью между диалогами и работой в режиме 24/7. Логичные следующие шаги: подключить ещё каналы (WhatsApp, Slack, Discord), добавить скиллы для расширения возможностей агента, создать второго агента с другой личностью и настроить автоматический бэкап папки ~/.openclaw/.
Ключевая деталь, на которой всё держится, это сервер. Поскольку Gateway хранит историю, настройки и состояние каналов, его имеет смысл крутить на стабильном VPS с фиксированным IP. Тем, кто хочет быстро поднять машину, тарифы VPS Serverspace покрывают конфигурации из этого гайда, с готовыми образами Ubuntu, на которых сразу работает apt install.