Как установить OpenClaw: пошаговая инструкция
Полное руководство по установке OpenClaw на Linux, macOS и Windows. Настройка Docker, подключение к Telegram, выбор AI-модели.
Оглавление
Что нужно для установки
OpenClaw (ранее ClawdBot) — AI-агент с открытым исходным кодом, который работает в Telegram. Перед установкой убедитесь, что у вас есть всё необходимое.
Системные требования
- Сервер (VPS) с минимум 1 GB оперативной памяти
- Операционная система: Ubuntu 22.04+ (рекомендуется), Debian 11+, macOS 13+, или Windows 10+ (через WSL2)
- Node.js версии 18 или выше
- npm (устанавливается вместе с Node.js)
- Стабильное интернет-соединение
API-ключ для AI-модели
OpenClaw работает с разными AI-моделями. Для каждой нужен отдельный API-ключ:
- Claude (Anthropic) — ключ на console.anthropic.com. Лучший выбор для сложных задач и программирования.
- ChatGPT (OpenAI) — ключ на platform.openai.com. Универсальная и быстрая модель.
- Gemini (Google) — ключ на aistudio.google.com. Мультимодальная модель с поддержкой изображений.
Не хотите разбираться с API-ключами? Через MyClawBot всё настроено — OAuth-авторизация прямо в боте, без ручного ввода ключей.
Установка на Linux/macOS
Шаг 1: Установка Node.js
Рекомендуем установить Node.js через nvm (Node Version Manager) — это позволяет легко переключаться между версиями:
# Установка nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# Перезагрузите терминал, затем:
nvm install 22
nvm use 22
# Проверка
node --version # должно показать v22.x.xНа macOS также можно установить через Homebrew: brew install node
Шаг 2: Установка OpenClaw
Установите OpenClaw глобально через npm:
npm install -g @anthropic-ai/clawЭто установит CLI-инструмент openclaw, который будет доступен в терминале.
Шаг 3: Первый запуск и настройка
Запустите мастер настройки:
openclaw onboardМастер проведёт вас через начальную настройку: выбор AI-модели, ввод API-ключа, настройку Telegram-бота. Следуйте подсказкам на экране.
Шаг 4: Подключение к Telegram
После настройки нужно подключить OpenClaw к Telegram. Подробная инструкция — в разделе «Подключение к Telegram» ниже.
Установка на Windows (через WSL2)
OpenClaw на Windows работает через WSL2 (Windows Subsystem for Linux). Это официальная подсистема от Microsoft, которая запускает Linux внутри Windows. Установка WSL2 занимает 5-10 минут.
Установка WSL2
Откройте PowerShell от имени администратора и выполните:
wsl --installЭта команда установит WSL2 и Ubuntu. После установки перезагрузите компьютер.
При первом запуске Ubuntu из меню «Пуск» создайте имя пользователя и пароль для Linux. Затем обновите пакеты:
sudo apt update && sudo apt upgrade -yДалее — как на Linux
Теперь вы находитесь в Linux-среде. Следуйте инструкции из раздела «Установка на Linux/macOS» выше — все шаги идентичны: установка Node.js через nvm, установка OpenClaw через npm, первый запуск.
Установка через Docker
Docker позволяет запустить OpenClaw в изолированном контейнере. Это удобно, если вы не хотите устанавливать Node.js на хост-систему или если на сервере уже работают другие приложения.
Убедитесь, что Docker установлен. Затем выполните:
# Загрузка образа
docker pull ghcr.io/anthropics/openclaw:latest
# Запуск контейнера
docker run -d \
--name openclaw \
--restart unless-stopped \
-e ANTHROPIC_API_KEY=sk-ant-... \
-e TELEGRAM_BOT_TOKEN=123456:ABC-DEF... \
-v openclaw-data:/data \
ghcr.io/anthropics/openclaw:latestЗамените ANTHROPIC_API_KEY на ваш ключ и TELEGRAM_BOT_TOKEN на токен вашего бота.
Для обновления: остановите контейнер, загрузите новый образ и запустите заново:
docker stop openclaw && docker rm openclaw
docker pull ghcr.io/anthropics/openclaw:latest
# Запустите снова с той же командой docker runАльтернатива: установка через MyClawBot за 1 минуту
Не хотите разбираться с SSH, Docker и Node.js?
MyClawBot устанавливает OpenClaw на готовый сервер за 1 минуту. Вам не нужно покупать VPS, настраивать SSH-ключи, устанавливать Docker или вводить команды в терминале. Просто создайте бота через @BotFather, вставьте токен на myclawbot.ru — и ваш AI-ассистент готов.
Установить через MyClawBot →| Самостоятельно | MyClawBot | |
|---|---|---|
| Время установки | 30-60 мин | 1 минута |
| Нужен SSH | Да | Нет |
| Нужен Docker | Желательно | Нет |
| Обновления | Вручную | Автоматически |
| Поддержка | AI-агент на русском | |
| Цена | ~$10/мес за VPS + время | 3 890 ₽/мес всё включено |
| Бонус на AI | 1 000 ₽ |
Настройка моделей
OpenClaw поддерживает несколько AI-моделей. Вы можете переключаться между ними в любой момент. Для каждой модели нужно получить API-ключ и добавить его в конфигурацию.
Claude (Anthropic)
Claude Opus — лучший выбор для сложных задач, программирования и анализа документов. Для получения ключа:
- Зарегистрируйтесь на console.anthropic.com
- Перейдите в раздел API Keys
- Создайте новый ключ и скопируйте его
# В файле конфигурации openclaw.env:
ANTHROPIC_API_KEY=sk-ant-api03-...ChatGPT (OpenAI)
GPT-4o — универсальная и быстрая модель. Для получения ключа:
- Зарегистрируйтесь на platform.openai.com
- Перейдите в Settings → API Keys
- Создайте новый ключ
# В файле конфигурации openclaw.env:
OPENAI_API_KEY=sk-proj-...Gemini (Google)
Gemini — мультимодальная модель, работающая с текстом, изображениями и видео. Для получения ключа:
- Перейдите на aistudio.google.com
- Нажмите «Get API Key»
- Создайте ключ для проекта
# В файле конфигурации openclaw.env:
GOOGLE_API_KEY=AIza...Подробнее о возможностях каждой модели читайте в статье «Что такое OpenClaw».
Подключение к Telegram
Чтобы OpenClaw работал как бот в Telegram, нужно создать бота через @BotFather и подключить его токен к OpenClaw.
- Откройте @BotFather в Telegram — это официальный бот Telegram для создания ботов. Найдите его через поиск или перейдите по ссылке t.me/BotFather.
- Создайте нового бота: отправьте команду
/newbot, придумайте имя и username (должен заканчиваться на «bot»). - Скопируйте токен — BotFather выдаст строку вида
123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. - Добавьте токен в конфигурацию OpenClaw:
# В файле openclaw.env:
TELEGRAM_BOT_TOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11После добавления токена перезапустите OpenClaw. Бот появится в Telegram — откройте с ним диалог и начните общение.
Через MyClawBot подключение к Telegram занимает 30 секунд: вставьте токен на сайте, и всё настроится автоматически.
Частые проблемы при установке
node: command not found
Node.js не установлен или не добавлен в PATH. Если вы использовали nvm, перезагрузите терминал или выполните source ~/.bashrc. Проверьте установку: node --version.
EACCES: permission denied
Ошибка прав при глобальной установке npm-пакетов. Решение: используйте nvm (он устанавливает Node.js в домашнюю директорию) или настройте npm prefix: npm config set prefix ~/.npm-global и добавьте ~/.npm-global/bin в PATH.
Port already in use (EADDRINUSE)
Порт занят другим процессом. Найдите процесс: lsof -i :порт и завершите его, или измените порт в конфигурации OpenClaw.
WSL2: «Virtual machine platform» не включена
Откройте «Включение или отключение компонентов Windows» и активируйте «Платформа виртуальной машины» и «Подсистема Windows для Linux». Перезагрузите компьютер. Если используете AMD — убедитесь, что SVM включён в BIOS.
Docker: permission denied
Добавьте пользователя в группу docker: sudo usermod -aG docker $USER, затем перезайдите в систему. Проверьте: docker ps (должно работать без sudo).
API key invalid / 401 Unauthorized
Проверьте, что API-ключ скопирован полностью, без лишних пробелов. Убедитесь, что на вашем аккаунте активна подписка и есть баланс. Для Claude ключ начинается с sk-ant-, для OpenAI — с sk-proj-.
Столкнулись с проблемой, которой нет в списке? Через MyClawBot вы получаете AI-агента поддержки, который поможет разобраться с любой ошибкой.
Часто задаваемые вопросы
Можно ли установить OpenClaw на обычный хостинг?
Нет. OpenClaw требует полного доступа к серверу (root-права) для запуска процессов, установки зависимостей и работы с файловой системой. Обычный shared-хостинг не подойдёт — нужен VPS или выделенный сервер. Через MyClawBot вопрос сервера решается автоматически — выделенный VPS уже включён в подписку.
OpenClaw работает на Windows без WSL?
Нативная поддержка Windows экспериментальная и может работать нестабильно. Рекомендуется использовать WSL2 (Windows Subsystem for Linux) — это занимает 5 минут и даёт полную совместимость. Либо используйте MyClawBot — установка не зависит от вашей операционной системы.
Нужен ли Docker обязательно?
Нет, Docker — один из способов установки, но не обязательный. OpenClaw можно установить напрямую через npm. Docker удобен для изоляции и простоты обновлений, но добавляет дополнительный слой сложности.
Сколько стоит сервер для OpenClaw?
Минимальный VPS для OpenClaw стоит от $5-10 в месяц (1 CPU, 1 GB RAM, Ubuntu 22.04). Этого достаточно для одного пользователя. Плюс вам понадобятся API-ключи для AI-моделей (Claude, ChatGPT). Через MyClawBot — 3 890 ₽/мес, сервер и бонус 1 000 ₽ на AI-запросы уже включены.
Как обновить OpenClaw до новой версии?
При установке через npm: запустите npm update -g @anthropic-ai/claw. При установке через Docker: docker pull и пересоздание контейнера. Через MyClawBot обновления устанавливаются автоматически — вам не нужно ничего делать.
Читайте также
- •Что такое OpenClaw — полный обзор возможностей AI-ассистента
- •ClawdBot → OpenClaw — история переименования и что изменилось