Гайд по OpenClaw: Как запустить модный ИИ-агент без сложностей (2026)

Большинство инструкций по ИИ-агентам заканчиваются на фразе «введите API ключ и наслаждайтесь». В реальности всё сложнее: нода не той версии, бот молчит, а Windows выдает ошибки путей. OpenClaw — мощный инструмент, который реально может управлять вашим календарем и файлами, но он требует уважения к деталям.

Ниже — единственная инструкция, которая вам понадобится. Мы пройдем путь от настройки среды до первого осмысленного диалога в Telegram, разбирая каждый нюанс, о который обычно спотыкаются новички.

Часть 1. Фундамент (Windows и Node.js)

OpenClaw написан на современном JavaScript. Если у вас старая версия Node.js или «голая» Windows, скрипт упадет на старте. Сэкономим вам пару часов гугления.

Если вы на Windows (Важно!)

Правильная установка Node.js (Linux / macOS / WSL)

Не используйте apt install nodejs (в репозиториях часто лежит древняя версия). Используйте NVM (Node Version Manager) — это стандарт индустрии:

# 1. Ставим NVM (менеджер версий)
 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
 
 # 2. Закройте и снова откройте терминал, чтобы изменения вступили в силу. 
 
 # 3. Ставим Node.js версии 22 (LTS)
 nvm install 22
 nvm use 22

Часть 2. Установка самого OpenClaw

Теперь, когда среда готова, ставим агента через пакетный менеджер NPM:

npm install -g openclaw@latest

После установки проверьте, что система видит команду:

openclaw --version

Если терминал показал версию (например, 1.4.x) — вы великолепны, идем дальше.

Часть 3. Интеграция с Telegram (Без ошибок)

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

Шаг 3.1. Создаем бота и берем токен

1. Откройте Telegram и найдите отца всех ботов: @BotFather.
2. Нажмите Start и отправьте команду /newbot.
3. Придумайте имя (любое) и юзернейм (на английском, заканчивается на bot, например MySmartAgent2026_bot).
4. BotFather выдаст длинный ключ: 7182312:AAHnq.... Скопируйте его, он понадобится через минуту.

Шаг 3.2. Узнаем ваш личный ID (Для Whitelist)

Это ваш пропуск в систему. Бот должен знать своего хозяина в лицо.

1. Найдите бота @userinfobot.
2. Нажмите Start.
3. Он пришлет вам Id: 123456789. Скопируйте цифры.

Часть 4. Мастер настройки (Onboard)

OpenClaw имеет встроенный мастер настройки. Запускаем:

openclaw onboard

Вас встретит интерактивное меню. Перемещайтесь стрелками, выбирайте Enter. Вот правильные ответы для старта:

• Select Gateway: Выбирайте Local. (Remote нужен только для сложных серверных архитектур).
• LLM Provider: Выберите вашу модель (Anthropic Claude 3.5 или OpenAI GPT-4o).
  Вас попросят ввести API Key. Вставьте ключ (ввод будет невидимым, это нормально).
• Clients: Найдите в списке Telegram, отметьте его пробелом, затем нажмите Enter.
  Вставьте токен, который дал BotFather (из шага 3.1).

Часть 5. Финальная настройка безопасности (Config)

Мастер создает базовый конфиг, но безопасность лучше докрутить вручную. Откроем файл настроек (обычно он лежит в домашней папке):

nano ~/.openclaw/config.yaml

Найдите секцию telegram. Она должна выглядеть вот так. Если поля allowed_users нет — допишите его вручную, соблюдая отступы (YAML чувствителен к пробелам):

telegram:
   enabled: true
   token: "ВАШ_ТОКЕН_ОТ_BOTFATHER"
   allowed_users:
     - 123456789  # <--- Вставьте сюда ваш ID от userinfobot!

Нажмите Ctrl+O, затем Enter (сохранить) и Ctrl+X (выйти).

Теперь бот будет отвечать ТОЛЬКО вам. Все остальные получат тишину.

Часть 6. Запуск: Тестовый и Боевой

Тестовый запуск

В терминале пишем:

openclaw start

Если видите зеленые строчки и надпись Telegram client ready — идите в личку к боту и пишите «Привет». Он должен ответить.
Чтобы остановить: нажмите Ctrl+C.

Боевой запуск (в фоне)

Если вы закроете терминал, бот уснет. Чтобы он работал 24/7, используем менеджер процессов PM2.

# 1. Устанавливаем PM2
 npm install -g pm2
 
 # 2. Запускаем OpenClaw через PM2
 pm2 start openclaw --name "my-agent" -- start
 
 # 3. Делаем так, чтобы он сам вставал после перезагрузки сервера
 pm2 save
 pm2 startup

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

• Бот молчит, хотя запущен. Проверьте баланс вашего API ключа (OpenAI/Anthropic). Если на счету $0, магии не будет.
• Ошибка "Connection refused". Если ваш сервер в РФ, скорее всего, доступа к API нет. Вам нужно настроить VPN на сервере или использовать прокси в конфиге OpenClaw.
• Ошибка "Rate Limit". Вы слишком часто пишете. Подождите минуту или повысьте лимиты в аккаунте провайдера нейросети.

Готово! Теперь у вас есть собственный ИИ-агент, который живет на вашем железе, подчиняется только вам и готов выполнять команды. Начните с простого: попросите его составить план дня или переписать черновик письма.