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

OpenClaw — мощный инструмент для создания рабочих процессов на базе ИИ, но его настройка в Windows может показаться новичкам сложной. Это руководство описывает основные способы установки, чтобы вы могли быстро приступить к работе.

Установка OpenClaw на Windows: сравнение 3 способов

Прежде чем переходить к шагам, вот краткий обзор трёх способов установки OpenClaw на Windows. У каждого способа свои плюсы и минусы по времени настройки, набору функций и техническим требованиям.

Kimi Claw — это онлайн-инструмент, позволяющий запускать OpenClaw прямо в браузере. Он автоматически выполняет настройку и конфигурацию, поэтому вам не нужны Node.js, WSL или настройка API-ключа. Начать работу с готовым к использованию агентом можно за несколько минут.

Чтобы настроить OpenClaw локально через PowerShell или WSL2, перейдите к разделу Способ 1 или Способ 2. Чтобы полностью пропустить локальную установку, перейдите к разделу Способ 3: Kimi Claw. Если хотите начать быстрее, можно приступить прямо сейчас.

Что нужно перед локальной установкой OpenClaw на Windows

Если вы планируете установить OpenClaw локально, убедитесь, что ваша система соответствует следующим требованиям. Если вы выбираете облачный вариант, например Kimi Claw, этот раздел можно пропустить полностью.

Системные требования

• Windows 10 или Windows 11 (64-разрядная версия)

• Не менее 4 ГБ ОЗУ (рекомендуется 8 ГБ для стабильной сборки npm-пакетов)

• Стабильное подключение к интернету

• Права администратора для первоначальной настройки, если вы выбираете WSL2

• Для OpenClaw WSL2: виртуализация должна быть включена в BIOS/UEFI

Необходимое программное обеспечение

• Node.js 22.14 или новее. OpenClaw требует современную среду выполнения Node.js. Скачайте её с nodejs.org или установите через скрипт onboarding.

• Git for Windows (необязательно, но рекомендуется). Некоторые npm-пакеты и навыки зависят от Git.

Способ 1: установка OpenClaw на Windows через PowerShell

По сравнению с WSL2 способ через PowerShell требует меньше шагов и не нуждается в среде Linux. Одна команда загружает OpenClaw, проверяет версию Node.js и запускает мастер onboarding. Этот способ работает как в Windows 10, так и в Windows 11.

Шаг 1: установите и запустите OpenClaw

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

Затем выполните следующую команду:

После выполнения команды вы должны увидеть результат, похожий на приведённый ниже скриншот. Закройте и снова откройте PowerShell, чтобы обновить системную переменную PATH, прежде чем переходить к настройке.

Шаг 2: Подтвердите предупреждение о риске и выберите режим настройки

Выберите Yes, чтобы подтвердить риск и продолжить.

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

Шаг 3: Настройте и авторизуйте свою модель ИИ

1. Выберите Moonshot AI в качестве провайдера модели/авторизации

1. Авторизуйте и настройте свою модель ИИ

Чтобы подключить OpenClaw, активируйте свой Kimi API Key на платформе Kimi. Пополнение баланса на $5 даёт бонусный купон на$5, но мы рекомендуем пополнить на $20 или больше, чтобы открыть доступ уровня Tier 2. Это снижает задержки и позволяет вашему агенту OpenClaw справляться со сложными многошаговыми задачами.

1. Создайте API-ключ Kimi

Перейдите в раздел API Keys и нажмите Create API Key. Обратите внимание, что API-ключ нужно хранить в надёжном и доступном месте: он показывается только один раз при создании.

1. Введите свой API-ключ и выберите модель по умолчанию

Когда мастер настройки попросит вас об этом, вставьте свой уникальный API-ключ в окно PowerShell/терминала.

Когда вас попросят выбрать модель по умолчанию, выберите moonshot/kimi-k2.5 (или выберите «Keep current», если она уже выделена). Эта модель обеспечивает наилучший баланс скорости и качества рассуждений для агентных задач.

Шаг 4: Выберите канал

Выберите, какое приложение вы хотите подключить к вашему OpenClaw. Если не знаете, что выбрать, просто пропустите этот шаг.

Шаг 5: Настройте для повышения производительности

Нажмите Yes, чтобы настроить, или No, чтобы пропустить.

Шаг 6: Включите хуки (Hooks)

Выберите способ общения с вашим ботом, затем подождите, пока он запустится.

Шаг 7: Запустите свой OpenClaw

После выполнения всех шагов выше можете пользоваться своим OpenClaw.

Способ 2: Установка OpenClaw на Windows через WSL2

Настройка OpenClaw через WSL2 обеспечивает полноценную среду Linux внутри Windows и является официально рекомендуемым способом запуска OpenClaw. Этот метод даёт доступ к полному набору функций, включая управление демонами через systemd, нативные shell-скрипты и более стабильную сборку через npm. Если вы планируете использовать OpenClaw на Windows для повседневной работы или разработки, OpenClaw через WSL — лучший выбор.

Шаг 1: Включите WSL2 для OpenClaw на Windows 11/10

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

Эта команда включает WSL, скачивает и устанавливает Ubuntu. После завершения процесса перезагрузите компьютер. При перезагрузке Windows запустится Ubuntu и попросит вас создать имя пользователя и пароль.

Если WSL уже установлен, проверьте это:

Шаг 2: настройка systemd в WSL2

OpenClaw работает как фоновая служба на основе systemd. Включите его в конфигурации WSL:

Затем перезапустите WSL из PowerShell:

Снова откройте терминал Ubuntu и проверьте, что systemd запущен:

В выводе должно отображаться systemd. Если вместо этого показывается init, проверьте файл /etc/wsl.conf.

Шаг 3: установка Node.js 22.14+

OpenClaw требует Node.js 22.14 или более новой версии. Установите его из репозитория NodeSource:

Проверьте установку:

Шаг 4: установка OpenClaw через npm

После установки Node.js установите OpenClaw глобально:

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

Проверьте установку:

Шаг 5: завершение настройки OpenClaw в Windows через onboarding

Запустите мастер настройки с флагом daemon, чтобы установить OpenClaw как службу systemd:

Мастер настройки поможет вам:

• Выбрать поставщика LLM и ввести API-ключ

• Выбрать модель по умолчанию

• Настроить каналы для сообщений (необязательно)

• Установить gateway как фоновую службу

После завершения настройки включите автозапуск службы, чтобы OpenClaw запускался автоматически при загрузке WSL:

Gateway — это основная фоновая служба, которая обрабатывает все операции OpenClaw, включая запросы агентов, обмен сообщениями и выполнение моделей. Проверка того, что она работает, подтверждает, что установка OpenClaw завершена и готова к использованию, и позволяет избежать ошибок на следующих шагах.

Выполните следующую команду в PowerShell или терминале WSL, чтобы проверить её статус:

Способ 3: запуск OpenClaw в Windows с Kimi Claw (без настройки)

Если настройка Node.js, WSL и API-ключей кажется вам избыточной, Kimi Claw предлагает более простой способ запуска OpenClaw. Он позволяет запускать OpenClaw прямо в браузере без локальной установки и ручной настройки. Чтобы начать, выполните следующие шаги:

Шаг 1: откройте Kimi Claw и создайте инстанс

Перейдите на страницу Kimi Claw и нажмите Создать, чтобы начать.

Шаг 2: начните развёртывание

Подтвердите развёртывание в появившемся окне. Kimi Claw настроит вашу среду OpenClaw примерно за две минуты, включая gateway, рабочую область и инструменты. Никакие команды или ручная настройка не требуются.

Шаг 3: работа в рабочей области

После завершения развёртывания рабочая область откроется в панели управления. Вы можете начать общаться со своим ИИ-агентом, настраивать навыки, настраивать запланированные задачи и управлять файлами — всё это прямо из браузера.

Что вы получаете с Kimi Claw

• Нулевая настройка: не требуется управлять Node.js, WSL или API-ключами

• 40 ГБ облачного хранилища: сохраняйте отчёты, наборы данных и созданные файлы, которые сохраняются между сессиями

• Постоянная память: ваш ИИ-агент помнит прошлые взаимодействия, предпочтения и контекст

• Более 5000 навыков ClawHub: мгновенный доступ к навыкам автоматизации, исследований, программирования и анализа

• Автоматизация задач по расписанию: настраивайте повторяющиеся задачи, такие как ежедневные отчёты, напоминания и мониторинг

• Работает с любого устройства: доступ к вашему агенту OpenClaw из любого браузера на Windows, Mac или мобильных устройствах

Настройки брандмауэра Windows и безопасности для OpenClaw

Kimi Claw автоматически обеспечивает безопасность и сетевые настройки на облачных серверах. Если вы предпочитаете устанавливать OpenClaw локально через PowerShell или WSL2, после установки рекомендуется настроить несколько параметров безопасности.

• Настройка брандмауэра Windows

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

Если Browser Relay или другие функции не могут подключиться, убедитесь, что трафик localhost не блокируется сторонним защитным программным обеспечением, например антивирусами, VPN-клиентами или корпоративными брандмауэрами.

• Защита Control UI

Control UI OpenClaw работает на порту 18789 и предоставляет полный доступ к вашему агенту. Никогда не открывайте этот порт для публичного доступа из интернета. Держите шлюз привязанным к 127.0.0.1 и обращайтесь к нему только со своего локального компьютера.

Для безопасного удалённого доступа используйте Tailscale, чтобы создать приватный туннель:

Это позволяет оставить порт на localhost, но при этом сделать его доступным через вашу приватную сеть Tailscale.

Распространённые ошибки установки OpenClaw в Windows и способы их устранения

Даже при наличии подробного руководства во время установки могут возникать проблемы. Ниже перечислены самые частые проблемы при установке OpenClaw в Windows и способы их устранения.

OpenClaw не распознаётся

• Причина: глобальный каталог npm bin отсутствует в системной переменной PATH.

• Решение: выполните следующую команду, чтобы найти префикс npm

Добавьте полученный путь в переменные окружения Windows. Не добавляйте \\bin в конце. Затем закройте и снова откройте PowerShell.

Git не найден во время установки

• Причина: Git для Windows не установлен.

• Решение: скачайте и установите Git с сайта git-scm.com. После установки перезапустите PowerShell и повторите попытку запуска установщика OpenClaw для Windows.

Слишком старая версия Node.js

• Причина: в вашей системе установлена более старая версия Node.js, не соответствующая минимальному требованию (v22.14+).

• Решение: скачайте последнюю LTS-версию с nodejs.org и установите её. Если вы используете OpenClaw через WSL2, переустановите Node.js через репозиторий NodeSource.

Ошибки «отказано в доступе»

• Причина: у PowerShell недостаточно прав, либо глобальный каталог npm недоступен для записи.

• Решение: запустите PowerShell от имени администратора либо измените глобальный префикс npm на каталог, доступный для записи текущему пользователю

Шлюз не запускается

• Причина: порт 18789 уже занят, либо файл конфигурации повреждён.

• Решение: проверьте наличие конфликтующих процессов и перезапустите

systemd в WSL2 не работает

• Причина: в файле /etc/wsl.conf отсутствует настройка systemd.

• Решение: убедитесь, что файл содержит правильные настройки

Если настройка отсутствует, добавьте её и перезапустите WSL с помощью команды wsl --shutdown в PowerShell.

Заключение

Установка OpenClaw в Windows может варьироваться от простой настройки на основе скрипта до более сложной среды WSL2 — в зависимости от ваших потребностей. Если вам нужен полный контроль и гибкость, PowerShell и WSL2 — надёжные варианты. Если вы хотите обойтись без настройки и начать работу сразу, Kimi Claw позволяет запускать OpenClaw в браузере без локальной установки. Выберите подход, который соответствует вашему рабочему процессу и уровню технической подготовки, и вы сможете получить максимум от OpenClaw.