Как Windows, WSL и Ubuntu подружить с OpenClaw 🦞
Большинство статей про «своего ИИ‑ассистента» начинаются с советов арендовать VPS, ставить Docker и ковыряться в конфиге Nginx. Для обычного человека это звучит как «позовите админа». А что если сказать, что мощный агент уровня OpenClaw можно поселить прямо на вашем домашнем Windows‑компьютере — без серверов, но с нормальной безопасностью и управляемостью?
В этом тексте разберём связку «Windows → WSL → Ubuntu → OpenClaw» человеческим языком, с акцентом на реальный опыт установки: что нажать, чего не бояться и как в итоге получить бота в Telegram, который работает на вашем железе.
Почему вообще WSL, если у меня Windows
Официально OpenClaw рассчитан на Linux‑среду: ему нужны нормальные пути, юзеры, службы, иногда systemd. Windows — другая операционная система, и заставлять её притворяться Linux’ом напрямую — путь боли. Тут в игру вступает WSL2: встроенный слой, который запускает полноценный Linux (чаще всего Ubuntu) рядом с вашей Windows.
Представьте: у вас в квартире есть обычная комната (Windows) и внутри неё — маленький «техбокс» с отдельной дверью (Ubuntu). В техбоксе можно поставить всё, что любят админы и разработчики, не портя ремонт в основной комнате. Именно туда мы и поселим OpenClaw.
Практические плюсы для обычного пользователя:
- Не нужно арендовать сервер в облаке и разбираться с удалённым доступом — всё крутится на домашнем ПК. - Конфиги и инструкции из мира Linux подходят почти без перевода: вы просто выполняете их внутри окна Ubuntu.
- WSL прозрачно шарит сеть с Windows: панель OpenClaw на `http://127.0.0.1:18789` открывается в привычном браузере, будто это обычный локальный сайт.
Шаг 1. Включаем WSL и ставим Ubuntu без танца
Схема такая: один раз включаем WSL2, ставим Ubuntu, и больше к этому возвращаться не надо — дальше живём внутри Linux.
Что нужно сделать:
1. Открыть **PowerShell от имени администратора** (правый клик по «Пуск» → Windows PowerShell (Администратор)).
2. Ввести команду:
```powershell
wsl --install
```
Windows сама подтянет нужные компоненты и скачает Ubuntu по умолчанию. 3. Перезагрузить компьютер, дождаться первого запуска Ubuntu и задать имя пользователя и пароль для «внутреннего» Linux.
После этого в меню «Пуск» появится приложение **Ubuntu**. Это и есть дверь в ваш маленький Linux‑мир: все команды про OpenClaw мы будем вводить именно туда, а не в PowerShell. Главное правило для читателя: «всё, что касается агента, делаем внутри Ubuntu, а не в Windows».
Шаг 2. Готовим Ubuntu к установке OpenClaw
Открываем приложение Ubuntu. Перед установкой OpenClaw нужно сделать минимальную «генеральную уборку»: обновить пакеты и поставить базовые утилиты.
Вводим по очереди:
```bash
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git
```
Этого достаточно, чтобы официальные инструкции OpenClaw отработали без сюрпризов.
Здесь же можно кратко объяснить читателю, что такое systemd и почему он так часто всплывает в гайдах: это менеджер служб в Linux, который умеет автоматически запускать программы в фоне, следить за ними и перезапускать при падении. В идеальном мире мы включаем systemd в WSL через файл `/etc/wsl.conf`, но если это упрётся в версию Windows или WSL — не страшно, OpenClaw можно запускать и руками, как обычную программу.
Шаг 3. Устанавливаем OpenClaw одной строкой
Теперь самое вкусное. Разработчики OpenClaw сделали установщик, который ставит всё «под капотом» сам.
В Ubuntu набираем:
```bash
curl -fsSL https://openclaw.ai/install.sh | bash
```
Скрипт скачает необходимые части, создаст конфиг‑директорию `~/.openclaw` и запустит мастер настройки прямо в терминале. Это тот самый момент, когда в окне появляется логотип с крабом и подпись вроде «Built by lobsters, for humans» — читателю можно честно признаться, что этот экран вызывает лёгкую зависимость у всех, кто хоть раз его видел.
Дальше мастер задаёт несколько важных вопросов:
- вы показывают предупреждение по безопасности (OpenClaw умеет читать файлы и выполнять команды, если вы включите инструменты — это не игрушка); - предлагают выбрать **провайдера моделей**: OpenAI, xAI/Grok, OpenRouter и т.п.; - просят **API‑ключ** для выбранного провайдера — без него агент просто не сможет отвечать.
На этом этапе важно объяснить читателю, что «модель» — это мозг агента, а OpenClaw — его тело и нервная система. Вы можете подключить разные мозги (OpenAI, Grok, Yandex и т.д.), но именно наличие ключа и лимитов у провайдера решает, будет ли бот отвечать или жаловаться на ошибки.
Шаг 4. Привязываем Telegram‑бота и проходим pairing
Самый понятный интерфейс для агента — Telegram. OpenClaw очень неплохо дружит с ним: всё, что происходит в боте, проксируется через gateway в ваш локальный OpenClaw.
Что нужно сделать читателю:
1. В Telegram найти **@BotFather**, создать нового бота командой `/newbot` и сохранить выданный токен вида `1234567890:AA...`.
2. В мастере OpenClaw выбрать канал **Telegram (Bot API)** и вставить этот токен. 3. После завершения онбординга запустить gateway командой:
```bash
openclaw gateway
```
Теперь OpenClaw слушает `ws://127.0.0.1:18789`, а панель управления доступна по `http://127.0.0.1:18789/` в браузере Windows.
Когда вы впервые пишете своему боту в личку, можете увидеть сообщение вроде: «OpenClaw: access not configured» и pairing‑код. Это не ошибка, а защита: агент просит вас подтвердить, что именно этот Telegram‑пользователь имеет право им пользоваться.
В Ubuntu делаем:
```bash
openclaw pairing approve telegram ВАШ_КОД
```
После этого бот официально признаёт вас хозяином и начинает отвечать на сообщения — уже через выбранную модель (OpenAI, Grok и т.д.).
Шаг 5. Типичные грабли и как не паниковать
Самый полезный подарок читателю — не только рабочий сценарий, но и карта граблей, на которые вы уже наступили. В связке WSL + Ubuntu + OpenClaw чаще всего встречаются такие ситуации:
- **Gateway уже запущен.** Вы видите в логах: «Port 18789 is already in use… gateway already running». Это не катастрофа: просто OpenClaw уже слушает порт, и второй экземпляр не нужен. Решение: закрыть лишнее окно или использовать `openclaw gateway stop`. - **Модель жалуется на лимиты.** OpenAI отвечает `API rate limit reached`, Grok — 403 с просьбой купить кредиты. Важно объяснить, что это не «сломанный агент», а ограничения провайдера: нужно либо пополнить баланс, либо подключить более щадящую модель/другой сервис. - **Доктор ругается на systemd.** В док‑выводе вылезает: «WSL2 needs systemd enabled…». Если после двух попыток включить systemd через `/etc/wsl.conf` он всё равно не стартует, для одиночного пользователя проще договориться с собой: «Окей, я буду запускать `openclaw gateway` руками, зато всё остальное уже работает». - **Бот молчит.** Часто это либо забытый шаг `/start` в личке бота, либо не одобренный pairing, либо модель, которая уткнулась в лимиты. Лечится проверкой pairing’а (`openclaw pairing list telegram`) и внимательным чтением текста ошибок, которые бот пересылает.
Если в статье вы покажете 2–3 таких реальных кейса со скринами/логами и короткими решениями, читатели Дзена будут чувствовать себя гораздо увереннее: «А, это как раз тот случай, про который он писал».
Зачем это всё практикам, а не только гикам
После всего вышеописанного у читателя не просто «завелся OpenClaw», а появился **новый рабочий инструмент**: личный ИИ‑агент, живущий у него на компьютере и доступный через Telegram и веб‑панель.
Что он может делать в реальной жизни:
- Делать ежедневный дайджест новостей по нейросетям, не заставляя вас листать десятки каналов и лент.
- Помогать писать и редактировать статьи, посты и сценарии под ваш стиль и формат. - Разбирать локальные файлы и заметки, не отправляя их в чужие облака.
Связка Windows + WSL + Ubuntu + OpenClaw — это не про «очередную игрушку для технарей», а про то, что у любого автора, маркетолога или продвинутого пользователя может появиться **свой** ИИ‑сотрудник, который работает из дома, а не из подписки.
И если раньше фраза «поднять себе Linux‑сервер с агентом» звучала как что‑то из мира DevOps, то теперь это реально делается за один вечер — максимум с несколькими перезагрузками и одним‑двумя сообщениями в Telegram: «OpenClaw: access not configured…», после которых вы официально становитесь тем самым человеком, у которого ИИ живёт под столом, а не в чьём‑то дата‑центре.
Что можно обещать в следующей статье
В конце текущего материала логично показать, что это только первый шаг, и пригласить читателя в «сериал» про жизнь с агентом.
Если будут отклики и вопросы, в следующей статье:
разберёмся, как превратить OpenClaw в редактора‑дайджестера по нейросетям: чтобы он сам собирал новости, сортировал по важности и выдавал вам готовый конспект;
покажу, как аккуратно подключить дополнительные инструменты (чтение файлов, веб‑поиск, работа с заметками), не превращая агента в дыру в безопасности;
настроим первый «боевой» сценарий под ваш формат: Дзен‑канал, телеграм‑блог или YouTube‑скрипты, чтобы агент не просто отвечал в чате, а делал за вас часть работы.
Можно мягко попросить читателя оставить комментарий с тем, что ему интереснее всего: сценарии для авторов, интеграция с Яндексом/ГигаЧатом, безопасность, или, например, как сделать отдельного агента под музыку/видео. Тогда следующую статью честно привяжем к реальным запросам аудитории, а не к абстрактной теории.
Да... Практика часто требует терпения и усидчивости, а подарок уже рядом:
