OpenClaw — ИИ агент на ПК: установка и подключение к Telegram

Зимой OpenClaw стал заметен в моей ленте: за одну неделю проект дважды переименовали, а число звёзд на GitHub быстро выросло до сотен тысяч. С тех пор пользователи всё чаще ищут инструкции по установке OpenClaw и его подключению к Telegram.

В этой статье, опираясь на официальные материалы проекта, объясняю, что такое OpenClaw, чем он отличается от Claude Code, как установить его на Windows, macOS или Linux, выбрать модель и связать с ботом Telegram. Также рассмотрю безопасность: вокруг OpenClaw уже возникали резонансные ситуации.

Инструкции по работе с сервисом собраны в документации Ailoot.

Что представляет собой OpenClaw?#

OpenClaw связывает модель ИИ с вашим Telegram-ботом. При настроенных инструментах и разрешениях он может составить сводку сообщений или запланировать напоминание. Процесс шлюза и его локальные настройки работают на вашем компьютере или сервере. Это не делает всю переписку локальной: при выборе облачной модели запрос и нужный контекст передаются её провайдеру. При подключении через Ailoot запрос проходит через Ailoot к выбранному провайдеру модели. Для локальной обработки запросов нужна локальная модель без облачного fallback; сообщения Telegram всё равно проходят через Telegram, а включённые инструменты могут обращаться к другим сервисам.

Проект развивается силами сообщества OpenClaw с открытым исходным кодом. Репозиторий на GitHub появился 24 ноября 2025 года; по состоянию на 22 августа 2026 года у него 387 тысяч звёзд и 81 тысяча форков. Это один из проектов с наиболее быстрым ростом среди открытых разработок того года. Основной язык — TypeScript.

История названий поможет понять старые инструкции. Изначально проект назывался Warelay и служил шлюзом для WhatsApp, затем получил имя Clawdbot. В январе 2026 года Anthropic попросила изменить название из-за товарного знака; несколько дней проект назывался Moltbot. 30 января 2026 года закрепилось нынешнее имя — OpenClaw. Поэтому упоминания «Клодбота» или «Молтбота» в старых руководствах относятся к тому же проекту.

Лобстер Молти — маскот OpenClaw, а линька, то есть смена панциря, стала официальной метафорой переименований.

Чем OpenClaw отличается от Claude Code и Hermes Agent?#

Эти продукты нередко объединяют понятием «ИИ-агент», хотя задачи у них различаются. Сравнение основных возможностей:

Claude Code подходит для разработки, особенно когда важны сильная модель и помощь с кодом. OpenClaw и Hermes решают другую задачу: работают постоянно, доступны через Telegram, учитывают предыдущие разговоры и выполняют действия по расписанию. Выбор между OpenClaw и Hermes зависит от потребностей; подробнее о Hermes, его установке и настройке рассказано в отдельном обзоре.

Если вы пока выбираете инструмент, начните с обзоров о том, чем пишут код в 2026 году и какие задачи можно поручить ИИ-агенту. Установка Claude Code разобрана в отдельной статье.

Что потребуется для установки OpenClaw?#

Сначала проверьте версию Node.js — это основное обязательное условие:

node --version

Поддерживаются ветки 22.22.3+, 24.15+ и 25.9+; рекомендуемая версия — Node 26. Если система не находит команду или установлен более старый выпуск, официальный установщик загрузит актуальный Node.js самостоятельно.

Теперь выберите модель. OpenClaw сам не генерирует ответы, а обращается к выбранной модели. Можно использовать ключ Anthropic, OpenAI или Google и платить этим провайдерам за фактическое потребление. Другой вариант — запустить модель локально через Ollama: плата за токены не взимается, но потребуется достаточно мощное оборудование. Оба способа описаны ниже.

Как установить OpenClaw на macOS и Linux?#

Проще всего воспользоваться официальным установщиком:

1. Запустите установку

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

   Скрипт определит систему, проверит наличие Node.js и при необходимости установит его. Затем он поставит OpenClaw и автоматически откроет мастер настройки. Чтобы сначала установить программу без мастера, добавьте флаг bash -s -- --no-onboard.

2. Убедитесь, что установка завершилась

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   Первая команда выводит версию, вторая проверяет конфигурацию, а третья показывает состояние шлюза, в том числе работу на порту 18789.

Если вы предпочитаете управлять установкой через npm, используйте команды:

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

Обратите внимание на ограничение новых версий npm. В npm 12 установочные скрипты пакетов по умолчанию блокируются; без --allow-scripts=openclaw установка завершится ошибкой allowScripts. В npm 11.15 и более ранних версиях такого запрета ещё нет, поэтому флаг не требуется. Узнать версию можно командой npm --version.

Флаг --install-daemon настраивает автозапуск через LaunchAgent в macOS или systemd в Linux. Шлюз запускается после перезагрузки или входа согласно условиям менеджера служб. Это не предотвращает сон и не сохраняет работу при выключенном компьютере. Ответы Telegram требуют бодрствующего хоста, работающего шлюза и сети. Для ответов при спящем или выключенном ноутбуке используйте постоянно включённый сервер.

Как установить OpenClaw на Windows?#

Если удобнее пользоваться окнами, выберите Windows Hub — нативное приложение OpenClaw для Windows 10 (20H2+) и Windows 11, пока находящееся в бета-версии. Откройте страницу выпусков Windows Hub и выберите установщик для своего процессора: OpenClawCompanion-Setup-x64.exe предназначен для обычных компьютеров, а arm64 — для устройств на ARM. После установки в меню «Пуск» появится OpenClaw Companion с иконкой в области уведомлений, окном чата и настройками.

При первом запуске выберите «Set up locally». Приложение создаст отдельную среду WSL с именем OpenClawGateway, установит туда шлюз и подключится к нему. Уже установленный Ubuntu этим не затрагивается.

Другой вариант — установить программу в PowerShell:

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

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

Третий способ — WSL2. В документации этот вариант назван наиболее совместимой средой выполнения для Windows. Установите Ubuntu, включите systemd, а затем воспользуйтесь инструкцией для Linux:

wsl --install -d Ubuntu-24.04

Внутри WSL добавьте systemd=true в секцию [boot] файла /etc/wsl.conf. В PowerShell выполните wsl --shutdown, чтобы перезапустить WSL, а затем установите OpenClaw по инструкции для Linux. Если вы не знакомы с дистрибутивами и systemd, Windows Hub выполнит эту настройку автоматически.

Как выбрать модель и настроить OpenClaw впервые?#

Модель служит вычислительной основой ассистента. Мастер настройки предложит выбрать поставщика из доступного списка. Например, можно напрямую подключить Claude через Anthropic или GPT через OpenAI. Также для OpenAI предусмотрен вход через подписку ChatGPT. Ещё один вариант — локальные модели Ollama или LM Studio: укажите адрес локального сервера, подробности приведены в следующем разделе.

Если на компьютере уже установлен Claude Code и выполнен вход, OpenClaw может использовать эти учётные данные. Сначала войдите на компьютере командой claude auth login, затем выберите соответствующий способ аутентификации в OpenClaw:

openclaw models auth login --provider anthropic --method cli --set-default

При работе шлюза в качестве фоновой службы, например после установки с --install-daemon, ключ должен быть ей доступен. Мастер настройки сохраняет его в ~/.openclaw/.env; обычно редактировать файл вручную не нужно. После изменения настроек перезапустите шлюз и проверьте состояние моделей:

openclaw gateway restart
openclaw models status

Если оплачивать облачную модель неудобно, рассмотрите запуск локальной модели через Ollama.

Как связать OpenClaw с Telegram?#

Для первого подключения Telegram достаточно токена бота; отдельная проверка бизнес-аккаунта не нужна. В документации OpenClaw Telegram назван одним из наиболее простых способов начать пользоваться ассистентом с телефона. Порядок действий такой:

1. Создайте бота через BotFather

   В Telegram найдите чат с @BotFather и убедитесь, что это именно указанный аккаунт. Отправьте команду /newbot, задайте имя и username, оканчивающийся на bot. BotFather пришлёт токен наподобие 123456789:ABCdef.... Это секретный ключ бота — храните его как пароль.

2. Добавьте токен в OpenClaw

   Самый простой способ — открыть мастер командой openclaw configure и выбрать канал Telegram. Вручную токен можно указать в параметре channels.telegram.botToken конфигурации либо через переменную окружения TELEGRAM_BOT_TOKEN. Согласно документации, команды openclaw channels login telegram нет: для подключения Telegram используется токен.

3. Запустите шлюз и отправьте боту сообщение

   openclaw gateway
   

   Откройте своего бота в Telegram и напишите ему. В ответ придёт восьмизначный код привязки. Это защитная проверка: до подтверждения отправителя бот не обрабатывает сообщения.

4. Подтвердите привязку

   openclaw pairing list telegram
   openclaw pairing approve telegram КОД
   

   Код действует один час. Первый подтверждённый отправитель автоматически получает права владельца для привилегированных команд.

При настройке часто возникают две дополнительные ситуации.

По умолчанию OpenClaw блокирует группы. Чтобы разрешить бота в группе, добавьте её в настройки channels.telegram.groups и оставьте requireMention: true. В этом режиме бот отвечает, только когда его вызывают по username, и не вмешивается в общий разговор. Кроме того, Telegram ограничивает видимость сообщений ботами в группах — по умолчанию они видят только команды. Изменить это можно у @BotFather командой /setprivacy. После переключения бота нужно удалить из группы и добавить снова, чтобы Telegram применил новую настройку.

Не разрешайте всем подряд управлять ботом. Режим dmPolicy: "open" со звёздочкой в списке доступа позволяет любому, кто найдёт username бота, отправлять ему команды. Для персонального ассистента это может открыть постороннему человеку доступ к действиям на вашем компьютере. Сохраните подтверждение по кодам или укажите свой числовой ID в allowFrom.

Как запустить OpenClaw с локальной моделью через Ollama?#

Локальный вариант позволяет не отправлять переписку внешнему поставщику модели. Вычисления выполняются на вашем оборудовании, а отдельная плата за токены не взимается.

1. Установите Ollama

   Загрузите установщик с ollama.com/download. Доступны версии для macOS, Windows и Linux.

2. Загрузите модель

   ollama pull gemma4
   

3. Настройте Ollama в OpenClaw

   openclaw onboard
   

   Выберите поставщика Ollama и режим: Local only — только локальные модели; Cloud only — модели с ollama.com; или Cloud + Local. Мастер обнаружит локальный сервер и покажет установленные модели.

4. Проверьте список моделей

   openclaw models list --provider ollama
   

У локального режима есть существенное ограничение. В документации OpenClaw указано, что для комфортной работы агента нужна производительность примерно двух Mac Studio с полностью заряженными батареями, а видеокарта с 24 ГБ памяти подходит лишь для лёгких запросов и может отвечать с задержкой. Компактные модели и модели с сильным сжатием хуже сохраняют контекст и слабее сопротивляются вредоносным инструкциям, встроенным в чужой текст. Для знакомства с технологией может хватить хорошего ноутбука; для ежедневной работы с инструментами облачная модель пока надёжнее.

Есть также предупреждение для конфигурации WSL2 + Ollama + видеокарта NVIDIA. Официальный установщик Ollama для Linux включает автозапуск службы с постоянным перезапуском. На WSL2 с GPU это может привести к циклу перезагрузок компьютера. Если столкнулись с проблемой, отключите автозапуск службы и обратитесь к разделу устранения неполадок на странице Ollama в документации.

Безопасно ли запускать OpenClaw?#

Главное, что следует учитывать: OpenClaw может работать с файлами и командами на вашем устройстве, а также пользоваться браузером. В документации проект описан как инструмент для одного доверенного пользователя. Не предоставляйте доступ к своему боту посторонним: тот, кто может отправлять команды агенту, потенциально может инициировать действия на вашем компьютере.

Минимальные меры предосторожности:

1. Оставьте привязку по кодам или настройте список разрешённых пользователей — инструкция приведена в разделе о Telegram.
2. Не открывайте доступ к шлюзу из внешней сети без необходимости. По умолчанию он принимает подключения только с вашего устройства; сохраните это ограничение.
3. После изменения настроек запускайте встроенную проверку:

openclaw security audit

Проверка выявляет открытый доступ, чрезмерно широкие права инструментов, ненадёжные токены и доступные извне порты. Флаг --fix автоматически исправляет часть найденных проблем.

Следите и за попытками мошенничества. Во время смены названия проекта в январе 2026 года автоматические аккаунты быстро заняли освободившиеся адреса и опубликовали криптовалютный кошелёк. Также появились поддельные разработчики OpenClaw, рекламировавшие мошеннический токен. Скачивайте программу только с openclaw.ai или официального репозитория проекта. У проекта нет собственной криптовалюты: предложения купить «токен OpenClaw» — мошенничество, не переводите туда деньги.

Что умеет OpenClaw после установки?#

Для начала полезно освоить возможности в таком порядке:

1. Шлюз и модель. Выполните openclaw gateway status, затем откройте openclaw dashboard. Загруженная панель подтверждает доступность Control UI. Отправьте в её чат «Ответь: проверка подключения модели» и убедитесь, что пришёл ответ ИИ: одна загрузка страницы модель не проверяет.
2. Telegram и нужная задача. После настройки бота и подтверждения собственной привязки отправьте новое сообщение этому боту в Telegram и проверьте ответ именно там. Затем выполните одну ограниченную задачу с видимым результатом, например сводку безвредной тестовой папки, которую разрешено читать. Для напоминания отдельно проверьте сохранённое расписание и доставленное сообщение. Ответ в панели не подтверждает доставку Telegram или выполнение по расписанию.
3. Настройте расписание. Ассистент может отправлять утреннюю сводку в Telegram или регулярно проверять почту. Для этого шлюз обычно оставляют работающим постоянно.
4. Ознакомьтесь с памятью. Долговременная память хранится в обычных файлах Markdown в рабочей папке: сведения о вас, предпочтениях к ответам и прошлых беседах. Эти файлы можно открыть и прочитать.
5. Изучите навыки официальный каталог навыков. В каталоге проекта есть готовые навыки и плагины со встроенной проверкой безопасности. Помните, что установленный чужой навык представляет собой код, работающий на вашем компьютере.

Подключайте возможности последовательно: сначала проверьте обычный диалог, затем настройте Telegram, после этого добавьте расписания. Такой порядок помогает понять, на каком этапе возникла проблема.

Как исправить проблемы при установке?#

Рассмотрим три типичных случая.

После установки появляется «openclaw: command not found». Обычно каталог глобальных пакетов npm не указан в переменной PATH терминала. Для проверки выполните команды из документации:

node -v
npm prefix -g
echo "$PATH"

Путь, выведенный второй командой, должен присутствовать в результате третьей. Если его нет, добавьте каталог в настройки оболочки. Также можно закрыть и снова открыть терминал: иногда обновлённый путь применяется только в новой сессии.

Шлюз запущен, но ассистент молчит. Согласно разделу вопросов и ответов документации, если на первое сообщение нет ответа и счётчик токенов остаётся нулевым, агент, вероятно, не стартовал — часто из-за невыбранной модели. Проверьте состояние командой:

openclaw gateway restart
openclaw status
openclaw models status

Если модель настроена, но ответа всё ещё нет, запустите openclaw logs --follow. Команда покажет текущий журнал и поможет найти этап, на котором останавливается процесс.

Бот не отвечает в Telegram. Проверьте последовательно, что используете токен нужного бота, шлюз работает (openclaw gateway status), а ваша привязка подтверждена (openclaw pairing list telegram). Код действует один час. Если вы писали боту накануне, отправьте новое сообщение и подтвердите свежий код.

Если самостоятельно найти причину не получается, документация предлагает поручить диагностику локальному ИИ-агенту, который может читать состояние компьютера. Передайте Claude Code или Codex вывод команд openclaw status --all и openclaw doctor; анализ конфигурации может оказаться быстрее обращения в поддержку.

Какие вопросы об OpenClaw задают чаще всего?#

Узнайте больше об Ailoot.