OpenClaw на VPS: как развернуть персонального AI-агента и подключить Telegram

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

Ниже — практическая схема запуска OpenClaw на Linux VPS: от выбора сервера и установки до Gateway, модели, Telegram и базовой безопасности.

Что такое OpenClaw

OpenClaw — self-hosted gateway для AI-агентов. Центральный Gateway управляет сессиями, подключёнными каналами, моделями и инструментами. К нему можно подключить Telegram, Discord, Slack, WhatsApp и другие каналы, а в качестве модели использовать поддерживаемого провайдера или локальный вариант.

Главное отличие такого подхода от обычного чат-бота — агент может не только отвечать текстом. При правильно настроенных разрешениях он способен работать с файлами, API, командами, расписанием и повторяемыми сценариями.

Какой VPS нужен

Если модель вызывается через внешний API, серверу не требуется GPU. Для базового OpenClaw важнее стабильный Linux, достаточная память, нормальная сеть и возможность держать Gateway постоянно запущенным. Конкретный объём ресурсов зависит от количества агентов, каналов, инструментов и параллельных задач.

Если планируется локальная LLM, требования меняются радикально: нужно отдельно оценивать RAM или VRAM, размер модели, квантизацию и контекст. Не стоит покупать дорогой GPU-сервер только потому, что агент называется AI: при работе через API вычисления модели выполняет провайдер.

Установка OpenClaw

В актуальной официальной документации для Linux предлагается installer script. Перед установкой стоит обновить систему, создать отдельного пользователя при необходимости и проверить доступ по SSH.

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

После установки полезно проверить окружение командами openclaw --version и openclaw doctor. Для первичной настройки используется onboarding, который помогает подключить модель и создать рабочую конфигурацию.

openclaw onboard --install-daemon
openclaw gateway status

Gateway должен работать как сервис

Для VPS важно не оставлять агент запущенным только в SSH-сессии. Gateway должен подниматься как управляемый сервис и автоматически стартовать после перезагрузки сервера. Официальная установка умеет установить daemon, а состояние можно проверять через openclaw gateway status.

Если агент перестал отвечать, диагностику лучше начинать именно с Gateway, а не сразу менять модель или Telegram-токен: проверить статус процесса, конфигурацию и вывод doctor.

Подключение модели

OpenClaw разделяет сам агент и модель. В конфигурации выбирается provider/model, а доступ к провайдеру настраивается через onboarding или поддерживаемый механизм авторизации. Это позволяет отдельно менять модель, не пересобирая Telegram-бота и всю серверную часть.

Для рабочих сценариев разумно выбирать современную модель с хорошей поддержкой tool use. Более дешёвую модель можно использовать для простых сообщений, но сложные действия, код и длинные цепочки обычно сильнее зависят от качества модели.

Подключение Telegram

Telegram удобен как интерфейс к персональному агенту: пользователь пишет боту, сообщение приходит в Gateway, OpenClaw передаёт его нужному агенту и возвращает ответ в тот же канал. Токен бота нельзя публиковать в репозитории, статье или клиентском JavaScript.

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

Безопасность важнее количества инструментов

Если агент получает доступ к shell, файлам, API или внешним аккаунтам, каждый новый инструмент увеличивает возможности и одновременно поверхность риска. Поэтому лучше начинать с минимального набора разрешений и добавлять их под конкретную задачу.

• не хранить API-ключи в публичном Git;
• не открывать Gateway наружу без необходимости;
• ограничить Telegram-пользователей;
• разделять системные и пользовательские права;
• делать резервную копию конфигурации перед крупными изменениями;
• проверять логи и doctor после обновлений.

Что агент может делать после базовой установки

Базовая установка даёт рабочий каркас: сервер, Gateway, модель и канал общения. Дальше возможности зависят от подключённых инструментов. Можно добавлять работу с документами и файлами, webhooks, API, расписание, уведомления и собственные skills.

Например, агент может принять сообщение в Telegram, обработать файл, получить данные из API, подготовить результат и отправить его обратно. Но такая автоматизация уже требует проектирования прав, ошибок и повторных запусков — это отдельная задача поверх самой установки.

Типовые проблемы после запуска

• Gateway запущен в терминале и исчезает после закрытия SSH;
• выбрана модель, к которой у аккаунта нет доступа;
• в конфигурации остался старый provider или fallback;
• Telegram подключён, но доступ пользователя не разрешён;
• порт Gateway без необходимости открыт в интернет;
• после ручной правки JSON появилась ошибка синтаксиса;
• слишком тяжёлая локальная модель перегружает сервер.

Вместо случайной переустановки полезнее последовательно проверить openclaw doctor, статус Gateway, выбранную модель, канал и последние изменения конфигурации.

OpenClaw и n8n

OpenClaw и n8n могут работать на одном VPS, если серверу хватает ресурсов, а сервисы разведены по портам и процессам. OpenClaw удобен как разговорный агент и исполнитель, а n8n — как визуальный оркестратор бизнес-процессов. Их можно связать webhook или API-вызовами.

Например, пользователь пишет агенту «подготовь отчёт», OpenClaw собирает параметры и вызывает webhook n8n, а workflow получает данные из CRM и возвращает результат. Это надёжнее, чем пытаться переносить всю детерминированную бизнес-логику в свободный диалог с моделью.

Как проверить установку перед сдачей

1. OpenClaw показывает установленную версию без ошибок.
2. openclaw doctor не сообщает критических проблем.
3. Gateway работает как сервис и переживает перезапуск.
4. Выбранная модель реально отвечает.
5. Telegram принимает сообщение и возвращает ответ.
6. Посторонний пользователь не получает доступ, если бот персональный.
7. Секреты отсутствуют в публичных файлах и логах.

Когда нужна отдельная настройка

Установить OpenClaw и подключить один Telegram-канал — это базовый запуск. Собственные skills, сложные автоматизации, CRM, почта, календарь, n8n, базы данных и бизнес-API требуют отдельной настройки и тестирования.

Если нужен VPS/VDS, Telegram-интерфейс и персональный AI-агент под конкретные задачи, A.S Groups может развернуть OpenClaw на вашем сервере, подключить модель и проверить рабочий сценарий. Для расширенной автоматизации заранее фиксируем список интеграций и действий, чтобы агент был не демонстрацией, а рабочим инструментом.