Скачать и установить OpenClaw на Linux (Ubuntu, Debian и другие)

OpenClaw --- бесплатный автономный ИИ-агент с открытым исходным кодом, который работает прямо на вашем сервере или компьютере и общается через мессенджеры: Telegram, WhatsApp, Slack, Discord, Signal и другие. В этом руководстве вы установите OpenClaw на Linux, подключите языковую модель и запустите агента, которому можно написать в мессенджер и получить ответ.

К концу инструкции у вас будет полностью настроенный OpenClaw с автозапуском через systemd.

Что понадобится

Прежде чем начинать, убедитесь, что у вас есть:

• Linux-дистрибутив --- Ubuntu, Debian, Fedora, Arch или любой другой с поддержкой Node.js 22+.
• 2 ГБ свободного места на диске --- для Node.js, OpenClaw и его зависимостей.
• Стабильное подключение к интернету --- для установки пакетов и работы с API языковой модели.
• API-ключ языковой модели --- понадобится на этапе настройки. Если у вас его ещё нет, получим в шаге 3.

Никаких специальных знаний программирования не требуется --- достаточно уметь открыть терминал и вставить команду.

Шаг 1. Установка Node.js

OpenClaw работает на Node.js --- среде выполнения JavaScript. Вам нужна версия 22 или новее.

Проверьте, установлен ли Node.js

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

node --version

Если вы видите номер версии вроде v22.4.1 --- Node.js уже установлен. Убедитесь, что первая цифра 22 или больше, и переходите к шагу 2.

Если команда не найдена или версия ниже 22 --- установите Node.js одним из способов ниже.

Способ A: Через NodeSource (рекомендуется)

NodeSource предоставляет актуальные пакеты Node.js для основных дистрибутивов.

Ubuntu / Debian:

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

Fedora / RHEL / CentOS:

curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo dnf install -y nodejs

Arch Linux:

sudo pacman -S nodejs npm

Способ B: Через nvm (Node Version Manager)

Если вы хотите управлять несколькими версиями Node.js:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 22

Проверяем результат

node --version
npm --version

Вы должны увидеть что-то вроде:

v22.4.1
10.2.4

После этого шага у вас установлены Node.js и npm, необходимые для работы OpenClaw.

Шаг 2. Установка OpenClaw

Способ A: Официальный установщик (рекомендуется)

Самый простой способ --- официальный скрипт установки. Он автоматически определит вашу систему и установит всё необходимое:

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

Скрипт автоматически установит OpenClaw и запустит мастер настройки.

Если вы хотите пропустить мастер настройки и настроить вручную позже:

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

Способ B: Через npm

Альтернативный способ --- установка через npm (если Node.js 22+ уже установлен):

npm install -g openclaw@latest

Проверка установки

openclaw --version

Ожидаемый вывод --- номер версии OpenClaw.

Если возникает ошибка прав доступа

На Linux при глобальной установке npm-пакетов может возникнуть ошибка EACCES: permission denied. Решения:

Вариант 1 --- sudo (быстро, но не идеально):

sudo npm install -g openclaw@latest

Вариант 2 --- изменить директорию npm (рекомендуется):

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g openclaw@latest

После этого шага у вас установлен OpenClaw и доступна команда openclaw в терминале.

Шаг 3. Получение API-ключа языковой модели

OpenClaw --- это оболочка, а «мозг» агента --- языковая модель (LLM). Вам нужен API-ключ одного из провайдеров.

Какую модель выбрать

Провайдер	Рекомендация	Где получить ключ
Anthropic Claude	Лучший выбор для начала. Модели Claude отлично справляются с русским языком и сложными задачами.	console.anthropic.com
OpenAI GPT	Хорошая альтернатива с широким набором моделей.	platform.openai.com
DeepSeek	Дешёвый вариант через OpenRouter (~$0.30/млн токенов).	openrouter.ai
Ollama	Полностью локальный запуск, без отправки данных в облако. Требует мощное железо (16+ ГБ RAM).	ollama.com

Как получить ключ (на примере Anthropic Claude)

1. Зарегистрируйтесь на console.anthropic.com.
2. Перейдите в раздел API Keys.
3. Нажмите Create Key, задайте имя (например, «openclaw»).
4. Скопируйте ключ --- он начинается с sk-ant-.... Сохраните его в надёжном месте: ключ показывается только один раз.
5. Пополните баланс: для тестирования достаточно $5.

После этого шага у вас есть API-ключ, который OpenClaw будет использовать для обращения к языковой модели.

Шаг 4. Первая настройка --- openclaw onboard

Запустите мастер настройки:

openclaw onboard --install-daemon

Флаг --install-daemon автоматически создаст systemd-сервис для автозапуска агента (подробнее в шаге 6).

Мастер настройки проведёт вас через несколько шагов:

1. Выбор языковой модели --- выберите провайдера (Claude, GPT, DeepSeek, Ollama). Для первого раза рекомендуем Claude.
2. Ввод API-ключа --- вставьте ключ, полученный в шаге 3.
3. Выбор мессенджера --- укажите, через какой мессенджер агент будет общаться (Telegram, WhatsApp, Slack, Discord, Signal). Для старта Telegram --- самый простой вариант.
4. Имя и описание агента --- задайте имя, которое будет отображаться в мессенджере.
5. Файл SOUL.md --- мастер создаст файл «личности» агента. Вы сможете отредактировать его позже.

После завершения в директории ~/.openclaw/ появятся файлы конфигурации:

ls -la ~/.openclaw/

~/.openclaw/
├── openclaw.json       # Основные настройки (формат JSON5)
├── workspace/
│   ├── SOUL.md         # Личность агента
│   ├── AGENTS.md       # Описание агентов
│   └── skills/         # Директория для скиллов
└── credentials         # Ключи и токены

После этого шага у вас настроенный агент с конфигурацией, файлом личности и подключённым мессенджером.

Шаг 5. Первый запуск

Запустите агента:

openclaw gateway --port 18789

В терминале вы увидите:

🤖 OpenClaw agent started
📡 Connected to Telegram
🌐 Dashboard: http://127.0.0.1:18789/
⏳ Waiting for messages...

Теперь откройте выбранный мессенджер и напишите агенту любое сообщение, например:

Привет! Расскажи о себе.

Агент должен ответить в течение нескольких секунд. Если ответ пришёл --- поздравляем, установка завершена.

Чтобы остановить агента, нажмите Ctrl + C в терминале.

Полезные команды для работы

openclaw gateway --port 18789            # Запустить агента
openclaw gateway --port 18789 --verbose  # Запуск с подробным выводом
openclaw doctor                          # Диагностика проблем
openclaw update                          # Обновить OpenClaw
openclaw dashboard                       # Открыть веб-панель управления

После этого шага у вас работающий ИИ-агент, который отвечает на сообщения в мессенджере.

Шаг 6. Автозапуск через systemd

Если вы использовали --install-daemon при настройке (шаг 4), systemd-сервис уже создан. Если нет --- установите его:

openclaw gateway install

Это создаст пользовательский systemd-сервис openclaw-gateway.service.

Управление сервисом

openclaw gateway status      # Проверить состояние
openclaw gateway restart     # Перезапустить
openclaw gateway stop        # Остановить

Сохранение после выхода из системы

По умолчанию пользовательские systemd-сервисы останавливаются при выходе из SSH-сессии. Чтобы сервис работал постоянно:

sudo loginctl enable-linger $USER

После этого агент будет автоматически запускаться при загрузке системы и продолжать работать после закрытия SSH-соединения.

Проверка

openclaw gateway status

Вы должны увидеть Runtime: running и RPC probe: ok.

Решение частых проблем

«command not found: openclaw»

Node.js установлен, но команда openclaw не найдена. Причина --- глобальные npm-пакеты не в PATH.

# Проверьте, где npm устанавливает глобальные пакеты:
npm root -g

# Добавьте путь к бинарным файлам npm в PATH:
NPM_ROOT=$(npm root -g)
echo "export PATH=\"${NPM_ROOT%/lib/node_modules}/bin:\$PATH\"" >> ~/.bashrc
source ~/.bashrc

Если вы используете zsh, замените .bashrc на .zshrc.

«Error: unsupported Node.js version»

OpenClaw требует Node.js 22+. Проверьте версию:

node --version

Если версия ниже 22, обновите через NodeSource (шаг 1) или nvm:

nvm install 22
nvm use 22

«Error: Invalid API key» или «Authentication failed»

• Убедитесь, что вы скопировали ключ полностью, без лишних пробелов.
• Проверьте, что на счёте провайдера есть средства.
• Убедитесь, что выбран правильный провайдер (ключ Claude не подойдёт для GPT и наоборот).

Перенастроить ключ можно, отредактировав конфигурационный файл:

nano ~/.openclaw/openclaw.json

«EACCES: permission denied» при установке

Используйте sudo npm install -g openclaw@latest или настройте npm для работы без root-прав (описано в шаге 2).

Агент запускается, но не отвечает в мессенджере

• Проверьте, что бот в мессенджере корректно создан и токен верный.
• Убедитесь, что вы пишете именно тому боту, который подключён к OpenClaw.
• Проверьте, не блокирует ли firewall исходящие соединения (порты 443 для API, порты Telegram/WhatsApp).
• Запустите диагностику:

openclaw doctor

Firewall на сервере

Если OpenClaw запущен на сервере с включённым firewall (ufw, firewalld), убедитесь, что исходящие соединения разрешены:

# UFW (Ubuntu/Debian):
sudo ufw allow out 443/tcp    # API языковой модели
sudo ufw allow out 80/tcp     # Telegram, WhatsApp

# Если нужен доступ к дашборду извне (не рекомендуется без защиты):
# sudo ufw allow 18789/tcp

Для безопасного доступа к дашборду с другого устройства используйте SSH-туннель вместо открытия порта:

# На вашем компьютере:
ssh -L 18789:127.0.0.1:18789 user@your-server
# Теперь откройте http://127.0.0.1:18789/ в браузере

Что дальше

Установка --- это только начало. Вот что стоит сделать следующим шагом:

• Gateway: как устроен и как настроить --- подробно о gateway, дашборде и удалённом доступе.
• Безопасность OpenClaw --- что нужно знать перед запуском агента.
• Выбор языковой модели --- какую LLM выбрать для OpenClaw.
• Установка через Docker --- альтернативный способ развёртывания в контейнере.
• Безопасная установка на VPS --- если OpenClaw работает на удалённом сервере.

OpenClaw --- проект с открытым исходным кодом и активным сообществом на GitHub. Присоединяйтесь, экспериментируйте и делайте своего агента полезнее с каждым днём.