tanaka.host  / блог
RSSЗаказать VPS
Введение/ИИ на сервере

OpenClaw (ClawdBot) на VPS: установка, Telegram-бот и панель управления

Ставим ИИ-агента OpenClaw на сервер, подключаем модель по API, бота в Telegram и открываем панель через SSH-туннель. Debian 12 и Ubuntu 24.04.

7 октября 2026 г.·5 мин чтения·openclaw, telegram, nodejs, ai-agent

OpenClaw (раньше проект назывался ClawdBot) — это ИИ-агент, который живёт на вашем сервере и общается с вами через Telegram, Discord или другой мессенджер. От обычного чата с нейросетью он отличается тем, что работает круглосуточно, помнит прошлые разговоры и умеет сам что-то делать: запускать команды, читать почту, собирать сводки по расписанию. На ноутбуке такой агент замолкает, как только вы закрыли крышку, поэтому ему и нужен VPS.

Нейросеть на сервере при этом не крутится. OpenClaw ходит к модели по API — в OpenAI, Anthropic, DeepSeek, OpenRouter — и платите вы поставщику модели по своему ключу. Серверу не нужна видеокарта, а качество ответов зависит от выбранной модели.

Агент получает настоящий доступ к серверу. Он выполняет команды с правами того пользователя, под которым установлен. Ставьте OpenClaw на отдельный сервер, где нет сайтов, баз и чужих данных, и не давайте ему ключи, которые жалко потерять.

Как устроен OpenClaw

Три части:

  • Шлюз (Gateway) — постоянно работающая программа на Node.js. Хранит память агента, принимает сообщения из мессенджеров, решает, когда обратиться к модели, и выполняет действия на сервере. Слушает порт 18789 только на 127.0.0.1.
  • Каналы — связь с мессенджерами. Начать проще всего с Telegram.
  • Панель управления (Control UI) — веб-интерфейс для переписки с агентом и настройки. Открывается через SSH-туннель и требует токен.

Что нужно

  • Сервер на tanaka.host с Debian 12 или Ubuntu 24.04 и не меньше 2 ГБ памяти. На 1 ГБ шлюз запускается, но сразу съедает почти всю свободную память. В простое gateway занимает 150–300 МБ, а под нагрузкой — когда агент крутит headless-браузер — требует уже 4 ГБ.
  • Доступ по SSH под root — см. подключение по SSH.
  • Ключ API поставщика модели.
  • Аккаунт в Telegram.

Есть два способа установки: официальный скрипт, который сам ставит Node.js, и ручная установка через npm. Ниже первый, второй — в конце.

1. Установщик

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

Скрипт ставит инструменты сборки и Node.js 24, скачивает OpenClaw и сразу запускает мастер первичной настройки. Занимает несколько минут.

2. Первичная настройка

Мастер управляется стрелками ↑ ↓ и Enter.

  1. How would you like to start? — Quick start (recommended). Выше мастер показывает предупреждение о безопасности, про которое написано в начале.
  2. What would you like to create? — One agent.
  3. Мастер поищет на сервере готовый доступ к нейросетям и на чистом сервере напишет No existing AI access was detected — это нормально.
  4. Model/auth provider — выберите поставщика, ключ которого у вас есть. Первые пункты — OpenAI, OpenRouter, xAI, Google, Anthropic. DeepSeek и Ollama спрятаны в More…, там можно набирать название с клавиатуры. Для некоторых поставщиков мастер предложит поставить модуль (например, Install DeepSeek plugin?) — оставьте Download from npm.
  5. Вставьте ключ в поле Enter … API key.

В конце мастер напишет Everything’s in place. Если ключа пока нет — выберите Skip for now и подключите модель позже командой openclaw onboard. Полный пошаговый мастер со всеми параметрами — openclaw onboard --classic.

3. Шлюз как служба

Чтобы агент работал постоянно и переживал перезагрузку:

openclaw gateway install
loginctl enable-linger root
openclaw gateway status

Вторая команда важна. Шлюз ставится как пользовательская служба systemd, а такие службы останавливаются вместе с выходом пользователя из системы. enable-linger разрешает им жить без открытой SSH-сессии.

В выводе openclaw gateway status должны быть строки Runtime: running и Listening: 127.0.0.1:18789.

4. Telegram

Откройте в Telegram @BotFather, отправьте /newbot, задайте имя и адрес бота. BotFather пришлёт токен вида 123456:ABC....

На сервере:

openclaw channels add

На вопрос Set up a chat channel now? — Yes, в списке каналов — Telegram (Bot API), аккаунт default (primary), способ передачи токена — Enter Telegram bot token, вставьте токен.

Напишите своему боту любое сообщение. Незнакомцам агент не отвечает — вместо этого бот пришлёт код сопряжения из восьми заглавных букв. Подтвердите его на сервере:

openclaw pairing list telegram
openclaw pairing approve telegram КОД

Код живёт час. После подтверждения агент начинает отвечать вам, а сообщения других людей так и будут ждать вашего одобрения. Как заменить сопряжение жёстким списком разрешённых ID и подключить Discord — в статье OpenClaw: Telegram, Discord и безопасность.

5. Панель управления

Панель слушает только внутренний адрес сервера, поэтому пробросьте порт SSH-туннелем. Команда выполняется на вашем компьютере, окно не закрывайте:

ssh -N -L 18789:127.0.0.1:18789 root@IP_сервера

Откройте в браузере http://localhost:18789. Панель спросит секрет Gateway — узнайте его на сервере:

openclaw gateway auth-token --show

Если токен не настроен, создайте: openclaw doctor --generate-gateway-token.

Не открывайте порт 18789 в интернет. Даже с токеном панель даёт управление агентом, а значит и сервером. Только SSH-туннель.

Альтернатива: установка через npm

Если хотите контролировать версию Node.js сами. OpenClaw требует Node.js 24.16.0+ (ветка 24.x) или 26.1.0+; ветки 22, 23 и 25 не поддерживаются. В репозиториях Ubuntu Node старый, поэтому берём NodeSource:

apt install -y curl ca-certificates gnupg
curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
apt install -y nodejs
node -v
npm -v

npm 12 (и 11.16+) по умолчанию блокирует install-скрипты пакетов, поэтому разрешите их явно для OpenClaw:

npm install -g openclaw@latest --allow-scripts=openclaw

На npm 11.15 и старше флаг --allow-scripts не нужен. Затем запустите мастер вместе с установкой службы одной командой:

openclaw onboard --install-daemon

Мастер тот же, что в шаге 2, но дополнительно спросит про канал (Telegram), поисковик (DuckDuckGo не требует ключа), навыки и хуки — всё это можно пропустить. Если после мастера терминал завис без приглашения, нажмите Ctrl+C.

Обслуживание

openclaw status            # состояние всех частей
openclaw doctor            # проверка настроек и поиск проблем
openclaw configure         # изменить настройки, например сменить модель
openclaw gateway restart   # перезапустить шлюз

openclaw doctor сразу предупредит, что токен шлюза лежит в ~/.openclaw/openclaw.json открытым текстом. Агент умеет читать файлы на сервере, поэтому секреты лучше перенести в отдельное хранилище: openclaw secrets configure.

Частые ошибки

Агент перестаёт отвечать после выхода из SSH. Не выполнена loginctl enable-linger root. Выполните её и поднимите шлюз: openclaw gateway start.

Бот в Telegram молчит. Проверьте по порядку: openclaw gateway status — шлюз работает; openclaw pairing list telegram — нет ли неподтверждённого кода (через час он протухает, напишите боту снова); подключена ли модель — без неё агенту нечем отвечать, подключите через openclaw onboard.

Панель пишет, что для Gateway требуется токен. Так и должно быть: openclaw gateway auth-token --show и вставьте в поле.

Можно ли без платного API? В списке поставщиков есть Ollama для локальных моделей, но на обычном VPS это медленно и требует много памяти — см. Ollama на CPU и DeepSeek через Ollama.

Дальше — ограничить доступ к боту, добавить Discord и закрыть сервер: OpenClaw: Telegram, Discord, обновления и безопасность. Официальная документация — docs.openclaw.ai.