Устанавливаем OpenClaw

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

Если хочешь сначала разобраться в самой концепции — у нас есть отдельная статья о том, что такое OpenClaw и как он работает.

---

🤔 Бесплатная модель или платный API?

Сам OpenClaw устанавливается легко — основные трудности начинаются на этапе подключения языковой модели. Здесь два пути, и от выбора зависят и стоимость, и требования к серверу.

Локальный запуск модели мы не рассматриваем: даже небольшие модели съедают от 1 до 30 ГБ оперативной памяти и требуют мощного сервера. В этой инструкции используем бесплатную облачную модель Qwen — она устанавливается на VPS, но работает в облаке, поэтому хватит и базового тарифа.

Ограничения бесплатной модели

Главное ограничение бесплатных моделей — лимит запросов и токенов. Токен — это условная единица текста, которую обрабатывает модель:

• 1 токен ≈ 3–4 символа текста;
• 1000 токенов ≈ 700–800 слов.

Токены расходуются на твой вопрос, ответ модели и контекст предыдущих сообщений. Когда лимит исчерпан, OpenClaw сообщит об этом:

API rate limit reached. Please try again later.

Это значит, что доступный лимит временно закончился — обычно он сбрасывается через некоторое время. Поэтому бесплатный вариант хорош для экспериментов, тестов и простых задач, а платный API — для серьёзной работы.

---

☁️ Зачем запускать OpenClaw на VPS

OpenClaw можно держать и на домашнем компьютере, но VPS даёт три весомых плюса:

• Работа 24/7. Ассистент доступен всегда — даже когда твой компьютер выключен.
• Управление сервером из чата. В любой момент можно написать боту и узнать загрузку CPU, свободное место на диске или другое состояние VPS.
• Безопасность. Эксперименты со скриптами и интеграциями выполняются на VPS, а не на домашнем ПК.

По железу OpenClaw почти не требователен. В нашем примере хватило базового VPS с 2 ядрами и 1 ГБ RAM — этого достаточно, когда AI-модель работает в облаке. Более мощный сервер с запасом памяти нужен только для локальных моделей.

Какой тариф выбрать

Для облачной модели подойдёт самый базовый тариф VPS: ассистент почти не нагружает сервер. Запас по RAM и CPU понадобится, только если позже захочешь запускать локальную языковую модель — тогда смотри в сторону тарифов с 8+ ГБ оперативной памяти.

---

💻 Как открыть терминал

Почти все работы мы проведём в терминале. Если раньше им не пользовался — ниже способы открыть его на каждой ОС.

macOS

Самый быстрый способ — через поиск Spotlight:

• нажми Cmd + Пробел;
• введи Terminal;
• нажми Enter.

Либо через Finder: Программы → Утилиты → Терминал. После запуска увидишь окно с мигающим курсором — это и есть терминал.

Windows

Есть два варианта. С WSL2 (рекомендуется): открой Пуск, введи Ubuntu или WSL и запусти приложение — откроется Linux-среда внутри Windows. Без WSL: открой Пуск, введи PowerShell или CMD и запусти программу.

Linux

В большинстве дистрибутивов терминал открывается сочетанием клавиш:

Ctrl + Alt + T

Либо найди Terminal в меню приложений.

Как вставить команду в терминал

• macOS: Cmd + C — копировать, Cmd + V — вставить;
• Windows (PowerShell): Ctrl + C — копировать, правый клик мышью — вставить;
• Linux: Ctrl + C — копировать, Ctrl + Shift + V — вставить.

После вставки нажми Enter, чтобы выполнить команду.

---

📦 Устанавливаем Node.js

OpenClaw написан на JavaScript и запускается через Node.js — без него программа не стартует. Часто Node.js уже есть на VPS. Проверь это командой:

node --version

Если увидишь номер версии (например, v22.12.0) — Node.js установлен, раздел можно пропустить. Если система отвечает command not found — установи его по инструкции для своей ОС.

macOS

Через официальный сайт: открой nodejs.org, нажми кнопку 22.x LTS, скачай файл .pkg и пройди установку. Через Homebrew — одной командой:

brew install node@22

Windows

Разработчики OpenClaw рекомендуют WSL2 — подсистему Linux внутри Windows, в ней инструмент работает стабильнее.

Простой способ: скачай версию 22.x LTS с nodejs.org, запусти файл .msi и следуй установщику. Если появится опция Automatically install the necessary tools — включи её.

Через WSL2 (рекомендуется): открой PowerShell от имени администратора и выполни:

wsl --install

После перезапуска откроется окно Ubuntu — создай имя пользователя и пароль. Затем установи Node.js:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

Linux (Ubuntu / Debian)

Открой терминал и выполни:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

Команда sudo запускает действие с правами администратора — система может попросить пароль. Во время ввода пароль не отображается, это нормально.

Проверяем установку

Снова выполни проверку версии:

node --version

Затем проверь пакетный менеджер npm, который ставится вместе с Node.js:

npm --version

Если обе команды возвращают номера версий (например, v22.12.0 и 10.9.0) — система готова к установке OpenClaw.

---

⬇️ Устанавливаем OpenClaw

Node.js готов — переходим к самому OpenClaw. Достаточно скопировать команду и вставить в терминал. Есть два способа.

Способ 1 — установочный скрипт

Самый простой вариант для новичков: скрипт сам скачает и установит OpenClaw.

macOS и Linux:

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

Windows (PowerShell):

iwr -useb https://openclaw.ai/install.ps1 | iex

Способ 2 — через npm

Если уже работал с Node.js, поставь OpenClaw через npm:

npm install -g openclaw@latest

В терминале пойдут строки установки — система качает файлы и зависимости. Обычно это занимает несколько минут.

Проверяем установку

После завершения выполни:

openclaw --version

Если увидишь номер версии (например, 2025.6.15) — всё готово. 💡 Если команда не распознаётся, закрой и снова открой терминал: иногда системе нужно обновить переменные окружения.

---

⚙️ Первый запуск и настройка

OpenClaw установлен — запустим его и подключим AI-модель. Большинство параметров настраивается автоматически через встроенный мастер.

Шаг 1 — Запускаем мастер настройки

Выполни в терминале:

openclaw onboard --install-daemon

Что делает команда:

• openclaw onboard — запускает мастер: задаёт вопросы и сам создаёт конфигурацию;
• --install-daemon — ставит OpenClaw фоновой службой (daemon), которая работает постоянно и не закрывается вместе с терминалом.

Мастер задаст много вопросов — почти везде выбирай варианты по умолчанию. Исключение — самый первый вопрос:

I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?

Здесь выбери Yes. Дальше остаётся выбрать только AI-модель и мессенджер — на них остановимся подробнее.

Шаг 2 — Подключаем AI-модель

Мастер предложит выбрать модель. На практике три сценария:

• OpenAI. Мастер откроет страницу авторизации в браузере — войди в аккаунт и разреши доступ. Нужна подписка на платный API (это не обычный ChatGPT+).
• Anthropic. Процесс такой же: мастер открывает страницу входа, после чего OpenClaw получает доступ к модели. Тоже платный API.
• Облачные провайдеры (бесплатно). Среди вариантов есть Qwen-сервисы. Мы выбрали модель qwen-portal/coder-model — бесплатную и работающую даже на базовом VPS.

Выбери в списке qwen-portal/coder-model. Мастер даст ссылку для входа в LLM — открой её в браузере, авторизуйся (можно через аккаунт Google) и подтверди вход. После этого настройка продолжится, и на запрос модели снова выбери qwen-portal/coder-model.

Шаг 3 — Gateway

В процессе мастер создаёт и запускает Gateway — центральный компонент OpenClaw. Он принимает сообщения пользователей, передаёт их модели и возвращает ответы — по сути, диспетчер всех соединений. По умолчанию Gateway запускается локально на отдельном порту (например, 18789).

Дальше мастер дойдёт до привязки мессенджера. Сверни окно терминала — сейчас подготовим бота в Telegram.

---

✈️ Подключаем Telegram

Главная идея OpenClaw — общаться с AI как с обычным контактом в мессенджере. Проще всего сделать это через Telegram: ты пишешь боту, OpenClaw отправляет сообщение модели и возвращает ответ в чат.

Шаг 1 — Создаём Telegram-бота

Бот создаётся через официальный сервис Telegram:

• открой Telegram и найди бота BotFather (проверь синюю галочку у контакта);
• напиши команду /newbot.

BotFather попросит два значения. Имя бота — название, которое видят пользователи (например, My AI Assistant). Username — уникальное имя, обязательно заканчивается на bot (например, my_helper_bot). После этого BotFather пришлёт токен бота вида:

123456789:ABCDefGhIJKlMNoPQRstuVWxyz

⚠️ Важно: токен — это пароль от бота. Его нельзя публиковать или передавать другим людям.

Шаг 2 — Добавляем токен в OpenClaw

Ты уже выбрал Telegram в списке мессенджеров. Дальше мастер спросит, как передать токен:

How do you want to provide this Telegram bot token?
- Enter Telegram bot token (Stores the credential directly in OpenClaw config)

Введи токен от BotFather, а затем — свой числовой ID (узнать его можно через бота @userinfo в Telegram). Остальные вопросы проходим так:

• выбор поисковика — skip for now;
• настройку skills — пропускаем;
• enable hooks — skip for now;
• Gateway service already installed — restart;
• How do you want to hatch your bot? — Hatch in TUI (recommended).

Готово — OpenClaw настроен. Переходим к проверке.

Шаг 3 — Проверяем, что Gateway запущен

Выполни команду:

openclaw gateway status

Если всё в порядке, терминал покажет, что Gateway работает. Если настройка завершилась с ошибкой (не подключилась модель, не стартовал сервис) — запусти диагностику:

openclaw doctor

---

💬 Первый диалог и проверка

Теперь напиши боту в Telegram:

• найди бота по его username;
• отправь любое сообщение, например Привет.

Сначала бот не ответит — нужно подтвердить аккаунт. В терминале выполни:

openclaw pairing list telegram

Команда покажет список запросов на доступ. Одобри свой запрос (ID берётся из вывода предыдущей команды):

openclaw pairing approve telegram ID_ИЗ_СПИСКА_ВЫШЕ

После этого снова напиши боту — он должен ответить. Если в чат приходит текст, значит связка Telegram и OpenClaw работает. 🎉

Дальше можно настраивать поведение бота, подключать skills и интеграции — но это уже темы отдельных статей. Главное достигнуто: теперь у тебя есть личный AI-ассистент прямо в Telegram.

---

❓ Частые вопросы

Можно ли пользоваться OpenClaw бесплатно?

Да. В инструкции используется бесплатная облачная модель Qwen (qwen-portal/coder-model), которая работает даже на базовом VPS. У бесплатных моделей есть лимит запросов и токенов, поэтому такой вариант лучше подходит для экспериментов и простых задач. Для серьёзной работы стоит подключить платный API OpenAI или Anthropic.

Какой VPS нужен для OpenClaw?

Если AI-модель работает в облаке, OpenClaw почти не нагружает сервер — хватает базового VPS с 2 ядрами и 1 ГБ оперативной памяти. Более мощный сервер с запасом RAM нужен только в одном случае: если ты планируешь запускать языковую модель локально, а не в облаке.

Что делать при ошибке «API rate limit reached»?

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

Нужен ли WSL2 для установки на Windows?

Не обязательно, но разработчики OpenClaw рекомендуют именно WSL2 — подсистему Linux внутри Windows. В ней инструмент работает стабильнее, чем в чистом PowerShell. Установить WSL2 можно одной командой wsl --install в PowerShell от имени администратора.

Безопасно ли хранить токен бота в OpenClaw?

Токен Telegram-бота — это фактически пароль от него, поэтому его нельзя публиковать или передавать другим. При настройке OpenClaw сохраняет токен в собственный конфиг на твоём VPS. Дополнительный плюс размещения на сервере — эксперименты со скриптами и интеграциями идут изолированно от домашнего компьютера.

---